X-Git-Url: https://plomlompom.com/repos/index.html?a=blobdiff_plain;f=SERVER_COMMANDS;h=3036c0478471262732bcc93a1ddfbc4fc46f665e;hb=0f015c3004d6c2282e84c34c31d10b952fefee20;hp=6a9d4ba397d7d63f027684d253b118858dac7c67;hpb=9c86eed25b9291dac2bd93882fd9d259bdf53201;p=plomrogue
diff --git a/SERVER_COMMANDS b/SERVER_COMMANDS
index 6a9d4ba..3036c04 100644
--- a/SERVER_COMMANDS
+++ b/SERVER_COMMANDS
@@ -14,8 +14,10 @@ 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.
-At the end of each turn, ./savefile is written â with a list of all god commands
-necessary to recreate the current world state.
+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"
+written to ./server/out.
Replay mode
-----------
@@ -24,11 +26,11 @@ 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.
+reached. Meta commands in ./record are not understood.
-From then on, ./server/in is also read. Meta commands are interpreted normally,
-but any player and god command merely furthers reading of ./record by one line
-and is otherwise ignored.
+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.
Command list
============
@@ -51,9 +53,18 @@ Write "PONG" line to ./server/out file.
QUIT
Shut down server.
+THINGS_HERE [0 to 255] [0 to 255]
+If world exists, write line-by-line list of things visible or in memory at y
+position of first argument, x position of second argument of map into
+./server/out file, enclosed by two lines "THINGS_HERE START" and
+"THINGS_HERE END".
+
Player commands
---------------
+ai
+Do what the AI would do.
+
wait
Make player character wait one turn.
@@ -92,7 +103,8 @@ MAKE_WORLD [0 to 4294967296]
Set map seed and randomness seed to argument. Remove all things. (Re-)generate
map. Add to map things specified in thing types table in quantity defined there
by START_NUMBER command, with first thing (of thing ID of 0) of type defined as
-player type by PLAYER_TYPE command. Set world turn to 1. Activate world.
+player type by PLAYER_TYPE command. Set world turn to 1. Activate world. Answer
+with 'NEW_WORLD' message in ./server/out file.
MAP_LENGTH [1 to 256]
Deactivate world. Remove ./server/worldstate file. Remove all things. Remove
@@ -102,8 +114,8 @@ WORLD_ACTIVE [0 to 255]
Set world activity state to argument. If 0, remove ./server/worldstate file.
Else, if world was so far inactive, a map exists, at least one "wait" thing
action is defined, and a thing of ID 0 (= a player character) that is not part
-of any other thing's inventory, (re-)build all animate things' fields of view and
-activate world. (Initial value: 0.)
+of any other thing's inventory, (re-)build all animate things' fields of view,
+and activate world. (Initial value: 0.)
TA_ID [0 to 255]
Select thing action to manipulate by argument as ID. If argument is 0, change it
@@ -123,7 +135,7 @@ T_ID [-32768 to 32767]
Select thing to manipulate by argument as ID. If argument is <0 or >255, change
it to the lowest unused thing ID. If thing of ID does not exist yet, create it
with default position of y=0/x=0, the first thing type's ID, and that type's
-lifepoints value. If world is active and the thing is animate, build its field
+lifepoints value; if world is active and the thing is animate, build its field
of view.
T_TYPE [0 to 255]
@@ -153,19 +165,34 @@ performing the action) value to argument.
T_LIFEPOINTS [0 to 255]
Set selected thing's lifepoints to argument.
+T_SATIATION [-32768 to 32767]
+Set selected thing's satiation score.
+
T_CARRIES [0 to 255]
Add thing of ID in argument to inventory of selected thing, if said thing is
available for carrying and not the selected thing.
+T_MEMMAP [0 to 255] [string]
+Set part of selected thing's memory of the game map to string argument: the line
+of the argument's number.
+
+T_MEMDEPTHMAP [0 to 255] [string]
+Set part of selected thing's game map memory depth map to string argument: the
+line of the argument's number.
+
+T_MEMTHING [0 to 255] [0 to 255] [0 to 255]
+Add to selected thing's memory of things on map thing of ID of first argument,
+y position of second argument and x position of third argument.
+
TT_ID [-32768 to 32767]
Select thing type to manipulate by argument as ID. If argument is <0 or <255,
change it 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, and remaining thing type attributes to 0.
-TT_CONSUMABLE [0-255]
+TT_CONSUMABLE [0-65535]
Set selected thing type's consumability value to argument â the number of
-lifepoints earned by consuming/using things of that type.
+.satiation score points earned by consuming/using things of that type.
TT_START_NUMBER [0-255]
Set selected thing type's number of things of type to spawn on successful
@@ -173,7 +200,14 @@ 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.
+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 tpe may then suffer a lifepoint decrement to the
+change 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.)
TT_SYMBOL [char]
Set to argument symbol by which things of the selected type are represented on
@@ -185,4 +219,10 @@ game log and the inventory.
TT_CORPSE_ID [0-255]
Set to argument the ID of the thing type that things of the selected type
-transform into when their change changes from animate to inanimate.
+transform into when their state changes from animate to inanimate.
+
+TT_PROLIFERATE [0-255]
+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.