plomlompom.com Git - plomrogue/blob - roguelike-server

   1 #!/usr/bin/python3
   2
   3 # This file is part of PlomRogue. PlomRogue is licensed under the GPL version 3
   4 # or any later version. For details on its copyright, license, and warranties,
   5 # see the file NOTICE in the root directory of the PlomRogue source package.
   6
   7
   8 import argparse
   9 import errno
  10 import os
  11 import shlex
  12 import shutil
  13 import time
  14 import ctypes
  15
  16
  17 class RandomnessIO:
  18     """"Interface to libplomrogue's pseudo-randomness generator."""
  19
  20     def set_seed(self, seed):
  21         libpr.seed_rrand(1, seed)
  22
  23     def get_seed(self):
  24         return libpr.seed_rrand(0, 0)
  25
  26     def next(self):
  27         return libpr.rrand()
  28
  29     seed = property(get_seed, set_seed)
  30
  31
  32 def prep_library():
  33     """Prepare ctypes library at ./libplomrogue.so"""
  34     libpath = ("./libplomrogue.so")
  35     if not os.access(libpath, os.F_OK):
  36         raise SystemExit("No library " + libpath + ", run ./redo first?")
  37     libpr = ctypes.cdll.LoadLibrary(libpath)
  38     libpr.seed_rrand.restype = ctypes.c_uint32
  39     return libpr
  40
  41
  42 def c_pointer_to_bytearray(ba):
  43     """Return C char * pointer to ba."""
  44     type = ctypes.c_char * len(ba)
  45     return type.from_buffer(ba)
  46
  47
  48 def strong_write(file, string):
  49     """Apply write(string), then flush()."""
  50     file.write(string)
  51     file.flush()
  52
  53
  54 def setup_server_io():
  55     """Fill IO files DB with proper file( path)s. Write process IO test string.
  56
  57     Ensure IO files directory at server/. Remove any old input file if found.
  58     Set up new input file for reading, and new output file for writing. Start
  59     output file with process hash line of format PID + " " + floated UNIX time
  60     (io_db["teststring"]). Raise SystemExit if file is found at path of either
  61     record or save file plus io_db["tmp_suffix"].
  62     """
  63     def detect_atomic_leftover(path, tmp_suffix):
  64         path_tmp = path + tmp_suffix
  65         msg = "Found file '" + path_tmp + "' that may be a leftover from an " \
  66               "aborted previous attempt to write '" + path + "'. Aborting " \
  67               "until matter is resolved by removing it from its current path."
  68         if os.access(path_tmp, os.F_OK):
  69             raise SystemExit(msg)
  70     io_db["teststring"] = str(os.getpid()) + " " + str(time.time())
  71     io_db["save_wait"] = 0
  72     io_db["verbose"] = False
  73     io_db["record_chunk"] = ""
  74     os.makedirs(io_db["path_server"], exist_ok=True)
  75     io_db["file_out"] = open(io_db["path_out"], "w")
  76     strong_write(io_db["file_out"], io_db["teststring"] + "\n")
  77     if os.access(io_db["path_in"], os.F_OK):
  78         os.remove(io_db["path_in"])
  79     io_db["file_in"] = open(io_db["path_in"], "w")
  80     io_db["file_in"].close()
  81     io_db["file_in"] = open(io_db["path_in"], "r")
  82     detect_atomic_leftover(io_db["path_save"], io_db["tmp_suffix"])
  83     detect_atomic_leftover(io_db["path_record"], io_db["tmp_suffix"])
  84
  85
  86 def cleanup_server_io():
  87     """Close and (if io_db["kicked_by_rival"] false) remove files in io_db."""
  88     def helper(file_key, path_key):
  89         if file_key in io_db:
  90             io_db[file_key].close()
  91         if not io_db["kicked_by_rival"] \
  92            and os.access(io_db[path_key], os.F_OK):
  93             os.remove(io_db[path_key])
  94     helper("file_in", "path_in")
  95     helper("file_out", "path_out")
  96     helper("file_worldstate", "path_worldstate")
  97     if "file_record" in io_db:
  98         io_db["file_record"].close()
  99
 100
 101 def obey(command, prefix, replay=False, do_record=False):
 102     """Call function from commands_db mapped to command's first token.
 103
 104     Tokenize command string with shlex.split(comments=True). If replay is set,
 105     a non-meta command from the commands_db merely triggers obey() on the next
 106     command from the records file. If not, non-meta commands set
 107     io_db["worldstate_updateable"] to world_db["WORLD_ACTIVE"], and, if
 108     do_record is set, are recorded to io_db["record_chunk"], and save_world()
 109     is called (and io_db["record_chunk"] written) if 15 seconds have passed
 110     since the last time it was called. The prefix string is inserted into the
 111     server's input message between its beginning 'input ' and ':'. All activity
 112     is preceded by a server_test() call. Commands that start with a lowercase
 113     letter are ignored when world_db["WORLD_ACTIVE"] is False/0.
 114     """
 115     server_test()
 116     if io_db["verbose"]:
 117         print("input " + prefix + ": " + command)
 118     try:
 119         tokens = shlex.split(command, comments=True)
 120     except ValueError as err:
 121         print("Can't tokenize command string: " + str(err) + ".")
 122         return
 123     if len(tokens) > 0 and tokens[0] in commands_db \
 124        and len(tokens) == commands_db[tokens[0]][0] + 1:
 125         if commands_db[tokens[0]][1]:
 126             commands_db[tokens[0]][2](*tokens[1:])
 127         elif tokens[0][0].islower() and not world_db["WORLD_ACTIVE"]:
 128             print("Ignoring lowercase-starting commands when world inactive.")
 129         elif replay:
 130             print("Due to replay mode, reading command as 'go on in record'.")
 131             line = io_db["file_record"].readline()
 132             if len(line) > 0:
 133                 obey(line.rstrip(), io_db["file_record"].prefix
 134                      + str(io_db["file_record"].line_n))
 135                 io_db["file_record"].line_n = io_db["file_record"].line_n + 1
 136             else:
 137                 print("Reached end of record file.")
 138         else:
 139             commands_db[tokens[0]][2](*tokens[1:])
 140             if do_record:
 141                 io_db["record_chunk"] += command + "\n"
 142                 if time.time() > io_db["save_wait"] + 15:
 143                     atomic_write(io_db["path_record"], io_db["record_chunk"],
 144                                  do_append=True)
 145                     if world_db["WORLD_ACTIVE"]:
 146                         save_world()
 147                     io_db["record_chunk"] = ""
 148                     io_db["save_wait"] = time.time()
 149             io_db["worldstate_updateable"] = world_db["WORLD_ACTIVE"]
 150     elif 0 != len(tokens):
 151         print("Invalid command/argument, or bad number of tokens.")
 152
 153
 154 def atomic_write(path, text, do_append=False, delete=True):
 155     """Atomic write of text to file at path, appended if do_append is set."""
 156     path_tmp = path + io_db["tmp_suffix"]
 157     mode = "w"
 158     if do_append:
 159         mode = "a"
 160         if os.access(path, os.F_OK):
 161             shutil.copyfile(path, path_tmp)
 162     file = open(path_tmp, mode)
 163     strong_write(file, text)
 164     file.close()
 165     if delete and os.access(path, os.F_OK):
 166         os.remove(path)
 167     os.rename(path_tmp, path)
 168
 169
 170 def save_world():
 171     """Save all commands needed to reconstruct current world state."""
 172
 173     def quote(string):
 174         string = string.replace("\u005C", '\u005C\u005C')
 175         return '"' + string.replace('"', '\u005C"') + '"'
 176
 177     def mapsetter(key):
 178         def helper(id=None):
 179             string = ""
 180             if key == "MAP" or world_db["Things"][id][key]:
 181                 map = world_db["MAP"] if key == "MAP" \
 182                                       else world_db["Things"][id][key]
 183                 length = world_db["MAP_LENGTH"]
 184                 for i in range(length):
 185                     line = map[i * length:(i * length) + length].decode()
 186                     string = string + key + " " + str(i) + " " + quote(line) \
 187                         + "\n"
 188             return string
 189         return helper
 190
 191     def memthing(id):
 192         string = ""
 193         for memthing in world_db["Things"][id]["T_MEMTHING"]:
 194             string = string + "T_MEMTHING " + str(memthing[0]) + " " + \
 195                 str(memthing[1]) + " " + str(memthing[2]) + "\n"
 196         return string
 197
 198     def helper(category, id_string, special_keys={}):
 199         string = ""
 200         for id in sorted(world_db[category].keys()):
 201             string = string + id_string + " " + str(id) + "\n"
 202             for key in sorted(world_db[category][id].keys()):
 203                 if not key in special_keys:
 204                     x = world_db[category][id][key]
 205                     argument = quote(x) if str == type(x) else str(x)
 206                     string = string + key + " " + argument + "\n"
 207                 elif special_keys[key]:
 208                     string = string + special_keys[key](id)
 209         return string
 210
 211     string = ""
 212     for key in sorted(world_db.keys()):
 213         if (not isinstance(world_db[key], dict)) and key != "MAP" and \
 214            key != "WORLD_ACTIVE":
 215             string = string + key + " " + str(world_db[key]) + "\n"
 216     string = string + mapsetter("MAP")()
 217     string = string + helper("ThingActions", "TA_ID")
 218     string = string + helper("ThingTypes", "TT_ID", {"TT_CORPSE_ID": False})
 219     for id in sorted(world_db["ThingTypes"].keys()):
 220         string = string + "TT_ID " + str(id) + "\n" + "TT_CORPSE_ID " + \
 221             str(world_db["ThingTypes"][id]["TT_CORPSE_ID"]) + "\n"
 222     string = string + helper("Things", "T_ID",
 223                              {"T_CARRIES": False, "carried": False,
 224                               "T_MEMMAP": mapsetter("T_MEMMAP"),
 225                               "T_MEMTHING": memthing, "fovmap": False,
 226                               "T_MEMDEPTHMAP": mapsetter("T_MEMDEPTHMAP")})
 227     for id in sorted(world_db["Things"].keys()):
 228         if [] != world_db["Things"][id]["T_CARRIES"]:
 229             string = string + "T_ID " + str(id) + "\n"
 230             for carried in sorted(world_db["Things"][id]["T_CARRIES"]):
 231                 string = string + "T_CARRIES " + str(carried) + "\n"
 232     string = string + "SEED_RANDOMNESS " + str(rand.seed) + "\n" + \
 233         "WORLD_ACTIVE " + str(world_db["WORLD_ACTIVE"])
 234     atomic_write(io_db["path_save"], string)
 235
 236
 237 def obey_lines_in_file(path, name, do_record=False):
 238     """Call obey() on each line of path's file, use name in input prefix."""
 239     file = open(path, "r")
 240     line_n = 1
 241     for line in file.readlines():
 242         obey(line.rstrip(), name + "file line " + str(line_n),
 243              do_record=do_record)
 244         line_n = line_n + 1
 245     file.close()
 246
 247
 248 def parse_command_line_arguments():
 249     """Return settings values read from command line arguments."""
 250     parser = argparse.ArgumentParser()
 251     parser.add_argument('-s', nargs='?', type=int, dest='replay', const=1,
 252                         action='store')
 253     parser.add_argument('-l', nargs="?", const="save", dest='savefile',
 254                         action="store")
 255     parser.add_argument('-v', dest='verbose', action='store_true')
 256     opts, unknown = parser.parse_known_args()
 257     return opts
 258
 259
 260 def server_test():
 261     """Ensure valid server out file belonging to current process.
 262
 263     This is done by comparing io_db["teststring"] to what's found at the start
 264     of the current file at io_db["path_out"]. On failure, set
 265     io_db["kicked_by_rival"] and raise SystemExit.
 266     """
 267     if not os.access(io_db["path_out"], os.F_OK):
 268         raise SystemExit("Server output file has disappeared.")
 269     file = open(io_db["path_out"], "r")
 270     test = file.readline().rstrip("\n")
 271     file.close()
 272     if test != io_db["teststring"]:
 273         io_db["kicked_by_rival"] = True
 274         msg = "Server test string in server output file does not match. This" \
 275               " indicates that the current server process has been " \
 276               "superseded by another one."
 277         raise SystemExit(msg)
 278
 279
 280 def read_command():
 281     """Return next newline-delimited command from server in file.
 282
 283     Keep building return string until a newline is encountered. Pause between
 284     unsuccessful reads, and after too much waiting, run server_test().
 285     """
 286     wait_on_fail = 0.03333
 287     max_wait = 5
 288     now = time.time()
 289     command = ""
 290     while True:
 291         add = io_db["file_in"].readline()
 292         if len(add) > 0:
 293             command = command + add
 294             if len(command) > 0 and "\n" == command[-1]:
 295                 command = command[:-1]
 296                 break
 297         else:
 298             time.sleep(wait_on_fail)
 299             if now + max_wait < time.time():
 300                 server_test()
 301                 now = time.time()
 302     return command
 303
 304
 305 def try_worldstate_update():
 306     """Write worldstate file if io_db["worldstate_updateable"] is set."""
 307     if io_db["worldstate_updateable"]:
 308
 309         def draw_visible_Things(map, run):
 310             for id in world_db["Things"]:
 311                 type = world_db["Things"][id]["T_TYPE"]
 312                 consumable = world_db["ThingTypes"][type]["TT_TOOL"] == "food"
 313                 alive = world_db["ThingTypes"][type]["TT_LIFEPOINTS"]
 314                 if (0 == run and not consumable and not alive) \
 315                    or (1 == run and consumable and not alive) \
 316                    or (2 == run and alive):
 317                     y = world_db["Things"][id]["T_POSY"]
 318                     x = world_db["Things"][id]["T_POSX"]
 319                     fovflag = world_db["Things"][0]["fovmap"][(y * length) + x]
 320                     if 'v' == chr(fovflag):
 321                         c = world_db["ThingTypes"][type]["TT_SYMBOL"]
 322                         map[(y * length) + x] = ord(c)
 323
 324         def write_map(string, map):
 325             for i in range(length):
 326                 line = map[i * length:(i * length) + length].decode()
 327                 string = string + line + "\n"
 328             return string
 329
 330         inventory = ""
 331         if [] == world_db["Things"][0]["T_CARRIES"]:
 332             inventory = "(none)\n"
 333         else:
 334             for id in world_db["Things"][0]["T_CARRIES"]:
 335                 type_id = world_db["Things"][id]["T_TYPE"]
 336                 name = world_db["ThingTypes"][type_id]["TT_NAME"]
 337                 inventory = inventory + name + "\n"
 338         string = str(world_db["TURN"]) + "\n" + \
 339             str(world_db["Things"][0]["T_LIFEPOINTS"]) + "\n" + \
 340             str(world_db["Things"][0]["T_SATIATION"]) + "\n" + \
 341             inventory + "%\n" + \
 342             str(world_db["Things"][0]["T_POSY"]) + "\n" + \
 343             str(world_db["Things"][0]["T_POSX"]) + "\n" + \
 344             str(world_db["MAP_LENGTH"]) + "\n"
 345         length = world_db["MAP_LENGTH"]
 346         fov = bytearray(b' ' * (length ** 2))
 347         for pos in range(length ** 2):
 348             if 'v' == chr(world_db["Things"][0]["fovmap"][pos]):
 349                 fov[pos] = world_db["MAP"][pos]
 350         for i in range(3):
 351             draw_visible_Things(fov, i)
 352         string = write_map(string, fov)
 353         mem = world_db["Things"][0]["T_MEMMAP"][:]
 354         for i in range(2):
 355             for mt in world_db["Things"][0]["T_MEMTHING"]:
 356                 consumable = world_db["ThingTypes"][mt[0]]["TT_TOOL"] == "food"
 357                 if (i == 0 and not consumable) or (i == 1 and consumable):
 358                     c = world_db["ThingTypes"][mt[0]]["TT_SYMBOL"]
 359                     mem[(mt[1] * length) + mt[2]] = ord(c)
 360         string = write_map(string, mem)
 361         atomic_write(io_db["path_worldstate"], string, delete=False)
 362         strong_write(io_db["file_out"], "WORLD_UPDATED\n")
 363         io_db["worldstate_updateable"] = False
 364
 365
 366 def replay_game():
 367     """Replay game from record file.
 368
 369     Use opts.replay as breakpoint turn to which to replay automatically before
 370     switching to manual input by non-meta commands in server input file
 371     triggering further reads of record file. Ensure opts.replay is at least 1.
 372     Run try_worldstate_update() before each interactive obey()/read_command().
 373     """
 374     if opts.replay < 1:
 375         opts.replay = 1
 376     print("Replay mode. Auto-replaying up to turn " + str(opts.replay) +
 377           " (if so late a turn is to be found).")
 378     if not os.access(io_db["path_record"], os.F_OK):
 379         raise SystemExit("No record file found to replay.")
 380     io_db["file_record"] = open(io_db["path_record"], "r")
 381     io_db["file_record"].prefix = "record file line "
 382     io_db["file_record"].line_n = 1
 383     while world_db["TURN"] < opts.replay:
 384         line = io_db["file_record"].readline()
 385         if "" == line:
 386             break
 387         obey(line.rstrip(), io_db["file_record"].prefix
 388              + str(io_db["file_record"].line_n))
 389         io_db["file_record"].line_n = io_db["file_record"].line_n + 1
 390     while True:
 391         try_worldstate_update()
 392         obey(read_command(), "in file", replay=True)
 393
 394
 395 def play_game():
 396     """Play game by server input file commands. Before, load save file found.
 397
 398     If no save file is found, a new world is generated from the commands in the
 399     world config plus a 'MAKE WORLD [current Unix timestamp]'. Record this
 400     command and all that follow via the server input file. Run
 401     try_worldstate_update() before each interactive obey()/read_command().
 402     """
 403     if os.access(io_db["path_save"], os.F_OK):
 404         obey_lines_in_file(io_db["path_save"], "save")
 405     else:
 406         if not os.access(io_db["path_worldconf"], os.F_OK):
 407             msg = "No world config file from which to start a new world."
 408             raise SystemExit(msg)
 409         obey_lines_in_file(io_db["path_worldconf"], "world config ",
 410                            do_record=True)
 411         obey("MAKE_WORLD " + str(int(time.time())), "in file", do_record=True)
 412     while True:
 413         try_worldstate_update()
 414         obey(read_command(), "in file", do_record=True)
 415
 416
 417 def make_map():
 418     """(Re-)make island map.
 419
 420     Let "~" represent water, "." land, "X" trees: Build island shape randomly,
 421     start with one land cell in the middle, then go into cycle of repeatedly
 422     selecting a random sea cell and transforming it into land if it is neighbor
 423     to land. The cycle ends when a land cell is due to be created at the map's
 424     border. Then put some trees on the map (TODO: more precise algorithm desc).
 425     """
 426
 427     def is_neighbor(coordinates, type):
 428         y = coordinates[0]
 429         x = coordinates[1]
 430         length = world_db["MAP_LENGTH"]
 431         ind = y % 2
 432         diag_west = x + (ind > 0)
 433         diag_east = x + (ind < (length - 1))
 434         pos = (y * length) + x
 435         if (y > 0 and diag_east
 436             and type == chr(world_db["MAP"][pos - length + ind])) \
 437            or (x < (length - 1)
 438                and type == chr(world_db["MAP"][pos + 1])) \
 439            or (y < (length - 1) and diag_east
 440                and type == chr(world_db["MAP"][pos + length + ind])) \
 441            or (y > 0 and diag_west
 442                and type == chr(world_db["MAP"][pos - length - (not ind)])) \
 443            or (x > 0
 444                and type == chr(world_db["MAP"][pos - 1])) \
 445            or (y < (length - 1) and diag_west
 446                and type == chr(world_db["MAP"][pos + length - (not ind)])):
 447             return True
 448         return False
 449
 450     world_db["MAP"] = bytearray(b'~' * (world_db["MAP_LENGTH"] ** 2))
 451     length = world_db["MAP_LENGTH"]
 452     add_half_width = (not (length % 2)) * int(length / 2)
 453     world_db["MAP"][int((length ** 2) / 2) + add_half_width] = ord(".")
 454     while (1):
 455         y = rand.next() % length
 456         x = rand.next() % length
 457         pos = (y * length) + x
 458         if "~" == chr(world_db["MAP"][pos]) and is_neighbor((y, x), "."):
 459             if y == 0 or y == (length - 1) or x == 0 or x == (length - 1):
 460                 break
 461             world_db["MAP"][pos] = ord(".")
 462     n_trees = int((length ** 2) / 16)
 463     i_trees = 0
 464     while (i_trees <= n_trees):
 465         single_allowed = rand.next() % 32
 466         y = rand.next() % length
 467         x = rand.next() % length
 468         pos = (y * length) + x
 469         if "." == chr(world_db["MAP"][pos]) \
 470                 and ((not single_allowed) or is_neighbor((y, x), "X")):
 471             world_db["MAP"][pos] = ord("X")
 472             i_trees += 1
 473     # This all-too-precise replica of the original C code misses iter_limit().
 474
 475
 476 def update_map_memory(t, age_map=True):
 477     """Update t's T_MEMMAP with what's in its FOV now,age its T_MEMMEPTHMAP."""
 478
 479     def age_some_memdepthmap_on_nonfov_cells():
 480         # OUTSOURCED FOR PERFORMANCE REASONS TO libplomrogue.so:
 481         # ord_v = ord("v")
 482         # ord_0 = ord("0")
 483         # ord_9 = ord("9")
 484         # for pos in [pos for pos in range(world_db["MAP_LENGTH"] ** 2)
 485         #             if not ord_v == t["fovmap"][pos]
 486         #             if ord_0 <= t["T_MEMDEPTHMAP"][pos]
 487         #             if ord_9 > t["T_MEMDEPTHMAP"][pos]
 488         #             if not rand.next() % (2 **
 489         #                                   (t["T_MEMDEPTHMAP"][pos] - 48))]:
 490         #     t["T_MEMDEPTHMAP"][pos] += 1
 491         memdepthmap = c_pointer_to_bytearray(t["T_MEMDEPTHMAP"])
 492         fovmap = c_pointer_to_bytearray(t["fovmap"])
 493         libpr.age_some_memdepthmap_on_nonfov_cells(memdepthmap, fovmap)
 494
 495     if not t["T_MEMMAP"]:
 496         t["T_MEMMAP"] = bytearray(b' ' * (world_db["MAP_LENGTH"] ** 2))
 497     if not t["T_MEMDEPTHMAP"]:
 498         t["T_MEMDEPTHMAP"] = bytearray(b' ' * (world_db["MAP_LENGTH"] ** 2))
 499     ord_v = ord("v")
 500     ord_0 = ord("0")
 501     ord_space = ord(" ")
 502     for pos in [pos for pos in range(world_db["MAP_LENGTH"] ** 2)
 503                 if ord_v == t["fovmap"][pos]]:
 504         t["T_MEMDEPTHMAP"][pos] = ord_0
 505         if ord_space == t["T_MEMMAP"][pos]:
 506             t["T_MEMMAP"][pos] = world_db["MAP"][pos]
 507     if age_map:
 508         age_some_memdepthmap_on_nonfov_cells()
 509     t["T_MEMTHING"] = [mt for mt in t["T_MEMTHING"]
 510                        if ord_v != t["fovmap"][(mt[1] * world_db["MAP_LENGTH"])
 511                                                + mt[2]]]
 512     for id in [id for id in world_db["Things"]
 513                if not world_db["Things"][id]["carried"]]:
 514         type = world_db["Things"][id]["T_TYPE"]
 515         if not world_db["ThingTypes"][type]["TT_LIFEPOINTS"]:
 516             y = world_db["Things"][id]["T_POSY"]
 517             x = world_db["Things"][id]["T_POSX"]
 518             if ord_v == t["fovmap"][(y * world_db["MAP_LENGTH"]) + x]:
 519                 t["T_MEMTHING"].append((type, y, x))
 520
 521
 522 def set_world_inactive():
 523     """Set world_db["WORLD_ACTIVE"] to 0 and remove worldstate file."""
 524     server_test()
 525     if os.access(io_db["path_worldstate"], os.F_OK):
 526         os.remove(io_db["path_worldstate"])
 527     world_db["WORLD_ACTIVE"] = 0
 528
 529
 530 def integer_test(val_string, min, max=None):
 531     """Return val_string if integer >= min & (if max set) <= max, else None."""
 532     try:
 533         val = int(val_string)
 534         if val < min or (max is not None and val > max):
 535             raise ValueError
 536         return val
 537     except ValueError:
 538         msg = "Ignoring: Please use integer >= " + str(min)
 539         if max is not None:
 540             msg += " and <= " + str(max)
 541         msg += "."
 542         print(msg)
 543         return None
 544
 545
 546 def setter(category, key, min, max=None):
 547     """Build setter for world_db([category + "s"][id])[key] to >=min/<=max."""
 548     if category is None:
 549         def f(val_string):
 550             val = integer_test(val_string, min, max)
 551             if None != val:
 552                 world_db[key] = val
 553     else:
 554         if category == "Thing":
 555             id_store = command_tid
 556             decorator = test_Thing_id
 557         elif category == "ThingType":
 558             id_store = command_ttid
 559             decorator = test_ThingType_id
 560         elif category == "ThingAction":
 561             id_store = command_taid
 562             decorator = test_ThingAction_id
 563
 564         @decorator
 565         def f(val_string):
 566             val = integer_test(val_string, min, max)
 567             if None != val:
 568                 world_db[category + "s"][id_store.id][key] = val
 569     return f
 570
 571
 572 def build_fov_map(t):
 573     """Build Thing's FOV map."""
 574     t["fovmap"] = bytearray(b'v' * (world_db["MAP_LENGTH"] ** 2))
 575     fovmap = c_pointer_to_bytearray(t["fovmap"])
 576     map = c_pointer_to_bytearray(world_db["MAP"])
 577     if libpr.build_fov_map(t["T_POSY"], t["T_POSX"], fovmap, map):
 578         raise RuntimeError("Malloc error in build_fov_Map().")
 579
 580
 581 def log_help():
 582     """Send quick usage info to log."""
 583     strong_write(io_db["file_out"], "LOG See README file for help.\n")
 584
 585
 586 def decrement_lifepoints(t):
 587     """Decrement t's lifepoints by 1, and if to zero, corpse it.
 588
 589     If t is the player avatar, only blank its fovmap, so that the client may
 590     still display memory data. On non-player things, erase fovmap and memory.
 591     Dying actors drop all their things.
 592     """
 593     t["T_LIFEPOINTS"] -= 1
 594     if 0 == t["T_LIFEPOINTS"]:
 595         for id in t["T_CARRIES"]:
 596             t["T_CARRIES"].remove(id)
 597             world_db["Things"][id]["T_POSY"] = t["T_POSY"]
 598             world_db["Things"][id]["T_POSX"] = t["T_POSX"]
 599             world_db["Things"][id]["carried"] = False
 600         t["T_TYPE"] = world_db["ThingTypes"][t["T_TYPE"]]["TT_CORPSE_ID"]
 601         if world_db["Things"][0] == t:
 602             t["fovmap"] = bytearray(b' ' * (world_db["MAP_LENGTH"] ** 2))
 603             strong_write(io_db["file_out"], "LOG You die.\n")
 604             strong_write(io_db["file_out"],
 605                          "LOG See README on how to start over.\n")
 606         else:
 607             t["fovmap"] = False
 608             t["T_MEMMAP"] = False
 609             t["T_MEMDEPTHMAP"] = False
 610             t["T_MEMTHING"] = []
 611
 612
 613 def mv_yx_in_dir_legal(dir, y, x):
 614     """Wrapper around libpr.mv_yx_in_dir_legal to simplify its use."""
 615     dir_c = dir.encode("ascii")[0]
 616     test = libpr.mv_yx_in_dir_legal_wrap(dir_c, y, x)
 617     if -1 == test:
 618         raise RuntimeError("Too much wrapping in mv_yx_in_dir_legal_wrap()!")
 619     return (test, libpr.result_y(), libpr.result_x())
 620
 621
 622 def actor_wait(t):
 623     """Make t do nothing (but loudly, if player avatar)."""
 624     if t == world_db["Things"][0]:
 625         strong_write(io_db["file_out"], "LOG You wait.\n")
 626
 627
 628 def actor_move(t):
 629     """If passable, move/collide(=attack) thing into T_ARGUMENT's direction."""
 630     passable = False
 631     move_result = mv_yx_in_dir_legal(chr(t["T_ARGUMENT"]),
 632                                      t["T_POSY"], t["T_POSX"])
 633     if 1 == move_result[0]:
 634         pos = (move_result[1] * world_db["MAP_LENGTH"]) + move_result[2]
 635         passable = "." == chr(world_db["MAP"][pos])
 636         hitted = [id for id in world_db["Things"]
 637                   if world_db["Things"][id] != t
 638                   if world_db["Things"][id]["T_LIFEPOINTS"]
 639                   if world_db["Things"][id]["T_POSY"] == move_result[1]
 640                   if world_db["Things"][id]["T_POSX"] == move_result[2]]
 641         if len(hitted):
 642             hit_id = hitted[0]
 643             if t == world_db["Things"][0]:
 644                 hitted_type = world_db["Things"][hit_id]["T_TYPE"]
 645                 hitted_name = world_db["ThingTypes"][hitted_type]["TT_NAME"]
 646                 strong_write(io_db["file_out"], "LOG You wound "
 647                                                 + hitted_name + ".\n")
 648             elif 0 == hit_id:
 649                 hitter_name = world_db["ThingTypes"][t["T_TYPE"]]["TT_NAME"]
 650                 strong_write(io_db["file_out"], "LOG " + hitter_name +
 651                                                 " wounds you.\n")
 652             decrement_lifepoints(world_db["Things"][hit_id])
 653             return
 654     dir = [dir for dir in directions_db
 655            if directions_db[dir] == chr(t["T_ARGUMENT"])][0]
 656     if passable:
 657         t["T_POSY"] = move_result[1]
 658         t["T_POSX"] = move_result[2]
 659         for id in t["T_CARRIES"]:
 660             world_db["Things"][id]["T_POSY"] = move_result[1]
 661             world_db["Things"][id]["T_POSX"] = move_result[2]
 662         build_fov_map(t)
 663         if t == world_db["Things"][0]:
 664             strong_write(io_db["file_out"], "LOG You move " + dir + ".\n")
 665     elif t == world_db["Things"][0]:
 666         strong_write(io_db["file_out"], "LOG You fail to move " + dir + ".\n")
 667
 668
 669 def actor_pick_up(t):
 670     """Make t pick up (topmost?) Thing from ground into inventory."""
 671     # Topmostness is actually not defined so far. Picks most nutritious Thing.
 672     ids = [id for id in world_db["Things"] if world_db["Things"][id] != t
 673            if not world_db["Things"][id]["carried"]
 674            if world_db["Things"][id]["T_POSY"] == t["T_POSY"]
 675            if world_db["Things"][id]["T_POSX"] == t["T_POSX"]]
 676     if len(ids):
 677         highest_id = ids[0]
 678         nutritious = 0
 679         for id in ids:
 680             type = world_db["Things"][id]["T_TYPE"]
 681             if world_db["ThingTypes"][type]["TT_TOOL"] == "food" \
 682             and world_db["ThingTypes"][type]["TT_TOOLPOWER"] > nutritious:
 683                 nutritious = world_db["ThingTypes"][type]["TT_TOOLPOWER"]
 684                 highest_id = id
 685         world_db["Things"][highest_id]["carried"] = True
 686         t["T_CARRIES"].append(highest_id)
 687         if t == world_db["Things"][0]:
 688             strong_write(io_db["file_out"], "LOG You pick up an object.\n")
 689     elif t == world_db["Things"][0]:
 690         err = "You try to pick up an object, but there is none."
 691         strong_write(io_db["file_out"], "LOG " + err + "\n")
 692
 693
 694 def actor_drop(t):
 695     """Make t rop Thing from inventory to ground indexed by T_ARGUMENT."""
 696     # TODO: Handle case where T_ARGUMENT matches nothing.
 697     if len(t["T_CARRIES"]):
 698         id = t["T_CARRIES"][t["T_ARGUMENT"]]
 699         t["T_CARRIES"].remove(id)
 700         world_db["Things"][id]["carried"] = False
 701         if t == world_db["Things"][0]:
 702             strong_write(io_db["file_out"], "LOG You drop an object.\n")
 703     elif t == world_db["Things"][0]:
 704         err = "You try to drop an object, but you own none."
 705         strong_write(io_db["file_out"], "LOG " + err + "\n")
 706
 707
 708 def actor_use(t):
 709     """Make t use (for now: consume) T_ARGUMENT-indexed Thing in inventory."""
 710     # TODO: Handle case where T_ARGUMENT matches nothing.
 711     if len(t["T_CARRIES"]):
 712         id = t["T_CARRIES"][t["T_ARGUMENT"]]
 713         type = world_db["Things"][id]["T_TYPE"]
 714         if world_db["ThingTypes"][type]["TT_TOOL"] == "food":
 715             t["T_CARRIES"].remove(id)
 716             del world_db["Things"][id]
 717             t["T_SATIATION"] += world_db["ThingTypes"][type]["TT_TOOLPOWER"]
 718             if t == world_db["Things"][0]:
 719                 strong_write(io_db["file_out"],
 720                              "LOG You consume this object.\n")
 721         elif t == world_db["Things"][0]:
 722             strong_write(io_db["file_out"],
 723                          "LOG You try to use this object, but fail.\n")
 724     elif t == world_db["Things"][0]:
 725         strong_write(io_db["file_out"],
 726                      "LOG You try to use an object, but you own none.\n")
 727
 728
 729 def thingproliferation(t, prol_map):
 730     """To chance of 1/TT_PROLIFERATE, create t offspring in open neighbor cell.
 731
 732     Naturally only works with TT_PROLIFERATE > 0. The neighbor cell must be be
 733     marked '.' in prol_map. If there are several map cell candidates, one is
 734     selected randomly.
 735     """
 736     prolscore = world_db["ThingTypes"][t["T_TYPE"]]["TT_PROLIFERATE"]
 737     if prolscore and (1 == prolscore or 1 == (rand.next() % prolscore)):
 738         candidates = []
 739         for dir in [directions_db[key] for key in directions_db]:
 740             mv_result = mv_yx_in_dir_legal(dir, t["T_POSY"], t["T_POSX"])
 741             if mv_result[0] and  ord('.') == prol_map[mv_result[1]
 742                                                       * world_db["MAP_LENGTH"]
 743                                                       + mv_result[2]]:
 744                 candidates.append((mv_result[1], mv_result[2]))
 745         if len(candidates):
 746             i = rand.next() % len(candidates)
 747             id = id_setter(-1, "Things")
 748             newT = new_Thing(t["T_TYPE"], (candidates[i][0], candidates[i][1]))
 749             world_db["Things"][id] = newT
 750
 751
 752 def try_healing(t):
 753     """Grow t's HP to a 1/32 chance if < HP max, satiation > 0, and waiting.
 754
 755     On success, decrease satiation score by 32.
 756     """
 757     if t["T_SATIATION"] > 0 \
 758        and t["T_LIFEPOINTS"] < \
 759         world_db["ThingTypes"][t["T_TYPE"]]["TT_LIFEPOINTS"] \
 760        and 0 == (rand.next() % 31) \
 761        and t["T_COMMAND"] == [id for id in world_db["ThingActions"]
 762                               if world_db["ThingActions"][id]["TA_NAME"] ==
 763                               "wait"][0]:
 764         t["T_LIFEPOINTS"] += 1
 765         t["T_SATIATION"] -= 32
 766         if t == world_db["Things"][0]:
 767             strong_write(io_db["file_out"], "LOG You heal.\n")
 768
 769
 770 def hunger(t):
 771     """Decrement t's satiation,dependent on it trigger lifepoint dec chance."""
 772     if t["T_SATIATION"] > -32768:
 773         t["T_SATIATION"] -= 1
 774     testbase = t["T_SATIATION"] if t["T_SATIATION"] >= 0 else -t["T_SATIATION"]
 775     if not world_db["ThingTypes"][t["T_TYPE"]]["TT_LIFEPOINTS"]:
 776         raise RuntimeError("A thing that should not hunger is hungering.")
 777     stomach = int(32767 / world_db["ThingTypes"][t["T_TYPE"]]["TT_LIFEPOINTS"])
 778     if int(int(testbase / stomach) / ((rand.next() % stomach) + 1)):
 779         if t == world_db["Things"][0]:
 780             strong_write(io_db["file_out"], "LOG You suffer from hunger.\n")
 781         decrement_lifepoints(t)
 782
 783
 784 def get_dir_to_target(t, filter):
 785     """Try to set T_COMMAND/T_ARGUMENT for move to "filter"-determined target.
 786
 787     The path-wise nearest target is chosen, via the shortest available path.
 788     Target must not be t. On succcess, return positive value, else False.
 789     Filters:
 790     "a": Thing in FOV is below a certain distance, animate, but of ThingType
 791          that is not t's, and starts out weaker than t is; build path as
 792          avoiding things of t's ThingType
 793     "f": neighbor cell (not inhabited by any animate Thing) further away from
 794          animate Thing not further than x steps away and in FOV and of a
 795          ThingType that is not t's, and starts out stronger or as strong as t
 796          is currently; or (cornered), if no such flight cell, but Thing of
 797          above criteria is too near,1 a cell closer to it, or, if less near,
 798          just wait
 799     "c": Thing in memorized map is consumable
 800     "s": memory map cell with greatest-reachable degree of unexploredness
 801     """
 802
 803     def zero_score_map_where_char_on_memdepthmap(c):
 804         # OUTSOURCED FOR PERFORMANCE REASONS TO libplomrogue.so:
 805         # for i in [i for i in range(world_db["MAP_LENGTH"] ** 2)
 806         #           if t["T_MEMDEPTHMAP"][i] == mem_depth_c[0]]:
 807         #     set_map_score(i, 0)
 808         map = c_pointer_to_bytearray(t["T_MEMDEPTHMAP"])
 809         if libpr.zero_score_map_where_char_on_memdepthmap(c, map):
 810             raise RuntimeError("No score map allocated for "
 811                                "zero_score_map_where_char_on_memdepthmap().")
 812
 813     def set_map_score(pos, score):
 814         test = libpr.set_map_score(pos, score)
 815         if test:
 816             raise RuntimeError("No score map allocated for set_map_score().")
 817
 818     def get_map_score(pos):
 819         result = libpr.get_map_score(pos)
 820         if result < 0:
 821             raise RuntimeError("No score map allocated for get_map_score().")
 822         return result
 823
 824     def seeing_thing():
 825         if t["fovmap"] and ("a" == filter or "f" == filter):
 826             for id in world_db["Things"]:
 827                 Thing = world_db["Things"][id]
 828                 if Thing != t and Thing["T_LIFEPOINTS"] and \
 829                    t["T_TYPE"] != Thing["T_TYPE"] and \
 830                    'v' == chr(t["fovmap"][(Thing["T_POSY"]
 831                                           * world_db["MAP_LENGTH"])
 832                                           + Thing["T_POSX"]]):
 833                     ThingType = world_db["ThingTypes"][Thing["T_TYPE"]]
 834                     if ("f" == filter and ThingType["TT_LIFEPOINTS"] >=
 835                         t["T_LIFEPOINTS"]) \
 836                        or ("a" == filter and ThingType["TT_LIFEPOINTS"] <
 837                             t["T_LIFEPOINTS"]):
 838                         return True
 839         elif t["T_MEMMAP"] and "c" == filter:
 840             for mt in t["T_MEMTHING"]:
 841                 if ' ' != chr(t["T_MEMMAP"][(mt[1] * world_db["MAP_LENGTH"])
 842                                             + mt[2]]) \
 843                    and world_db["ThingTypes"][mt[0]]["TT_TOOL"] == "food":
 844                     return True
 845         return False
 846
 847     def set_cells_passable_on_memmap_to_65534_on_scoremap():
 848         # OUTSOURCED FOR PERFORMANCE REASONS TO libplomrogue.so:
 849         # ord_dot = ord(".")
 850         # memmap = t["T_MEMMAP"]
 851         # for i in [i for i in range(world_db["MAP_LENGTH"] ** 2)
 852         #            if ord_dot == memmap[i]]:
 853         #     set_map_score(i, 65534) # i.e. 65535-1
 854         map = c_pointer_to_bytearray(t["T_MEMMAP"])
 855         if libpr.set_cells_passable_on_memmap_to_65534_on_scoremap(map):
 856             raise RuntimeError("No score map allocated for set_cells_passable"
 857                                "_on_memmap_to_65534_on_scoremap().")
 858
 859     def init_score_map():
 860         test = libpr.init_score_map()
 861         if test:
 862             raise RuntimeError("Malloc error in init_score_map().")
 863         ord_v = ord("v")
 864         ord_blank = ord(" ")
 865         set_cells_passable_on_memmap_to_65534_on_scoremap()
 866         if "a" == filter:
 867             for id in world_db["Things"]:
 868                 Thing = world_db["Things"][id]
 869                 pos = Thing["T_POSY"] * world_db["MAP_LENGTH"] \
 870                     + Thing["T_POSX"]
 871                 if t != Thing and Thing["T_LIFEPOINTS"] and \
 872                    t["T_TYPE"] != Thing["T_TYPE"] and \
 873                    ord_v == t["fovmap"][pos] and \
 874                    t["T_LIFEPOINTS"] > \
 875                    world_db["ThingTypes"][Thing["T_TYPE"]]["TT_LIFEPOINTS"]:
 876                     set_map_score(pos, 0)
 877                 elif t["T_TYPE"] == Thing["T_TYPE"]:
 878                     set_map_score(pos, 65535)
 879         elif "f" == filter:
 880             for id in [id for id in world_db["Things"]
 881                        if world_db["Things"][id]["T_LIFEPOINTS"]]:
 882                 Thing = world_db["Things"][id]
 883                 pos = Thing["T_POSY"] * world_db["MAP_LENGTH"] \
 884                     + Thing["T_POSX"]
 885                 if t["T_TYPE"] != Thing["T_TYPE"] and \
 886                    ord_v == t["fovmap"][pos] and \
 887                    t["T_LIFEPOINTS"] <= \
 888                    world_db["ThingTypes"][Thing["T_TYPE"]]["TT_LIFEPOINTS"]:
 889                     set_map_score(pos, 0)
 890         elif "c" == filter:
 891             for mt in [mt for mt in t["T_MEMTHING"]
 892                        if ord_blank != t["T_MEMMAP"][mt[1]
 893                                                      * world_db["MAP_LENGTH"]
 894                                                      + mt[2]]
 895                        if world_db["ThingTypes"][mt[0]]["TT_TOOL"] == "food"]:
 896                 set_map_score(mt[1] * world_db["MAP_LENGTH"] + mt[2], 0)
 897         elif "s" == filter:
 898             zero_score_map_where_char_on_memdepthmap(mem_depth_c[0])
 899
 900     def rand_target_dir(neighbors, cmp, dirs):
 901         candidates = []
 902         n_candidates = 0
 903         for i in range(len(dirs)):
 904             if cmp == neighbors[i]:
 905                 candidates.append(dirs[i])
 906                 n_candidates += 1
 907         return candidates[rand.next() % n_candidates] if n_candidates else 0
 908
 909     def get_neighbor_scores(dirs, eye_pos):
 910         scores = []
 911         if libpr.ready_neighbor_scores(eye_pos):
 912             raise RuntimeError("No score map allocated for " +
 913                                "ready_neighbor_scores.()")
 914         for i in range(len(dirs)):
 915             scores.append(libpr.get_neighbor_score(i))
 916         return scores
 917
 918     def get_dir_from_neighbors():
 919         dir_to_target = False
 920         dirs = "edcxsw"
 921         eye_pos = t["T_POSY"] * world_db["MAP_LENGTH"] + t["T_POSX"]
 922         neighbors = get_neighbor_scores(dirs, eye_pos)
 923         if "f" == filter:
 924             inhabited = [world_db["Things"][id]["T_POSY"]
 925                          * world_db["MAP_LENGTH"]
 926                          + world_db["Things"][id]["T_POSX"]
 927                          for id in world_db["Things"]
 928                          if world_db["Things"][id]["T_LIFEPOINTS"]]
 929             for i in range(len(dirs)):
 930                 mv_yx_in_dir_legal(dirs[i], t["T_POSY"], t["T_POSX"])
 931                 pos_cmp = libpr.result_y() * world_db["MAP_LENGTH"] \
 932                     + libpr.result_x()
 933                 for pos in [pos for pos in inhabited if pos == pos_cmp]:
 934                     neighbors[i] = 65535
 935                     break
 936         minmax_start = 0 if "f" == filter else 65535 - 1
 937         minmax_neighbor = minmax_start
 938         for i in range(len(dirs)):
 939             if ("f" == filter and get_map_score(eye_pos) < neighbors[i] and
 940                 minmax_neighbor < neighbors[i] and 65535 != neighbors[i]) \
 941                or ("f" != filter and minmax_neighbor > neighbors[i]):
 942                 minmax_neighbor = neighbors[i]
 943         if minmax_neighbor != minmax_start:
 944             dir_to_target = rand_target_dir(neighbors, minmax_neighbor, dirs)
 945         if "f" == filter:
 946             if not dir_to_target:
 947                 if 1 == get_map_score(eye_pos):
 948                     dir_to_target = rand_target_dir(neighbors, 0, dirs)
 949                 elif 3 >= get_map_score(eye_pos):
 950                     t["T_COMMAND"] = [id for id in world_db["ThingActions"]
 951                                       if
 952                                       world_db["ThingActions"][id]["TA_NAME"]
 953                                       == "wait"][0]
 954                     return 1
 955             elif dir_to_target and 3 < get_map_score(eye_pos):
 956                 dir_to_target = 0
 957         elif "a" == filter and 10 <= get_map_score(eye_pos):
 958             dir_to_target = 0
 959         return dir_to_target
 960
 961     dir_to_target = False
 962     mem_depth_c = b' '
 963     run_i = 9 + 1 if "s" == filter else 1
 964     while run_i and not dir_to_target and ("s" == filter or seeing_thing()):
 965         run_i -= 1
 966         init_score_map()
 967         mem_depth_c = b'9' if b' ' == mem_depth_c \
 968             else bytes([mem_depth_c[0] - 1])
 969         if libpr.dijkstra_map():
 970             raise RuntimeError("No score map allocated for dijkstra_map().")
 971         dir_to_target = get_dir_from_neighbors()
 972         libpr.free_score_map()
 973         if dir_to_target and str == type(dir_to_target):
 974             t["T_COMMAND"] = [id for id in world_db["ThingActions"]
 975                               if world_db["ThingActions"][id]["TA_NAME"]
 976                               == "move"][0]
 977             t["T_ARGUMENT"] = ord(dir_to_target)
 978     return dir_to_target
 979
 980
 981 def standing_on_food(t):
 982     """Return True/False whether t is standing on a consumable."""
 983     for id in [id for id in world_db["Things"] if world_db["Things"][id] != t
 984                if world_db["Things"][id]["T_POSY"] == t["T_POSY"]
 985                if world_db["Things"][id]["T_POSX"] == t["T_POSX"]
 986                if world_db["ThingTypes"][world_db["Things"][id]["T_TYPE"]]
 987                           ["TT_TOOL"] == "food"]:
 988         return True
 989     return False
 990
 991
 992 def get_inventory_slot_to_consume(t):
 993     """Return slot Id of strongest consumable in t's inventory, else -1."""
 994     cmp_food = 0
 995     selection = -1
 996     i = 0
 997     for id in t["T_CARRIES"]:
 998         type = world_db["Things"][id]["T_TYPE"]
 999         if world_db["ThingTypes"][type]["TT_TOOL"] == "food" \
1000            and world_db["ThingTypes"][type]["TT_TOOLPOWER"] > cmp_food:
1001             cmp_food = world_db["ThingTypes"][type]["TT_TOOLPOWER"]
1002             selection = i
1003         i += 1
1004     return selection
1005
1006
1007 def ai(t):
1008     """Determine next command/argment for actor t via AI algorithms.
1009
1010     AI will look for, and move towards, enemies (animate Things not of their
1011     own ThingType); if they see none, they will consume consumables in their
1012     inventory; if there are none, they will pick up what they stand on if they
1013     stand on consumables; if they stand on none, they will move towards the
1014     next consumable they see or remember on the map; if they see or remember
1015     none, they will explore parts of the map unseen since ever or for at least
1016     one turn; if there is nothing to explore, they will simply wait.
1017     """
1018     t["T_COMMAND"] = [id for id in world_db["ThingActions"]
1019                       if world_db["ThingActions"][id]["TA_NAME"] == "wait"][0]
1020     if not get_dir_to_target(t, "f"):
1021         sel = get_inventory_slot_to_consume(t)
1022         if -1 != sel:
1023             t["T_COMMAND"] = [id for id in world_db["ThingActions"]
1024                               if world_db["ThingActions"][id]["TA_NAME"]
1025                               == "use"][0]
1026             t["T_ARGUMENT"] = sel
1027         elif standing_on_food(t):
1028             t["T_COMMAND"] = [id for id in world_db["ThingActions"]
1029                               if world_db["ThingActions"][id]["TA_NAME"]
1030                               == "pick_up"][0]
1031         elif (not get_dir_to_target(t, "c")) and \
1032              (not get_dir_to_target(t, "a")):
1033             get_dir_to_target(t, "s")
1034
1035
1036 def turn_over():
1037     """Run game world and its inhabitants until new player input expected."""
1038     id = 0
1039     whilebreaker = False
1040     while world_db["Things"][0]["T_LIFEPOINTS"]:
1041         proliferable_map = world_db["MAP"][:]
1042         for id in [id for id in world_db["Things"]
1043                    if not world_db["Things"][id]["carried"]]:
1044             y = world_db["Things"][id]["T_POSY"]
1045             x = world_db["Things"][id]["T_POSX"]
1046             proliferable_map[y * world_db["MAP_LENGTH"] + x] = ord('X')
1047         for id in [id for id in world_db["Things"]]:  # Only what's from start!
1048             if not id in world_db["Things"] or \
1049                world_db["Things"][id]["carried"]:   # May have been consumed or
1050                 continue                            # picked up during turn …
1051             Thing = world_db["Things"][id]
1052             if Thing["T_LIFEPOINTS"]:
1053                 if not Thing["T_COMMAND"]:
1054                     update_map_memory(Thing)
1055                     if 0 == id:
1056                         whilebreaker = True
1057                         break
1058                     ai(Thing)
1059                 try_healing(Thing)
1060                 hunger(Thing)
1061                 if Thing["T_LIFEPOINTS"]:
1062                     Thing["T_PROGRESS"] += 1
1063                     taid = [a for a in world_db["ThingActions"]
1064                               if a == Thing["T_COMMAND"]][0]
1065                     ThingAction = world_db["ThingActions"][taid]
1066                     if Thing["T_PROGRESS"] == ThingAction["TA_EFFORT"]:
1067                         eval("actor_" + ThingAction["TA_NAME"])(Thing)
1068                         Thing["T_COMMAND"] = 0
1069                         Thing["T_PROGRESS"] = 0
1070             thingproliferation(Thing, proliferable_map)
1071         if whilebreaker:
1072             break
1073         world_db["TURN"] += 1
1074
1075
1076 def new_Thing(type, pos=(0, 0)):
1077     """Return Thing of type T_TYPE, with fovmap if alive and world active."""
1078     thing = {
1079         "T_LIFEPOINTS": world_db["ThingTypes"][type]["TT_LIFEPOINTS"],
1080         "T_ARGUMENT": 0,
1081         "T_PROGRESS": 0,
1082         "T_SATIATION": 0,
1083         "T_COMMAND": 0,
1084         "T_TYPE": type,
1085         "T_POSY": pos[0],
1086         "T_POSX": pos[1],
1087         "T_CARRIES": [],
1088         "carried": False,
1089         "T_MEMTHING": [],
1090         "T_MEMMAP": False,
1091         "T_MEMDEPTHMAP": False,
1092         "fovmap": False
1093     }
1094     if world_db["WORLD_ACTIVE"] and thing["T_LIFEPOINTS"]:
1095         build_fov_map(thing)
1096     return thing
1097
1098
1099 def id_setter(id, category, id_store=False, start_at_1=False):
1100     """Set ID of object of category to manipulate ID unused? Create new one.
1101     The ID is stored as id_store.id (if id_store is set). If the integer of the
1102     input is valid (if start_at_1, >= 0, else >= -1), but <0 or (if start_at_1)
1103     <1, calculate new ID: lowest unused ID >=0 or (if start_at_1) >= 1. None is
1104     always returned when no new object is created, else the new object's ID.
1105     """
1106     min = 0 if start_at_1 else -1
1107     if str == type(id):
1108         id = integer_test(id, min)
1109     if None != id:
1110         if id in world_db[category]:
1111             if id_store:
1112                 id_store.id = id
1113             return None
1114         else:
1115             if (start_at_1 and 0 == id) \
1116                or ((not start_at_1) and (id < 0)):
1117                 id = 0 if start_at_1 else -1
1118                 while 1:
1119                     id = id + 1
1120                     if id not in world_db[category]:
1121                         break
1122             if id_store:
1123                 id_store.id = id
1124     return id
1125
1126
1127 def command_ping():
1128     """Send PONG line to server output file."""
1129     strong_write(io_db["file_out"], "PONG\n")
1130
1131
1132 def command_quit():
1133     """Abort server process."""
1134     if None == opts.replay:
1135         if world_db["WORLD_ACTIVE"]:
1136             save_world()
1137         atomic_write(io_db["path_record"], io_db["record_chunk"], do_append=True)
1138     raise SystemExit("received QUIT command")
1139
1140
1141 def command_thingshere(str_y, str_x):
1142     """Write to out file list of Things known to player at coordinate y, x."""
1143     if world_db["WORLD_ACTIVE"]:
1144         y = integer_test(str_y, 0, 255)
1145         x = integer_test(str_x, 0, 255)
1146         length = world_db["MAP_LENGTH"]
1147         if None != y and None != x and y < length and x < length:
1148             pos = (y * world_db["MAP_LENGTH"]) + x
1149             strong_write(io_db["file_out"], "THINGS_HERE START\n")
1150             if "v" == chr(world_db["Things"][0]["fovmap"][pos]):
1151                 for id in world_db["Things"]:
1152                     if y == world_db["Things"][id]["T_POSY"] \
1153                        and x == world_db["Things"][id]["T_POSX"] \
1154                        and not world_db["Things"][id]["carried"]:
1155                         type = world_db["Things"][id]["T_TYPE"]
1156                         name = world_db["ThingTypes"][type]["TT_NAME"]
1157                         strong_write(io_db["file_out"], name + "\n")
1158             else:
1159                 for mt in world_db["Things"][0]["T_MEMTHING"]:
1160                     if y == mt[1] and x == mt[2]:
1161                         name = world_db["ThingTypes"][mt[0]]["TT_NAME"]
1162                         strong_write(io_db["file_out"], name + "\n")
1163             strong_write(io_db["file_out"], "THINGS_HERE END\n")
1164         else:
1165             print("Ignoring: Invalid map coordinates.")
1166     else:
1167         print("Ignoring: Command only works on existing worlds.")
1168
1169
1170 def play_commander(action, args=False):
1171     """Setter for player's T_COMMAND and T_ARGUMENT, then calling turn_over().
1172
1173     T_ARGUMENT is set to direction char if action=="wait",or 8-bit int if args.
1174     """
1175
1176     def set_command():
1177         id = [x for x in world_db["ThingActions"]
1178               if world_db["ThingActions"][x]["TA_NAME"] == action][0]
1179         world_db["Things"][0]["T_COMMAND"] = id
1180         turn_over()
1181
1182     def set_command_and_argument_int(str_arg):
1183         val = integer_test(str_arg, 0, 255)
1184         if None != val:
1185             world_db["Things"][0]["T_ARGUMENT"] = val
1186             set_command()
1187
1188     def set_command_and_argument_movestring(str_arg):
1189         if str_arg in directions_db:
1190             world_db["Things"][0]["T_ARGUMENT"] = ord(directions_db[str_arg])
1191             set_command()
1192         else:
1193             print("Ignoring: Argument must be valid direction string.")
1194
1195     if action == "move":
1196         return set_command_and_argument_movestring
1197     elif args:
1198         return set_command_and_argument_int
1199     else:
1200         return set_command
1201
1202
1203 def command_seedrandomness(seed_string):
1204     """Set rand seed to int(seed_string)."""
1205     val = integer_test(seed_string, 0, 4294967295)
1206     if None != val:
1207         rand.seed = val
1208
1209
1210 def command_makeworld(seed_string):
1211     """(Re-)build game world, i.e. map, things, to a new turn 1 from seed.
1212
1213     Seed rand with seed. Do more only with a "wait" ThingAction and
1214     world["PLAYER_TYPE"] matching ThingType of TT_START_NUMBER > 0. Then,
1215     world_db["Things"] emptied, call make_map() and set
1216     world_db["WORLD_ACTIVE"], world_db["TURN"] to 1. Build new Things
1217     according to ThingTypes' TT_START_NUMBERS, with Thing of ID 0 to ThingType
1218     of ID = world["PLAYER_TYPE"]. Place Things randomly, and actors not on each
1219     other. Init player's memory map. Write "NEW_WORLD" line to out file.
1220     Call log_help().
1221     """
1222
1223     def free_pos():
1224         i = 0
1225         while 1:
1226             err = "Space to put thing on too hard to find. Map too small?"
1227             while 1:
1228                 y = rand.next() % world_db["MAP_LENGTH"]
1229                 x = rand.next() % world_db["MAP_LENGTH"]
1230                 if "." == chr(world_db["MAP"][y * world_db["MAP_LENGTH"] + x]):
1231                     break
1232                 i += 1
1233                 if i == 65535:
1234                     raise SystemExit(err)
1235             # Replica of C code, wrongly ignores animatedness of new Thing.
1236             pos_clear = (0 == len([id for id in world_db["Things"]
1237                                    if world_db["Things"][id]["T_LIFEPOINTS"]
1238                                    if world_db["Things"][id]["T_POSY"] == y
1239                                    if world_db["Things"][id]["T_POSX"] == x]))
1240             if pos_clear:
1241                 break
1242         return (y, x)
1243
1244     val = integer_test(seed_string, 0, 4294967295)
1245     if None == val:
1246         return
1247     rand.seed = val
1248     player_will_be_generated = False
1249     playertype = world_db["PLAYER_TYPE"]
1250     for ThingType in world_db["ThingTypes"]:
1251         if playertype == ThingType:
1252             if 0 < world_db["ThingTypes"][ThingType]["TT_START_NUMBER"]:
1253                 player_will_be_generated = True
1254             break
1255     if not player_will_be_generated:
1256         print("Ignoring: No player type with start number >0 defined.")
1257         return
1258     wait_action = False
1259     for ThingAction in world_db["ThingActions"]:
1260         if "wait" == world_db["ThingActions"][ThingAction]["TA_NAME"]:
1261             wait_action = True
1262     if not wait_action:
1263         print("Ignoring beyond SEED_MAP: " +
1264               "No thing action with name 'wait' defined.")
1265         return
1266     world_db["Things"] = {}
1267     make_map()
1268     world_db["WORLD_ACTIVE"] = 1
1269     world_db["TURN"] = 1
1270     for i in range(world_db["ThingTypes"][playertype]["TT_START_NUMBER"]):
1271         id = id_setter(-1, "Things")
1272         world_db["Things"][id] = new_Thing(playertype, free_pos())
1273     if not world_db["Things"][0]["fovmap"]:
1274         empty_fovmap = bytearray(b" " * world_db["MAP_LENGTH"] ** 2)
1275         world_db["Things"][0]["fovmap"] = empty_fovmap
1276     update_map_memory(world_db["Things"][0])
1277     for type in world_db["ThingTypes"]:
1278         for i in range(world_db["ThingTypes"][type]["TT_START_NUMBER"]):
1279             if type != playertype:
1280                 id = id_setter(-1, "Things")
1281                 world_db["Things"][id] = new_Thing(type, free_pos())
1282     strong_write(io_db["file_out"], "NEW_WORLD\n")
1283     log_help()
1284
1285
1286 def command_maplength(maplength_string):
1287     """Redefine map length. Invalidate map, therefore lose all things on it."""
1288     val = integer_test(maplength_string, 1, 256)
1289     if None != val:
1290         world_db["MAP_LENGTH"] = val
1291         world_db["MAP"] = False
1292         set_world_inactive()
1293         world_db["Things"] = {}
1294         libpr.set_maplength(val)
1295
1296
1297 def command_worldactive(worldactive_string):
1298     """Toggle world_db["WORLD_ACTIVE"] if possible.
1299
1300     An active world can always be set inactive. An inactive world can only be
1301     set active with a "wait" ThingAction, and a player Thing (of ID 0), and a
1302     map. On activation, rebuild all Things' FOVs, and the player's map memory.
1303     Also call log_help().
1304     """
1305     val = integer_test(worldactive_string, 0, 1)
1306     if None != val:
1307         if 0 != world_db["WORLD_ACTIVE"]:
1308             if 0 == val:
1309                 set_world_inactive()
1310             else:
1311                 print("World already active.")
1312         elif 0 == world_db["WORLD_ACTIVE"]:
1313             wait_exists = False
1314             for ThingAction in world_db["ThingActions"]:
1315                 if "wait" == world_db["ThingActions"][ThingAction]["TA_NAME"]:
1316                     wait_exists = True
1317                     break
1318             player_exists = False
1319             for Thing in world_db["Things"]:
1320                 if 0 == Thing:
1321                     player_exists = True
1322                     break
1323             if wait_exists and player_exists and world_db["MAP"]:
1324                 for id in world_db["Things"]:
1325                     if world_db["Things"][id]["T_LIFEPOINTS"]:
1326                         build_fov_map(world_db["Things"][id])
1327                         if 0 == id:
1328                             update_map_memory(world_db["Things"][id], False)
1329                 if not world_db["Things"][0]["T_LIFEPOINTS"]:
1330                     empty_fovmap = bytearray(b" " * world_db["MAP_LENGTH"] ** 2)
1331                     world_db["Things"][0]["fovmap"] = empty_fovmap
1332                 world_db["WORLD_ACTIVE"] = 1
1333                 log_help()
1334             else:
1335                 print("Ignoring: Not all conditions for world activation met.")
1336
1337
1338 def test_for_id_maker(object, category):
1339     """Return decorator testing for object having "id" attribute."""
1340     def decorator(f):
1341         def helper(*args):
1342             if hasattr(object, "id"):
1343                 f(*args)
1344             else:
1345                 print("Ignoring: No " + category +
1346                       " defined to manipulate yet.")
1347         return helper
1348     return decorator
1349
1350
1351 def command_tid(id_string):
1352     """Set ID of Thing to manipulate. ID unused? Create new one.
1353
1354     Default new Thing's type to the first available ThingType, others: zero.
1355     """
1356     id = id_setter(id_string, "Things", command_tid)
1357     if None != id:
1358         if world_db["ThingTypes"] == {}:
1359             print("Ignoring: No ThingType to settle new Thing in.")
1360             return
1361         type = list(world_db["ThingTypes"].keys())[0]
1362         world_db["Things"][id] = new_Thing(type)
1363
1364
1365 test_Thing_id = test_for_id_maker(command_tid, "Thing")
1366
1367
1368 @test_Thing_id
1369 def command_tcommand(str_int):
1370     """Set T_COMMAND of selected Thing."""
1371     val = integer_test(str_int, 0)
1372     if None != val:
1373         if 0 == val or val in world_db["ThingActions"]:
1374             world_db["Things"][command_tid.id]["T_COMMAND"] = val
1375         else:
1376             print("Ignoring: ThingAction ID belongs to no known ThingAction.")
1377
1378
1379 @test_Thing_id
1380 def command_ttype(str_int):
1381     """Set T_TYPE of selected Thing."""
1382     val = integer_test(str_int, 0)
1383     if None != val:
1384         if val in world_db["ThingTypes"]:
1385             world_db["Things"][command_tid.id]["T_TYPE"] = val
1386         else:
1387             print("Ignoring: ThingType ID belongs to no known ThingType.")
1388
1389
1390 @test_Thing_id
1391 def command_tcarries(str_int):
1392     """Append int(str_int) to T_CARRIES of selected Thing.
1393
1394     The ID int(str_int) must not be of the selected Thing, and must belong to a
1395     Thing with unset "carried" flag. Its "carried" flag will be set on owning.
1396     """
1397     val = integer_test(str_int, 0)
1398     if None != val:
1399         if val == command_tid.id:
1400             print("Ignoring: Thing cannot carry itself.")
1401         elif val in world_db["Things"] \
1402                 and not world_db["Things"][val]["carried"]:
1403             world_db["Things"][command_tid.id]["T_CARRIES"].append(val)
1404             world_db["Things"][val]["carried"] = True
1405         else:
1406             print("Ignoring: Thing not available for carrying.")
1407     # Note that the whole carrying structure is different from the C version:
1408     # Carried-ness is marked by a "carried" flag, not by Things containing
1409     # Things internally.
1410
1411
1412 @test_Thing_id
1413 def command_tmemthing(str_t, str_y, str_x):
1414     """Add (int(str_t), int(str_y), int(str_x)) to selected Thing's T_MEMTHING.
1415
1416     The type must fit to an existing ThingType, and the position into the map.
1417     """
1418     type = integer_test(str_t, 0)
1419     posy = integer_test(str_y, 0, 255)
1420     posx = integer_test(str_x, 0, 255)
1421     if None != type and None != posy and None != posx:
1422         if type not in world_db["ThingTypes"] \
1423            or posy >= world_db["MAP_LENGTH"] or posx >= world_db["MAP_LENGTH"]:
1424             print("Ignoring: Illegal value for thing type or position.")
1425         else:
1426             memthing = (type, posy, posx)
1427             world_db["Things"][command_tid.id]["T_MEMTHING"].append(memthing)
1428
1429
1430 def setter_map(maptype):
1431     """Set (world or Thing's) map of maptype's int(str_int)-th line to mapline.
1432
1433     If no map of maptype exists yet, initialize it with ' ' bytes first.
1434     """
1435
1436     def valid_map_line(str_int, mapline):
1437         val = integer_test(str_int, 0, 255)
1438         if None != val:
1439             if val >= world_db["MAP_LENGTH"]:
1440                 print("Illegal value for map line number.")
1441             elif len(mapline) != world_db["MAP_LENGTH"]:
1442                 print("Map line length is unequal map width.")
1443             else:
1444                 return val
1445         return None
1446
1447     def nonThingMap_helper(str_int, mapline):
1448         val = valid_map_line(str_int, mapline)
1449         if None != val:
1450             length = world_db["MAP_LENGTH"]
1451             if not world_db["MAP"]:
1452                 map = bytearray(b' ' * (length ** 2))
1453             else:
1454                 map = world_db["MAP"]
1455             map[val * length:(val * length) + length] = mapline.encode()
1456             if not world_db["MAP"]:
1457                 world_db["MAP"] = map
1458
1459     @test_Thing_id
1460     def ThingMap_helper(str_int, mapline):
1461         val = valid_map_line(str_int, mapline)
1462         if None != val:
1463             length = world_db["MAP_LENGTH"]
1464             if not world_db["Things"][command_tid.id][maptype]:
1465                 map = bytearray(b' ' * (length ** 2))
1466             else:
1467                 map = world_db["Things"][command_tid.id][maptype]
1468             map[val * length:(val * length) + length] = mapline.encode()
1469             if not world_db["Things"][command_tid.id][maptype]:
1470                 world_db["Things"][command_tid.id][maptype] = map
1471
1472     return nonThingMap_helper if maptype == "MAP" else ThingMap_helper
1473
1474
1475
1476 def setter_tpos(axis):
1477     """Generate setter for T_POSX or  T_POSY of selected Thing.
1478
1479     If world is active, rebuilds animate things' fovmap, player's memory map.
1480     """
1481     @test_Thing_id
1482     def helper(str_int):
1483         val = integer_test(str_int, 0, 255)
1484         if None != val:
1485             if val < world_db["MAP_LENGTH"]:
1486                 world_db["Things"][command_tid.id]["T_POS" + axis] = val
1487                 if world_db["WORLD_ACTIVE"] \
1488                    and world_db["Things"][command_tid.id]["T_LIFEPOINTS"]:
1489                     build_fov_map(world_db["Things"][command_tid.id])
1490                     if 0 == command_tid.id:
1491                         update_map_memory(world_db["Things"][command_tid.id])
1492             else:
1493                 print("Ignoring: Position is outside of map.")
1494     return helper
1495
1496
1497 def command_ttid(id_string):
1498     """Set ID of ThingType to manipulate. ID unused? Create new one.
1499
1500     Default new ThingType's TT_SYMBOL to "?", TT_CORPSE_ID to self, TT_TOOL to
1501     "", others: 0.
1502     """
1503     id = id_setter(id_string, "ThingTypes", command_ttid)
1504     if None != id:
1505         world_db["ThingTypes"][id] = {
1506             "TT_NAME": "(none)",
1507             "TT_TOOLPOWER": 0,
1508             "TT_LIFEPOINTS": 0,
1509             "TT_PROLIFERATE": 0,
1510             "TT_START_NUMBER": 0,
1511             "TT_SYMBOL": "?",
1512             "TT_CORPSE_ID": id,
1513             "TT_TOOL": ""
1514         }
1515
1516
1517 test_ThingType_id = test_for_id_maker(command_ttid, "ThingType")
1518
1519
1520 @test_ThingType_id
1521 def command_ttname(name):
1522     """Set TT_NAME of selected ThingType."""
1523     world_db["ThingTypes"][command_ttid.id]["TT_NAME"] = name
1524
1525
1526 @test_ThingType_id
1527 def command_tttool(name):
1528     """Set TT_TOOL of selected ThingType."""
1529     world_db["ThingTypes"][command_ttid.id]["TT_TOOL"] = name
1530
1531
1532 @test_ThingType_id
1533 def command_ttsymbol(char):
1534     """Set TT_SYMBOL of selected ThingType. """
1535     if 1 == len(char):
1536         world_db["ThingTypes"][command_ttid.id]["TT_SYMBOL"] = char
1537     else:
1538         print("Ignoring: Argument must be single character.")
1539
1540
1541 @test_ThingType_id
1542 def command_ttcorpseid(str_int):
1543     """Set TT_CORPSE_ID of selected ThingType."""
1544     val = integer_test(str_int, 0)
1545     if None != val:
1546         if val in world_db["ThingTypes"]:
1547             world_db["ThingTypes"][command_ttid.id]["TT_CORPSE_ID"] = val
1548         else:
1549             print("Ignoring: Corpse ID belongs to no known ThignType.")
1550
1551
1552 def command_taid(id_string):
1553     """Set ID of ThingAction to manipulate. ID unused? Create new one.
1554
1555     Default new ThingAction's TA_EFFORT to 1, its TA_NAME to "wait".
1556     """
1557     id = id_setter(id_string, "ThingActions", command_taid, True)
1558     if None != id:
1559         world_db["ThingActions"][id] = {
1560             "TA_EFFORT": 1,
1561             "TA_NAME": "wait"
1562         }
1563
1564
1565 test_ThingAction_id = test_for_id_maker(command_taid, "ThingAction")
1566
1567
1568 @test_ThingAction_id
1569 def command_taname(name):
1570     """Set TA_NAME of selected ThingAction.
1571
1572     The name must match a valid thing action function. If after the name
1573     setting no ThingAction with name "wait" remains, call set_world_inactive().
1574     """
1575     if name == "wait" or name == "move" or name == "use" or name == "drop" \
1576        or name == "pick_up":
1577         world_db["ThingActions"][command_taid.id]["TA_NAME"] = name
1578         if 1 == world_db["WORLD_ACTIVE"]:
1579             wait_defined = False
1580             for id in world_db["ThingActions"]:
1581                 if "wait" == world_db["ThingActions"][id]["TA_NAME"]:
1582                     wait_defined = True
1583                     break
1584             if not wait_defined:
1585                 set_world_inactive()
1586     else:
1587         print("Ignoring: Invalid action name.")
1588     # In contrast to the original,naming won't map a function to a ThingAction.
1589
1590
1591 def command_ai():
1592     """Call ai() on player Thing, then turn_over()."""
1593     ai(world_db["Things"][0])
1594     turn_over()
1595
1596
1597 """Commands database.
1598
1599 Map command start tokens to ([0]) number of expected command arguments, ([1])
1600 the command's meta-ness (i.e. is it to be written to the record file, is it to
1601 be ignored in replay mode if read from server input file), and ([2]) a function
1602 to be called on it.
1603 """
1604 commands_db = {
1605     "QUIT": (0, True, command_quit),
1606     "PING": (0, True, command_ping),
1607     "THINGS_HERE": (2, True, command_thingshere),
1608     "MAKE_WORLD": (1, False, command_makeworld),
1609     "SEED_RANDOMNESS": (1, False, command_seedrandomness),
1610     "TURN": (1, False, setter(None, "TURN", 0, 65535)),
1611     "PLAYER_TYPE": (1, False, setter(None, "PLAYER_TYPE", 0)),
1612     "MAP_LENGTH": (1, False, command_maplength),
1613     "WORLD_ACTIVE": (1, False, command_worldactive),
1614     "MAP": (2, False, setter_map("MAP")),
1615     "TA_ID": (1, False, command_taid),
1616     "TA_EFFORT": (1, False, setter("ThingAction", "TA_EFFORT", 0, 255)),
1617     "TA_NAME": (1, False, command_taname),
1618     "TT_ID": (1, False, command_ttid),
1619     "TT_NAME": (1, False, command_ttname),
1620     "TT_TOOL": (1, False, command_tttool),
1621     "TT_SYMBOL": (1, False, command_ttsymbol),
1622     "TT_CORPSE_ID": (1, False, command_ttcorpseid),
1623     "TT_TOOLPOWER": (1, False, setter("ThingType", "TT_TOOLPOWER", 0, 65535)),
1624     "TT_START_NUMBER": (1, False, setter("ThingType", "TT_START_NUMBER",
1625                                          0, 255)),
1626     "TT_PROLIFERATE": (1, False, setter("ThingType", "TT_PROLIFERATE",
1627                                         0, 65535)),
1628     "TT_LIFEPOINTS": (1, False, setter("ThingType", "TT_LIFEPOINTS", 0, 255)),
1629     "T_ID": (1, False, command_tid),
1630     "T_ARGUMENT": (1, False, setter("Thing", "T_ARGUMENT", 0, 255)),
1631     "T_PROGRESS": (1, False, setter("Thing", "T_PROGRESS", 0, 255)),
1632     "T_LIFEPOINTS": (1, False, setter("Thing", "T_LIFEPOINTS", 0, 255)),
1633     "T_SATIATION": (1, False, setter("Thing", "T_SATIATION", -32768, 32767)),
1634     "T_COMMAND": (1, False, command_tcommand),
1635     "T_TYPE": (1, False, command_ttype),
1636     "T_CARRIES": (1, False, command_tcarries),
1637     "T_MEMMAP": (2, False, setter_map("T_MEMMAP")),
1638     "T_MEMDEPTHMAP": (2, False, setter_map("T_MEMDEPTHMAP")),
1639     "T_MEMTHING": (3, False, command_tmemthing),
1640     "T_POSY": (1, False, setter_tpos("Y")),
1641     "T_POSX": (1, False, setter_tpos("X")),
1642     "wait": (0, False, play_commander("wait")),
1643     "move": (1, False, play_commander("move")),
1644     "pick_up": (0, False, play_commander("pick_up")),
1645     "drop": (1, False, play_commander("drop", True)),
1646     "use": (1, False, play_commander("use", True)),
1647     "ai": (0, False, command_ai)
1648 }
1649 # TODO: Unhandled cases: (Un-)killing animates (esp. player!) with T_LIFEPOINTS.
1650
1651
1652 """World state database. With sane default values. (Randomness is in rand.)"""
1653 world_db = {
1654     "TURN": 0,
1655     "MAP_LENGTH": 64,
1656     "PLAYER_TYPE": 0,
1657     "WORLD_ACTIVE": 0,
1658     "MAP": False,
1659     "ThingActions": {},
1660     "ThingTypes": {},
1661     "Things": {}
1662 }
1663
1664 """Mapping of direction names to internal direction chars."""
1665 directions_db = {"east": "d", "south-east": "c", "south-west": "x",
1666                  "west": "s", "north-west": "w", "north-east": "e"}
1667
1668 """File IO database."""
1669 io_db = {
1670     "path_save": "save",
1671     "path_record": "record_save",
1672     "path_worldconf": "confserver/world",
1673     "path_server": "server/",
1674     "path_in": "server/in",
1675     "path_out": "server/out",
1676     "path_worldstate": "server/worldstate",
1677     "tmp_suffix": "_tmp",
1678     "kicked_by_rival": False,
1679     "worldstate_updateable": False
1680 }
1681
1682
1683 try:
1684     libpr = prep_library()
1685     rand = RandomnessIO()
1686     opts = parse_command_line_arguments()
1687     if opts.savefile:
1688         io_db["path_save"] = opts.savefile
1689         io_db["path_record"] = "record_" + opts.savefile
1690     setup_server_io()
1691     if opts.verbose:
1692         io_db["verbose"] = True
1693     if None != opts.replay:
1694         replay_game()
1695     else:
1696         play_game()
1697 except SystemExit as exit:
1698     print("ABORTING: " + exit.args[0])
1699 except:
1700     print("SOMETHING WENT WRONG IN UNEXPECTED WAYS")
1701     raise
1702 finally:
1703     cleanup_server_io()