pmdsky-debug-py 5.1.5__py3-none-any.whl → 5.1.7__py3-none-any.whl

pmdsky_debug_py/jp_itcm.py

@@ -3185,8 +3185,8 @@ class JpItcmArm9Functions:
         None,
         None,
         (
-            "Note: unverified, ported from Irdkwia's notes\n\nr0: dbox_id\nr1:"
-            " portrait_ptr"
+            "Note: unverified, ported from Irdkwia's notes\n\nr0: dbox_id\nr1: portrait"
+            " box pointer"
         ),
     )
 
@@ -3807,13 +3807,20 @@ class JpItcmArm9Functions:
         ),
     )
 
-    SetPortraitMonsterId = Symbol(
+    InitPortraitBox = Symbol(
+        None,
+        None,
+        None,
+        "Initializes a struct portrait_box.\n\nr0: portrait box pointer",
+    )
+
+    InitPortraitBoxWithMonsterId = Symbol(
         None,
         None,
         None,
         (
-            "Note: unverified, ported from Irdkwia's notes\n\nr0: portrait_ptr\nr1:"
-            " monster ID"
+            "Note: unverified, ported from Irdkwia's notes\n\nr0: portrait box"
+            " pointer\nr1: monster ID"
         ),
     )
 
@@ -3822,8 +3829,8 @@ class JpItcmArm9Functions:
         None,
         None,
         (
-            "Note: unverified, ported from Irdkwia's notes\n\nr0: portrait_ptr\nr1:"
-            " expression_id"
+            "Note: unverified, ported from Irdkwia's notes\n\nr0: portrait box"
+            " pointer\nr1: expression_id"
         ),
     )
 
@@ -3831,7 +3838,10 @@ class JpItcmArm9Functions:
         None,
         None,
         None,
-        "Note: unverified, ported from Irdkwia's notes\n\nr0: portrait_ptr\nr1: attr",
+        (
+            "Note: unverified, ported from Irdkwia's notes\n\nr0: portrait box"
+            " pointer\nr1: attr"
+        ),
     )
 
     SetPortraitAttrStruct = Symbol(
@@ -3839,8 +3849,8 @@ class JpItcmArm9Functions:
         None,
         None,
         (
-            "Note: unverified, ported from Irdkwia's notes\n\nr0: portrait_ptr\nr1:"
-            " attr_ptr"
+            "Note: unverified, ported from Irdkwia's notes\n\nr0: portrait box"
+            " pointer\nr1: attr_ptr"
         ),
     )
 
@@ -3850,7 +3860,7 @@ class JpItcmArm9Functions:
         None,
         (
             "If buffer_portrait is null, it only checks if it exists\n\nNote:"
-            " unverified, ported from Irdkwia's notes\n\nr0: portrait_ptr\nr1:"
+            " unverified, ported from Irdkwia's notes\n\nr0: portrait box pointer\nr1:"
             " buffer_portrait\nreturn: exists"
         ),
     )
@@ -5004,7 +5014,7 @@ class JpItcmArm9Functions:
         None, None, None, "Note: unverified, ported from Irdkwia's notes\n\nNo params."
     )
 
-    IsNotNickname = Symbol(
+    StrcmpMonsterName = Symbol(
         None,
         None,
         None,
@@ -5285,93 +5295,186 @@ class JpItcmArm9Functions:
         "Note: unverified, ported from Irdkwia's notes\n\nr0: recruit_str",
     )
 
-    GetMember = Symbol(
+    IsValidTeamMember = Symbol(
         None,
         None,
         None,
-        "Note: unverified, ported from Irdkwia's notes\n\nr0: member_idx\nreturn: ?",
+        (
+            "Returns whether or not the team member at the given index is valid for the"
+            " current game mode.\n\nDuring normal play, this will only be false for the"
+            " special-episode-reserved indexes (2, 3, 4). During special episodes, this"
+            " will be false for the hero and partner (0, 1).\n\nr0: team member"
+            " index\nreturn: bool"
+        ),
     )
 
-    GetHeroStrIdIfExists = Symbol(
-        None, None, None, "Note: unverified, ported from Irdkwia's notes\n\nreturn: ?"
+    IsMainCharacter = Symbol(
+        None,
+        None,
+        None,
+        (
+            "Returns whether or not the team member at the given index is a 'main"
+            " character'.\n\nDuring normal play, this will only be true for the hero"
+            " and partner (0, 1). During special episodes, this will be true for the"
+            " special-episode-reserved indexes (2, 3, 4).\n\nr0: team member"
+            " index\nreturn: bool"
+        ),
     )
 
-    GetPartnerStrIdIfExists = Symbol(
-        None, None, None, "Note: unverified, ported from Irdkwia's notes\n\nreturn: ?"
+    GetTeamMember = Symbol(
+        None,
+        None,
+        None,
+        (
+            "Gets the team member at the given index.\n\nr0: team member index\nreturn:"
+            " ground monster pointer"
+        ),
     )
 
-    GetFirstTeamMemberStrIdIfExists = Symbol(
-        None, None, None, "Note: unverified, ported from Irdkwia's notes\n\nreturn: ?"
+    GetHeroMemberIdx = Symbol(
+        None,
+        None,
+        None,
+        (
+            "Returns the team member index of the hero (0) if the hero is valid,"
+            " otherwise return -1.\n\nreturn: team member index"
+        ),
     )
 
-    GetSecondTeamMemberStrIdIfExists = Symbol(
-        None, None, None, "Note: unverified, ported from Irdkwia's notes\n\nreturn: ?"
+    GetPartnerMemberIdx = Symbol(
+        None,
+        None,
+        None,
+        (
+            "Returns the team member index of the partner (1) if the partner is valid,"
+            " otherwise return -1.\n\nreturn: team member index"
+        ),
     )
 
-    GetThirdTeamMemberStrIdIfExists = Symbol(
-        None, None, None, "Note: unverified, ported from Irdkwia's notes\n\nreturn: ?"
+    GetMainCharacter1MemberIdx = Symbol(
+        None,
+        None,
+        None,
+        (
+            "Returns the team member index of the first main character for the given"
+            " game mode, if valid, otherwise return -1.\n\nIn normal play, this will be"
+            " the hero (0). During special episodes, this will be 2.\n\nreturn: team"
+            " member index"
+        ),
     )
 
-    GetHeroData = Symbol(
+    GetMainCharacter2MemberIdx = Symbol(
         None,
         None,
         None,
         (
-            "Returns the ground monster data of the hero (first slot in Chimecho"
-            " Assembly)\n\nreturn: Monster data"
+            "Returns the team member index of the second main character for the given"
+            " game mode, if valid, otherwise return -1.\n\nIn normal play, this will be"
+            " the partner (1). During special episodes, this will be 3 if there's a"
+            " second main character.\n\nreturn: team member index"
         ),
     )
 
-    GetPartnerData = Symbol(
+    GetMainCharacter3MemberIdx = Symbol(
         None,
         None,
         None,
         (
-            "Returns the ground monster data of the partner (second slot in Chimecho"
-            " Assembly)\n\nreturn: Monster data"
+            "Returns the team member index of the third main character for the given"
+            " game mode, if valid, otherwise return -1.\n\nIn normal play, this will be"
+            " invalid (-1). During special episodes, this will be 4 if there's a third"
+            " main character.\n\nreturn: team member index"
         ),
     )
 
-    GetFirstTeamMemberData = Symbol(
+    GetHero = Symbol(
         None,
         None,
         None,
-        "Note: unverified, ported from Irdkwia's notes\n\nreturn: Monster data",
+        (
+            "Returns the ground monster data of the hero.\n\nreturn: ground monster"
+            " pointer"
+        ),
     )
 
-    GetSecondTeamMemberData = Symbol(
+    GetPartner = Symbol(
         None,
         None,
         None,
-        "Note: unverified, ported from Irdkwia's notes\n\nreturn: Monster data",
+        (
+            "Returns the ground monster data of the partner.\n\nreturn: ground monster"
+            " pointer"
+        ),
     )
 
-    GetThirdTeamMemberData = Symbol(
+    GetMainCharacter1 = Symbol(
         None,
         None,
         None,
-        "Note: unverified, ported from Irdkwia's notes\n\nreturn: Monster data",
+        (
+            "Returns the ground monster data of the first main character for the given"
+            " game mode.\n\nIn normal play, this will be the hero. During special"
+            " episodes, this will be the first special episode main character (index"
+            " 2).\n\nreturn: ground monster pointer"
+        ),
     )
 
-    GetFirstEmptyRecruitSlot = Symbol(
+    GetMainCharacter2 = Symbol(
         None,
         None,
         None,
         (
-            "Returns -1 if there is none\n\nNote: unverified, ported from Irdkwia's"
-            " notes\n\nr0: ?\nreturn: ?"
+            "Returns the ground monster data of the second main character for the given"
+            " game mode, or null if invalid.\n\nIn normal play, this will be the"
+            " partner. During special episodes, this will be the second special episode"
+            " main character (index 3) if one is present.\n\nreturn: ground monster"
+            " pointer"
         ),
     )
 
-    CheckTeamMemberField8 = Symbol(
+    GetMainCharacter3 = Symbol(
         None,
         None,
         None,
         (
-            "Checks if a value obtained from team_member::field_0x8 is equal to certain"
-            " values.\n\nThis is known to return true for some or all of the guest"
-            " monsters.\n\nr0: Value read from team_member::field_0x8\nreturn: True if"
-            " the value is equal to 0x55AA or 0x5AA5"
+            "Returns the ground monster data of the third main character for the given"
+            " game mode, or null if invalid.\n\nIn normal play, this will be null."
+            " During special episodes, this will be the third special episode main"
+            " character (index 4) if one is present.\n\nreturn: ground monster pointer"
+        ),
+    )
+
+    GetFirstEmptyMemberIdx = Symbol(
+        None,
+        None,
+        None,
+        (
+            "Gets the first unoccupied team member index (in the Chimecho Assembly), or"
+            " -1 if there is none.\n\nIf valid, this will always be at least 5, since"
+            " indexes 0-4 are reserved for main characters.\n\nr0: ?\nreturn: team"
+            " member index of the first available slot"
+        ),
+    )
+
+    IsMonsterNotNicknamed = Symbol(
+        None,
+        None,
+        None,
+        (
+            "Checks if the string_buffer matches the name of the species\n\nr0: ground"
+            " monster pointer\nreturn: bool"
+        ),
+    )
+
+    CheckTeamMemberIdx = Symbol(
+        None,
+        None,
+        None,
+        (
+            "Checks if a team member's member index (team_member::member_idx) is equal"
+            " to certain values.\n\nThis is known to return true for some or all of the"
+            " guest monsters.\n\nr0: member index\nreturn: True if the value is equal"
+            " to 0x55AA or 0x5AA5"
         ),
     )
 
@@ -5386,25 +5489,32 @@ class JpItcmArm9Functions:
         ),
     )
 
-    GetTeamMemberData = Symbol(
+    SetActiveTeam = Symbol(
+        None,
+        None,
+        None,
+        "Sets the specified team to active in TEAM_MEMBER_TABLE.\n\nr0: team ID",
+    )
+
+    GetActiveTeamMember = Symbol(
         None,
         None,
         None,
         (
-            "Returns a struct containing information about a team member.\n\nIrdkwia's"
-            " notes (note the discrepancy): GetEquivalentTeamID\n  r0: str_id\n "
-            " return: team_id, -1 if not in team\n\nr0: Index\nreturn: Pointer to"
-            " struct containing team member information"
+            "Returns a struct containing information about the active team member in"
+            " the given slot index.\n\nr0: roster index\nreturn: team member pointer,"
+            " or null if index is -1"
         ),
     )
 
-    GetTeamMember = Symbol(
+    GetActiveRosterIndex = Symbol(
         None,
         None,
         None,
         (
-            "Null pointer if -1\n\nNote: unverified, ported from Irdkwia's notes\n\nr0:"
-            " team_id\nreturn: team member"
+            "Searches for the roster index for the given team member within the current"
+            " active roster.\n\nr0: team member index\nreturn: roster index if the team"
+            " member is active, -1 otherwise"
         ),
     )
 
@@ -7568,7 +7678,12 @@ class JpItcmArm9Data:
         ),
     )
 
-    GAME_MODE = Symbol(None, None, None, "[Runtime]\n\ntype: uint8_t")
+    GAME_MODE = Symbol(
+        None,
+        None,
+        None,
+        "[Runtime] Game mode, see enum game_mode for possible values.\n\ntype: uint8_t",
+    )
 
     GLOBAL_PROGRESS_PTR = Symbol(
         None, None, None, "[Runtime]\n\ntype: struct global_progress*"
@@ -7595,9 +7710,7 @@ class JpItcmArm9Data:
         ),
     )
 
-    PARTY_MONSTERS_PTR = Symbol(
-        None, None, None, "Note: unverified, ported from Irdkwia's notes"
-    )
+    TEAM_MEMBER_TABLE_PTR = Symbol(None, None, None, "Pointer to TEAM_MEMBER_TABLE")
 
     MISSION_LIST_PTR = Symbol(
         None, None, None, "Note: unverified, ported from Irdkwia's notes"
@@ -17240,6 +17353,28 @@ class JpItcmOverlay29Functions:
         ),
     )
 
+    EndSleepClassStatus = Symbol(
+        None,
+        None,
+        None,
+        (
+            "Cures the target's sleep, sleepless, nightmare, yawn or napping status due"
+            " to the action of the user, and prints the event to the log.\n\nr0:"
+            " pointer to user\nr1: pointer to target"
+        ),
+    )
+
+    EndBurnClassStatus = Symbol(
+        None,
+        None,
+        None,
+        (
+            "Cures the target's burned, poisoned, badly poisoned or paralysis status"
+            " due to the action of the user, and prints the event to the log.\n\nr0:"
+            " pointer to user\nr1: pointer to target"
+        ),
+    )
+
     EndFrozenClassStatus = Symbol(
         None,
         None,
@@ -17263,6 +17398,74 @@ class JpItcmOverlay29Functions:
         ),
     )
 
+    EndReflectClassStatus = Symbol(
+        None,
+        None,
+        None,
+        (
+            "Removes the target's reflect, safeguard, light screen, counter, magic"
+            " coat, wish, protect, mirror coat, endure, mini counter?, mirror move,"
+            " conversion 2, vital throw, mist, metal burst, aqua ring or lucky chant"
+            " status due to the action of the user, and prints the event to the"
+            " log.\n\nr0: pointer to user\nr1: pointer to target"
+        ),
+    )
+
+    EndLeechSeedClassStatus = Symbol(
+        None,
+        None,
+        None,
+        (
+            "Cures the target's leech seed or destiny bond status due to the action of"
+            " the user, and prints the event to the log.\n\nr0: pointer to user\nr1:"
+            " pointer to target"
+        ),
+    )
+
+    EndSureShotClassStatus = Symbol(
+        None,
+        None,
+        None,
+        (
+            "Removes the target's sure shot, whiffer, set damage or focus energy status"
+            " due to the action of the user, and prints the event to the log.\n\nr0:"
+            " pointer to user\nr1: pointer to target"
+        ),
+    )
+
+    EndMuzzledStatus = Symbol(
+        None,
+        None,
+        None,
+        (
+            "Removes the target's muzzled status due to the action of the user, and"
+            " prints the event to the log.\n\nr0: pointer to user\nr1: pointer to"
+            " target"
+        ),
+    )
+
+    EndMiracleEyeStatus = Symbol(
+        None,
+        None,
+        None,
+        (
+            "Removes the target's miracle eye status due to the action of the user, and"
+            " prints the event to the log.\n\nr0: pointer to user\nr1: pointer to"
+            " target"
+        ),
+    )
+
+    EndMagnetRiseStatus = Symbol(
+        None,
+        None,
+        None,
+        (
+            "Removes the target's magnet rise status due to the action of the user, and"
+            " prints the event to the log.\n\nr0: pointer to user\nr1: pointer to"
+            " target"
+        ),
+    )
+
     TryTriggerMonsterHouse = Symbol(
         None,
         None,
@@ -21786,7 +21989,9 @@ class JpItcmOverlay31Data:
         None, None, None, "Note: unverified, ported from Irdkwia's notes"
     )
 
-    OVERLAY31_JP_STRING = Symbol(None, None, None, "\n\n----　 初期ポジション=%d　----- \n")
+    OVERLAY31_JP_STRING = Symbol(
+        None, None, None, "\n\n----　 初期ポジション=%d　----- \n"
+    )
 
     DUNGEON_D_BOX_LAYOUT_14 = Symbol(
         None, None, None, "Note: unverified, ported from Irdkwia's notes"
@@ -22414,32 +22619,15 @@ class JpItcmRamData:
         ),
     )
 
-    TEAM_MEMBER_LIST = Symbol(
-        None,
-        None,
-        None,
-        (
-            "List of all team members and persistent information about them.\n\nAppears"
-            " to be ordered in chronological order of recruitment. The first five"
-            " entries appear to be fixed:\n  1. Hero\n  2. Partner\n  3. Grovyle\n  4."
-            " Dusknoir\n  5. Celebi\nSubsequent entries are normal recruits.\n\nIf a"
-            " member is released, all subsequent members will be shifted up (so there"
-            " should be no gaps in the list).\n\ntype: struct ground_monster[555]"
-        ),
-    )
-
-    TEAM_ACTIVE_ROSTER = Symbol(
+    TEAM_MEMBER_TABLE = Symbol(
         None,
         None,
         None,
         (
-            "List of all currently active team members and relevant information about"
-            " them.\n\nListed in team order. The first four entries correspond to the"
-            " team in normal modes of play. The last three entries are always for"
-            " Grovyle, Dusknoir, and Celebi (in that order).\n\nThis struct is updated"
-            " relatively infrequently. For example, in dungeon mode, it's typically"
-            " only updated at the start of the floor; refer to DUNGEON_STRUCT instead"
-            " for live data.\n\ntype: struct team_member[7]"
+            "Table with all team members, persistent information about them, and"
+            " information about which ones are currently active.\n\nSee the comments on"
+            " struct team_member_table for more information.\n\ntype: struct"
+            " team_member_table"
         ),
     )