home · contact · privacy
959d769ea899e0eb6cfbae6315cc7af0f9d6df5e
[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 "
622                  + "Use 'PgUp'/PgDn' to scroll the 'Things here' window.\n")
623     strong_write(io_db["file_out"], "LOG See README file for more details.\n")
624
625
626 def decrement_lifepoints(t):
627     """Decrement t's lifepoints by 1, and if to zero, corpse it.
628
629     If t is the player avatar, only blank its fovmap, so that the client may
630     still display memory data. On non-player things, erase fovmap and memory.
631     Dying actors drop all their things.
632     """
633     # 7DRL: Also decrements God's mood; deaths heavily so.
634     # 7DRL: Return 1 if death, else 0.
635     t["T_LIFEPOINTS"] -= 1
636     world_db["GOD_MOOD"] -= 1  # #
637     if 0 == t["T_LIFEPOINTS"]:
638         sadness = world_db["ThingTypes"][t["T_TYPE"]]["TT_LIFEPOINTS"]  # #
639         world_db["GOD_MOOD"] -= sadness  # #        
640         for id in t["T_CARRIES"]:
641             t["T_CARRIES"].remove(id)
642             world_db["Things"][id]["T_POSY"] = t["T_POSY"]
643             world_db["Things"][id]["T_POSX"] = t["T_POSX"]
644             world_db["Things"][id]["carried"] = False
645         t["T_TYPE"] = world_db["ThingTypes"][t["T_TYPE"]]["TT_CORPSE_ID"]
646         if world_db["Things"][0] == t:
647             t["fovmap"] = bytearray(b' ' * (world_db["MAP_LENGTH"] ** 2))
648             strong_write(io_db["file_out"], "LOG You die.\n")
649             strong_write(io_db["file_out"],
650                          "LOG See README on how to start over.\n")
651         else:
652             t["fovmap"] = False
653             t["T_MEMMAP"] = False
654             t["T_MEMDEPTHMAP"] = False
655             t["T_MEMTHING"] = []
656         return sadness  # #
657     return 0  # #
658
659
660 def add_gods_favor(i): # #
661     """"Add to GOD_FAVOR, multiplied with factor growing log. with GOD_MOOD."""
662     def favor_multiplier(i):
663         x = 100
664         threshold = math.e * x
665         mood = world_db["GOD_MOOD"]
666         if i > 0:
667             if mood > threshold:
668                 i = i * math.log(mood / x)
669             elif -mood > threshold:
670                 i = i / math.log(-mood / x)
671         elif i < 0:
672             if -mood > threshold:
673                 i = i * math.log(-mood / x)
674             if mood > threshold:
675                 i = i / math.log(mood / x)
676         return int(i)
677     world_db["GOD_FAVOR"] += favor_multiplier(i)
678
679
680 def mv_yx_in_dir_legal(dir, y, x):
681     """Wrapper around libpr.mv_yx_in_dir_legal to simplify its use."""
682     dir_c = dir.encode("ascii")[0]
683     test = libpr.mv_yx_in_dir_legal_wrap(dir_c, y, x)
684     if -1 == test:
685         raise RuntimeError("Too much wrapping in mv_yx_in_dir_legal_wrap()!")
686     return (test, libpr.result_y(), libpr.result_x())
687
688
689 def enter_altar():  # #
690      """What happens when the player enters the altar."""
691      if world_db["FAVOR_STAGE"] > 9000:
692         strong_write(io_db["file_out"],
693                      "LOG You step on a soul-less slab of stone.\n")
694         return
695      strong_write(io_db["file_out"], "LOG YOU ENTER SACRED GROUND.\n")
696      if world_db["FAVOR_STAGE"] == 0:
697          world_db["FAVOR_STAGE"] = 1
698          strong_write(io_db["file_out"], "LOG The Island God speaks to you: "
699                       + "\"I don't trust you. You intrude on the island's "
700                       + "affairs. I think you're a nuisance at best, and a "
701                       + "danger to my children at worst. I will give you a "
702                       + "chance to lighten my mood, however: For a while now, "
703                       + "I've been trying to spread the plant "
704                       + world_db["ThingTypes"][world_db["PLANT_0"]]["TT_NAME"]
705                       + " (\""
706                       + world_db["ThingTypes"][world_db["PLANT_0"]]["TT_SYMBOL"]
707                       + "\"). I have not been very successful so far. Maybe "
708                       + "you can make yourself useful there. I will count "
709                       + "each further "
710                       + world_db["ThingTypes"][world_db["PLANT_0"]]["TT_NAME"]
711                       + " that grows to your favor.\n")
712      elif world_db["FAVOR_STAGE"] == 1 and world_db["GOD_FAVOR"] >= 100:
713          world_db["FAVOR_STAGE"] = 2
714          strong_write(io_db["file_out"], "LOG The Island God speaks to you: "
715                       + "\"You could have done worse so far. Maybe you are not "
716                       + "the worst to happen to this island since the metal "
717                       + "birds threw the great lightning ball. Maybe you can "
718                       + "help me spread another plant. It multiplies faster, "
719                       + "and it is highly nutritious: "
720                       + world_db["ThingTypes"][world_db["PLANT_1"]]["TT_NAME"]
721                       + " (\""
722                       + world_db["ThingTypes"][world_db["PLANT_1"]]["TT_SYMBOL"]
723                       + "\"). It is new. I give you the only example. Be very "
724                       + "careful with it! I also give you another tool that "
725                       + "might be helpful.\n")
726          id = id_setter(-1, "Things")
727          world_db["Things"][id] = new_Thing(world_db["PLANT_1"],
728                                             world_db["altar"])
729          id = id_setter(-1, "Things")
730          world_db["Things"][id] = new_Thing(world_db["TOOL_0"],
731                                             world_db["altar"])
732      elif world_db["FAVOR_STAGE"] == 2 and \
733           0 == len([id for id in world_db["Things"]
734                    if world_db["Things"][id]["T_TYPE"]
735                       == world_db["PLANT_1"]]):
736          strong_write(io_db["file_out"], "LOG The Island God speaks to you: "
737                       + "\"I am greatly disappointed that you lost all "
738                       + world_db["ThingTypes"][world_db["PLANT_1"]]["TT_NAME"]
739                       + " this island had. Here is another one. It cost me "
740                       + " great work. Be more careful this time.\n")
741          id = id_setter(-1, "Things")
742          world_db["Things"][id] = new_Thing(world_db["PLANT_1"],
743                                             world_db["altar"])
744          add_gods_favor(-250)
745      elif world_db["GOD_FAVOR"] > 9000:
746          world_db["FAVOR_STAGE"] = 9001
747          strong_write(io_db["file_out"], "LOG The Island God speaks to you: "
748                       + "\"You have proven yourself worthy of my respect. "
749                       + "You were a good citizen to the island, and sometimes "
750                       + "a better steward to its inhabitants than me. The "
751                       + "island shall miss you when you leave. But you have "
752                       + "earned the right to do so. Take this "
753                       + world_db["ThingTypes"][world_db["SLIPPERS"]]["TT_NAME"]
754                       + " and USE it when you please. It will take you to "
755                       + "where you came from. (But do feel free to stay here "
756                       + "as long as you like.)\"\n")
757          id = id_setter(-1, "Things")
758          world_db["Things"][id] = new_Thing(world_db["SLIPPERS"],
759                                             world_db["altar"])
760
761
762 def actor_wait(t):
763     """Make t do nothing (but loudly, if player avatar)."""
764     if t == world_db["Things"][0]:
765         strong_write(io_db["file_out"], "LOG You wait.\n")
766
767
768 def actor_move(t):
769     """If passable, move/collide(=attack) thing into T_ARGUMENT's direction."""
770     # 7DRL: Player wounding (worse: killing) others will lower God's favor.
771     # 7DRL: Player entering the altar triggers enter_altar().
772     # 7DRL: Player with axe chops down trees.
773     passable = False
774     move_result = mv_yx_in_dir_legal(chr(t["T_ARGUMENT"]),
775                                      t["T_POSY"], t["T_POSX"])
776     if 1 == move_result[0]:
777         pos = (move_result[1] * world_db["MAP_LENGTH"]) + move_result[2]
778         hitted = [id for id in world_db["Things"]
779                   if world_db["Things"][id] != t
780                   if world_db["Things"][id]["T_LIFEPOINTS"]
781                   if world_db["Things"][id]["T_POSY"] == move_result[1]
782                   if world_db["Things"][id]["T_POSX"] == move_result[2]]
783         if len(hitted):
784             hit_id = hitted[0]
785             if t == world_db["Things"][0]:
786                 hitted_type = world_db["Things"][hit_id]["T_TYPE"]
787                 hitted_name = world_db["ThingTypes"][hitted_type]["TT_NAME"]
788                 strong_write(io_db["file_out"], "LOG You wound " + hitted_name
789                                                 + ".\n")
790                 add_gods_favor(-1)  # #
791             elif 0 == hit_id:
792                 hitter_name = world_db["ThingTypes"][t["T_TYPE"]]["TT_NAME"]
793                 strong_write(io_db["file_out"], "LOG " + hitter_name +
794                                                 " wounds you.\n")
795             test = decrement_lifepoints(world_db["Things"][hit_id])  # #(test=)
796             if test and t == world_db["Things"][0]:  # #
797                 add_gods_favor(-test)  # #
798             return
799         if (ord("X") == world_db["MAP"][pos]  # #
800             or ord("|") == world_db["MAP"][pos]):  # #
801             carries_axe = False  # #
802             for id in t["T_CARRIES"]:  # # 
803                 type = world_db["Things"][id]["T_TYPE"]  # #
804                 if world_db["ThingTypes"][type]["TT_TOOL"] == "axe":  # #
805                     carries_axe = True  # #
806                     break  # #
807             if carries_axe:  # #
808                 axe_name = world_db["ThingTypes"][type]["TT_NAME"]  # #
809                 if t == world_db["Things"][0]:  # #
810                     strong_write(io_db["file_out"], "LOG With your "  # #
811                                                     + axe_name  # #
812                                                     + ", you chop!\n")  # #
813                     if ord("X") == world_db["MAP"][pos]:  # #
814                         add_gods_favor(-1)  # #
815                 chop_power = world_db["ThingTypes"][type]["TT_TOOLPOWER"]
816                 case_X = world_db["MAP"][pos] == ord("X")  # #
817                 if (chop_power > 0  # #
818                     and ((case_X and  # #
819                           0 == int(rand.next() / chop_power))  # #
820                     or (not case_X and  # #
821                              0 == int(rand.next() / (3 * chop_power))))):  # #
822                     if t == world_db["Things"][0]:  # #
823                         strong_write(io_db["file_out"],  # #
824                                      "LOG You chop it down.\n")  # #
825                     if world_db["MAP"][pos] == ord("X"):  # #
826                         add_gods_favor(-10)  # #
827                     world_db["MAP"][pos] = ord(".")   # #
828                     i = 3 if case_X else 1  # #
829                     for i in range(i):  # #
830                         id = id_setter(-1, "Things")  # #
831                         world_db["Things"][id] = \
832                           new_Thing(world_db["LUMBER"],  # #
833                                     (move_result[1], move_result[2]))  # # 
834                     build_fov_map(t)  # #
835                 return   # #
836         passable = ("." == chr(world_db["MAP"][pos]) or
837                     ":" == chr(world_db["MAP"][pos]) or # #
838                     "_" == chr(world_db["MAP"][pos])) # #
839     dir = [dir for dir in directions_db
840            if directions_db[dir] == chr(t["T_ARGUMENT"])][0]
841     if passable:
842         t["T_POSY"] = move_result[1]
843         t["T_POSX"] = move_result[2]
844         for id in t["T_CARRIES"]:
845             world_db["Things"][id]["T_POSY"] = move_result[1]
846             world_db["Things"][id]["T_POSX"] = move_result[2]
847         build_fov_map(t)
848         if t == world_db["Things"][0]:
849             strong_write(io_db["file_out"], "LOG You move " + dir + ".\n")
850             if (move_result[1] == world_db["altar"][0] and  # #
851                 move_result[2] == world_db["altar"][1]):  # #
852                 enter_altar()  # #
853     elif t == world_db["Things"][0]:
854         strong_write(io_db["file_out"], "LOG You fail to move " + dir + ".\n")
855
856
857 def actor_pick_up(t):
858     """Make t pick up (topmost?) Thing from ground into inventory."""
859     # Topmostness is actually not defined so far. Picks most nutritious Thing.
860     # 7DRL: Non-player picking up player-dropped consumable -> GOD_FAVOR gain.
861     used_slots = len(t["T_CARRIES"]) # #
862     if used_slots < world_db["ThingTypes"][t["T_TYPE"]]["TT_STORAGE"]: # #
863         ids = [id for id in world_db["Things"] if world_db["Things"][id] != t
864                if not world_db["Things"][id]["carried"]
865                if world_db["Things"][id]["T_POSY"] == t["T_POSY"]
866                if world_db["Things"][id]["T_POSX"] == t["T_POSX"]]
867         if len(ids):
868             highest_id = ids[0]
869             nutritious = 0
870             for id in ids:
871                 type = world_db["Things"][id]["T_TYPE"]
872                 if world_db["ThingTypes"][type]["TT_TOOL"] == "food" \
873                 and world_db["ThingTypes"][type]["TT_TOOLPOWER"] > nutritious:
874                     nutritious = world_db["ThingTypes"][type]["TT_TOOLPOWER"]
875                     highest_id = id
876             world_db["Things"][highest_id]["carried"] = True
877             type = world_db["Things"][highest_id]["T_TYPE"]  # #
878             if (t != world_db["Things"][0] # #
879                 and world_db["Things"][highest_id]["T_PLAYERDROP"]  # #
880                 and world_db["ThingTypes"][type]["TT_TOOL"] == "food"):  # #
881                 score = world_db["ThingTypes"][type]["TT_TOOLPOWER"] / 32  # #
882                 add_gods_favor(score)  # #
883                 world_db["Things"][highest_id]["T_PLAYERDROP"] = 0  # #
884             t["T_CARRIES"].append(highest_id)
885             if t == world_db["Things"][0]:
886                 strong_write(io_db["file_out"], "LOG You pick up an object.\n")
887         elif t == world_db["Things"][0]:
888             err = "You try to pick up an object, but there is none."
889             strong_write(io_db["file_out"], "LOG " + err + "\n")
890     elif t == world_db["Things"][0]: # #
891         strong_write(io_db["file_out"], "LOG Can't pick up object: " + # #
892                                         "No storage room to carry more.\n") # #
893
894
895 def actor_drop(t):
896     """Make t rop Thing from inventory to ground indexed by T_ARGUMENT."""
897     # TODO: Handle case where T_ARGUMENT matches nothing.
898     if len(t["T_CARRIES"]):
899         id = t["T_CARRIES"][t["T_ARGUMENT"]]
900         t["T_CARRIES"].remove(id)
901         world_db["Things"][id]["carried"] = False
902         if t == world_db["Things"][0]:
903             strong_write(io_db["file_out"], "LOG You drop an object.\n")
904             world_db["Things"][id]["T_PLAYERDROP"] = 1  # #
905     elif t == world_db["Things"][0]:
906         err = "You try to drop an object, but you own none."
907         strong_write(io_db["file_out"], "LOG " + err + "\n")
908
909
910 def actor_use(t):
911     """Make t use (for now: consume) T_ARGUMENT-indexed Thing in inventory."""
912     # TODO: Handle case where T_ARGUMENT matches nothing.
913     # 7DLR: Handle SLIPPERS-type Thing use.
914     if len(t["T_CARRIES"]):
915         id = t["T_CARRIES"][t["T_ARGUMENT"]]
916         type = world_db["Things"][id]["T_TYPE"]
917         if type == world_db["SLIPPERS"]:  # #
918             if t == world_db["Things"][0]:  # #
919                 strong_write(io_db["file_out"], "LOG You use the "  # #
920                              + world_db["ThingTypes"][type]["TT_NAME"]  # #
921                              + ". It glows in wondrous colors, and emits "  # #
922                              + "a sound as if from a dying cat. The "  # #
923                              + "Island God laughs.\n")  # #
924             t["T_LIFEPOINTS"] = 1  # #
925             decrement_lifepoints(t)  # #
926         elif (world_db["ThingTypes"][type]["TT_TOOL"] == "axe"  # #
927               and t == world_db["Things"][0]):  # #
928                 strong_write(io_db["file_out"],  # #
929                              "LOG To use this item for chopping, move "  # #
930                              "towards a tree while carrying it in "  # #
931                              "your inventory.\n")  # #
932         elif (world_db["ThingTypes"][type]["TT_TOOL"] == "carpentry"):  # #
933             pos = t["T_POSY"] * world_db["MAP_LENGTH"] + t["T_POSX"]
934             if (world_db["MAP"][pos] == ord("X")  # #
935                 or world_db["MAP"][pos] == ord("|")):  # #
936                 strong_write(io_db["file_out"],  # #
937                              "LOG Can't build when standing on barrier.\n")  # #
938                 return
939             for id in [id for id in world_db["Things"]
940                        if not world_db["Things"][id] == t
941                        if not world_db["Things"][id]["carried"]
942                        if world_db["Things"][id]["T_POSY"] == t["T_POSY"]
943                        if world_db["Things"][id]["T_POSX"] == t["T_POSX"]]:
944                  strong_write(io_db["file_out"],
945                               "LOG Can't build when standing objects.\n")  # #
946                  return
947             for id in t["T_CARRIES"]:  # #
948                 type_tool = world_db["Things"][id]["T_TYPE"]  # #
949                 if (world_db["ThingTypes"][type_tool]["TT_TOOL"]  # #
950                     == "carpentry"):  # #
951                     break  # #
952             wood_id = None  # #
953             for id in t["T_CARRIES"]:  # #
954                 type_material = world_db["Things"][id]["T_TYPE"]  # #
955                 if (world_db["ThingTypes"][type_material]["TT_TOOL"]  # #
956                     == "wood"):  # #
957                     wood_id = id  # #
958                     break  # #
959             if wood_id != None:  # #
960                 t["T_CARRIES"].remove(wood_id)  # #
961                 del world_db["Things"][wood_id]  # #
962                 world_db["MAP"][pos] = ord("|")  # #
963                 strong_write(io_db["file_out"], "LOG With your "  # #
964                              + world_db["ThingTypes"][type_tool]["TT_NAME"]  # #
965                              + " you build a wooden barrier from your "  # #
966                              + world_db["ThingTypes"][type_material]  # #
967                                ["TT_NAME"]  # #
968                              + ".\n")  # #
969             else:  # #
970                 strong_write(io_db["file_out"], "LOG You can't use a "  # #
971                              + world_db["ThingTypes"][type_tool]["TT_NAME"]  # #
972                              + " without some wood in your inventory.\n")  # #
973         elif world_db["ThingTypes"][type]["TT_TOOL"] == "food":
974             t["T_CARRIES"].remove(id)
975             del world_db["Things"][id]
976             t["T_SATIATION"] += world_db["ThingTypes"][type]["TT_TOOLPOWER"]
977             if t == world_db["Things"][0]:
978                 strong_write(io_db["file_out"],
979                              "LOG You consume this object.\n")
980         elif t == world_db["Things"][0]:
981             strong_write(io_db["file_out"],
982                          "LOG You try to use this object, but fail.\n")
983     elif t == world_db["Things"][0]:
984         strong_write(io_db["file_out"],
985                      "LOG You try to use an object, but you own none.\n")
986
987
988 def thingproliferation(t, prol_map):
989     """To chance of 1/TT_PROLIFERATE, create t offspring in open neighbor cell.
990
991     Naturally only works with TT_PROLIFERATE > 0. The neighbor cell must be be
992     marked "." in prol_map. If there are several map cell candidates, one is
993     selected randomly.
994     """
995     # 7DRL: success increments God's mood
996     # 7DRL: Plants (no TT_LIFEPOINTS) proliferate only on ":" ground.
997     prolscore = world_db["ThingTypes"][t["T_TYPE"]]["TT_PROLIFERATE"]
998     if prolscore and (1 == prolscore or 1 == (rand.next() % prolscore)):
999         candidates = []
1000         for dir in [directions_db[key] for key in directions_db]:
1001             mv_result = mv_yx_in_dir_legal(dir, t["T_POSY"], t["T_POSX"])
1002             pos = mv_result[1] * world_db["MAP_LENGTH"] + mv_result[2]
1003             if mv_result[0] and \
1004                (ord(":") == prol_map[pos]  # #
1005                 or (world_db["ThingTypes"][t["T_TYPE"]]["TT_LIFEPOINTS"]  # #
1006                     and ord(".") == prol_map[pos])):
1007             # if mv_result[0] and ord(".") == prol_map[mv_result[1]
1008             #                                          * world_db["MAP_LENGTH"]
1009             #                                          + mv_result[2]]:
1010                 candidates.append((mv_result[1], mv_result[2]))
1011         if len(candidates):
1012             i = rand.next() % len(candidates)
1013             id = id_setter(-1, "Things")
1014             newT = new_Thing(t["T_TYPE"], (candidates[i][0], candidates[i][1]))
1015             world_db["Things"][id] = newT
1016             animacy = world_db["ThingTypes"][t["T_TYPE"]]["TT_LIFEPOINTS"]  # #
1017             if animacy:  # #
1018                 world_db["GOD_MOOD"] += animacy  # #
1019             else:  # #
1020                 world_db["GOD_MOOD"] += 1  # #
1021             if (world_db["FAVOR_STAGE"] > 0  # #
1022                 and t["T_TYPE"] == world_db["PLANT_0"]):  # #
1023                 world_db["GOD_FAVOR"] += 5  # #
1024             elif t["T_TYPE"] == world_db["PLANT_1"]:  # #
1025                 world_db["GOD_FAVOR"] += 25  # #
1026
1027
1028 def try_healing(t):
1029     """Grow t's HP to a 1/32 chance if < HP max, satiation > 0, and waiting.
1030
1031     On success, decrease satiation score by 32.
1032     """
1033     # 7DRL: Successful heals increment God's mood.
1034     if t["T_SATIATION"] > 0 \
1035        and t["T_LIFEPOINTS"] < \
1036            world_db["ThingTypes"][t["T_TYPE"]]["TT_LIFEPOINTS"] \
1037        and 0 == (rand.next() % 31) \
1038        and t["T_COMMAND"] == [id for id in world_db["ThingActions"]
1039                               if world_db["ThingActions"][id]["TA_NAME"] ==
1040                                  "wait"][0]:
1041         t["T_LIFEPOINTS"] += 1
1042         world_db["GOD_MOOD"] += 1  # #
1043         t["T_SATIATION"] -= 32
1044         if t == world_db["Things"][0]:
1045             strong_write(io_db["file_out"], "LOG You heal.\n")
1046
1047
1048 def hunger(t):
1049     """Decrement t's satiation,dependent on it trigger lifepoint dec chance."""
1050     if t["T_SATIATION"] > -32768:
1051         t["T_SATIATION"] -= 1
1052     testbase = t["T_SATIATION"] if t["T_SATIATION"] >= 0 else -t["T_SATIATION"]
1053     if not world_db["ThingTypes"][t["T_TYPE"]]["TT_LIFEPOINTS"]:
1054         raise RuntimeError("A thing that should not hunger is hungering.")
1055     stomach = int(32767 / world_db["ThingTypes"][t["T_TYPE"]]["TT_LIFEPOINTS"])
1056     if int(int(testbase / stomach) / ((rand.next() % stomach) + 1)):
1057         if t == world_db["Things"][0]:
1058             strong_write(io_db["file_out"], "LOG You suffer from hunger.\n")
1059         decrement_lifepoints(t)
1060
1061
1062 def get_dir_to_target(t, filter):
1063     """Try to set T_COMMAND/T_ARGUMENT for move to "filter"-determined target.
1064
1065     The path-wise nearest target is chosen, via the shortest available path.
1066     Target must not be t. On succcess, return positive value, else False.
1067     Filters:
1068     "a": Thing in FOV is below a certain distance, animate, but of ThingType
1069          that is not t's, and starts out weaker than t is; build path as
1070          avoiding things of t's ThingType
1071     "f": neighbor cell (not inhabited by any animate Thing) further away from
1072          animate Thing not further than x steps away and in FOV and of a
1073          ThingType that is not t's, and starts out stronger or as strong as t
1074          is currently; or (cornered), if no such flight cell, but Thing of
1075          above criteria is too near,1 a cell closer to it, or, if less near,
1076          just wait
1077     "c": Thing in memorized map is consumable
1078     "s": memory map cell with greatest-reachable degree of unexploredness
1079     """
1080
1081     def zero_score_map_where_char_on_memdepthmap(c):
1082         # OUTSOURCED FOR PERFORMANCE REASONS TO libplomrogue.so:
1083         # for i in [i for i in range(world_db["MAP_LENGTH"] ** 2)
1084         #           if t["T_MEMDEPTHMAP"][i] == mem_depth_c[0]]:
1085         #     set_map_score(i, 0)
1086         map = c_pointer_to_bytearray(t["T_MEMDEPTHMAP"])
1087         if libpr.zero_score_map_where_char_on_memdepthmap(c, map):
1088             raise RuntimeError("No score map allocated for "
1089                                "zero_score_map_where_char_on_memdepthmap().")
1090
1091     def set_map_score(pos, score):
1092         test = libpr.set_map_score(pos, score)
1093         if test:
1094             raise RuntimeError("No score map allocated for set_map_score().")
1095
1096     def get_map_score(pos):
1097         result = libpr.get_map_score(pos)
1098         if result < 0:
1099             raise RuntimeError("No score map allocated for get_map_score().")
1100         return result
1101
1102     def seeing_thing():
1103         if t["fovmap"] and ("a" == filter or "f" == filter):
1104             for id in world_db["Things"]:
1105                 Thing = world_db["Things"][id]
1106                 if Thing != t and Thing["T_LIFEPOINTS"] and \
1107                    t["T_TYPE"] != Thing["T_TYPE"] and \
1108                    'v' == chr(t["fovmap"][(Thing["T_POSY"]
1109                                           * world_db["MAP_LENGTH"])
1110                                           + Thing["T_POSX"]]):
1111                     ThingType = world_db["ThingTypes"][Thing["T_TYPE"]]
1112                     if ("f" == filter and ThingType["TT_LIFEPOINTS"] >=
1113                                           t["T_LIFEPOINTS"]) \
1114                        or ("a" == filter and ThingType["TT_LIFEPOINTS"] <
1115                                              t["T_LIFEPOINTS"]):
1116                         return True
1117         elif t["T_MEMMAP"] and "c" == filter:
1118             for mt in t["T_MEMTHING"]:
1119                 if ' ' != chr(t["T_MEMMAP"][(mt[1] * world_db["MAP_LENGTH"])
1120                                          + mt[2]]) \
1121                    and world_db["ThingTypes"][mt[0]]["TT_TOOL"] == "food":
1122                     return True
1123         return False
1124
1125     def set_cells_passable_on_memmap_to_65534_on_scoremap():
1126         # OUTSOURCED FOR PERFORMANCE REASONS TO libplomrogue.so:
1127         # ord_dot = ord(".")
1128         # memmap = t["T_MEMMAP"]
1129         # for i in [i for i in range(world_db["MAP_LENGTH"] ** 2)
1130         #            if ord_dot == memmap[i]]:
1131         #     set_map_score(i, 65534) # i.e. 65535-1
1132         map = c_pointer_to_bytearray(t["T_MEMMAP"])
1133         if libpr.set_cells_passable_on_memmap_to_65534_on_scoremap(map):
1134             raise RuntimeError("No score map allocated for "
1135                         "set_cells_passable_on_memmap_to_65534_on_scoremap().")
1136
1137     def init_score_map():
1138         test = libpr.init_score_map()
1139         if test:
1140             raise RuntimeError("Malloc error in init_score_map().")
1141         ord_v = ord("v")
1142         ord_blank = ord(" ")
1143         set_cells_passable_on_memmap_to_65534_on_scoremap()
1144         if "a" == filter:
1145             for id in world_db["Things"]:
1146                 Thing = world_db["Things"][id]
1147                 pos = Thing["T_POSY"] * world_db["MAP_LENGTH"] \
1148                       + Thing["T_POSX"]
1149                 if t != Thing and Thing["T_LIFEPOINTS"] and \
1150                    t["T_TYPE"] != Thing["T_TYPE"] and \
1151                    ord_v == t["fovmap"][pos] and \
1152                    t["T_LIFEPOINTS"] > \
1153                    world_db["ThingTypes"][Thing["T_TYPE"]]["TT_LIFEPOINTS"]:
1154                     set_map_score(pos, 0)
1155                 elif t["T_TYPE"] == Thing["T_TYPE"]:
1156                     set_map_score(pos, 65535)
1157         elif "f" == filter:
1158             for id in [id for id in world_db["Things"]
1159                        if world_db["Things"][id]["T_LIFEPOINTS"]]:
1160                 Thing = world_db["Things"][id]
1161                 pos = Thing["T_POSY"] * world_db["MAP_LENGTH"] \
1162                       + Thing["T_POSX"]
1163                 if t["T_TYPE"] != Thing["T_TYPE"] and \
1164                    ord_v == t["fovmap"][pos] and \
1165                    t["T_LIFEPOINTS"] <= \
1166                    world_db["ThingTypes"][Thing["T_TYPE"]]["TT_LIFEPOINTS"]:
1167                     set_map_score(pos, 0)
1168         elif "c" == filter:
1169             for mt in [mt for mt in t["T_MEMTHING"]
1170                        if ord_blank != t["T_MEMMAP"][mt[1]
1171                                                     * world_db["MAP_LENGTH"]
1172                                                     + mt[2]]
1173                        if world_db["ThingTypes"][mt[0]]["TT_TOOL"] == "food"]:
1174                 set_map_score(mt[1] * world_db["MAP_LENGTH"] + mt[2], 0)
1175         elif "s" == filter:
1176             zero_score_map_where_char_on_memdepthmap(mem_depth_c[0])
1177
1178     def rand_target_dir(neighbors, cmp, dirs):
1179         candidates = []
1180         n_candidates = 0
1181         for i in range(len(dirs)):
1182             if cmp == neighbors[i]:
1183                 candidates.append(dirs[i])
1184                 n_candidates += 1
1185         return candidates[rand.next() % n_candidates] if n_candidates else 0
1186
1187     def get_neighbor_scores(dirs, eye_pos):
1188         scores = []
1189         if libpr.ready_neighbor_scores(eye_pos):
1190             raise RuntimeError("No score map allocated for " +
1191                                "ready_neighbor_scores.()")
1192         for i in range(len(dirs)):
1193             scores.append(libpr.get_neighbor_score(i))
1194         return scores
1195
1196     def get_dir_from_neighbors():
1197         dir_to_target = False
1198         dirs = "edcxsw"
1199         eye_pos = t["T_POSY"] * world_db["MAP_LENGTH"] + t["T_POSX"]
1200         neighbors = get_neighbor_scores(dirs, eye_pos)
1201         if "f" == filter:
1202             inhabited = [world_db["Things"][id]["T_POSY"]
1203                          * world_db["MAP_LENGTH"]
1204                          + world_db["Things"][id]["T_POSX"]
1205                          for id in world_db["Things"]
1206                          if world_db["Things"][id]["T_LIFEPOINTS"]]
1207             for i in range(len(dirs)):
1208                 mv_yx_in_dir_legal(dirs[i], t["T_POSY"], t["T_POSX"])
1209                 pos_cmp = libpr.result_y() * world_db["MAP_LENGTH"] \
1210                           + libpr.result_x()
1211                 for pos in [pos for pos in inhabited if pos == pos_cmp]:
1212                     neighbors[i] = 65535
1213                     break
1214         minmax_start = 0 if "f" == filter else 65535 - 1
1215         minmax_neighbor = minmax_start
1216         for i in range(len(dirs)):
1217             if ("f" == filter and get_map_score(eye_pos) < neighbors[i] and
1218                 minmax_neighbor < neighbors[i] and 65535 != neighbors[i]) \
1219                or ("f" != filter and minmax_neighbor > neighbors[i]):
1220                 minmax_neighbor = neighbors[i]
1221         if minmax_neighbor != minmax_start:
1222             dir_to_target = rand_target_dir(neighbors, minmax_neighbor, dirs)
1223         if "f" == filter:
1224             if not dir_to_target:
1225                 if 1 == get_map_score(eye_pos):
1226                     dir_to_target = rand_target_dir(neighbors, 0, dirs)
1227                 elif 3 >= get_map_score(eye_pos):
1228                     t["T_COMMAND"] = [id for id in world_db["ThingActions"]
1229                                       if
1230                                       world_db["ThingActions"][id]["TA_NAME"]
1231                                          == "wait"][0]
1232                     return 1
1233             elif dir_to_target and 3 < get_map_score(eye_pos):
1234                 dir_to_target = 0
1235         elif "a" == filter and 10 <= get_map_score(eye_pos):
1236             dir_to_target = 0
1237         return dir_to_target
1238
1239     dir_to_target = False
1240     mem_depth_c = b' '
1241     run_i = 9 + 1 if "s" == filter else 1
1242     while run_i and not dir_to_target and ("s" == filter or seeing_thing()):
1243         run_i -= 1
1244         init_score_map()
1245         mem_depth_c = b'9' if b' ' == mem_depth_c \
1246                            else bytes([mem_depth_c[0] - 1])
1247         if libpr.dijkstra_map():
1248             raise RuntimeError("No score map allocated for dijkstra_map().")
1249         dir_to_target = get_dir_from_neighbors()
1250         libpr.free_score_map()
1251         if dir_to_target and str == type(dir_to_target):
1252             t["T_COMMAND"] = [id for id in world_db["ThingActions"]
1253                               if world_db["ThingActions"][id]["TA_NAME"]
1254                                  == "move"][0]
1255             t["T_ARGUMENT"] = ord(dir_to_target)
1256     return dir_to_target
1257
1258
1259 def standing_on_food(t):
1260     """Return True/False whether t is standing on a consumable."""
1261     for id in [id for id in world_db["Things"] if world_db["Things"][id] != t
1262                if world_db["Things"][id]["T_POSY"] == t["T_POSY"]
1263                if world_db["Things"][id]["T_POSX"] == t["T_POSX"]
1264                if world_db["ThingTypes"][world_db["Things"][id]["T_TYPE"]]
1265                   ["TT_TOOL"] == "food"]:
1266         return True
1267     return False
1268
1269
1270 def get_inventory_slot_to_consume(t):
1271     """Return slot Id of strongest consumable in t's inventory, else -1."""
1272     cmp_food = 0
1273     selection = -1
1274     i = 0
1275     for id in t["T_CARRIES"]:
1276         type = world_db["Things"][id]["T_TYPE"]
1277         if world_db["ThingTypes"][type]["TT_TOOL"] == "food" \
1278            and world_db["ThingTypes"][type]["TT_TOOLPOWER"] > cmp_food:
1279             cmp_food = world_db["ThingTypes"][type]["TT_TOOLPOWER"]
1280             selection = i
1281         i += 1
1282     return selection
1283
1284
1285 def ai(t):
1286     """Determine next command/argment for actor t via AI algorithms.
1287
1288     AI will look for, and move towards, enemies (animate Things not of their
1289     own ThingType); if they see none, they will consume consumables in their
1290     inventory; if there are none, they will pick up what they stand on if they
1291     stand on consumables; if they stand on none, they will move towards the
1292     next consumable they see or remember on the map; if they see or remember
1293     none, they will explore parts of the map unseen since ever or for at least
1294     one turn; if there is nothing to explore, they will simply wait.
1295     """
1296     # 7DRL add: Don't pick up or search things when inventory is full.
1297     t["T_COMMAND"] = [id for id in world_db["ThingActions"]
1298                       if world_db["ThingActions"][id]["TA_NAME"] == "wait"][0]
1299     if not get_dir_to_target(t, "f"):
1300         sel = get_inventory_slot_to_consume(t)
1301         if -1 != sel:
1302             t["T_COMMAND"] = [id for id in world_db["ThingActions"]
1303                               if world_db["ThingActions"][id]["TA_NAME"]
1304                                  == "use"][0]
1305             t["T_ARGUMENT"] = sel
1306         elif standing_on_food(t) \
1307              and (len(t["T_CARRIES"]) < # #
1308                  world_db["ThingTypes"][t["T_TYPE"]]["TT_STORAGE"]): # #
1309             t["T_COMMAND"] = [id for id in world_db["ThingActions"]
1310                               if world_db["ThingActions"][id]["TA_NAME"]
1311                                  == "pick_up"][0]
1312         elif (not
1313               (len(t["T_CARRIES"]) < # #
1314                 world_db["ThingTypes"][t["T_TYPE"]]["TT_STORAGE"] # #
1315                and get_dir_to_target(t, "c"))) and \
1316              (not get_dir_to_target(t, "a")):
1317             get_dir_to_target(t, "s")
1318
1319
1320 def turn_over():
1321     """Run game world and its inhabitants until new player input expected."""
1322     id = 0
1323     whilebreaker = False
1324     while world_db["Things"][0]["T_LIFEPOINTS"]:
1325         proliferable_map = world_db["MAP"][:]
1326         for id in [id for id in world_db["Things"]
1327                    if not world_db["Things"][id]["carried"]]:
1328             y = world_db["Things"][id]["T_POSY"]
1329             x = world_db["Things"][id]["T_POSX"]
1330             proliferable_map[y * world_db["MAP_LENGTH"] + x] = ord("X")
1331         for id in [id for id in world_db["Things"]]:  # Only what's from start!
1332             if not id in world_db["Things"] or \
1333                world_db["Things"][id]["carried"]:   # May have been consumed or
1334                 continue                            # picked up during turn …
1335             Thing = world_db["Things"][id]
1336             if Thing["T_LIFEPOINTS"]:
1337                 if not Thing["T_COMMAND"]:
1338                     update_map_memory(Thing)
1339                     if 0 == id:
1340                         whilebreaker = True
1341                         break
1342                     ai(Thing)
1343                 try_healing(Thing)
1344                 hunger(Thing)
1345                 if Thing["T_LIFEPOINTS"]:
1346                     Thing["T_PROGRESS"] += 1
1347                     taid = [a for a in world_db["ThingActions"]
1348                               if a == Thing["T_COMMAND"]][0]
1349                     ThingAction = world_db["ThingActions"][taid]
1350                     if Thing["T_PROGRESS"] == ThingAction["TA_EFFORT"]:
1351                         eval("actor_" + ThingAction["TA_NAME"])(Thing)
1352                         Thing["T_COMMAND"] = 0
1353                         Thing["T_PROGRESS"] = 0
1354             thingproliferation(Thing, proliferable_map)
1355         if whilebreaker:
1356             break
1357         world_db["TURN"] += 1
1358
1359
1360 def new_Thing(type, pos=(0, 0)):
1361     """Return Thing of type T_TYPE, with fovmap if alive and world active."""
1362     thing = {
1363         "T_LIFEPOINTS": world_db["ThingTypes"][type]["TT_LIFEPOINTS"],
1364         "T_ARGUMENT": 0,
1365         "T_PROGRESS": 0,
1366         "T_SATIATION": 0,
1367         "T_COMMAND": 0,
1368         "T_PLAYERDROP": 0,  # #
1369         "T_TYPE": type,
1370         "T_POSY": pos[0],
1371         "T_POSX": pos[1],
1372         "T_CARRIES": [],
1373         "carried": False,
1374         "T_MEMTHING": [],
1375         "T_MEMMAP": False,
1376         "T_MEMDEPTHMAP": False,
1377         "fovmap": False
1378     }
1379     if world_db["WORLD_ACTIVE"] and thing["T_LIFEPOINTS"]:
1380         build_fov_map(thing)
1381     return thing
1382
1383
1384 def id_setter(id, category, id_store=False, start_at_1=False):
1385     """Set ID of object of category to manipulate ID unused? Create new one.
1386
1387     The ID is stored as id_store.id (if id_store is set). If the integer of the
1388     input is valid (if start_at_1, >= 0, else >= -1), but <0 or (if start_at_1)
1389     <1, calculate new ID: lowest unused ID >=0 or (if start_at_1) >= 1. None is
1390     always returned when no new object is created, otherwise the new object's
1391     ID.
1392     """
1393     min = 0 if start_at_1 else -1
1394     if str == type(id):
1395         id = integer_test(id, min)
1396     if None != id:
1397         if id in world_db[category]:
1398             if id_store:
1399                 id_store.id = id
1400             return None
1401         else:
1402             if (start_at_1 and 0 == id) \
1403                or ((not start_at_1) and (id < 0)):
1404                 id = 0 if start_at_1 else -1
1405                 while 1:
1406                     id = id + 1
1407                     if id not in world_db[category]:
1408                         break
1409             if id_store:
1410                 id_store.id = id
1411     return id
1412
1413
1414 def command_ping():
1415     """Send PONG line to server output file."""
1416     strong_write(io_db["file_out"], "PONG\n")
1417
1418
1419 def command_quit():
1420     """Abort server process."""
1421     if None == opts.replay:
1422         if world_db["WORLD_ACTIVE"]:
1423             save_world()
1424         atomic_write(io_db["path_record"], io_db["record_chunk"], do_append=True)
1425     raise SystemExit("received QUIT command")
1426
1427
1428 def command_thingshere(str_y, str_x):
1429     """Write to out file list of Things known to player at coordinate y, x."""
1430     # 7DRL: terrain, too
1431     if world_db["WORLD_ACTIVE"]:
1432         y = integer_test(str_y, 0, 255)
1433         x = integer_test(str_x, 0, 255)
1434         length = world_db["MAP_LENGTH"]
1435         if None != y and None != x and y < length and x < length:
1436             pos = (y * world_db["MAP_LENGTH"]) + x
1437             strong_write(io_db["file_out"], "THINGS_HERE START\n")
1438             pos = y * world_db["MAP_LENGTH"] + x;  # #
1439             if world_db["Things"][0]["T_MEMMAP"][pos] == ord("~"):  # #
1440                 name = "(terrain: SEA)"  # #
1441             elif world_db["Things"][0]["T_MEMMAP"][pos] == ord("."):  # #
1442                 name = "(terrain: EARTH)"  # #
1443             elif world_db["Things"][0]["T_MEMMAP"][pos] == ord(":"):  # #
1444                 name = "(terrain: SOIL)"  # #
1445             elif world_db["Things"][0]["T_MEMMAP"][pos] == ord("X"):  # #
1446                 name = "(terrain: TREE)"  # #
1447             elif world_db["Things"][0]["T_MEMMAP"][pos] == ord("|"):  # #
1448                 name = "(terrain: WALL)"  # #
1449             elif world_db["Things"][0]["T_MEMMAP"][pos] == ord("_"):  # #
1450                 name = "(terrain: ALTAR)"  # #
1451             strong_write(io_db["file_out"], name + "\n")  # #
1452             if "v" == chr(world_db["Things"][0]["fovmap"][pos]):
1453                 for id in world_db["Things"]:
1454                     if y == world_db["Things"][id]["T_POSY"] \
1455                        and x == world_db["Things"][id]["T_POSX"] \
1456                        and not world_db["Things"][id]["carried"]:
1457                         type = world_db["Things"][id]["T_TYPE"]
1458                         name = world_db["ThingTypes"][type]["TT_NAME"]
1459                         strong_write(io_db["file_out"], name + "\n")
1460             else:
1461                 for mt in world_db["Things"][0]["T_MEMTHING"]:
1462                     if y == mt[1] and x == mt[2]:
1463                         name = world_db["ThingTypes"][mt[0]]["TT_NAME"]
1464                         strong_write(io_db["file_out"], name + "\n")
1465             strong_write(io_db["file_out"], "THINGS_HERE END\n")
1466         else:
1467             print("Ignoring: Invalid map coordinates.")
1468     else:
1469         print("Ignoring: Command only works on existing worlds.")
1470
1471
1472 def play_commander(action, args=False):
1473     """Setter for player's T_COMMAND and T_ARGUMENT, then calling turn_over().
1474
1475     T_ARGUMENT is set to direction char if action=="wait",or 8-bit int if args.
1476     """
1477
1478     def set_command():
1479         id = [x for x in world_db["ThingActions"]
1480                 if world_db["ThingActions"][x]["TA_NAME"] == action][0]
1481         world_db["Things"][0]["T_COMMAND"] = id
1482         turn_over()
1483
1484     def set_command_and_argument_int(str_arg):
1485         val = integer_test(str_arg, 0, 255)
1486         if None != val:
1487             world_db["Things"][0]["T_ARGUMENT"] = val
1488             set_command()
1489
1490     def set_command_and_argument_movestring(str_arg):
1491         if str_arg in directions_db:
1492             world_db["Things"][0]["T_ARGUMENT"] = ord(directions_db[str_arg])
1493             set_command()
1494         else:
1495             print("Ignoring: Argument must be valid direction string.")
1496
1497     if action == "move":
1498         return set_command_and_argument_movestring
1499     elif args:
1500         return set_command_and_argument_int
1501     else:
1502         return set_command
1503
1504
1505 def command_seedrandomness(seed_string):
1506     """Set rand seed to int(seed_string)."""
1507     val = integer_test(seed_string, 0, 4294967295)
1508     if None != val:
1509         rand.seed = val
1510
1511
1512 def command_makeworld(seed_string):
1513     """(Re-)build game world, i.e. map, things, to a new turn 1 from seed.
1514
1515     Seed rand with seed. Do more only with a "wait" ThingAction and
1516     world["PLAYER_TYPE"] matching ThingType of TT_START_NUMBER > 0. Then,
1517     world_db["Things"] emptied, call make_map() and set
1518     world_db["WORLD_ACTIVE"], world_db["TURN"] to 1. Build new Things
1519     according to ThingTypes' TT_START_NUMBERS, with Thing of ID 0 to ThingType
1520     of ID = world["PLAYER_TYPE"]. Place Things randomly, and actors not on each
1521     other. Init player's memory map. Write "NEW_WORLD" line to out file.
1522     Call log_help().
1523     """
1524
1525     # def free_pos(plant=False):
1526     def free_pos(plant=False):  # #
1527         i = 0
1528         while 1:
1529             err = "Space to put thing on too hard to find. Map too small?"
1530             while 1:
1531                 y = rand.next() % world_db["MAP_LENGTH"]
1532                 x = rand.next() % world_db["MAP_LENGTH"]
1533                 pos = y * world_db["MAP_LENGTH"] + x;
1534                 if (not plant  # #
1535                     and "." == chr(world_db["MAP"][pos])) \
1536                    or ":" == chr(world_db["MAP"][pos]):  # #
1537                     break
1538                 i += 1
1539                 if i == 65535:
1540                     raise SystemExit(err)
1541             # Replica of C code, wrongly ignores animatedness of new Thing.
1542             pos_clear = (0 == len([id for id in world_db["Things"]
1543                                    if world_db["Things"][id]["T_LIFEPOINTS"]
1544                                    if world_db["Things"][id]["T_POSY"] == y
1545                                    if world_db["Things"][id]["T_POSX"] == x]))
1546             if pos_clear:
1547                 break
1548         return (y, x)
1549
1550     val = integer_test(seed_string, 0, 4294967295)
1551     if None == val:
1552         return
1553     rand.seed = val
1554     player_will_be_generated = False
1555     playertype = world_db["PLAYER_TYPE"]
1556     for ThingType in world_db["ThingTypes"]:
1557         if playertype == ThingType:
1558             if 0 < world_db["ThingTypes"][ThingType]["TT_START_NUMBER"]:
1559                 player_will_be_generated = True
1560             break
1561     if not player_will_be_generated:
1562         print("Ignoring: No player type with start number >0 defined.")
1563         return
1564     wait_action = False
1565     for ThingAction in world_db["ThingActions"]:
1566         if "wait" == world_db["ThingActions"][ThingAction]["TA_NAME"]:
1567             wait_action = True
1568     if not wait_action:
1569         print("Ignoring: No thing action with name 'wait' defined.")
1570         return
1571     for name in specials:  # #
1572         if world_db[name] not in world_db["ThingTypes"]:  # #
1573             print("Ignoring: No valid " + name + " set.")  # #
1574             return  # #
1575     world_db["Things"] = {}
1576     make_map()
1577     world_db["WORLD_ACTIVE"] = 1
1578     world_db["TURN"] = 1
1579     for i in range(world_db["ThingTypes"][playertype]["TT_START_NUMBER"]):
1580         id = id_setter(-1, "Things")
1581         world_db["Things"][id] = new_Thing(playertype, free_pos())
1582     if not world_db["Things"][0]["fovmap"]:
1583         empty_fovmap = bytearray(b" " * world_db["MAP_LENGTH"] ** 2)
1584         world_db["Things"][0]["fovmap"] = empty_fovmap
1585     update_map_memory(world_db["Things"][0])
1586     for type in world_db["ThingTypes"]:
1587         for i in range(world_db["ThingTypes"][type]["TT_START_NUMBER"]):
1588             if type != playertype:
1589                 id = id_setter(-1, "Things")
1590                 plantness = world_db["ThingTypes"][type]["TT_PROLIFERATE"]  # #
1591                 world_db["Things"][id] = new_Thing(type, free_pos(plantness))
1592     strong_write(io_db["file_out"], "NEW_WORLD\n")
1593     log_help()
1594
1595
1596 def command_maplength(maplength_string):
1597     """Redefine map length. Invalidate map, therefore lose all things on it."""
1598     val = integer_test(maplength_string, 1, 256)
1599     if None != val:
1600         world_db["MAP_LENGTH"] = val
1601         world_db["MAP"] = False
1602         set_world_inactive()
1603         world_db["Things"] = {}
1604         libpr.set_maplength(val)
1605
1606
1607 def command_worldactive(worldactive_string):
1608     """Toggle world_db["WORLD_ACTIVE"] if possible.
1609
1610     An active world can always be set inactive. An inactive world can only be
1611     set active with a "wait" ThingAction, and a player Thing (of ID 0), and a
1612     map. On activation, rebuild all Things' FOVs, and the player's map memory.
1613     Also call log_help().
1614     """
1615     # 7DRL: altar must be on map, and specials must be set for active world.
1616     val = integer_test(worldactive_string, 0, 1)
1617     if None != val:
1618         if 0 != world_db["WORLD_ACTIVE"]:
1619             if 0 == val:
1620                 set_world_inactive()
1621             else:
1622                 print("World already active.")
1623         elif 0 == world_db["WORLD_ACTIVE"]:
1624             wait_exists = False
1625             for ThingAction in world_db["ThingActions"]:
1626                 if "wait" == world_db["ThingActions"][ThingAction]["TA_NAME"]:
1627                     wait_exists = True
1628                     break
1629             player_exists = False
1630             for Thing in world_db["Things"]:
1631                 if 0 == Thing:
1632                     player_exists = True
1633                     break
1634             specials_set = True  # #
1635             for name in specials:  # #
1636                 if world_db[name] not in world_db["ThingTypes"]:  # #
1637                     specials_set = False  # #
1638             altar_found = False  # #
1639             if world_db["MAP"]:  # #
1640                 pos = world_db["MAP"].find(b'_')  # #
1641                 if pos > 0:  # #
1642                     y = int(pos / world_db["MAP_LENGTH"])  # #
1643                     x = pos % world_db["MAP_LENGTH"]  # #
1644                     world_db["altar"] = (y, x)  # #
1645                     altar_found = True  # #
1646             if wait_exists and player_exists and world_db["MAP"] \
1647                and specials_set:  # #
1648                 for id in world_db["Things"]:
1649                     if world_db["Things"][id]["T_LIFEPOINTS"]:
1650                         build_fov_map(world_db["Things"][id])
1651                         if 0 == id:
1652                             update_map_memory(world_db["Things"][id], False)
1653                 if not world_db["Things"][0]["T_LIFEPOINTS"]:
1654                     empty_fovmap = bytearray(b" " * world_db["MAP_LENGTH"] ** 2)
1655                     world_db["Things"][0]["fovmap"] = empty_fovmap
1656                 world_db["WORLD_ACTIVE"] = 1
1657                 log_help()
1658             else:
1659                 print("Ignoring: Not all conditions for world activation met.")
1660
1661
1662 def specialtypesetter(name):  # #
1663     """Setter world_db[name], deactivating world if set int no ThingType."""
1664     def helper(str_int):
1665         val = integer_test(str_int, 0)
1666         if None != val:
1667             world_db[name] = val
1668             if world_db["WORLD_ACTIVE"] \
1669                and world_db[name] not in world_db["ThingTypes"]:
1670                 world_db["WORLD_ACTIVE"] = 0
1671                 print(name + " fits no known ThingType, deactivating world.")
1672     return helper
1673
1674
1675 def test_for_id_maker(object, category):
1676     """Return decorator testing for object having "id" attribute."""
1677     def decorator(f):
1678         def helper(*args):
1679             if hasattr(object, "id"):
1680                 f(*args)
1681             else:
1682                 print("Ignoring: No " + category +
1683                       " defined to manipulate yet.")
1684         return helper
1685     return decorator
1686
1687
1688 def command_tid(id_string):
1689     """Set ID of Thing to manipulate. ID unused? Create new one.
1690
1691     Default new Thing's type to the first available ThingType, others: zero.
1692     """
1693     id = id_setter(id_string, "Things", command_tid)
1694     if None != id:
1695         if world_db["ThingTypes"] == {}:
1696             print("Ignoring: No ThingType to settle new Thing in.")
1697             return
1698         type = list(world_db["ThingTypes"].keys())[0]
1699         world_db["Things"][id] = new_Thing(type)
1700
1701
1702 test_Thing_id = test_for_id_maker(command_tid, "Thing")
1703
1704
1705 @test_Thing_id
1706 def command_tcommand(str_int):
1707     """Set T_COMMAND of selected Thing."""
1708     val = integer_test(str_int, 0)
1709     if None != val:
1710         if 0 == val or val in world_db["ThingActions"]:
1711             world_db["Things"][command_tid.id]["T_COMMAND"] = val
1712         else:
1713             print("Ignoring: ThingAction ID belongs to no known ThingAction.")
1714
1715
1716 @test_Thing_id
1717 def command_ttype(str_int):
1718     """Set T_TYPE of selected Thing."""
1719     val = integer_test(str_int, 0)
1720     if None != val:
1721         if val in world_db["ThingTypes"]:
1722             world_db["Things"][command_tid.id]["T_TYPE"] = val
1723         else:
1724             print("Ignoring: ThingType ID belongs to no known ThingType.")
1725
1726
1727 @test_Thing_id
1728 def command_tcarries(str_int):
1729     """Append int(str_int) to T_CARRIES of selected Thing.
1730
1731     The ID int(str_int) must not be of the selected Thing, and must belong to a
1732     Thing with unset "carried" flag. Its "carried" flag will be set on owning.
1733     """
1734     val = integer_test(str_int, 0)
1735     if None != val:
1736         if val == command_tid.id:
1737             print("Ignoring: Thing cannot carry itself.")
1738         elif val in world_db["Things"] \
1739              and not world_db["Things"][val]["carried"]:
1740             world_db["Things"][command_tid.id]["T_CARRIES"].append(val)
1741             world_db["Things"][val]["carried"] = True
1742         else:
1743             print("Ignoring: Thing not available for carrying.")
1744     # Note that the whole carrying structure is different from the C version:
1745     # Carried-ness is marked by a "carried" flag, not by Things containing
1746     # Things internally.
1747
1748
1749 @test_Thing_id
1750 def command_tmemthing(str_t, str_y, str_x):
1751     """Add (int(str_t), int(str_y), int(str_x)) to selected Thing's T_MEMTHING.
1752
1753     The type must fit to an existing ThingType, and the position into the map.
1754     """
1755     type = integer_test(str_t, 0)
1756     posy = integer_test(str_y, 0, 255)
1757     posx = integer_test(str_x, 0, 255)
1758     if None != type and None != posy and None != posx:
1759         if type not in world_db["ThingTypes"] \
1760            or posy >= world_db["MAP_LENGTH"] or posx >= world_db["MAP_LENGTH"]:
1761             print("Ignoring: Illegal value for thing type or position.")
1762         else:
1763             memthing = (type, posy, posx)
1764             world_db["Things"][command_tid.id]["T_MEMTHING"].append(memthing)
1765
1766
1767 def setter_map(maptype):
1768     """Set (world or Thing's) map of maptype's int(str_int)-th line to mapline.
1769
1770     If no map of maptype exists yet, initialize it with ' ' bytes first.
1771     """
1772
1773     def valid_map_line(str_int, mapline):
1774         val = integer_test(str_int, 0, 255)
1775         if None != val:
1776             if val >= world_db["MAP_LENGTH"]:
1777                 print("Illegal value for map line number.")
1778             elif len(mapline) != world_db["MAP_LENGTH"]:
1779                 print("Map line length is unequal map width.")
1780             else:
1781                 return val
1782         return None
1783
1784     def nonThingMap_helper(str_int, mapline):
1785         val = valid_map_line(str_int, mapline)
1786         if None != val:
1787             length = world_db["MAP_LENGTH"]
1788             if not world_db["MAP"]:
1789                 map = bytearray(b' ' * (length ** 2))
1790             else:
1791                 map = world_db["MAP"]
1792             map[val * length:(val * length) + length] = mapline.encode()
1793             if not world_db["MAP"]:
1794                 world_db["MAP"] = map
1795
1796     @test_Thing_id
1797     def ThingMap_helper(str_int, mapline):
1798         val = valid_map_line(str_int, mapline)
1799         if None != val:
1800             length = world_db["MAP_LENGTH"]
1801             if not world_db["Things"][command_tid.id][maptype]:
1802                 map = bytearray(b' ' * (length ** 2))
1803             else:
1804                 map = world_db["Things"][command_tid.id][maptype]
1805             map[val * length:(val * length) + length] = mapline.encode()
1806             if not world_db["Things"][command_tid.id][maptype]:
1807                 world_db["Things"][command_tid.id][maptype] = map
1808
1809     return nonThingMap_helper if maptype == "MAP" else ThingMap_helper
1810
1811
1812 def setter_tpos(axis):
1813     """Generate setter for T_POSX or  T_POSY of selected Thing.
1814
1815     If world is active, rebuilds animate things' fovmap, player's memory map.
1816     """
1817     @test_Thing_id
1818     def helper(str_int):
1819         val = integer_test(str_int, 0, 255)
1820         if None != val:
1821             if val < world_db["MAP_LENGTH"]:
1822                 world_db["Things"][command_tid.id]["T_POS" + axis] = val
1823                 if world_db["WORLD_ACTIVE"] \
1824                    and world_db["Things"][command_tid.id]["T_LIFEPOINTS"]:
1825                     build_fov_map(world_db["Things"][command_tid.id])
1826                     if 0 == command_tid.id:
1827                         update_map_memory(world_db["Things"][command_tid.id])
1828             else:
1829                 print("Ignoring: Position is outside of map.")
1830     return helper
1831
1832
1833 def command_ttid(id_string):
1834     """Set ID of ThingType to manipulate. ID unused? Create new one.
1835
1836     Default new ThingType's TT_SYMBOL to "?", TT_CORPSE_ID to self, TT_TOOL to
1837     "", others: 0.
1838     """
1839     id = id_setter(id_string, "ThingTypes", command_ttid)
1840     if None != id:
1841         world_db["ThingTypes"][id] = {
1842             "TT_NAME": "(none)",
1843             "TT_TOOLPOWER": 0,
1844             "TT_LIFEPOINTS": 0,
1845             "TT_PROLIFERATE": 0,
1846             "TT_START_NUMBER": 0,
1847             "TT_STORAGE": 0, # #
1848             "TT_SYMBOL": "?",
1849             "TT_CORPSE_ID": id,
1850             "TT_TOOL": ""
1851         }
1852
1853
1854 test_ThingType_id = test_for_id_maker(command_ttid, "ThingType")
1855
1856
1857 @test_ThingType_id
1858 def command_ttname(name):
1859     """Set TT_NAME of selected ThingType."""
1860     world_db["ThingTypes"][command_ttid.id]["TT_NAME"] = name
1861
1862
1863 @test_ThingType_id
1864 def command_tttool(name):
1865     """Set TT_TOOL of selected ThingType."""
1866     world_db["ThingTypes"][command_ttid.id]["TT_TOOL"] = name
1867
1868
1869 @test_ThingType_id
1870 def command_ttsymbol(char):
1871     """Set TT_SYMBOL of selected ThingType. """
1872     if 1 == len(char):
1873         world_db["ThingTypes"][command_ttid.id]["TT_SYMBOL"] = char
1874     else:
1875         print("Ignoring: Argument must be single character.")
1876
1877
1878 @test_ThingType_id
1879 def command_ttcorpseid(str_int):
1880     """Set TT_CORPSE_ID of selected ThingType."""
1881     val = integer_test(str_int, 0)
1882     if None != val:
1883         if val in world_db["ThingTypes"]:
1884             world_db["ThingTypes"][command_ttid.id]["TT_CORPSE_ID"] = val
1885         else:
1886             print("Ignoring: Corpse ID belongs to no known ThignType.")
1887
1888
1889 def command_taid(id_string):
1890     """Set ID of ThingAction to manipulate. ID unused? Create new one.
1891
1892     Default new ThingAction's TA_EFFORT to 1, its TA_NAME to "wait".
1893     """
1894     id = id_setter(id_string, "ThingActions", command_taid, True)
1895     if None != id:
1896         world_db["ThingActions"][id] = {
1897             "TA_EFFORT": 1,
1898             "TA_NAME": "wait"
1899         }
1900
1901
1902 test_ThingAction_id = test_for_id_maker(command_taid, "ThingAction")
1903
1904
1905 @test_ThingAction_id
1906 def command_taname(name):
1907     """Set TA_NAME of selected ThingAction.
1908
1909     The name must match a valid thing action function. If after the name
1910     setting no ThingAction with name "wait" remains, call set_world_inactive().
1911     """
1912     if name == "wait" or name == "move" or name == "use" or name == "drop" \
1913        or name == "pick_up":
1914         world_db["ThingActions"][command_taid.id]["TA_NAME"] = name
1915         if 1 == world_db["WORLD_ACTIVE"]:
1916             wait_defined = False
1917             for id in world_db["ThingActions"]:
1918                 if "wait" == world_db["ThingActions"][id]["TA_NAME"]:
1919                     wait_defined = True
1920                     break
1921             if not wait_defined:
1922                 set_world_inactive()
1923     else:
1924         print("Ignoring: Invalid action name.")
1925     # In contrast to the original,naming won't map a function to a ThingAction.
1926
1927
1928 def command_ai():
1929     """Call ai() on player Thing, then turn_over()."""
1930     ai(world_db["Things"][0])
1931     turn_over()
1932
1933
1934 """Commands database.
1935
1936 Map command start tokens to ([0]) number of expected command arguments, ([1])
1937 the command's meta-ness (i.e. is it to be written to the record file, is it to
1938 be ignored in replay mode if read from server input file), and ([2]) a function
1939 to be called on it.
1940 """
1941 commands_db = {
1942     "QUIT": (0, True, command_quit),
1943     "PING": (0, True, command_ping),
1944     "THINGS_HERE": (2, True, command_thingshere),
1945     "MAKE_WORLD": (1, False, command_makeworld),
1946     "SEED_RANDOMNESS": (1, False, command_seedrandomness),
1947     "TURN": (1, False, setter(None, "TURN", 0, 65535)),
1948     "GOD_MOOD": (1, False, setter(None, "GOD_MOOD", -32768, 32767)),  # #
1949     "GOD_FAVOR": (1, False, setter(None, "GOD_FAVOR", -32768, 32767)),  # #
1950     "PLAYER_TYPE": (1, False, setter(None, "PLAYER_TYPE", 0)),
1951     "MAP_LENGTH": (1, False, command_maplength),
1952     "WORLD_ACTIVE": (1, False, command_worldactive),
1953     "MAP": (2, False, setter_map("MAP")),
1954     "FAVOR_STAGE": (1, False, setter(None, "FAVOR_STAGE", 0, 65535)),  # #
1955     "SLIPPERS": (1, False, specialtypesetter("SLIPPERS")),  # #
1956     "PLANT_0": (1, False, specialtypesetter("PLANT_0")),  # #
1957     "PLANT_1": (1, False, specialtypesetter("PLANT_1")),  # #
1958     "LUMBER": (1, False, specialtypesetter("LUMBER")),  # #
1959     "TOOL_0": (1, False, specialtypesetter("TOOL_0")),  # #
1960     "TA_ID": (1, False, command_taid),
1961     "TA_EFFORT": (1, False, setter("ThingAction", "TA_EFFORT", 0, 255)),
1962     "TA_NAME": (1, False, command_taname),
1963     "TT_ID": (1, False, command_ttid),
1964     "TT_NAME": (1, False, command_ttname),
1965     "TT_TOOL": (1, False, command_tttool),
1966     "TT_SYMBOL": (1, False, command_ttsymbol),
1967     "TT_CORPSE_ID": (1, False, command_ttcorpseid),
1968     "TT_TOOLPOWER": (1, False, setter("ThingType", "TT_TOOLPOWER", 0, 65535)),
1969     "TT_START_NUMBER": (1, False, setter("ThingType", "TT_START_NUMBER",
1970                                          0, 255)),
1971     "TT_PROLIFERATE": (1, False, setter("ThingType", "TT_PROLIFERATE",
1972                                         0, 65535)),
1973     "TT_LIFEPOINTS": (1, False, setter("ThingType", "TT_LIFEPOINTS", 0, 255)),
1974     "TT_STORAGE": (1, False, setter("ThingType", "TT_STORAGE", 0, 255)),  # #
1975     "T_ID": (1, False, command_tid),
1976     "T_ARGUMENT": (1, False, setter("Thing", "T_ARGUMENT", 0, 255)),
1977     "T_PROGRESS": (1, False, setter("Thing", "T_PROGRESS", 0, 255)),
1978     "T_LIFEPOINTS": (1, False, setter("Thing", "T_LIFEPOINTS", 0, 255)),
1979     "T_SATIATION": (1, False, setter("Thing", "T_SATIATION", -32768, 32767)),
1980     "T_COMMAND": (1, False, command_tcommand),
1981     "T_TYPE": (1, False, command_ttype),
1982     "T_CARRIES": (1, False, command_tcarries),
1983     "T_MEMMAP": (2, False, setter_map("T_MEMMAP")),
1984     "T_MEMDEPTHMAP": (2, False, setter_map("T_MEMDEPTHMAP")),
1985     "T_MEMTHING": (3, False, command_tmemthing),
1986     "T_POSY": (1, False, setter_tpos("Y")),
1987     "T_POSX": (1, False, setter_tpos("X")),
1988     "T_PLAYERDROP": (1, False, setter("Thing", "T_PLAYERDROP", 0, 1)),  # #
1989     "wait": (0, False, play_commander("wait")),
1990     "move": (1, False, play_commander("move")),
1991     "pick_up": (0, False, play_commander("pick_up")),
1992     "drop": (1, False, play_commander("drop", True)),
1993     "use": (1, False, play_commander("use", True)),
1994     "ai": (0, False, command_ai)
1995 }
1996 # TODO: Unhandled cases: (Un-)killing animates (esp. player!) with T_LIFEPOINTS.
1997
1998
1999 """World state database. With sane default values. (Randomness is in rand.)"""
2000 world_db = {
2001     "TURN": 0,
2002     "MAP_LENGTH": 64,
2003     "PLAYER_TYPE": 0,
2004     "WORLD_ACTIVE": 0,
2005     "GOD_MOOD": 0,  # #
2006     "GOD_FAVOR": 0,  # #
2007     "MAP": False,
2008     "FAVOR_STAGE": 0,  # #
2009     "SLIPPERS": 0,  # #
2010     "PLANT_0": 0,  # #
2011     "PLANT_1": 0,  # #
2012     "LUMBER": 0,  # #
2013     "TOOL_0": 0,  # #
2014     "ThingActions": {},
2015     "ThingTypes": {},
2016     "Things": {}
2017 }
2018
2019 # 7DRL-specific!
2020 """Special type settings."""
2021 specials = ["SLIPPERS", "PLANT_0", "PLANT_1", "LUMBER", "TOOL_0"]  # #
2022
2023 """Mapping of direction names to internal direction chars."""
2024 directions_db = {"east": "d", "south-east": "c", "south-west": "x",
2025                  "west": "s", "north-west": "w", "north-east": "e"}
2026
2027 """File IO database."""
2028 io_db = {
2029     "path_save": "save",
2030     "path_record": "record_save",
2031     "path_worldconf": "confserver/world",
2032     "path_server": "server/",
2033     "path_in": "server/in",
2034     "path_out": "server/out",
2035     "path_worldstate": "server/worldstate",
2036     "tmp_suffix": "_tmp",
2037     "kicked_by_rival": False,
2038     "worldstate_updateable": False
2039 }
2040
2041
2042 try:
2043     libpr = prep_library()
2044     rand = RandomnessIO()
2045     opts = parse_command_line_arguments()
2046     if opts.savefile:
2047         io_db["path_save"] = opts.savefile
2048         io_db["path_record"] = "record_" + opts.savefile
2049     setup_server_io()
2050     if opts.verbose:
2051         io_db["verbose"] = True
2052     if None != opts.replay:
2053         replay_game()
2054     else:
2055         play_game()
2056 except SystemExit as exit:
2057     print("ABORTING: " + exit.args[0])
2058 except:
2059     print("SOMETHING WENT WRONG IN UNEXPECTED WAYS")
2060     raise
2061 finally:
2062     cleanup_server_io()