pmdsky-debug-py 10.0.46__py3-none-any.whl → 10.0.48__py3-none-any.whl

pmdsky_debug_py/_release.py

@@ -1 +1 @@
-RELEASE = "v0.10.0+d562c4b8ff"
+RELEASE = "v0.10.0+4ad2cab8ca"

pmdsky_debug_py/eu.py

@@ -855,6 +855,15 @@ class EuArm9Functions:
         None,
     )
 
+    GetDsFirmwareUserSettingsVeneer = Symbol(
+        [0x4F74],
+        [0x2004F74],
+        None,
+        "GetDsFirmwareUserSettingsVeneer",
+        "Likely a linker-generated veneer for GetDsFirmwareUserSettings.\n\nSee https://developer.arm.com/documentation/dui0474/k/image-structure-and-generation/linker-generated-veneers/what-is-a-veneer-\n\nr0: user_settings pointer",
+        None,
+    )
+
     Rgb8ToRgb5 = Symbol(
         [0x4FCC],
         [0x2004FCC],
@@ -918,6 +927,33 @@ class EuArm9Functions:
         None,
     )
 
+    DebugPrintSystemClock = Symbol(
+        [0x6EF8],
+        [0x2006EF8],
+        None,
+        "DebugPrintSystemClock",
+        "This function prints the debug message 'Now date & time' followed by the current date and time of the DS system clock. Called on boot.\n\nNo params.",
+        None,
+    )
+
+    GetSystemClock = Symbol(
+        [0x6F68],
+        [0x2006F68],
+        None,
+        "GetSystemClock",
+        "Gets information surrounding the DS system clock, such as the current month, day, etc.\n\nr0: system_clock pointer",
+        None,
+    )
+
+    SprintfSystemClock = Symbol(
+        [0x6FB8],
+        [0x2006FB8],
+        None,
+        "SprintfSystemClock",
+        "Calls sprintf to format a string using the fields of the DS system clock as 'year/month/day hour:minute:second'. Used in DebugPrintSystemClock.\n\nr0: system_clock pointer\nr1: str",
+        None,
+    )
+
     DataTransferInit = Symbol(
         [0x8168],
         [0x2008168],
@@ -4417,6 +4453,15 @@ class EuArm9Functions:
         None,
     )
 
+    GetCharWidth = Symbol(
+        [0x26830],
+        [0x2026830],
+        None,
+        "GetCharWidth",
+        "Gets the width of a text char.\n\nr0: char\nreturn: char width",
+        None,
+    )
+
     GetColorCodePaletteOffset = Symbol(
         [0x268A8],
         [0x20268A8],
@@ -4426,6 +4471,15 @@ class EuArm9Functions:
         None,
     )
 
+    DrawChar = Symbol(
+        [0x26A50],
+        [0x2026A50],
+        None,
+        "DrawChar",
+        "Draws a single char within a window. This function is also responsible for drawing the shadows of a char.\n\nr0: window_id\nr1: x offset within window\nr2: y offset within window\nr3: char\nstack[0]: color offset\nreturn: char width",
+        None,
+    )
+
     GetWindow = Symbol(
         [0x278EC],
         [0x20278EC],
@@ -4971,7 +5025,7 @@ class EuArm9Functions:
         [0x202D4E4],
         None,
         "CreateOptionsMenu",
-        "Creates a window containing a menu controlling game options. Also see struct options_menu.\n\nThis is used for the options and window options menus, among other things.\n\nIf window_params is NULL, OPTIONS_MENU_DEFAULT_WINDOW_PARAMS will be used. Otherwise, it will be copied onto the window, ignoring the update and contents fields. If window_params::width and/or window_params::height are 0, they will be computed based on the contained text.\n\nIf window_extra_info is non-NULL, it will be copied onto the window. Note that window_extra_info can only be NULL if there are no window_flags set that require extra info.\n\nr0: window_params\nr1: window_flags\nr2: window_extra_info pointer\nr3: options_menu_id_item struct array, terminated with an item with msg_id 0\nstack[0]: number of items\nstack[1]: ?\nreturn: window_id",
+        "Creates a window containing a menu controlling game options. Also see struct options_menu.\n\nThis is used for the options and window options menus, among other things.\n\nIf window_params is NULL, OPTIONS_MENU_DEFAULT_WINDOW_PARAMS will be used. Otherwise, it will be copied onto the window, ignoring the update and contents fields. If window_params::width and/or window_params::height are 0, they will be computed based on the contained text.\n\nIf window_extra_info is non-NULL, it will be copied onto the window. Note that window_extra_info can only be NULL if there are no window_flags set that require extra info.\n\nr0: window_params\nr1: window_flags\nr2: window_extra_info pointer\nr3: options_menu_id_item struct array, terminated with an item with msg_id 0\nstack[0]: number of items\nstack[1]: option_states pointer\nreturn: window_id",
         None,
     )
 
@@ -5002,6 +5056,24 @@ class EuArm9Functions:
         None,
     )
 
+    GetOptionsMenuStates = Symbol(
+        [0x2D8A4],
+        [0x202D8A4],
+        None,
+        "GetOptionsMenuStates",
+        "Gets all the option menu states; used to determine what options the user has selected in a menu. Each option state corresponds a options_menu_id_item.\n\nr0: window_id\nr1: option_states pointer",
+        None,
+    )
+
+    GetOptionsMenuResult = Symbol(
+        [0x2D8D8],
+        [0x202D8D8],
+        None,
+        "GetOptionsMenuResult",
+        "Returns whether or not the options menu was confirmed or canceled (e.g., by pressing the B button).\n\nr0: window_id\nreturn: bool",
+        None,
+    )
+
     UpdateOptionsMenu = Symbol(
         [0x2D90C],
         [0x202D90C],
@@ -12751,6 +12823,15 @@ class EuLibsFunctions:
         None,
     )
 
+    GetDsFirmwareUserSettings = Symbol(
+        [0xF930],
+        [0x207BDA0],
+        None,
+        "GetDsFirmwareUserSettings",
+        "Gets the user settings of the DS firmware.\n\nSee https://problemkaputt.de/gbatek.htm#dsfirmwareusersettings\n\nr0: user_settings pointer",
+        None,
+    )
+
     CountLeadingZeros = Symbol(
         [0xF9B4],
         [0x207BE24],
@@ -22679,7 +22760,7 @@ class EuOverlay29Functions:
         [0x22E1F68],
         None,
         "GetTileAtEntity",
-        "Returns a pointer to the tile where an entity is located.\n\nr0: pointer to entity\nreturns: pointer to tile",
+        "Returns a pointer to the tile where an entity is located.\n\nr0: pointer to entity\nreturn: pointer to tile",
         None,
     )
 
@@ -24661,7 +24742,7 @@ class EuOverlay29Functions:
         [0x2300988],
         None,
         "GetNumberOfAttacks",
-        "Returns the number of attacks that a monster can do in one turn (1 or 2).\n\nChecks for the abilities Swift Swim, Chlorophyll, Unburden, and for exclusive items.\n\nr0: pointer to entity\nreturns: int",
+        "Returns the number of attacks that a monster can do in one turn (1 or 2).\n\nChecks for the abilities Swift Swim, Chlorophyll, Unburden, and for exclusive items.\n\nr0: pointer to entity\nreturn: int",
         None,
     )
 
@@ -25192,7 +25273,7 @@ class EuOverlay29Functions:
         [0x2305A0C],
         None,
         "DisplayActions",
-        "Graphically displays any pending actions that have happened but haven't been shown on screen yet. All actions are displayed at the same time. For example, this delayed display system is used to display multiple monsters moving at once even though they take turns sequentially.\n\nr0: Pointer to an entity. Can be null.\nreturns: Seems to be true if there were any pending actions to display.",
+        "Graphically displays any pending actions that have happened but haven't been shown on screen yet. All actions are displayed at the same time. For example, this delayed display system is used to display multiple monsters moving at once even though they take turns sequentially.\n\nr0: Pointer to an entity. Can be null.\nreturn: Seems to be true if there were any pending actions to display.",
         None,
     )
 
@@ -27199,7 +27280,7 @@ class EuOverlay29Functions:
         [0x23246B0],
         None,
         "MoveHitCheck",
-        "Determines if a move used hits or misses the target. It gets called twice per target, once with r3 = false and a second time with r3 = true.\n\nr0: Attacker\nr1: Defender\nr2: Pointer to move data\nr3: False if the move's first accuracy (accuracy1) should be used, true if its second accuracy (accuracy2) should be used instead.\nstack[0]: If true, always hit if the attacker and defender are the same. Otherwise, moves can miss no matter what the attacker and defender are.\nreturns: True if the move hits, false if it misses.",
+        "Determines if a move used hits or misses the target. It gets called twice per target, once with r3 = false and a second time with r3 = true.\n\nr0: Attacker\nr1: Defender\nr2: Pointer to move data\nr3: False if the move's first accuracy (accuracy1) should be used, true if its second accuracy (accuracy2) should be used instead.\nstack[0]: If true, always hit if the attacker and defender are the same. Otherwise, moves can miss no matter what the attacker and defender are.\nreturn: True if the move hits, false if it misses.",
         None,
     )
 
@@ -27253,7 +27334,7 @@ class EuOverlay29Functions:
         [0x232539C],
         None,
         "DungeonRandOutcomeUserTargetInteraction",
-        "Like DungeonRandOutcome, but specifically for user-target interactions.\n\nThis modifies the underlying random process depending on factors like Serene Grace, and whether or not either entity has fainted.\n\nr0: user entity pointer\nr1: target entity pointer\nr2: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturns: True if the random check passed, false otherwise.",
+        "Like DungeonRandOutcome, but specifically for user-target interactions.\n\nThis modifies the underlying random process depending on factors like Serene Grace, and whether or not either entity has fainted.\n\nr0: user entity pointer\nr1: target entity pointer\nr2: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturn: True if the random check passed, false otherwise.",
         None,
     )
 
@@ -27262,7 +27343,7 @@ class EuOverlay29Functions:
         [0x2325488],
         None,
         "DungeonRandOutcomeUserAction",
-        "Like DungeonRandOutcome, but specifically for user actions.\n\nThis modifies the underlying random process to factor in Serene Grace (and checks whether the user is a valid entity).\n\nr0: entity pointer\nr1: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturns: True if the random check passed, false otherwise.",
+        "Like DungeonRandOutcome, but specifically for user actions.\n\nThis modifies the underlying random process to factor in Serene Grace (and checks whether the user is a valid entity).\n\nr0: entity pointer\nr1: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturn: True if the random check passed, false otherwise.",
         None,
     )
 

pmdsky_debug_py/eu_itcm.py

@@ -843,6 +843,15 @@ class EuItcmArm9Functions:
         None,
     )
 
+    GetDsFirmwareUserSettingsVeneer = Symbol(
+        None,
+        None,
+        None,
+        "GetDsFirmwareUserSettingsVeneer",
+        "Likely a linker-generated veneer for GetDsFirmwareUserSettings.\n\nSee https://developer.arm.com/documentation/dui0474/k/image-structure-and-generation/linker-generated-veneers/what-is-a-veneer-\n\nr0: user_settings pointer",
+        None,
+    )
+
     Rgb8ToRgb5 = Symbol(
         None,
         None,
@@ -906,6 +915,33 @@ class EuItcmArm9Functions:
         None,
     )
 
+    DebugPrintSystemClock = Symbol(
+        None,
+        None,
+        None,
+        "DebugPrintSystemClock",
+        "This function prints the debug message 'Now date & time' followed by the current date and time of the DS system clock. Called on boot.\n\nNo params.",
+        None,
+    )
+
+    GetSystemClock = Symbol(
+        None,
+        None,
+        None,
+        "GetSystemClock",
+        "Gets information surrounding the DS system clock, such as the current month, day, etc.\n\nr0: system_clock pointer",
+        None,
+    )
+
+    SprintfSystemClock = Symbol(
+        None,
+        None,
+        None,
+        "SprintfSystemClock",
+        "Calls sprintf to format a string using the fields of the DS system clock as 'year/month/day hour:minute:second'. Used in DebugPrintSystemClock.\n\nr0: system_clock pointer\nr1: str",
+        None,
+    )
+
     DataTransferInit = Symbol(
         None,
         None,
@@ -4371,6 +4407,15 @@ class EuItcmArm9Functions:
         None,
     )
 
+    GetCharWidth = Symbol(
+        None,
+        None,
+        None,
+        "GetCharWidth",
+        "Gets the width of a text char.\n\nr0: char\nreturn: char width",
+        None,
+    )
+
     GetColorCodePaletteOffset = Symbol(
         None,
         None,
@@ -4380,6 +4425,15 @@ class EuItcmArm9Functions:
         None,
     )
 
+    DrawChar = Symbol(
+        None,
+        None,
+        None,
+        "DrawChar",
+        "Draws a single char within a window. This function is also responsible for drawing the shadows of a char.\n\nr0: window_id\nr1: x offset within window\nr2: y offset within window\nr3: char\nstack[0]: color offset\nreturn: char width",
+        None,
+    )
+
     GetWindow = Symbol(
         None,
         None,
@@ -4925,7 +4979,7 @@ class EuItcmArm9Functions:
         None,
         None,
         "CreateOptionsMenu",
-        "Creates a window containing a menu controlling game options. Also see struct options_menu.\n\nThis is used for the options and window options menus, among other things.\n\nIf window_params is NULL, OPTIONS_MENU_DEFAULT_WINDOW_PARAMS will be used. Otherwise, it will be copied onto the window, ignoring the update and contents fields. If window_params::width and/or window_params::height are 0, they will be computed based on the contained text.\n\nIf window_extra_info is non-NULL, it will be copied onto the window. Note that window_extra_info can only be NULL if there are no window_flags set that require extra info.\n\nr0: window_params\nr1: window_flags\nr2: window_extra_info pointer\nr3: options_menu_id_item struct array, terminated with an item with msg_id 0\nstack[0]: number of items\nstack[1]: ?\nreturn: window_id",
+        "Creates a window containing a menu controlling game options. Also see struct options_menu.\n\nThis is used for the options and window options menus, among other things.\n\nIf window_params is NULL, OPTIONS_MENU_DEFAULT_WINDOW_PARAMS will be used. Otherwise, it will be copied onto the window, ignoring the update and contents fields. If window_params::width and/or window_params::height are 0, they will be computed based on the contained text.\n\nIf window_extra_info is non-NULL, it will be copied onto the window. Note that window_extra_info can only be NULL if there are no window_flags set that require extra info.\n\nr0: window_params\nr1: window_flags\nr2: window_extra_info pointer\nr3: options_menu_id_item struct array, terminated with an item with msg_id 0\nstack[0]: number of items\nstack[1]: option_states pointer\nreturn: window_id",
         None,
     )
 
@@ -4956,6 +5010,24 @@ class EuItcmArm9Functions:
         None,
     )
 
+    GetOptionsMenuStates = Symbol(
+        None,
+        None,
+        None,
+        "GetOptionsMenuStates",
+        "Gets all the option menu states; used to determine what options the user has selected in a menu. Each option state corresponds a options_menu_id_item.\n\nr0: window_id\nr1: option_states pointer",
+        None,
+    )
+
+    GetOptionsMenuResult = Symbol(
+        None,
+        None,
+        None,
+        "GetOptionsMenuResult",
+        "Returns whether or not the options menu was confirmed or canceled (e.g., by pressing the B button).\n\nr0: window_id\nreturn: bool",
+        None,
+    )
+
     UpdateOptionsMenu = Symbol(
         None,
         None,
@@ -12510,6 +12582,15 @@ class EuItcmLibsFunctions:
         None,
     )
 
+    GetDsFirmwareUserSettings = Symbol(
+        None,
+        None,
+        None,
+        "GetDsFirmwareUserSettings",
+        "Gets the user settings of the DS firmware.\n\nSee https://problemkaputt.de/gbatek.htm#dsfirmwareusersettings\n\nr0: user_settings pointer",
+        None,
+    )
+
     CountLeadingZeros = Symbol(
         None,
         None,
@@ -22178,7 +22259,7 @@ class EuItcmOverlay29Functions:
         None,
         None,
         "GetTileAtEntity",
-        "Returns a pointer to the tile where an entity is located.\n\nr0: pointer to entity\nreturns: pointer to tile",
+        "Returns a pointer to the tile where an entity is located.\n\nr0: pointer to entity\nreturn: pointer to tile",
         None,
     )
 
@@ -24086,7 +24167,7 @@ class EuItcmOverlay29Functions:
         None,
         None,
         "GetNumberOfAttacks",
-        "Returns the number of attacks that a monster can do in one turn (1 or 2).\n\nChecks for the abilities Swift Swim, Chlorophyll, Unburden, and for exclusive items.\n\nr0: pointer to entity\nreturns: int",
+        "Returns the number of attacks that a monster can do in one turn (1 or 2).\n\nChecks for the abilities Swift Swim, Chlorophyll, Unburden, and for exclusive items.\n\nr0: pointer to entity\nreturn: int",
         None,
     )
 
@@ -24617,7 +24698,7 @@ class EuItcmOverlay29Functions:
         None,
         None,
         "DisplayActions",
-        "Graphically displays any pending actions that have happened but haven't been shown on screen yet. All actions are displayed at the same time. For example, this delayed display system is used to display multiple monsters moving at once even though they take turns sequentially.\n\nr0: Pointer to an entity. Can be null.\nreturns: Seems to be true if there were any pending actions to display.",
+        "Graphically displays any pending actions that have happened but haven't been shown on screen yet. All actions are displayed at the same time. For example, this delayed display system is used to display multiple monsters moving at once even though they take turns sequentially.\n\nr0: Pointer to an entity. Can be null.\nreturn: Seems to be true if there were any pending actions to display.",
         None,
     )
 
@@ -26624,7 +26705,7 @@ class EuItcmOverlay29Functions:
         None,
         None,
         "MoveHitCheck",
-        "Determines if a move used hits or misses the target. It gets called twice per target, once with r3 = false and a second time with r3 = true.\n\nr0: Attacker\nr1: Defender\nr2: Pointer to move data\nr3: False if the move's first accuracy (accuracy1) should be used, true if its second accuracy (accuracy2) should be used instead.\nstack[0]: If true, always hit if the attacker and defender are the same. Otherwise, moves can miss no matter what the attacker and defender are.\nreturns: True if the move hits, false if it misses.",
+        "Determines if a move used hits or misses the target. It gets called twice per target, once with r3 = false and a second time with r3 = true.\n\nr0: Attacker\nr1: Defender\nr2: Pointer to move data\nr3: False if the move's first accuracy (accuracy1) should be used, true if its second accuracy (accuracy2) should be used instead.\nstack[0]: If true, always hit if the attacker and defender are the same. Otherwise, moves can miss no matter what the attacker and defender are.\nreturn: True if the move hits, false if it misses.",
         None,
     )
 
@@ -26678,7 +26759,7 @@ class EuItcmOverlay29Functions:
         None,
         None,
         "DungeonRandOutcomeUserTargetInteraction",
-        "Like DungeonRandOutcome, but specifically for user-target interactions.\n\nThis modifies the underlying random process depending on factors like Serene Grace, and whether or not either entity has fainted.\n\nr0: user entity pointer\nr1: target entity pointer\nr2: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturns: True if the random check passed, false otherwise.",
+        "Like DungeonRandOutcome, but specifically for user-target interactions.\n\nThis modifies the underlying random process depending on factors like Serene Grace, and whether or not either entity has fainted.\n\nr0: user entity pointer\nr1: target entity pointer\nr2: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturn: True if the random check passed, false otherwise.",
         None,
     )
 
@@ -26687,7 +26768,7 @@ class EuItcmOverlay29Functions:
         None,
         None,
         "DungeonRandOutcomeUserAction",
-        "Like DungeonRandOutcome, but specifically for user actions.\n\nThis modifies the underlying random process to factor in Serene Grace (and checks whether the user is a valid entity).\n\nr0: entity pointer\nr1: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturns: True if the random check passed, false otherwise.",
+        "Like DungeonRandOutcome, but specifically for user actions.\n\nThis modifies the underlying random process to factor in Serene Grace (and checks whether the user is a valid entity).\n\nr0: entity pointer\nr1: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturn: True if the random check passed, false otherwise.",
         None,
     )
 

pmdsky_debug_py/jp.py

@@ -855,6 +855,15 @@ class JpArm9Functions:
         None,
     )
 
+    GetDsFirmwareUserSettingsVeneer = Symbol(
+        [0x4F74],
+        [0x2004F74],
+        None,
+        "GetDsFirmwareUserSettingsVeneer",
+        "Likely a linker-generated veneer for GetDsFirmwareUserSettings.\n\nSee https://developer.arm.com/documentation/dui0474/k/image-structure-and-generation/linker-generated-veneers/what-is-a-veneer-\n\nr0: user_settings pointer",
+        None,
+    )
+
     Rgb8ToRgb5 = Symbol(
         [0x4FCC],
         [0x2004FCC],
@@ -918,6 +927,33 @@ class JpArm9Functions:
         None,
     )
 
+    DebugPrintSystemClock = Symbol(
+        [0x6EF8],
+        [0x2006EF8],
+        None,
+        "DebugPrintSystemClock",
+        "This function prints the debug message 'Now date & time' followed by the current date and time of the DS system clock. Called on boot.\n\nNo params.",
+        None,
+    )
+
+    GetSystemClock = Symbol(
+        [0x6F68],
+        [0x2006F68],
+        None,
+        "GetSystemClock",
+        "Gets information surrounding the DS system clock, such as the current month, day, etc.\n\nr0: system_clock pointer",
+        None,
+    )
+
+    SprintfSystemClock = Symbol(
+        [0x6FB8],
+        [0x2006FB8],
+        None,
+        "SprintfSystemClock",
+        "Calls sprintf to format a string using the fields of the DS system clock as 'year/month/day hour:minute:second'. Used in DebugPrintSystemClock.\n\nr0: system_clock pointer\nr1: str",
+        None,
+    )
+
     DataTransferInit = Symbol(
         [0x8168],
         [0x2008168],
@@ -4417,6 +4453,15 @@ class JpArm9Functions:
         None,
     )
 
+    GetCharWidth = Symbol(
+        [0x26624],
+        [0x2026624],
+        None,
+        "GetCharWidth",
+        "Gets the width of a text char.\n\nr0: char\nreturn: char width",
+        None,
+    )
+
     GetColorCodePaletteOffset = Symbol(
         [0x2669C],
         [0x202669C],
@@ -4426,6 +4471,15 @@ class JpArm9Functions:
         None,
     )
 
+    DrawChar = Symbol(
+        [0x26844],
+        [0x2026844],
+        None,
+        "DrawChar",
+        "Draws a single char within a window. This function is also responsible for drawing the shadows of a char.\n\nr0: window_id\nr1: x offset within window\nr2: y offset within window\nr3: char\nstack[0]: color offset\nreturn: char width",
+        None,
+    )
+
     GetWindow = Symbol(
         [0x27940],
         [0x2027940],
@@ -4971,7 +5025,7 @@ class JpArm9Functions:
         [0x202D548],
         None,
         "CreateOptionsMenu",
-        "Creates a window containing a menu controlling game options. Also see struct options_menu.\n\nThis is used for the options and window options menus, among other things.\n\nIf window_params is NULL, OPTIONS_MENU_DEFAULT_WINDOW_PARAMS will be used. Otherwise, it will be copied onto the window, ignoring the update and contents fields. If window_params::width and/or window_params::height are 0, they will be computed based on the contained text.\n\nIf window_extra_info is non-NULL, it will be copied onto the window. Note that window_extra_info can only be NULL if there are no window_flags set that require extra info.\n\nr0: window_params\nr1: window_flags\nr2: window_extra_info pointer\nr3: options_menu_id_item struct array, terminated with an item with msg_id 0\nstack[0]: number of items\nstack[1]: ?\nreturn: window_id",
+        "Creates a window containing a menu controlling game options. Also see struct options_menu.\n\nThis is used for the options and window options menus, among other things.\n\nIf window_params is NULL, OPTIONS_MENU_DEFAULT_WINDOW_PARAMS will be used. Otherwise, it will be copied onto the window, ignoring the update and contents fields. If window_params::width and/or window_params::height are 0, they will be computed based on the contained text.\n\nIf window_extra_info is non-NULL, it will be copied onto the window. Note that window_extra_info can only be NULL if there are no window_flags set that require extra info.\n\nr0: window_params\nr1: window_flags\nr2: window_extra_info pointer\nr3: options_menu_id_item struct array, terminated with an item with msg_id 0\nstack[0]: number of items\nstack[1]: option_states pointer\nreturn: window_id",
         None,
     )
 
@@ -5002,6 +5056,24 @@ class JpArm9Functions:
         None,
     )
 
+    GetOptionsMenuStates = Symbol(
+        [0x2D908],
+        [0x202D908],
+        None,
+        "GetOptionsMenuStates",
+        "Gets all the option menu states; used to determine what options the user has selected in a menu. Each option state corresponds a options_menu_id_item.\n\nr0: window_id\nr1: option_states pointer",
+        None,
+    )
+
+    GetOptionsMenuResult = Symbol(
+        [0x2D93C],
+        [0x202D93C],
+        None,
+        "GetOptionsMenuResult",
+        "Returns whether or not the options menu was confirmed or canceled (e.g., by pressing the B button).\n\nr0: window_id\nreturn: bool",
+        None,
+    )
+
     UpdateOptionsMenu = Symbol(
         [0x2D970],
         [0x202D970],
@@ -12746,6 +12818,15 @@ class JpLibsFunctions:
         None,
     )
 
+    GetDsFirmwareUserSettings = Symbol(
+        [0xF930],
+        [0x207BCF0],
+        None,
+        "GetDsFirmwareUserSettings",
+        "Gets the user settings of the DS firmware.\n\nSee https://problemkaputt.de/gbatek.htm#dsfirmwareusersettings\n\nr0: user_settings pointer",
+        None,
+    )
+
     CountLeadingZeros = Symbol(
         [0xF9B4],
         [0x207BD74],
@@ -22670,7 +22751,7 @@ class JpOverlay29Functions:
         [0x22E2CB8],
         None,
         "GetTileAtEntity",
-        "Returns a pointer to the tile where an entity is located.\n\nr0: pointer to entity\nreturns: pointer to tile",
+        "Returns a pointer to the tile where an entity is located.\n\nr0: pointer to entity\nreturn: pointer to tile",
         None,
     )
 
@@ -24652,7 +24733,7 @@ class JpOverlay29Functions:
         [0x230138C],
         None,
         "GetNumberOfAttacks",
-        "Returns the number of attacks that a monster can do in one turn (1 or 2).\n\nChecks for the abilities Swift Swim, Chlorophyll, Unburden, and for exclusive items.\n\nr0: pointer to entity\nreturns: int",
+        "Returns the number of attacks that a monster can do in one turn (1 or 2).\n\nChecks for the abilities Swift Swim, Chlorophyll, Unburden, and for exclusive items.\n\nr0: pointer to entity\nreturn: int",
         None,
     )
 
@@ -25183,7 +25264,7 @@ class JpOverlay29Functions:
         [0x2306530],
         None,
         "DisplayActions",
-        "Graphically displays any pending actions that have happened but haven't been shown on screen yet. All actions are displayed at the same time. For example, this delayed display system is used to display multiple monsters moving at once even though they take turns sequentially.\n\nr0: Pointer to an entity. Can be null.\nreturns: Seems to be true if there were any pending actions to display.",
+        "Graphically displays any pending actions that have happened but haven't been shown on screen yet. All actions are displayed at the same time. For example, this delayed display system is used to display multiple monsters moving at once even though they take turns sequentially.\n\nr0: Pointer to an entity. Can be null.\nreturn: Seems to be true if there were any pending actions to display.",
         None,
     )
 
@@ -27190,7 +27271,7 @@ class JpOverlay29Functions:
         [0x23250E8],
         None,
         "MoveHitCheck",
-        "Determines if a move used hits or misses the target. It gets called twice per target, once with r3 = false and a second time with r3 = true.\n\nr0: Attacker\nr1: Defender\nr2: Pointer to move data\nr3: False if the move's first accuracy (accuracy1) should be used, true if its second accuracy (accuracy2) should be used instead.\nstack[0]: If true, always hit if the attacker and defender are the same. Otherwise, moves can miss no matter what the attacker and defender are.\nreturns: True if the move hits, false if it misses.",
+        "Determines if a move used hits or misses the target. It gets called twice per target, once with r3 = false and a second time with r3 = true.\n\nr0: Attacker\nr1: Defender\nr2: Pointer to move data\nr3: False if the move's first accuracy (accuracy1) should be used, true if its second accuracy (accuracy2) should be used instead.\nstack[0]: If true, always hit if the attacker and defender are the same. Otherwise, moves can miss no matter what the attacker and defender are.\nreturn: True if the move hits, false if it misses.",
         None,
     )
 
@@ -27244,7 +27325,7 @@ class JpOverlay29Functions:
         [0x2325DC4],
         None,
         "DungeonRandOutcomeUserTargetInteraction",
-        "Like DungeonRandOutcome, but specifically for user-target interactions.\n\nThis modifies the underlying random process depending on factors like Serene Grace, and whether or not either entity has fainted.\n\nr0: user entity pointer\nr1: target entity pointer\nr2: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturns: True if the random check passed, false otherwise.",
+        "Like DungeonRandOutcome, but specifically for user-target interactions.\n\nThis modifies the underlying random process depending on factors like Serene Grace, and whether or not either entity has fainted.\n\nr0: user entity pointer\nr1: target entity pointer\nr2: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturn: True if the random check passed, false otherwise.",
         None,
     )
 
@@ -27253,7 +27334,7 @@ class JpOverlay29Functions:
         [0x2325EAC],
         None,
         "DungeonRandOutcomeUserAction",
-        "Like DungeonRandOutcome, but specifically for user actions.\n\nThis modifies the underlying random process to factor in Serene Grace (and checks whether the user is a valid entity).\n\nr0: entity pointer\nr1: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturns: True if the random check passed, false otherwise.",
+        "Like DungeonRandOutcome, but specifically for user actions.\n\nThis modifies the underlying random process to factor in Serene Grace (and checks whether the user is a valid entity).\n\nr0: entity pointer\nr1: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturn: True if the random check passed, false otherwise.",
         None,
     )
 

pmdsky_debug_py/jp_itcm.py

@@ -843,6 +843,15 @@ class JpItcmArm9Functions:
         None,
     )
 
+    GetDsFirmwareUserSettingsVeneer = Symbol(
+        None,
+        None,
+        None,
+        "GetDsFirmwareUserSettingsVeneer",
+        "Likely a linker-generated veneer for GetDsFirmwareUserSettings.\n\nSee https://developer.arm.com/documentation/dui0474/k/image-structure-and-generation/linker-generated-veneers/what-is-a-veneer-\n\nr0: user_settings pointer",
+        None,
+    )
+
     Rgb8ToRgb5 = Symbol(
         None,
         None,
@@ -906,6 +915,33 @@ class JpItcmArm9Functions:
         None,
     )
 
+    DebugPrintSystemClock = Symbol(
+        None,
+        None,
+        None,
+        "DebugPrintSystemClock",
+        "This function prints the debug message 'Now date & time' followed by the current date and time of the DS system clock. Called on boot.\n\nNo params.",
+        None,
+    )
+
+    GetSystemClock = Symbol(
+        None,
+        None,
+        None,
+        "GetSystemClock",
+        "Gets information surrounding the DS system clock, such as the current month, day, etc.\n\nr0: system_clock pointer",
+        None,
+    )
+
+    SprintfSystemClock = Symbol(
+        None,
+        None,
+        None,
+        "SprintfSystemClock",
+        "Calls sprintf to format a string using the fields of the DS system clock as 'year/month/day hour:minute:second'. Used in DebugPrintSystemClock.\n\nr0: system_clock pointer\nr1: str",
+        None,
+    )
+
     DataTransferInit = Symbol(
         None,
         None,
@@ -4371,6 +4407,15 @@ class JpItcmArm9Functions:
         None,
     )
 
+    GetCharWidth = Symbol(
+        None,
+        None,
+        None,
+        "GetCharWidth",
+        "Gets the width of a text char.\n\nr0: char\nreturn: char width",
+        None,
+    )
+
     GetColorCodePaletteOffset = Symbol(
         None,
         None,
@@ -4380,6 +4425,15 @@ class JpItcmArm9Functions:
         None,
     )
 
+    DrawChar = Symbol(
+        None,
+        None,
+        None,
+        "DrawChar",
+        "Draws a single char within a window. This function is also responsible for drawing the shadows of a char.\n\nr0: window_id\nr1: x offset within window\nr2: y offset within window\nr3: char\nstack[0]: color offset\nreturn: char width",
+        None,
+    )
+
     GetWindow = Symbol(
         None,
         None,
@@ -4925,7 +4979,7 @@ class JpItcmArm9Functions:
         None,
         None,
         "CreateOptionsMenu",
-        "Creates a window containing a menu controlling game options. Also see struct options_menu.\n\nThis is used for the options and window options menus, among other things.\n\nIf window_params is NULL, OPTIONS_MENU_DEFAULT_WINDOW_PARAMS will be used. Otherwise, it will be copied onto the window, ignoring the update and contents fields. If window_params::width and/or window_params::height are 0, they will be computed based on the contained text.\n\nIf window_extra_info is non-NULL, it will be copied onto the window. Note that window_extra_info can only be NULL if there are no window_flags set that require extra info.\n\nr0: window_params\nr1: window_flags\nr2: window_extra_info pointer\nr3: options_menu_id_item struct array, terminated with an item with msg_id 0\nstack[0]: number of items\nstack[1]: ?\nreturn: window_id",
+        "Creates a window containing a menu controlling game options. Also see struct options_menu.\n\nThis is used for the options and window options menus, among other things.\n\nIf window_params is NULL, OPTIONS_MENU_DEFAULT_WINDOW_PARAMS will be used. Otherwise, it will be copied onto the window, ignoring the update and contents fields. If window_params::width and/or window_params::height are 0, they will be computed based on the contained text.\n\nIf window_extra_info is non-NULL, it will be copied onto the window. Note that window_extra_info can only be NULL if there are no window_flags set that require extra info.\n\nr0: window_params\nr1: window_flags\nr2: window_extra_info pointer\nr3: options_menu_id_item struct array, terminated with an item with msg_id 0\nstack[0]: number of items\nstack[1]: option_states pointer\nreturn: window_id",
         None,
     )
 
@@ -4956,6 +5010,24 @@ class JpItcmArm9Functions:
         None,
     )
 
+    GetOptionsMenuStates = Symbol(
+        None,
+        None,
+        None,
+        "GetOptionsMenuStates",
+        "Gets all the option menu states; used to determine what options the user has selected in a menu. Each option state corresponds a options_menu_id_item.\n\nr0: window_id\nr1: option_states pointer",
+        None,
+    )
+
+    GetOptionsMenuResult = Symbol(
+        None,
+        None,
+        None,
+        "GetOptionsMenuResult",
+        "Returns whether or not the options menu was confirmed or canceled (e.g., by pressing the B button).\n\nr0: window_id\nreturn: bool",
+        None,
+    )
+
     UpdateOptionsMenu = Symbol(
         None,
         None,
@@ -12510,6 +12582,15 @@ class JpItcmLibsFunctions:
         None,
     )
 
+    GetDsFirmwareUserSettings = Symbol(
+        None,
+        None,
+        None,
+        "GetDsFirmwareUserSettings",
+        "Gets the user settings of the DS firmware.\n\nSee https://problemkaputt.de/gbatek.htm#dsfirmwareusersettings\n\nr0: user_settings pointer",
+        None,
+    )
+
     CountLeadingZeros = Symbol(
         None,
         None,
@@ -22178,7 +22259,7 @@ class JpItcmOverlay29Functions:
         None,
         None,
         "GetTileAtEntity",
-        "Returns a pointer to the tile where an entity is located.\n\nr0: pointer to entity\nreturns: pointer to tile",
+        "Returns a pointer to the tile where an entity is located.\n\nr0: pointer to entity\nreturn: pointer to tile",
         None,
     )
 
@@ -24086,7 +24167,7 @@ class JpItcmOverlay29Functions:
         None,
         None,
         "GetNumberOfAttacks",
-        "Returns the number of attacks that a monster can do in one turn (1 or 2).\n\nChecks for the abilities Swift Swim, Chlorophyll, Unburden, and for exclusive items.\n\nr0: pointer to entity\nreturns: int",
+        "Returns the number of attacks that a monster can do in one turn (1 or 2).\n\nChecks for the abilities Swift Swim, Chlorophyll, Unburden, and for exclusive items.\n\nr0: pointer to entity\nreturn: int",
         None,
     )
 
@@ -24617,7 +24698,7 @@ class JpItcmOverlay29Functions:
         None,
         None,
         "DisplayActions",
-        "Graphically displays any pending actions that have happened but haven't been shown on screen yet. All actions are displayed at the same time. For example, this delayed display system is used to display multiple monsters moving at once even though they take turns sequentially.\n\nr0: Pointer to an entity. Can be null.\nreturns: Seems to be true if there were any pending actions to display.",
+        "Graphically displays any pending actions that have happened but haven't been shown on screen yet. All actions are displayed at the same time. For example, this delayed display system is used to display multiple monsters moving at once even though they take turns sequentially.\n\nr0: Pointer to an entity. Can be null.\nreturn: Seems to be true if there were any pending actions to display.",
         None,
     )
 
@@ -26624,7 +26705,7 @@ class JpItcmOverlay29Functions:
         None,
         None,
         "MoveHitCheck",
-        "Determines if a move used hits or misses the target. It gets called twice per target, once with r3 = false and a second time with r3 = true.\n\nr0: Attacker\nr1: Defender\nr2: Pointer to move data\nr3: False if the move's first accuracy (accuracy1) should be used, true if its second accuracy (accuracy2) should be used instead.\nstack[0]: If true, always hit if the attacker and defender are the same. Otherwise, moves can miss no matter what the attacker and defender are.\nreturns: True if the move hits, false if it misses.",
+        "Determines if a move used hits or misses the target. It gets called twice per target, once with r3 = false and a second time with r3 = true.\n\nr0: Attacker\nr1: Defender\nr2: Pointer to move data\nr3: False if the move's first accuracy (accuracy1) should be used, true if its second accuracy (accuracy2) should be used instead.\nstack[0]: If true, always hit if the attacker and defender are the same. Otherwise, moves can miss no matter what the attacker and defender are.\nreturn: True if the move hits, false if it misses.",
         None,
     )
 
@@ -26678,7 +26759,7 @@ class JpItcmOverlay29Functions:
         None,
         None,
         "DungeonRandOutcomeUserTargetInteraction",
-        "Like DungeonRandOutcome, but specifically for user-target interactions.\n\nThis modifies the underlying random process depending on factors like Serene Grace, and whether or not either entity has fainted.\n\nr0: user entity pointer\nr1: target entity pointer\nr2: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturns: True if the random check passed, false otherwise.",
+        "Like DungeonRandOutcome, but specifically for user-target interactions.\n\nThis modifies the underlying random process depending on factors like Serene Grace, and whether or not either entity has fainted.\n\nr0: user entity pointer\nr1: target entity pointer\nr2: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturn: True if the random check passed, false otherwise.",
         None,
     )
 
@@ -26687,7 +26768,7 @@ class JpItcmOverlay29Functions:
         None,
         None,
         "DungeonRandOutcomeUserAction",
-        "Like DungeonRandOutcome, but specifically for user actions.\n\nThis modifies the underlying random process to factor in Serene Grace (and checks whether the user is a valid entity).\n\nr0: entity pointer\nr1: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturns: True if the random check passed, false otherwise.",
+        "Like DungeonRandOutcome, but specifically for user actions.\n\nThis modifies the underlying random process to factor in Serene Grace (and checks whether the user is a valid entity).\n\nr0: entity pointer\nr1: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturn: True if the random check passed, false otherwise.",
         None,
     )
 

pmdsky_debug_py/na.py

@@ -855,6 +855,15 @@ class NaArm9Functions:
         None,
     )
 
+    GetDsFirmwareUserSettingsVeneer = Symbol(
+        [0x4F74],
+        [0x2004F74],
+        None,
+        "GetDsFirmwareUserSettingsVeneer",
+        "Likely a linker-generated veneer for GetDsFirmwareUserSettings.\n\nSee https://developer.arm.com/documentation/dui0474/k/image-structure-and-generation/linker-generated-veneers/what-is-a-veneer-\n\nr0: user_settings pointer",
+        None,
+    )
+
     Rgb8ToRgb5 = Symbol(
         [0x4FCC],
         [0x2004FCC],
@@ -918,6 +927,33 @@ class NaArm9Functions:
         None,
     )
 
+    DebugPrintSystemClock = Symbol(
+        [0x6EF8],
+        [0x2006EF8],
+        None,
+        "DebugPrintSystemClock",
+        "This function prints the debug message 'Now date & time' followed by the current date and time of the DS system clock. Called on boot.\n\nNo params.",
+        None,
+    )
+
+    GetSystemClock = Symbol(
+        [0x6F68],
+        [0x2006F68],
+        None,
+        "GetSystemClock",
+        "Gets information surrounding the DS system clock, such as the current month, day, etc.\n\nr0: system_clock pointer",
+        None,
+    )
+
+    SprintfSystemClock = Symbol(
+        [0x6FB8],
+        [0x2006FB8],
+        None,
+        "SprintfSystemClock",
+        "Calls sprintf to format a string using the fields of the DS system clock as 'year/month/day hour:minute:second'. Used in DebugPrintSystemClock.\n\nr0: system_clock pointer\nr1: str",
+        None,
+    )
+
     DataTransferInit = Symbol(
         [0x8168],
         [0x2008168],
@@ -4417,6 +4453,15 @@ class NaArm9Functions:
         None,
     )
 
+    GetCharWidth = Symbol(
+        [0x2654C],
+        [0x202654C],
+        None,
+        "GetCharWidth",
+        "Gets the width of a text char.\n\nr0: char\nreturn: char width",
+        None,
+    )
+
     GetColorCodePaletteOffset = Symbol(
         [0x265C4],
         [0x20265C4],
@@ -4426,6 +4471,15 @@ class NaArm9Functions:
         None,
     )
 
+    DrawChar = Symbol(
+        [0x2676C],
+        [0x202676C],
+        None,
+        "DrawChar",
+        "Draws a single char within a window. This function is also responsible for drawing the shadows of a char.\n\nr0: window_id\nr1: x offset within window\nr2: y offset within window\nr3: char\nstack[0]: color offset\nreturn: char width",
+        None,
+    )
+
     GetWindow = Symbol(
         [0x275F8],
         [0x20275F8],
@@ -4971,7 +5025,7 @@ class NaArm9Functions:
         [0x202D1F0],
         None,
         "CreateOptionsMenu",
-        "Creates a window containing a menu controlling game options. Also see struct options_menu.\n\nThis is used for the options and window options menus, among other things.\n\nIf window_params is NULL, OPTIONS_MENU_DEFAULT_WINDOW_PARAMS will be used. Otherwise, it will be copied onto the window, ignoring the update and contents fields. If window_params::width and/or window_params::height are 0, they will be computed based on the contained text.\n\nIf window_extra_info is non-NULL, it will be copied onto the window. Note that window_extra_info can only be NULL if there are no window_flags set that require extra info.\n\nr0: window_params\nr1: window_flags\nr2: window_extra_info pointer\nr3: options_menu_id_item struct array, terminated with an item with msg_id 0\nstack[0]: number of items\nstack[1]: ?\nreturn: window_id",
+        "Creates a window containing a menu controlling game options. Also see struct options_menu.\n\nThis is used for the options and window options menus, among other things.\n\nIf window_params is NULL, OPTIONS_MENU_DEFAULT_WINDOW_PARAMS will be used. Otherwise, it will be copied onto the window, ignoring the update and contents fields. If window_params::width and/or window_params::height are 0, they will be computed based on the contained text.\n\nIf window_extra_info is non-NULL, it will be copied onto the window. Note that window_extra_info can only be NULL if there are no window_flags set that require extra info.\n\nr0: window_params\nr1: window_flags\nr2: window_extra_info pointer\nr3: options_menu_id_item struct array, terminated with an item with msg_id 0\nstack[0]: number of items\nstack[1]: option_states pointer\nreturn: window_id",
         None,
     )
 
@@ -5002,6 +5056,24 @@ class NaArm9Functions:
         None,
     )
 
+    GetOptionsMenuStates = Symbol(
+        [0x2D5B0],
+        [0x202D5B0],
+        None,
+        "GetOptionsMenuStates",
+        "Gets all the option menu states; used to determine what options the user has selected in a menu. Each option state corresponds a options_menu_id_item.\n\nr0: window_id\nr1: option_states pointer",
+        None,
+    )
+
+    GetOptionsMenuResult = Symbol(
+        [0x2D5E4],
+        [0x202D5E4],
+        None,
+        "GetOptionsMenuResult",
+        "Returns whether or not the options menu was confirmed or canceled (e.g., by pressing the B button).\n\nr0: window_id\nreturn: bool",
+        None,
+    )
+
     UpdateOptionsMenu = Symbol(
         [0x2D618],
         [0x202D618],
@@ -12751,6 +12823,15 @@ class NaLibsFunctions:
         None,
     )
 
+    GetDsFirmwareUserSettings = Symbol(
+        [0xF930],
+        [0x207BA08],
+        None,
+        "GetDsFirmwareUserSettings",
+        "Gets the user settings of the DS firmware.\n\nSee https://problemkaputt.de/gbatek.htm#dsfirmwareusersettings\n\nr0: user_settings pointer",
+        None,
+    )
+
     CountLeadingZeros = Symbol(
         [0xF9B4],
         [0x207BA8C],
@@ -22677,7 +22758,7 @@ class NaOverlay29Functions:
         [0x22E1628],
         None,
         "GetTileAtEntity",
-        "Returns a pointer to the tile where an entity is located.\n\nr0: pointer to entity\nreturns: pointer to tile",
+        "Returns a pointer to the tile where an entity is located.\n\nr0: pointer to entity\nreturn: pointer to tile",
         None,
     )
 
@@ -24659,7 +24740,7 @@ class NaOverlay29Functions:
         [0x22FFF5C],
         None,
         "GetNumberOfAttacks",
-        "Returns the number of attacks that a monster can do in one turn (1 or 2).\n\nChecks for the abilities Swift Swim, Chlorophyll, Unburden, and for exclusive items.\n\nr0: pointer to entity\nreturns: int",
+        "Returns the number of attacks that a monster can do in one turn (1 or 2).\n\nChecks for the abilities Swift Swim, Chlorophyll, Unburden, and for exclusive items.\n\nr0: pointer to entity\nreturn: int",
         None,
     )
 
@@ -25190,7 +25271,7 @@ class NaOverlay29Functions:
         [0x2304FE0],
         None,
         "DisplayActions",
-        "Graphically displays any pending actions that have happened but haven't been shown on screen yet. All actions are displayed at the same time. For example, this delayed display system is used to display multiple monsters moving at once even though they take turns sequentially.\n\nr0: Pointer to an entity. Can be null.\nreturns: Seems to be true if there were any pending actions to display.",
+        "Graphically displays any pending actions that have happened but haven't been shown on screen yet. All actions are displayed at the same time. For example, this delayed display system is used to display multiple monsters moving at once even though they take turns sequentially.\n\nr0: Pointer to an entity. Can be null.\nreturn: Seems to be true if there were any pending actions to display.",
         None,
     )
 
@@ -27197,7 +27278,7 @@ class NaOverlay29Functions:
         [0x2323C48],
         None,
         "MoveHitCheck",
-        "Determines if a move used hits or misses the target. It gets called twice per target, once with r3 = false and a second time with r3 = true.\n\nr0: Attacker\nr1: Defender\nr2: Pointer to move data\nr3: False if the move's first accuracy (accuracy1) should be used, true if its second accuracy (accuracy2) should be used instead.\nstack[0]: If true, always hit if the attacker and defender are the same. Otherwise, moves can miss no matter what the attacker and defender are.\nreturns: True if the move hits, false if it misses.",
+        "Determines if a move used hits or misses the target. It gets called twice per target, once with r3 = false and a second time with r3 = true.\n\nr0: Attacker\nr1: Defender\nr2: Pointer to move data\nr3: False if the move's first accuracy (accuracy1) should be used, true if its second accuracy (accuracy2) should be used instead.\nstack[0]: If true, always hit if the attacker and defender are the same. Otherwise, moves can miss no matter what the attacker and defender are.\nreturn: True if the move hits, false if it misses.",
         None,
     )
 
@@ -27251,7 +27332,7 @@ class NaOverlay29Functions:
         [0x2324934],
         None,
         "DungeonRandOutcomeUserTargetInteraction",
-        "Like DungeonRandOutcome, but specifically for user-target interactions.\n\nThis modifies the underlying random process depending on factors like Serene Grace, and whether or not either entity has fainted.\n\nr0: user entity pointer\nr1: target entity pointer\nr2: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturns: True if the random check passed, false otherwise.",
+        "Like DungeonRandOutcome, but specifically for user-target interactions.\n\nThis modifies the underlying random process depending on factors like Serene Grace, and whether or not either entity has fainted.\n\nr0: user entity pointer\nr1: target entity pointer\nr2: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturn: True if the random check passed, false otherwise.",
         None,
     )
 
@@ -27260,7 +27341,7 @@ class NaOverlay29Functions:
         [0x2324A20],
         None,
         "DungeonRandOutcomeUserAction",
-        "Like DungeonRandOutcome, but specifically for user actions.\n\nThis modifies the underlying random process to factor in Serene Grace (and checks whether the user is a valid entity).\n\nr0: entity pointer\nr1: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturns: True if the random check passed, false otherwise.",
+        "Like DungeonRandOutcome, but specifically for user actions.\n\nThis modifies the underlying random process to factor in Serene Grace (and checks whether the user is a valid entity).\n\nr0: entity pointer\nr1: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturn: True if the random check passed, false otherwise.",
         None,
     )
 

pmdsky_debug_py/na_itcm.py

@@ -843,6 +843,15 @@ class NaItcmArm9Functions:
         None,
     )
 
+    GetDsFirmwareUserSettingsVeneer = Symbol(
+        None,
+        None,
+        None,
+        "GetDsFirmwareUserSettingsVeneer",
+        "Likely a linker-generated veneer for GetDsFirmwareUserSettings.\n\nSee https://developer.arm.com/documentation/dui0474/k/image-structure-and-generation/linker-generated-veneers/what-is-a-veneer-\n\nr0: user_settings pointer",
+        None,
+    )
+
     Rgb8ToRgb5 = Symbol(
         None,
         None,
@@ -906,6 +915,33 @@ class NaItcmArm9Functions:
         None,
     )
 
+    DebugPrintSystemClock = Symbol(
+        None,
+        None,
+        None,
+        "DebugPrintSystemClock",
+        "This function prints the debug message 'Now date & time' followed by the current date and time of the DS system clock. Called on boot.\n\nNo params.",
+        None,
+    )
+
+    GetSystemClock = Symbol(
+        None,
+        None,
+        None,
+        "GetSystemClock",
+        "Gets information surrounding the DS system clock, such as the current month, day, etc.\n\nr0: system_clock pointer",
+        None,
+    )
+
+    SprintfSystemClock = Symbol(
+        None,
+        None,
+        None,
+        "SprintfSystemClock",
+        "Calls sprintf to format a string using the fields of the DS system clock as 'year/month/day hour:minute:second'. Used in DebugPrintSystemClock.\n\nr0: system_clock pointer\nr1: str",
+        None,
+    )
+
     DataTransferInit = Symbol(
         None,
         None,
@@ -4371,6 +4407,15 @@ class NaItcmArm9Functions:
         None,
     )
 
+    GetCharWidth = Symbol(
+        None,
+        None,
+        None,
+        "GetCharWidth",
+        "Gets the width of a text char.\n\nr0: char\nreturn: char width",
+        None,
+    )
+
     GetColorCodePaletteOffset = Symbol(
         None,
         None,
@@ -4380,6 +4425,15 @@ class NaItcmArm9Functions:
         None,
     )
 
+    DrawChar = Symbol(
+        None,
+        None,
+        None,
+        "DrawChar",
+        "Draws a single char within a window. This function is also responsible for drawing the shadows of a char.\n\nr0: window_id\nr1: x offset within window\nr2: y offset within window\nr3: char\nstack[0]: color offset\nreturn: char width",
+        None,
+    )
+
     GetWindow = Symbol(
         None,
         None,
@@ -4925,7 +4979,7 @@ class NaItcmArm9Functions:
         None,
         None,
         "CreateOptionsMenu",
-        "Creates a window containing a menu controlling game options. Also see struct options_menu.\n\nThis is used for the options and window options menus, among other things.\n\nIf window_params is NULL, OPTIONS_MENU_DEFAULT_WINDOW_PARAMS will be used. Otherwise, it will be copied onto the window, ignoring the update and contents fields. If window_params::width and/or window_params::height are 0, they will be computed based on the contained text.\n\nIf window_extra_info is non-NULL, it will be copied onto the window. Note that window_extra_info can only be NULL if there are no window_flags set that require extra info.\n\nr0: window_params\nr1: window_flags\nr2: window_extra_info pointer\nr3: options_menu_id_item struct array, terminated with an item with msg_id 0\nstack[0]: number of items\nstack[1]: ?\nreturn: window_id",
+        "Creates a window containing a menu controlling game options. Also see struct options_menu.\n\nThis is used for the options and window options menus, among other things.\n\nIf window_params is NULL, OPTIONS_MENU_DEFAULT_WINDOW_PARAMS will be used. Otherwise, it will be copied onto the window, ignoring the update and contents fields. If window_params::width and/or window_params::height are 0, they will be computed based on the contained text.\n\nIf window_extra_info is non-NULL, it will be copied onto the window. Note that window_extra_info can only be NULL if there are no window_flags set that require extra info.\n\nr0: window_params\nr1: window_flags\nr2: window_extra_info pointer\nr3: options_menu_id_item struct array, terminated with an item with msg_id 0\nstack[0]: number of items\nstack[1]: option_states pointer\nreturn: window_id",
         None,
     )
 
@@ -4956,6 +5010,24 @@ class NaItcmArm9Functions:
         None,
     )
 
+    GetOptionsMenuStates = Symbol(
+        None,
+        None,
+        None,
+        "GetOptionsMenuStates",
+        "Gets all the option menu states; used to determine what options the user has selected in a menu. Each option state corresponds a options_menu_id_item.\n\nr0: window_id\nr1: option_states pointer",
+        None,
+    )
+
+    GetOptionsMenuResult = Symbol(
+        None,
+        None,
+        None,
+        "GetOptionsMenuResult",
+        "Returns whether or not the options menu was confirmed or canceled (e.g., by pressing the B button).\n\nr0: window_id\nreturn: bool",
+        None,
+    )
+
     UpdateOptionsMenu = Symbol(
         None,
         None,
@@ -12510,6 +12582,15 @@ class NaItcmLibsFunctions:
         None,
     )
 
+    GetDsFirmwareUserSettings = Symbol(
+        None,
+        None,
+        None,
+        "GetDsFirmwareUserSettings",
+        "Gets the user settings of the DS firmware.\n\nSee https://problemkaputt.de/gbatek.htm#dsfirmwareusersettings\n\nr0: user_settings pointer",
+        None,
+    )
+
     CountLeadingZeros = Symbol(
         None,
         None,
@@ -22178,7 +22259,7 @@ class NaItcmOverlay29Functions:
         None,
         None,
         "GetTileAtEntity",
-        "Returns a pointer to the tile where an entity is located.\n\nr0: pointer to entity\nreturns: pointer to tile",
+        "Returns a pointer to the tile where an entity is located.\n\nr0: pointer to entity\nreturn: pointer to tile",
         None,
     )
 
@@ -24086,7 +24167,7 @@ class NaItcmOverlay29Functions:
         None,
         None,
         "GetNumberOfAttacks",
-        "Returns the number of attacks that a monster can do in one turn (1 or 2).\n\nChecks for the abilities Swift Swim, Chlorophyll, Unburden, and for exclusive items.\n\nr0: pointer to entity\nreturns: int",
+        "Returns the number of attacks that a monster can do in one turn (1 or 2).\n\nChecks for the abilities Swift Swim, Chlorophyll, Unburden, and for exclusive items.\n\nr0: pointer to entity\nreturn: int",
         None,
     )
 
@@ -24617,7 +24698,7 @@ class NaItcmOverlay29Functions:
         None,
         None,
         "DisplayActions",
-        "Graphically displays any pending actions that have happened but haven't been shown on screen yet. All actions are displayed at the same time. For example, this delayed display system is used to display multiple monsters moving at once even though they take turns sequentially.\n\nr0: Pointer to an entity. Can be null.\nreturns: Seems to be true if there were any pending actions to display.",
+        "Graphically displays any pending actions that have happened but haven't been shown on screen yet. All actions are displayed at the same time. For example, this delayed display system is used to display multiple monsters moving at once even though they take turns sequentially.\n\nr0: Pointer to an entity. Can be null.\nreturn: Seems to be true if there were any pending actions to display.",
         None,
     )
 
@@ -26624,7 +26705,7 @@ class NaItcmOverlay29Functions:
         None,
         None,
         "MoveHitCheck",
-        "Determines if a move used hits or misses the target. It gets called twice per target, once with r3 = false and a second time with r3 = true.\n\nr0: Attacker\nr1: Defender\nr2: Pointer to move data\nr3: False if the move's first accuracy (accuracy1) should be used, true if its second accuracy (accuracy2) should be used instead.\nstack[0]: If true, always hit if the attacker and defender are the same. Otherwise, moves can miss no matter what the attacker and defender are.\nreturns: True if the move hits, false if it misses.",
+        "Determines if a move used hits or misses the target. It gets called twice per target, once with r3 = false and a second time with r3 = true.\n\nr0: Attacker\nr1: Defender\nr2: Pointer to move data\nr3: False if the move's first accuracy (accuracy1) should be used, true if its second accuracy (accuracy2) should be used instead.\nstack[0]: If true, always hit if the attacker and defender are the same. Otherwise, moves can miss no matter what the attacker and defender are.\nreturn: True if the move hits, false if it misses.",
         None,
     )
 
@@ -26678,7 +26759,7 @@ class NaItcmOverlay29Functions:
         None,
         None,
         "DungeonRandOutcomeUserTargetInteraction",
-        "Like DungeonRandOutcome, but specifically for user-target interactions.\n\nThis modifies the underlying random process depending on factors like Serene Grace, and whether or not either entity has fainted.\n\nr0: user entity pointer\nr1: target entity pointer\nr2: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturns: True if the random check passed, false otherwise.",
+        "Like DungeonRandOutcome, but specifically for user-target interactions.\n\nThis modifies the underlying random process depending on factors like Serene Grace, and whether or not either entity has fainted.\n\nr0: user entity pointer\nr1: target entity pointer\nr2: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturn: True if the random check passed, false otherwise.",
         None,
     )
 
@@ -26687,7 +26768,7 @@ class NaItcmOverlay29Functions:
         None,
         None,
         "DungeonRandOutcomeUserAction",
-        "Like DungeonRandOutcome, but specifically for user actions.\n\nThis modifies the underlying random process to factor in Serene Grace (and checks whether the user is a valid entity).\n\nr0: entity pointer\nr1: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturns: True if the random check passed, false otherwise.",
+        "Like DungeonRandOutcome, but specifically for user actions.\n\nThis modifies the underlying random process to factor in Serene Grace (and checks whether the user is a valid entity).\n\nr0: entity pointer\nr1: base success percentage (100*p). 0 is treated specially and guarantees success.\nreturn: True if the random check passed, false otherwise.",
         None,
     )
 

pmdsky_debug_py/protocol.py

@@ -537,6 +537,11 @@ class Arm9FunctionsProtocol(Protocol):
         None,
     ]
 
+    GetDsFirmwareUserSettingsVeneer: Symbol[
+        Optional[list[int]],
+        None,
+    ]
+
     Rgb8ToRgb5: Symbol[
         Optional[list[int]],
         None,
@@ -572,6 +577,21 @@ class Arm9FunctionsProtocol(Protocol):
         None,
     ]
 
+    DebugPrintSystemClock: Symbol[
+        Optional[list[int]],
+        None,
+    ]
+
+    GetSystemClock: Symbol[
+        Optional[list[int]],
+        None,
+    ]
+
+    SprintfSystemClock: Symbol[
+        Optional[list[int]],
+        None,
+    ]
+
     DataTransferInit: Symbol[
         Optional[list[int]],
         None,
@@ -2497,11 +2517,21 @@ class Arm9FunctionsProtocol(Protocol):
         None,
     ]
 
+    GetCharWidth: Symbol[
+        Optional[list[int]],
+        None,
+    ]
+
     GetColorCodePaletteOffset: Symbol[
         Optional[list[int]],
         None,
     ]
 
+    DrawChar: Symbol[
+        Optional[list[int]],
+        None,
+    ]
+
     GetWindow: Symbol[
         Optional[list[int]],
         None,
@@ -2822,6 +2852,16 @@ class Arm9FunctionsProtocol(Protocol):
         None,
     ]
 
+    GetOptionsMenuStates: Symbol[
+        Optional[list[int]],
+        None,
+    ]
+
+    GetOptionsMenuResult: Symbol[
+        Optional[list[int]],
+        None,
+    ]
+
     UpdateOptionsMenu: Symbol[
         Optional[list[int]],
         None,
@@ -8098,6 +8138,11 @@ class LibsFunctionsProtocol(Protocol):
         None,
     ]
 
+    GetDsFirmwareUserSettings: Symbol[
+        Optional[list[int]],
+        None,
+    ]
+
     CountLeadingZeros: Symbol[
         Optional[list[int]],
         None,

{pmdsky_debug_py-10.0.46.dist-info → pmdsky_debug_py-10.0.48.dist-info}/METADATA

@@ -1,18 +1,18 @@
 Metadata-Version: 2.1
 Name: pmdsky-debug-py
-Version: 10.0.46
+Version: 10.0.48
 Summary: pmdsky-debug symbols for Python.
 Author-email: Marco 'Capypara' Köpcke <hello@capypara.de>
 License: MIT
 Project-URL: repository, https://github.com/SkyTemple/pmdsky-debug-py
 Classifier: Development Status :: 4 - Beta
 Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/x-rst
 
 pmdsky-debug-py

pmdsky_debug_py-10.0.48.dist-info/RECORD

@@ -0,0 +1,14 @@
+pmdsky_debug_py/__init__.py,sha256=xvXjdxEqeoQaaS6ssZYVI9jARzv5M4q6FNwA3Z6fOw4,1831
+pmdsky_debug_py/_release.py,sha256=Z3wigXibl1zInVvUH5WInbMQ8xmwiMghbhUurmrRgOU,31
+pmdsky_debug_py/eu.py,sha256=LugklOhOlYSVj1B8gEEXMUmkAYMYeENwKU5V98YNZHE,1123222
+pmdsky_debug_py/eu_itcm.py,sha256=14kMVN76b0QKcTZZ6ACG2h2dkT1DxI0KPMKgZF75Ny0,1072766
+pmdsky_debug_py/jp.py,sha256=Mq1ElrJwR8i4wTLWiHwbW8fcS0bgqi6PbNuIC1pAf0I,1119633
+pmdsky_debug_py/jp_itcm.py,sha256=ZdSAdxwCL1aKeuFwF72dT8uS9W-9Rg8dQyEm-IYs1Dc,1072756
+pmdsky_debug_py/na.py,sha256=i9aCcVx6i1a9xwZMG4MYbIOpIRUoBvO0iEdGof6NArI,1124166
+pmdsky_debug_py/na_itcm.py,sha256=Wm4Im-mNWSzYRINYNxloDjCjbgaql9HKJHYaJseV_wM,1072766
+pmdsky_debug_py/protocol.py,sha256=DFC88Tgk12tK77TgfKtkOmAxsta5jKgDiYegW2V4hqg,330323
+pmdsky_debug_py/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pmdsky_debug_py-10.0.48.dist-info/METADATA,sha256=d5nSHNdXSZInErEVv5ypBVcWsEevgmL76jZ41ExJ_ys,1376
+pmdsky_debug_py-10.0.48.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+pmdsky_debug_py-10.0.48.dist-info/top_level.txt,sha256=cqvpcJbud2s8IyBAc1MfCySwniko_6qO5LWSSxNIoXI,16
+pmdsky_debug_py-10.0.48.dist-info/RECORD,,

pmdsky_debug_py-10.0.46.dist-info/RECORD

@@ -1,14 +0,0 @@
-pmdsky_debug_py/__init__.py,sha256=xvXjdxEqeoQaaS6ssZYVI9jARzv5M4q6FNwA3Z6fOw4,1831
-pmdsky_debug_py/_release.py,sha256=oz0M5jann6aatrveo9uh7DVgorPBL3nh1vXW7L6KZM4,31
-pmdsky_debug_py/eu.py,sha256=k4qKcikrjhhDtjXaijHz3w-6MSwphwsL0DZPzx-xZYk,1120429
-pmdsky_debug_py/eu_itcm.py,sha256=1FTK7w0QYfHxEvQbLeL0tZMQkloGDWEWlm_FTtwHNO8,1070076
-pmdsky_debug_py/jp.py,sha256=8W2RnV0W6UuCjahYBfnA-jAzHK-OTgm_yzik3yhM1SE,1116840
-pmdsky_debug_py/jp_itcm.py,sha256=nRXpdXZE4k2gY4p-sUNqpkZ2wHXls3cLWUiAqGdcPlg,1070066
-pmdsky_debug_py/na.py,sha256=0D_Fk6mknbMHV4W2ldKrTnjHYZQ_0mhoqQBOVKKy86U,1121373
-pmdsky_debug_py/na_itcm.py,sha256=6O5IHYMFAVo0tC7X4qJxzv3WKdHsQGa5e5O9_RSkme0,1070076
-pmdsky_debug_py/protocol.py,sha256=UGuZd9vsuEL8FKU8yxvhVDAlBDejHmek8oBTIRKQtCU,329578
-pmdsky_debug_py/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pmdsky_debug_py-10.0.46.dist-info/METADATA,sha256=VEdlfUBR8VrHf6s2LAEPiu-hxjn3Ki-Ic-IJNAFMYN8,1374
-pmdsky_debug_py-10.0.46.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
-pmdsky_debug_py-10.0.46.dist-info/top_level.txt,sha256=cqvpcJbud2s8IyBAc1MfCySwniko_6qO5LWSSxNIoXI,16
-pmdsky_debug_py-10.0.46.dist-info/RECORD,,