Server: meta command STACK to list item stack below player in out file.

[plomrogue] / SERVER_COMMANDS

diff --git a/SERVER_COMMANDS b/SERVER_COMMANDS
index cab9cd16d058ddda21e84b1d47baa8f98c760c82..6d011c7e83d0b41fbc8e50214e9f72bbdcaaee24 100644 (file)
--- a/SERVER_COMMANDS
+++ b/SERVER_COMMANDS
@@ -24,11 +24,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 +51,16 @@ Write "PONG" line to ./server/out file.
 QUIT
 Shut down server.
 
+STACK
+Write line-by-line list of items the player stands on into ./server/out file,
+enclosed by two lines "THINGS_BELOW_PLAYER START" and "THINGS_BELOW_PLAYER END".
+
 Player commands
 ---------------
 
+ai
+Do what the AI would do.
+
 wait
 Make player character wait one turn.
 
@@ -113,16 +120,17 @@ exist yet, create it with default name "wait" and default effort 1.
 TA_EFFORT [0 to 255]
 Set to argument the number of turns finishing the selected thing action takes.
 
-TA_NAME {wait|move|use|drop|pick_up}
-Set selected thing action's name (and thereby function). Legal worlds need at
-least one action of name "wait", so if this unsets the world's only "wait"
-action, the world is deactivated, and the ./server/worldstate file removed.
+TA_NAME [wait|move|use|drop|pick_up]
+Set selected thing action's name (and thereby function, equal to player
+command). Legal worlds need at least one action of name "wait", so if this
+unsets the world's only "wait" action, the world is deactivated, and the
+./server/worldstate file removed.
 
 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]
@@ -156,6 +164,14 @@ 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_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
@@ -184,4 +200,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.