home · contact · privacy
fdd11f91c9180cc4226e199ac3d1a0abba28cc8c
[plomrogue] / src / server / map_objects.h
1 /* src/server/map_objects.h
2  *
3  * Structs for objects on the map and their type definitions, and routines to
4  * initialize these and load and save them from/to files.
5  */
6
7 #ifndef MAP_OBJECTS_H
8 #define MAP_OBJECTS_H
9
10 #include <stdint.h> /* uint8_t */
11 #include "../common/yx_uint8.h" /* yx_uint8 structs */
12
13
14
15 struct MapObj
16 {
17     struct MapObj * next;        /* pointer to next one in map object chain */
18     struct MapObj * owns;        /* chain of map objects owned / in inventory */
19     struct yx_uint8 pos;         /* coordinate on map */
20     uint8_t id;                  /* individual map object's unique identifier */
21     uint8_t type;                /* ID of appropriate map object definition */
22     uint8_t lifepoints;          /* 0: object is inanimate; >0: hitpoints */
23     uint8_t command;             /* map object's current action; 0 if none */
24     uint8_t arg;                 /* optional field for .command argument */
25     uint8_t progress;            /* turns already passed to realize .command */
26 };
27
28 struct MapObjDef
29 {
30     uint8_t id;         /* map object definition identifier / sets .type */
31     struct MapObjDef * next;
32     char char_on_map;   /* map object symbol to appear on map */
33     char * name;        /* string to describe object in game log */
34     uint8_t corpse_id;  /* type to change map object into upon destruction */
35     uint8_t lifepoints; /* default start value for map object's .lifepoints */
36     uint8_t consumable; /* can be eaten if !0, for so much hitpoint win */
37 };
38
39
40
41 /* Free map object definitions chain starting at "mod_start". */
42 extern void free_map_object_defs(struct MapObjDef * mod_start);
43
44 /* Add object(s) ("n": how many?) of "type" to map on random position(s). New
45  * animate objects are never placed in the same square with other animate ones.
46  */
47 extern void add_map_objects(uint8_t type, uint8_t n);
48
49 /* Free map objects in map object chain starting at "mo_start. */
50 extern void free_map_objects(struct MapObj * mo_start);
51
52 /* Move object of "id" from "source" inventory to "target" inventory. */
53 extern void own_map_object(struct MapObj ** target, struct MapObj ** source,
54                            uint8_t id);
55
56 /* Get pointer to the MapObj struct that represents the player. */
57 extern struct MapObj * get_player();
58
59 /* Get pointer to the map object definition of identifier "def_id". */
60 extern struct MapObjDef * get_map_object_def(uint8_t id);
61
62 /* Move not only "mo" to "pos", but also all map objects owned by it. */
63 extern void set_object_position(struct MapObj * mo, struct yx_uint8 pos);
64
65
66
67 #endif