home · contact · privacy
7DRL: Some population balancing.
[plomrogue] / SERVER_COMMANDS
index 65c22fd2c315827e1b8b9bb62d38784240e375d1..88c0877088036a7e06a31d224ed24373a4fe7cc3 100644 (file)
@@ -4,33 +4,34 @@ Command reading and writing
 Normal mode
 -----------
 
-In normal mode, the server on start up checks for the existence of ./savefile
-and, on success, reads all commands from it. If no savefile exists, commands
-from ./confserver/world are read instead – and written to the file ./record.
+In normal mode, the server on start up checks for the existence of ./save and,
+on success, reads all commands from it. If no save file exists, commands from
+./confserver/world are read instead – and written to the file ./record_save.
 Afterwards, the command "MAKE_WORLD" with the current Unix time as argument is
-interpreted (and also written to ./record).
+interpreted (and also written to ./record_save).
 
 In any case, from then on, further commands are read in from ./server/in. New
 commands must be appended to the file – which is what the client does. All
-commands from ./server/in except meta commands are also written to ./record.
+commands from ./server/in except meta commands are also written to
+./record_save.
 
-Every fifteen seconds, if any turns have passed, ./savefile is written – with a
-list of all god commands necessary to recreate the current world state. On each
-world state change, ./server/worldstate is updated and a message "WORLD_UPDATED"
+Every fifteen seconds, if any turns have passed, ./save is written – with a list
+of all god commands necessary to recreate the current world state. On each world
+state change, ./server/worldstate is updated and a message "WORLD_UPDATED"
 written to ./server/out.
 
 Replay mode
 -----------
 
-In replay mode, commands from ./record are read. If a turn number is given as an
-argument, the file is read until the given turn is reached, or, if the turn
-number is higher than the last turn of the recorded play, the last turn. If no
-turn number is given as argument, the record file is replayed until turn 1 is
-reached. Meta commands in ./record are not understood.
+In replay mode, commands from ./record_save are read. If a turn number is given
+as an argument, the file is read until the given turn is reached, or, if the
+turn number is higher than the last turn of the recorded play, the last turn. If
+no turn number is given as argument, the record file is replayed until turn 1 is
+reached. Meta commands in ./record_save are not understood.
 
 From then on, ./server/in is also read. Meta commands sent by the client are
 interpreted normally, but any player and god command merely furthers reading of
-./record by one line and is otherwise ignored.
+./record_save by one line and is otherwise ignored.
 
 Command list
 ============
@@ -166,10 +167,10 @@ T_LIFEPOINTS [0 to 255]
 Set selected thing's lifepoints to argument.
 
 T_SATIATION [-32768 to 32767]
-Set selected thing's satiation score. If above zero, and thing's lifepoints are
-below its thing type's initial lifepoints, there is a 1/32 chance each turn of
-waiting action that the thing's lifepoints will rise. For values affecting the
-thing's lifepoints negatively, see note on TT_LIFEPOINTS.
+Set selected thing's satiation score. Each turn, there is a chance of hitpoint
+loss that grows with the satiation score's absolute value, and one of hitpoint
+gain that lowers with it. Each turn, T_SATIATION lessens by the square root of
+the thing's type's start hitpoints (see TT_LIFEPOINTS).
 
 T_CARRIES [0 to 255]
 Add thing of ID in argument to inventory of selected thing, if said thing is
@@ -193,9 +194,14 @@ to the lowest unused thing type ID. If thing type of ID does not exist yet,
 create it with default name "(none)", corpse ID equal to the new thing type's
 ID, symbol "?", and remaining thing type attributes to 0.
 
-TT_CONSUMABLE [0-65535]
-Set selected thing type's consumability value to argument – the number of
-.satiation score points earned by consuming/using things of that type.
+TT_TOOL [|food]
+(May be left empty.) Defines the way things of the selected type can be used.
+The only options so far that is interpreted is "food" (may be consumed).
+
+TT_TOOLPOWER [0 to 65535]
+Set selected thing type's tool power value to argument. If its tool type is
+"food", this sets the number of .satiation score points earned by consuming
+things of that type.
 
 TT_START_NUMBER [0-255]
 Set selected thing type's number of things of type to spawn on successful
@@ -203,14 +209,8 @@ MAKE_WORLD command to argument.
 
 TT_LIFEPOINTS [0-255]
 Set selected thing type's initial lifepoints value to argument. Things of 0
-lifepoints are considered inanimate, otherwise animate. This value also sets the
-degree to which the selected type's things suffer from under- or over-satiation:
-If 0, not at all. Else, it defines a stomach size value of 32767 divided by it.
-Each turn a thing of the given type may then suffer a lifepoint decrement to the
-chance of the rounded down quotient of its satiation score's absolute value by
-its stomach size value, then again divided by the latter. (This means that the
-change is always zero when the absolute value of the satiation score is lower
-than the stomach size value.)
+lifepoints are considered inanimate, otherwise animate. The square root of this
+is the amount things of the type suffer satiation score loss each turn.
 
 TT_SYMBOL [char]
 Set to argument symbol by which things of the selected type are represented on
@@ -224,8 +224,33 @@ TT_CORPSE_ID [0-255]
 Set to argument the ID of the thing type that things of the selected type
 transform into when their state changes from animate to inanimate.
 
-TT_PROLIFERATE [0-255]
+TT_PROLIFERATE [0 to 65535]
 If non-zero, there is a chance of 1 divided by the given value each turn for any
 thing of the selected type to emit an offspring to a random neighbor cell if one
 is available that is passable and not inhabited by a thing of the same same type
 or, if the proliferating thing is animate, any other animate thing.
+
+Unexplained 7DRL additions
+---------------------------
+
+GOD_FAVOR [-32768 to 32767]
+
+SLIPPERS [0 to infinity]
+
+FAVOR_STAGE [0 to 65535]
+
+PLANT_0 [0 to infinity]
+
+LUMBER [0 to infinity]
+
+TOOL_0 [0 to infinity]
+
+TOOL_1 [0 to infinity]
+
+EMPATHY [0 to 1]
+
+ANIMAL_0 [0 to infinity]
+
+ANIMAL_1 [0 to infinity]
+
+TT_TOOLS gains the arguments "axe", "carpentry", "wood".