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