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