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