Recent miscellaneous findings

headers/data/arm9.h

@@ -156,6 +156,7 @@ extern int16_t IQ_SKILL_RESTRICTIONS[69];
 extern struct secondary_terrain_type_8 SECONDARY_TERRAIN_TYPES[200];
 extern struct monster_id_16 SENTRY_DUTY_MONSTER_IDS[102];
 extern int32_t IQ_SKILLS[69];
+extern int MIN_TEAM_MEMBER_IQ;
 extern uint8_t IQ_GROUP_SKILLS[400];
 extern int MONEY_QUANTITY_TABLE[100];
 extern int16_t IQ_GUMMI_GAIN_TABLE[18][18];

headers/data/overlay29.h

@@ -60,6 +60,7 @@ extern struct status_icon_flags STATUS_ICON_ARRAY_FREEZE[8];
 extern struct status_icon_flags STATUS_ICON_ARRAY_CRINGE[8];
 extern struct status_icon_flags STATUS_ICON_ARRAY_BIDE[14];
 extern struct status_icon_flags STATUS_ICON_ARRAY_REFLECT[18];
+extern struct window_params DUNGEON_CONTROLS_MENU_WINDOW_PARAMS;
 extern enum direction_id POSITION_DISPLACEMENT_TO_DIRECTION[3][3];
 extern int16_t DIRECTIONS_XY[8][2];
 extern int FACING_DIRECTION_INCREMENTS[8];
@@ -97,6 +98,7 @@ extern undefined4 OV29_STATIC_INITIALIZER;
 extern struct dungeon* DUNGEON_PTR;
 extern struct dungeon* DUNGEON_PTR_MASTER;
 extern struct top_screen_status* TOP_SCREEN_STATUS_PTR;
+extern struct dungeon_controls_menu* DUNGEON_CONTROLS_MENU_PTR;
 extern struct entity* LEADER_PTR;
 extern struct prng_state DUNGEON_PRNG_STATE;
 extern uint32_t DUNGEON_PRNG_STATE_SECONDARY_VALUES[5];

headers/functions/arm9.h

@@ -533,6 +533,7 @@ void DisplayAnimationControlCurrentFrame(struct animation_control* anim_ctrl);
 void DisplayAndSwitchAnimationControlCurrentFrame(struct animation_control* anim_ctrl);
 void FillOamAdjustmentInfo(struct animation_control* dst, uint16_t* src);
 uint32_t AnimationControlGetAllocForMaxFrame(struct animation_control* anim_ctrl);
+void SetAnimationControlPausedFlag(struct animation_control* anim_ctrl, bool new_val);
 void DeleteWanTableEntry(struct wan_table* wan_table, int wan_id);
 int AllocateWanTableEntry(struct wan_table* wan_table);
 int FindWanTableEntry(struct wan_table* wan_table, const char* path);
@@ -1290,7 +1291,7 @@ void GetNameOfTeamMemberAtIdx(char* out, int roster_idx);
 void GetRecoloredTeamMemberName(char* out, struct team_member* team_member);
 void ChangeGiratinaFormIfSkyDungeon(enum dungeon_id dungeon_id);
 void RevertGiratinaAndShaymin(uint8_t member_idx, undefined param_2);
-void* OamTileNumberToVramAddress(uint16_t oam_tile_num, uint8_t screen);
+void* OamTileNumberToVramAddress(uint16_t oam_tile_num, enum screen screen);
 int GetIqSkillStringId(enum iq_skill_id iq_skill);
 bool DoesTacticFollowLeader(enum tactic_id tactic_id);
 void GetUnlockedTactics(enum tactic_id* unlocked_tactics, int level);

headers/functions/overlay10.h

@@ -14,7 +14,9 @@ void UpdateInventoryMenu(struct window* window);
 bool IsInventoryMenuState3(int window_id);
 void CreateInventoryMenuOuter(int n_items, int param_2, int param_3, uint8_t* param_4,
                               undefined* param_5, undefined* param_6, uint32_t param_7);
+void LoadPaletteBase(uint8_t sprite_index, bool is_4bpp);
 int GetEffectAnimationField0x19(int anim_id);
+bool ScreenEffectActive(enum screen screen);
 bool AnimationHasMoreFrames(int param_1);
 struct effect_animation* GetEffectAnimation(int anim_id);
 struct move_animation* GetMoveAnimation(enum move_id move_id);
@@ -27,8 +29,8 @@ undefined4 DrawTeamStats(undefined4 param_1, int param_2, undefined4 param_3, ui
 void UpdateTeamStats(void);
 int FreeTeamStats(void);
 int FreeMapAndTeam(void);
-void ProcessTeamStatsLvHp(int idx);
-void ProcessTeamStatsNameGender(int idx);
+void ProcessTeamStatsLvHp(int window_id);
+void ProcessTeamStatsNameGender(int window_id);
 bool IsBackgroundTileset(int tileset_id);
 void InitTilesetBuffer(void* buffer, int tileset_id, uint32_t malloc_flags);
 int MainGame(int end_cond);

headers/functions/overlay29.h

@@ -25,7 +25,7 @@ void SetDungeonEscapeFields(uint32_t successful_exit_tracker, bool end_floor_no_
 uint32_t GetSuccessfulExitTracker(void);
 void GetAndStoreButtonInput(void);
 bool CheckTouchscreenArea(int x1, int y1, int x2, int y2);
-void* OamTileNumberToVramAddressOv29(short oam_tile_num, uint8_t screen);
+void* OamTileNumberToVramAddressOv29(short oam_tile_num, enum screen screen);
 void ResetDungeonColorPalette(void);
 struct trap* GetTrapInfo(struct entity* trap_entity);
 struct item* GetItemInfo(struct entity* item_entity);
@@ -57,6 +57,7 @@ void UpdateCamera(undefined param_1);
 bool ItemIsActive(struct entity* entity, enum item_id item_id);
 int GetVisibilityRange(void);
 void RevealWholeFloor(struct entity* entity);
+bool DungeonScreenEffectActive(void);
 int PlayEffectAnimationEntity(struct entity* entity, int effect_id, bool play_now, int param_4,
                               int param_5, undefined param_6, enum direction_id effect_dir,
                               uint16_t* custom_oam_adjustment_info);
@@ -87,10 +88,12 @@ void PlayDefensiveStatMultiplierDownEffect(struct entity* entity, int stat_index
 void PlayHitChanceUpEffect(struct entity* entity, int stat_index);
 void PlayHitChanceDownEffect(struct entity* entity, int stat_index);
 void PlaySeByIdIfShouldDisplayEntity(struct entity* entity, int se_id);
+void PlayStairsSfx(void);
 bool ShouldDisplayEntityAdvanced(struct entity* entity);
 void PlayEffectAnimation0x1A9(struct entity* entity);
 void PlayEffectAnimation0x29(struct entity* entity);
 void PlayEffectAnimation0x18E(struct entity* entity);
+void PlayKeyDoorUnlockEffect(struct entity* entity, bool is_not_treasure_memo);
 void PlayStairSensorArrowEffect(struct entity* entity, enum direction_id arrow_dir);
 void LoadMappaFileAttributes(int quick_saved, bool disable_monsters, undefined* special_process);
 enum trap_id GetRandomSpawnTrapId(void);
@@ -110,13 +113,17 @@ int InitializeTeamStats(void);
 int UpdateTeamStatsWrapper(void);
 int FreeTeamStatsWrapper(void);
 void DisplayTeamStatsSprite(struct entity* team_member, int actual_idx, int roster_idx);
+void InitDungeonControlsMenuWithBg(void);
+void FreeDungeonControlsMenuWithBg(void);
 void AssignTopScreenHandlers(void** funcs, top_screen_status_fn_t init_func,
                              top_screen_status_fn_t update_func, void* param_4,
                              top_screen_status_fn_t free_func);
 void HandleTopScreenFades(void);
 int FreeTopScreen(void);
 void DungeonChangeTopScreenType(int top_screen_type);
 void DrawDungeonControlsText(int window_id);
+void InitDungeonControlsMenu(void);
+void FreeDungeonControlsMenu(void);
 enum direction_id GetDirectionTowardsPosition(struct position* origin, struct position* target);
 int GetChebyshevDistance(struct position* position_a, struct position* position_b);
 bool IsPositionActuallyInSight(struct position* origin, struct position* target,
@@ -229,14 +236,16 @@ int SpawnMonstersAroundPos(struct entity* monster, struct position* pos, uint8_t
 void RevealTrapsNearby(struct entity* monster);
 bool RevealTrapAtPos(int x, int y);
 void CheckBossFightVictory(struct entity* fainted_entity, enum monster_behavior behavior,
-                           bool change_music);
+                           bool dont_change_music);
 void ChangeTeamAnimationsToIdle(void);
 bool IsFloorOver2(void);
 bool ShouldRunMonsterAi(struct entity* monster);
 bool DebugRecruitingEnabled(void);
 void TryActivateIqBooster(void);
 bool IsBehaviorLoneOutlaw(enum monster_behavior behavior);
 bool IsSecretBazaarNpcBehavior(enum monster_behavior behavior);
+void FreezeAnim(struct entity* entity);
+void UnfreezeAnim(struct entity* entity);
 bool TalkToSecretBazaarNpcStandard(int string_id, struct entity* shopkeeper,
                                    enum portrait_emotion emotion);
 bool TalkToSecretBazaarNpcWithYesNoMenu(int string_id, struct entity* shopkeeper,
@@ -258,15 +267,22 @@ void CheckLeaderTile(void);
 void ChangeLeader(void);
 enum monster_gender GetPlayerGender(void);
 void HandleHeldItemSwaps(struct entity* entity);
+void TryPlaceItem(struct entity* user);
+void UseSingleUseItemSelf(struct entity* user);
 void UseSingleUseItemWrapper(struct entity* user);
 void UseSingleUseItem(struct entity* user, struct entity* target);
 void UseThrowableItem(struct entity* user);
+void TalkToTeamMemberInFront(struct entity* entity);
+void PlayerUseMove(struct entity* entity);
+void UseRegularAttackOrStruggle(struct entity* entity);
 void ResetDamageData(struct damage_data* damage);
 void FreeLoadedAttackSpriteAndMore(void);
 uint16_t SetAndLoadCurrentAttackAnimation(enum pack_file_id pack_id, uint16_t file_index);
 void ClearLoadedAttackSprite(void);
 uint16_t GetLoadedAttackSpriteId(void);
 int DungeonGetTotalSpriteFileSize(enum monster_id monster_id);
+void LoadMonsterSprites(void);
+void LoadActiveMonsterSprites(void);
 uint16_t DungeonGetSpriteIndex(enum monster_id monster_id);
 bool JoinedAtRangeCheck2Veneer(struct dungeon_id_8 joined_at);
 bool FloorNumberIsEven(void);
@@ -277,10 +293,12 @@ void SwapMonsterWanFileIndex(int src_id, int dst_id);
 void LoadMonsterSprite(enum monster_id monster_id, undefined param_2);
 void DeleteMonsterSpriteFile(enum monster_id monster_id);
 void DeleteAllMonsterSpriteFiles(void);
+bool CanMonsterBeAddedToTeam(struct entity* entity);
 void EuFaintCheck(bool non_team_member_fainted, bool set_unk_byte);
 void HandleFaint(struct entity* fainted_entity, union damage_source damage_source,
                  struct entity* killer);
-void MoveMonsterToPos(struct entity* entity, int x_pos, int y_pos, undefined param_4);
+void MoveMonsterToPos(struct entity* entity, int x_pos, int y_pos, bool reset_prev_pos_fields);
+struct entity* GetMonsterInFront(struct entity* entity);
 void CreateMonsterSummaryFromEntity(struct monster_summary* monster_summary,
                                     struct entity* monster_entity);
 void FillRecruitInfo(struct recruit_info* recruit_info, struct entity* monster);
@@ -342,6 +360,9 @@ void InitOtherMonsterData(struct entity* entity, int fixed_room_stats_index, enu
 void InitEnemySpawnStats(void);
 void InitEnemyStatsAndMoves(struct move* move_list, int16_t* hp, uint8_t* offensive_stats,
                             uint8_t* defensive_stats);
+void InitExplorerMazeMonsterStatsMovesAndIq(struct move* move_list, int16_t* hp,
+                                            uint8_t* offensive_stats, uint8_t* defensive_stats,
+                                            int16_t* iq, enum monster_behavior behavior);
 void SpawnTeam(undefined param_1);
 void SpawnInitialMonsters(void);
 struct entity* SpawnMonster(struct spawned_monster_data* monster_data, bool cannot_be_asleep);
@@ -623,6 +644,8 @@ void ResetHitChanceStat(struct entity* user, struct entity* target, int stat_idx
 bool ExclusiveItemEffectIsActiveWithLogging(struct entity* user, struct entity* target,
                                             bool should_log, int message_id,
                                             enum exclusive_item_effect_id effect_id);
+void LogMessageWithTargetAndExclusiveItemName(struct entity* user, struct entity* target,
+                                              int message_id, enum exclusive_item_effect_id effect);
 bool TryActivateQuickFeet(struct entity* attacker, struct entity* defender);
 void TryInflictTerrifiedStatus(struct entity* user, struct entity* target);
 bool TryInflictGrudgeStatus(struct entity* user, struct entity* target, bool log_message);
@@ -733,6 +756,7 @@ bool TargetRegularAttack(struct entity* user, enum direction_id* direction, bool
 bool IsTargetInRange(struct entity* user, struct entity* target, enum direction_id direction,
                      int n_tiles);
 bool ShouldUsePp(struct entity* entity);
+void AiUseMove(struct entity* entity);
 struct move_target_and_range GetEntityMoveTargetAndRange(struct entity* entity, struct move* move,
                                                          bool is_ai);
 struct natural_gift_item_info* GetEntityNaturalGiftInfo(struct entity* entity);
@@ -894,6 +918,7 @@ void SetHiddenStairsField(enum hidden_stairs_type hidden_stairs);
 enum hidden_stairs_type GetHiddenFloorField(void);
 void SetHiddenFloorField(enum hidden_stairs_type hidden_floor);
 void LoadWeather3DFiles(void);
+bool Weather3DEffectActive(void);
 void RenderWeather3D(void);
 struct minimap_display_data* GetMinimapData(void);
 void DrawMinimapTile(int x, int y);
@@ -979,6 +1004,7 @@ void ResetHiddenStairsSpawn(void);
 void PlaceFixedRoomTile(struct tile* tile, union fixed_room_action action, int x, int y,
                         bool place_item_or_trap);
 enum direction_id FixedRoomActionParamToDirection(uint8_t fixed_room_action_param);
+void TryOpenKeyDoor(struct entity* user, struct tile* tile, int success_msg_id, int fail_msg_id);
 void ApplyKeyEffect(struct entity* user, struct entity* target);
 void LoadFixedRoomData(void);
 int LoadFixedRoom(int param_1, int param_2, int param_3, undefined4 param_4);
@@ -1023,7 +1049,7 @@ void RemoveEmptyItemsInBagWrapper(void);
 void GenerateItem(struct item* item, enum item_id item_id, uint16_t quantity,
                   enum gen_item_stickiness sticky_type);
 void HandleRegularProjectileThrow(struct entity* user, struct item* item,
-                                  struct position* start_pos, enum direction dir,
+                                  struct position* start_pos, enum direction_id dir,
                                   struct projectile_throw_info* projectile_throw_info);
 void HandleCurvedProjectileThrow(struct entity* user, struct item* item, struct position* start_pos,
                                  struct position* target_pos,
@@ -1101,6 +1127,7 @@ int GetAlertBoxLoadingStatus(void);
 void LogMessage(struct entity* user, const char* message, bool show_popup);
 void LogMessageById(struct entity* user, int message_id, bool show_popup);
 bool AlertBoxIsActive(void);
+bool FullyCloseAlertBox(void);
 bool AlertBoxIsScrolling(void);
 void WaitUntilAlertBoxTextIsLoaded(undefined param_1);
 void WaitUntilAlertBoxPauseIsOver(undefined param_1);

headers/types/common/common.h

@@ -1289,7 +1289,7 @@ struct menu_control {
     struct menu_load_entry active_entry; // 0xC4: The entry for the currently active menu
     // 0xD4: 0 means no menu active, 1 means menu initializing, 2 means menu active, 3 means ???
     int state;
-    // 0xD8: Whether the overlay in active_entry should be unloaded upon calling FreeMenu
+    // 0xD8: Whether the overlay in active_entry should be unloaded upon calling FreeActiveMenu
     bool should_unload_overlay_on_free;
     undefined field_0xd9;
     undefined field_0xda;

headers/types/common/graphics.h

@@ -9,10 +9,13 @@
 // Contains data relating to animation.
 // Mentioned under the name of "AnimeCtrl" in a debug message.
 struct animation_control {
-    uint16_t some_bitfield;
+    uint16_t some_bitfield1 : 14;
+    uint16_t anim_paused : 1;
+    uint16_t some_bitfield2 : 1;
     uint16_t unk_flags1 : 4;
     uint16_t no_auto_frame_switch : 1;
-    uint16_t unk_flags2 : 11;
+    uint16_t use_oam_adjustment_info : 1;
+    uint16_t unk_flags2 : 10;
     undefined2 field2_0x4;
     uint16_t anim_frame_duration;
     undefined2 field4_0x8;
@@ -485,7 +488,7 @@ struct unk_palette_struct {
     struct palette_data_substruct extended_palette_sub; // 0x3C: Unused for top screen
     struct palette_data extended_palette_data;          // 0x50: Unused for top screen
     undefined field_0x78;
-    bool is_top_screen; // 0x79
+    struct screen_8 screen; // 0x79
     undefined field_0x7a[34];
 };
 ASSERT_SIZE(struct unk_palette_struct, 156);

headers/types/dungeon_mode/dungeon_mode.h

@@ -2628,6 +2628,15 @@ struct recruit_info {
 };
 ASSERT_SIZE(struct recruit_info, 72);
 
+struct dungeon_controls_menu {
+    int8_t window_id; // 0x0
+    undefined field_0x1;
+    undefined field_0x2;
+    undefined field_0x3;
+    struct preprocessor_args preprocessor_args; // 0x4
+};
+ASSERT_SIZE(struct dungeon_controls_menu, 84);
+
 // Separate this out into its own file because it's massive
 #include "dungeon.h"
 

symbols/arm9.yml

@@ -5062,6 +5062,14 @@ arm9:
 
         r0: animation_control
         return: allocation for max frame
+    - name: SetAnimationControlPausedFlag
+      address:
+        EU: 0x201D234
+      description: |-
+        Changes the flag for whether the animation should be paused.
+
+        r0: animation_control
+        r1: whether the animation should be paused
     - name: DeleteWanTableEntry
       address:
         EU: 0x201D278
@@ -12360,7 +12368,7 @@ arm9:
         Maps an object's designated OAM tile number (bits 0-9 in attribute 2) to the address its texture should be placed at in VRAM.
 
         r0: tile number
-        r1: 0 for bottom screen, 1 for top screen
+        r1: screen
         return: VRAM tile address
     - name: GetIqSkillStringId
       address:
@@ -15318,6 +15326,12 @@ arm9:
         Table of 4-byte values for each IQ skill that represent the required IQ value to unlock a skill.
 
         type: int[69]
+    - name: MIN_TEAM_MEMBER_IQ
+      address:
+        EU: 0x20A2220
+      length:
+        EU: 0x4
+      description: The minimum IQ for a team member or Explorer Maze monster.
     - name: IQ_GROUP_SKILLS
       address:
         EU: 0x20A2314
@@ -16458,9 +16472,7 @@ arm9:
         type: int16_t[6]
     - name: MENU_CONTROL_PTR
       address:
-        EU: 0x20B06B4
-        NA: 0x20AFD98
-        JP: 0x20B11D8
+        EU: 0x20B06D4
       length:
         EU: 0x4
         NA: 0x4

symbols/overlay10.yml

@@ -148,6 +148,16 @@ overlay10:
         stack[0]: ?
         stack[1]: ?
         statk[2]: uint32_t
+    - name: LoadPaletteBase
+      address:
+        EU: 0x22BE09C
+      description: |-
+        Loads either the 8bpp or 4bpp palette base (from WAN file 292 or 1, respectively).
+
+        See https://github.com/WraithFire/wanimation-studio/blob/master/docs/README.md#sprite-modes
+
+        r0: sprite index in wan_table to load from
+        r1: 0 for 8bpp, 1 for 4bpp
     - name: GetEffectAnimationField0x19
       address:
         EU: 0x22BE7F4
@@ -158,6 +168,13 @@ overlay10:
 
         r0: anim_id
         return: GetEffectAnimation(anim_id)->field_0x19.
+    - name: ScreenEffectActive
+      address:
+        EU: 0x22C0228
+      description: |-
+        Returns true if a screen effect (like Leaf Storm's or cutscene rain) is currently active on the given screen.
+
+        r0: screen
     - name: AnimationHasMoreFrames
       address:
         EU: 0x22C0244
@@ -289,7 +306,7 @@ overlay10:
       description: |-
         Appears to populate the Lv./HP row in the "Team stats" top screen.
 
-        r0: index of some kind
+        r0: window id
     - name: ProcessTeamStatsNameGender
       address:
         EU: 0x22C21BC
@@ -298,7 +315,7 @@ overlay10:
       description: |-
         Appears to populate the name/gender row in the "Team stats" top screen.
 
-        r0: index of some kind
+        r0: window id
     - name: IsBackgroundTileset
       address:
         EU: 0x22C2ECC