X-Git-Url: https://plomlompom.com/repos/test.html?a=blobdiff_plain;f=src%2Fmap_object_actions.h;h=2edc172e7a73d1cd96f99b861b957bb5785ed988;hb=f2a7bc28be634fde4dfe4bde4c83395cab9efa91;hp=2202b27e60642cc70485332f8c84ccc607c09e2d;hpb=120715d0a4a308cdf748e1925be472ed6a59f092;p=plomrogue
diff --git a/src/map_object_actions.h b/src/map_object_actions.h
index 2202b27..2edc172 100644
--- a/src/map_object_actions.h
+++ b/src/map_object_actions.h
@@ -1,15 +1,49 @@
+/* map_object_actions.h
+ *
+ * Routines for the actions available to map objects.
+ */
+
#ifndef MAP_OBJECT_ACTIONS_H
#define MAP_OBJECT_ACTIONS_H
-#include "yx_uint16.h"
+
+#include "yx_uint16.h" /* for yx_uint16 coordinates */
struct World;
struct Map;
struct Monster;
-extern char is_passable (struct Map *, struct yx_uint16);
-extern void move_monster (struct World *, struct Monster *);
-extern void move_player (struct World *, enum dir);
-extern void player_wait(struct World *);
+
+
+/* Try to move "monster" in random direction. On contact with other monster,
+ * only bump. On contact with player, fight / reduce player's hitpoints,
+ * and thereby potentially trigger the player's death. Update the log for any
+ * contact action.
+ */
+extern void move_monster(struct World * world, struct Monster * monster);
+
+
+
+/* Try to move player in direction "d". On contact with monster, fight / reduce
+ * monster's hitpoints, and thereby potentially trigger the monster's death.
+ * Update the log on whatever the player did and turn control over to the enemy.
+ */
+extern void move_player (struct World * world, enum dir d);
+
+
+
+/* Make player wait one turn, i.e. only update_log with a "you wait" message
+ * and turn control over to the enemy.
+ */
+extern void player_wait(struct World * world);
+
+
+
+/* Check if coordinate pos on (or beyond) map is accessible to map object
+ * movement.
+ */
+extern char is_passable (struct Map * map, struct yx_uint16 pos);
+
+
#endif