Some new functions related to dungeon AI behavior

CREDITS.txt

@@ -32,6 +32,7 @@ other parts of the project, feel free to add yourself to this file!
 - Rhokin
 - ShadyGamerX
 - ElectricGeorge
+- Assidion
 - The rest of the contributors to Project Pokémon's technical documentation
   for the NDS Mystery Dungeon games, which can be found here:
   https://projectpokemon.org/home/docs/mystery-dungeon-nds/

headers/functions/overlay29.h

@@ -867,5 +867,8 @@ void DisplayMessageInternal(int message_id, bool wait_for_input, struct portrait
 void OpenMenu(undefined param_1, undefined param_2, bool open_bag);
 int OthersMenuLoop(void);
 undefined OthersMenu(void);
+int GetAiUseItemProbability(struct entity* item_consumer, struct item* used_item, int unknown);
+bool IsAdjacentToEnemy(struct entity* entity);
+enum relation GetRelationBetweenMonsters(struct entity* entity_1, struct entity* entity_2, bool unknown_1, bool unknown_2);
 
 #endif

headers/types/dungeon_mode/enums.h

@@ -1442,4 +1442,11 @@ enum fade_status_dungeon {
     DUNGEON_FADE_0x5 = 5,
 };
 
+// Used to indicate whether two monsters are allies, enemies, or neither (one is a shopkeeper, decoy, etc.)
+enum relation {
+    RELATION_ALLIES = 0,
+    RELATION_ENEMIES = 1,
+    RELATION_OTHER = 2,
+};
+
 #endif

symbols/overlay29.yml

@@ -8500,6 +8500,44 @@ overlay29:
         Called when the in-dungeon "others" menu is open. Does not return until the menu is closed.
         
         return: Always 0
+    - name: GetAiUseItemProbability
+      address:
+        EU: 0x231EAC4
+        NA: 0x231DEB8
+        JP: 0x231F138
+      description: |-
+        Called to get the probability of an item being used or thrown by an AI on the current turn.
+
+        r0: Pointer to either the user if it is an item used by the AI or the target if it is an item thrown by the AI
+        r1: Pointer to item
+        r2: Unknown 2-bit bitvector. Bit 1 influences only the Warp Seed case, while Bit 0 influences various items.
+        
+        return: Integer in range [0, 100]
+      - name: IsAdjacentToEnemy
+      address:
+        EU: 0x231F358
+        NA: 0x231E74C
+        JP: 0x231F9CC
+      description: |-
+        Called to check if a hostile entity is present in any of the tiles adjacent to an entity.
+
+        r0: Pointer to entity
+        
+        return: True if yes, false if no
+      - name: GetRelationBetweenMonsters
+      address:
+        EU: 0x2302188
+        NA: 0x230157C
+        JP: 0x23027FC
+      description: |-
+        Called to check if two monsters are allies, enemies, or neither (one is a shopkeeper, decoy, etc.)
+
+        r0: Pointer to entity 1
+        r1: Pointer to entity 2
+        r2: ? (If == 0, will make function return 2 if r1 is invisible and r0 can see invisible monsters)
+        r3: ? (If != 0, will make function return 2 if r0 is a team member and r1 has some sort of status)
+        
+        return: 0 if allies, 1 if enemies, 2 if other
   data:
     - name: DUNGEON_STRUCT_SIZE
       address: