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