X-Git-Url: https://plomlompom.com/repos/?a=blobdiff_plain;f=SERVER_COMMANDS;h=d54ac79fd8028485d50383738e8bd1899811a55c;hb=b1c36ca1d6f9bc4f88f616733dfbc751cb63b465;hp=cb1635da037ee7c736283ab6a00a56ebefefc8cd;hpb=7bedc1d4ffc9c3b623c4195c484539ba7adb2dfd;p=plomrogue diff --git a/SERVER_COMMANDS b/SERVER_COMMANDS index cb1635d..d54ac79 100644 --- a/SERVER_COMMANDS +++ b/SERVER_COMMANDS @@ -4,15 +4,16 @@ 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 @@ -22,15 +23,15 @@ 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 ============ @@ -44,6 +45,9 @@ whitespaces. "[char]" means a single ASCII character is expected. If one of a set of pre-defined strings is expected, the legal strings are divided by pipe symbols ("|"). +Commands in lowercase characters ("player commands") are only interpreted if the +game world is set active. + Meta commands ------------- @@ -96,9 +100,6 @@ be generated. (Initial value: 0.) SEED_RANDOMNESS [0 to 4294967295] Set randomness seed to argument. (Initial value: 0.) -SEED_MAP [0 to 4294967295] -(Re-)generate map to seed of argument and map size. - MAKE_WORLD [0 to 4294967295] 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 @@ -110,6 +111,9 @@ MAP_LENGTH [1 to 256] Deactivate world. Remove ./server/worldstate file. Remove all things. Remove map. Set map edge length to argument. (Initial value: 64.) +MAP [0 to 255] [string] +Set part of game map to string argument: the line of the argument's number. + WORLD_ACTIVE [0|1] 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 @@ -224,8 +228,7 @@ TT_CORPSE_ID [0 to infinity] 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. +is available that is passable and not inhabited by any thing.