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