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