Splatlogger 1.2.4__tar.gz → 1.3.1__tar.gz

{splatlogger-1.2.4/src/Splatlogger.egg-info → splatlogger-1.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Splatlogger
-Version: 1.2.4
+Version: 1.3.1
 Summary: PID Grabber and player/match information logging tool for Splatoon
 Author-email: Shadow Doggo <shadowdoggo@protonmail.com>
 License-Expression: MIT
@@ -50,8 +50,13 @@ or any other app with the TCPGecko server.
 On Aroma, use [TCPGecko-Plugin](https://github.com/PinkDiamondTeam/TCPGecko-Plugin).
 
 ## Usage
+Splatlogger uses a command-line interface (CLI), you will need to run it within a terminal.
+
+On Windows, it's best to use [Windows Terminal](https://learn.microsoft.com/en-us/windows/terminal/install)
+or [PowerShell](https://learn.microsoft.com/en-us/powershell/scripting/install/install-powershell-on-windows), as the Command Prompt can't properly display certain characters.
+
 ### Running the executable
-Windows and Linux executables are provided on the [Releases](https://codeberg.org/ShadowDoggo/Splatlogger/releases/latest) page.
+Executables for Windows, Linux and macOS are provided on the [Releases](https://codeberg.org/ShadowDoggo/Splatlogger/releases/latest) page.
 
 Run Splatlogger with:
 ```
@@ -60,9 +65,9 @@ path/to/Splatlogger-executable --ip IP [options] / --cemu [PID] [options]
 Use the `--ip` target where `IP` is your Wii U's LAN IP address,
 or the `-c` / `--cemu` target to enable Cemu mode where `PID` is the process ID of the Cemu process (optional, should be detected automatically).
 
-Open a command prompt/terminal window and drag the executable into it to automatically get the path.
+Drag the executable into the terminal window to automatically get the path.
 
-On Linux, you might need to make the file executable first with `chmod +x path/to/Splatlogger-executable`
+On Linux and macOS, you might need to make the file executable first with `chmod +x path/to/Splatlogger-executable`
 
 ### Running with Python
 You can install Splatlogger as a package from PyPI:
@@ -103,7 +108,7 @@ python -m splatlogger --ip IP [options] / --cemu [PID] [options]
   - `none` - Don't create a log file.
   - `standard` - Log only basic player information, the same as what's printed to the console (default).
   - `extended` - Log all player information and additional match information.
-  - `stats` - Same as above with the addition of player stats (points, K/D, win/lose) and disconnect detection.
+  - `full` - Same as above with the addition of player stats (points, K/D, win/lose), disconnect detection, and match results.
 Requires the match to end to finish logging; if it ends abruptly, the stats won't be logged.
 
 - `--service` - Choose which network service you're using.
@@ -118,11 +123,6 @@ Also allows you to view information about the lobby/gathering while on the match
 
     (These options don't affect anything if the log level is set to `none`)
 
-- `--stack Address (in hex)` - (Cemu only, optional) Beginning address of the stack space for Default Core 1 (Debug > View PPC threads).
-Only required for logging stats. If the default values don't work, you'll need to specify this manually.
-
-  <img src="assets/stack.png" width="600" alt="(example)">
-
 - `-sl`, `--single-log` - Enable single log mode. When enabled, only one log file will be created for each day and logging will resume in that file
 instead of creating a new one for each logging session (default behavior for `--auto latest`).
 
@@ -150,7 +150,7 @@ ip = "192.168.1.50"
 # Target network service: "pretendo", "altendo", or "none"
 service = "pretendo"
 
-# Log level: "standard", "extended", "stats", or "none"
+# Log level: "standard", "extended", "full", or "none"
 log_level = "extended"
 
 # Auto logging: "all", "latest" (omit for manual logging)
@@ -169,9 +169,6 @@ single_log = true
 # Cemu process ID (set to -1 to find automatically)
 # Uncomment this option to enable Cemu mode
 # cemu = -1
-
-# Beginning address of the stack space for Default Core 1 (set only if stat logging doesn't work by default)
-# stack = "0xE101440"
 ```
 
 ### Troubleshooting
@@ -182,9 +179,6 @@ If it keeps failing to connect, make sure that:
 - Port 7331 isn't blocked by the firewall.
 - TCPGecko is running.
 
-There's an issue with TCPGecko where opening an applet such as the Friend List and going back into the game causes memory
-reads to fail. If auto-logging is enabled, you'll need to restart Splatlogger after returning to the game.
-
 For Cemu users on Linux, if you have ptrace protection enabled, you'll need to run Python as root.
 In that case, it's best to run the package from source or use the executable instead.
 
@@ -208,9 +202,7 @@ python scripts/build.py [--upx-dir path/to/upx]
 ```
 use `--upx-dir` if you're using UPX to compress the executable.
 
-You can also use `build.bat` on Windows and `build.sh` on Linux to handle everything automatically.
-
-(No builds or build script are provided for macOS as I don't have a Mac to test, and my attempts at virtualizing macOS have been unsuccessful.)
+You can also use `build.bat` on Windows and `build.sh` on Linux/macOS to handle everything automatically.
 
 ## Acknowledgments
 - NWPlayer123 for the reference implementation of a TCPGecko library.

{splatlogger-1.2.4 → splatlogger-1.3.1}/README.md

@@ -25,8 +25,13 @@ or any other app with the TCPGecko server.
 On Aroma, use [TCPGecko-Plugin](https://github.com/PinkDiamondTeam/TCPGecko-Plugin).
 
 ## Usage
+Splatlogger uses a command-line interface (CLI), you will need to run it within a terminal.
+
+On Windows, it's best to use [Windows Terminal](https://learn.microsoft.com/en-us/windows/terminal/install)
+or [PowerShell](https://learn.microsoft.com/en-us/powershell/scripting/install/install-powershell-on-windows), as the Command Prompt can't properly display certain characters.
+
 ### Running the executable
-Windows and Linux executables are provided on the [Releases](https://codeberg.org/ShadowDoggo/Splatlogger/releases/latest) page.
+Executables for Windows, Linux and macOS are provided on the [Releases](https://codeberg.org/ShadowDoggo/Splatlogger/releases/latest) page.
 
 Run Splatlogger with:
 ```
@@ -35,9 +40,9 @@ path/to/Splatlogger-executable --ip IP [options] / --cemu [PID] [options]
 Use the `--ip` target where `IP` is your Wii U's LAN IP address,
 or the `-c` / `--cemu` target to enable Cemu mode where `PID` is the process ID of the Cemu process (optional, should be detected automatically).
 
-Open a command prompt/terminal window and drag the executable into it to automatically get the path.
+Drag the executable into the terminal window to automatically get the path.
 
-On Linux, you might need to make the file executable first with `chmod +x path/to/Splatlogger-executable`
+On Linux and macOS, you might need to make the file executable first with `chmod +x path/to/Splatlogger-executable`
 
 ### Running with Python
 You can install Splatlogger as a package from PyPI:
@@ -78,7 +83,7 @@ python -m splatlogger --ip IP [options] / --cemu [PID] [options]
   - `none` - Don't create a log file.
   - `standard` - Log only basic player information, the same as what's printed to the console (default).
   - `extended` - Log all player information and additional match information.
-  - `stats` - Same as above with the addition of player stats (points, K/D, win/lose) and disconnect detection.
+  - `full` - Same as above with the addition of player stats (points, K/D, win/lose), disconnect detection, and match results.
 Requires the match to end to finish logging; if it ends abruptly, the stats won't be logged.
 
 - `--service` - Choose which network service you're using.
@@ -93,11 +98,6 @@ Also allows you to view information about the lobby/gathering while on the match
 
     (These options don't affect anything if the log level is set to `none`)
 
-- `--stack Address (in hex)` - (Cemu only, optional) Beginning address of the stack space for Default Core 1 (Debug > View PPC threads).
-Only required for logging stats. If the default values don't work, you'll need to specify this manually.
-
-  <img src="assets/stack.png" width="600" alt="(example)">
-
 - `-sl`, `--single-log` - Enable single log mode. When enabled, only one log file will be created for each day and logging will resume in that file
 instead of creating a new one for each logging session (default behavior for `--auto latest`).
 
@@ -125,7 +125,7 @@ ip = "192.168.1.50"
 # Target network service: "pretendo", "altendo", or "none"
 service = "pretendo"
 
-# Log level: "standard", "extended", "stats", or "none"
+# Log level: "standard", "extended", "full", or "none"
 log_level = "extended"
 
 # Auto logging: "all", "latest" (omit for manual logging)
@@ -144,9 +144,6 @@ single_log = true
 # Cemu process ID (set to -1 to find automatically)
 # Uncomment this option to enable Cemu mode
 # cemu = -1
-
-# Beginning address of the stack space for Default Core 1 (set only if stat logging doesn't work by default)
-# stack = "0xE101440"
 ```
 
 ### Troubleshooting
@@ -157,9 +154,6 @@ If it keeps failing to connect, make sure that:
 - Port 7331 isn't blocked by the firewall.
 - TCPGecko is running.
 
-There's an issue with TCPGecko where opening an applet such as the Friend List and going back into the game causes memory
-reads to fail. If auto-logging is enabled, you'll need to restart Splatlogger after returning to the game.
-
 For Cemu users on Linux, if you have ptrace protection enabled, you'll need to run Python as root.
 In that case, it's best to run the package from source or use the executable instead.
 
@@ -183,9 +177,7 @@ python scripts/build.py [--upx-dir path/to/upx]
 ```
 use `--upx-dir` if you're using UPX to compress the executable.
 
-You can also use `build.bat` on Windows and `build.sh` on Linux to handle everything automatically.
-
-(No builds or build script are provided for macOS as I don't have a Mac to test, and my attempts at virtualizing macOS have been unsuccessful.)
+You can also use `build.bat` on Windows and `build.sh` on Linux/macOS to handle everything automatically.
 
 ## Acknowledgments
 - NWPlayer123 for the reference implementation of a TCPGecko library.

{splatlogger-1.2.4 → splatlogger-1.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "Splatlogger"
-version = "1.2.4"
+version = "1.3.1"
 authors = [
     { name="Shadow Doggo", email="shadowdoggo@protonmail.com" }
 ]

{splatlogger-1.2.4 → splatlogger-1.3.1/src/Splatlogger.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Splatlogger
-Version: 1.2.4
+Version: 1.3.1
 Summary: PID Grabber and player/match information logging tool for Splatoon
 Author-email: Shadow Doggo <shadowdoggo@protonmail.com>
 License-Expression: MIT
@@ -50,8 +50,13 @@ or any other app with the TCPGecko server.
 On Aroma, use [TCPGecko-Plugin](https://github.com/PinkDiamondTeam/TCPGecko-Plugin).
 
 ## Usage
+Splatlogger uses a command-line interface (CLI), you will need to run it within a terminal.
+
+On Windows, it's best to use [Windows Terminal](https://learn.microsoft.com/en-us/windows/terminal/install)
+or [PowerShell](https://learn.microsoft.com/en-us/powershell/scripting/install/install-powershell-on-windows), as the Command Prompt can't properly display certain characters.
+
 ### Running the executable
-Windows and Linux executables are provided on the [Releases](https://codeberg.org/ShadowDoggo/Splatlogger/releases/latest) page.
+Executables for Windows, Linux and macOS are provided on the [Releases](https://codeberg.org/ShadowDoggo/Splatlogger/releases/latest) page.
 
 Run Splatlogger with:
 ```
@@ -60,9 +65,9 @@ path/to/Splatlogger-executable --ip IP [options] / --cemu [PID] [options]
 Use the `--ip` target where `IP` is your Wii U's LAN IP address,
 or the `-c` / `--cemu` target to enable Cemu mode where `PID` is the process ID of the Cemu process (optional, should be detected automatically).
 
-Open a command prompt/terminal window and drag the executable into it to automatically get the path.
+Drag the executable into the terminal window to automatically get the path.
 
-On Linux, you might need to make the file executable first with `chmod +x path/to/Splatlogger-executable`
+On Linux and macOS, you might need to make the file executable first with `chmod +x path/to/Splatlogger-executable`
 
 ### Running with Python
 You can install Splatlogger as a package from PyPI:
@@ -103,7 +108,7 @@ python -m splatlogger --ip IP [options] / --cemu [PID] [options]
   - `none` - Don't create a log file.
   - `standard` - Log only basic player information, the same as what's printed to the console (default).
   - `extended` - Log all player information and additional match information.
-  - `stats` - Same as above with the addition of player stats (points, K/D, win/lose) and disconnect detection.
+  - `full` - Same as above with the addition of player stats (points, K/D, win/lose), disconnect detection, and match results.
 Requires the match to end to finish logging; if it ends abruptly, the stats won't be logged.
 
 - `--service` - Choose which network service you're using.
@@ -118,11 +123,6 @@ Also allows you to view information about the lobby/gathering while on the match
 
     (These options don't affect anything if the log level is set to `none`)
 
-- `--stack Address (in hex)` - (Cemu only, optional) Beginning address of the stack space for Default Core 1 (Debug > View PPC threads).
-Only required for logging stats. If the default values don't work, you'll need to specify this manually.
-
-  <img src="assets/stack.png" width="600" alt="(example)">
-
 - `-sl`, `--single-log` - Enable single log mode. When enabled, only one log file will be created for each day and logging will resume in that file
 instead of creating a new one for each logging session (default behavior for `--auto latest`).
 
@@ -150,7 +150,7 @@ ip = "192.168.1.50"
 # Target network service: "pretendo", "altendo", or "none"
 service = "pretendo"
 
-# Log level: "standard", "extended", "stats", or "none"
+# Log level: "standard", "extended", "full", or "none"
 log_level = "extended"
 
 # Auto logging: "all", "latest" (omit for manual logging)
@@ -169,9 +169,6 @@ single_log = true
 # Cemu process ID (set to -1 to find automatically)
 # Uncomment this option to enable Cemu mode
 # cemu = -1
-
-# Beginning address of the stack space for Default Core 1 (set only if stat logging doesn't work by default)
-# stack = "0xE101440"
 ```
 
 ### Troubleshooting
@@ -182,9 +179,6 @@ If it keeps failing to connect, make sure that:
 - Port 7331 isn't blocked by the firewall.
 - TCPGecko is running.
 
-There's an issue with TCPGecko where opening an applet such as the Friend List and going back into the game causes memory
-reads to fail. If auto-logging is enabled, you'll need to restart Splatlogger after returning to the game.
-
 For Cemu users on Linux, if you have ptrace protection enabled, you'll need to run Python as root.
 In that case, it's best to run the package from source or use the executable instead.
 
@@ -208,9 +202,7 @@ python scripts/build.py [--upx-dir path/to/upx]
 ```
 use `--upx-dir` if you're using UPX to compress the executable.
 
-You can also use `build.bat` on Windows and `build.sh` on Linux to handle everything automatically.
-
-(No builds or build script are provided for macOS as I don't have a Mac to test, and my attempts at virtualizing macOS have been unsuccessful.)
+You can also use `build.bat` on Windows and `build.sh` on Linux/macOS to handle everything automatically.
 
 ## Acknowledgments
 - NWPlayer123 for the reference implementation of a TCPGecko library.

{splatlogger-1.2.4 → splatlogger-1.3.1}/src/splatlogger/__init__.py

@@ -1,2 +1,2 @@
-__version__ = "1.2.4"
+__version__ = "1.3.1"
 __author__ = "Shadow Doggo"

{splatlogger-1.2.4 → splatlogger-1.3.1}/src/splatlogger/__main__.py

@@ -3,6 +3,5 @@ try:
 except ImportError:
     from splatlogger.cli import cli
 
-
 if __name__ == "__main__":
     cli()

{splatlogger-1.2.4 → splatlogger-1.3.1}/src/splatlogger/cemu_gecko.py

@@ -74,11 +74,9 @@ class CemuGecko:
     def resolve_pointer_chain(self, base_address: int, offsets: list[int]) -> int:
         """Follow a pointer chain to its destination address starting from base_address and applying offsets."""
         current_address = self.peek32(base_address)
-
         for offset in offsets[:-1]:
             if current_address == 0:
                 return 0
-
             current_address = self.peek32(current_address + offset)
 
         if current_address != 0 and offsets:

{splatlogger-1.2.4 → splatlogger-1.3.1}/src/splatlogger/cli.py

@@ -7,7 +7,7 @@ import webbrowser
 from pathlib import Path
 
 import userpaths
-from colorama import Fore, Style, just_fix_windows_console
+from colorama import just_fix_windows_console
 from prompt_toolkit import PromptSession
 from prompt_toolkit.patch_stdout import patch_stdout
 
@@ -70,7 +70,7 @@ def command_listener(ctx: AppContext) -> None:
 
 
 def parse_args() -> Options:
-    parser = argparse.ArgumentParser(description="PID (Principal ID)/Network ID grabber and match logger for Splatoon")
+    parser = argparse.ArgumentParser(description="PID Grabber and player/match information logging tool for Splatoon")
     add_parser_arguments(parser)
 
     config_path = Path(userpaths.get_my_documents()) / "Splatlogger/config.toml"
@@ -83,28 +83,25 @@ def parse_args() -> Options:
     args = parser.parse_args()
 
     if not args.ip and not args.cemu:
-        print(
-            f'{Fore.YELLOW}No target (IP address or Cemu mode) was provided. Run "splatlogger -h" for help.{Style.RESET_ALL}'
-            "\nWould you like to open the README? (y/n)")
+        uf.print_warning("No target (IP address or Cemu mode) was provided. Run \"splatlogger -h\" for help.\n")
+        print("Would you like to open the README? (y/n)")
         if input().lower() in ("y", "yes"):
             webbrowser.open("https://codeberg.org/ShadowDoggo/Splatlogger/src/branch/main/README.md")
         sys.exit()
 
-    stack_addr: int | None = None
-    if args.stack and args.cemu:
-        try:
-            stack_addr = int(args.stack, 16)
-        except ValueError:
-            uf.print_error("Invalid stack address. Please provide a valid hex value.")
-            sys.exit()
-
     if args.log_level == "none" and args.silent:
-        uf.print_warning("You have disabled printing logs to the console as well as creating a log file. "
-                         "Are you sure this wasn't a mistake?\n")
+        uf.print_warning("Silent mode is enabled and no log level is set. No information will be logged.\n")
 
-    return Options(ip=args.ip, log_level=args.log_level, auto_logging=args.auto in ("all", "latest"),
-                   log_latest=args.auto == "latest", platform="cemu" if args.cemu else "wiiu", cemu_pid=args.cemu,
-                   service=args.service, silent_logging=args.silent, single_log=args.single_log, stack=stack_addr)
+    return Options(
+        ip=args.ip,
+        log_level=args.log_level,
+        auto_logging=args.auto in ("all", "latest"),
+        log_latest=args.auto == "latest",
+        platform="cemu" if args.cemu else "wiiu", cemu_pid=args.cemu,
+        service=args.service,
+        silent_logging=args.silent,
+        single_log=args.single_log
+    )
 
 
 def add_parser_arguments(parser: argparse.ArgumentParser) -> None:
@@ -113,15 +110,12 @@ def add_parser_arguments(parser: argparse.ArgumentParser) -> None:
                         help="Switch to Cemu mode (optional: PID of the Cemu process).", metavar="PID",
                         nargs="?", const=-1)
     parser.add_argument("--log-level", help="Set how much data should be logged (see README).",
-                        choices=["none", "standard", "extended", "stats"], default="standard")
+                        choices=["none", "standard", "extended", "full"], default="standard")
     parser.add_argument("--service", help="Choose which network service you're using (Pretendo by default).",
                         choices=["none", "pretendo", "altendo"], default="pretendo")
     parser.add_argument("-a", "--auto",
                         help="Enable auto logging (see README).",
                         choices=["all", "latest"], nargs="?", const="all")
-    parser.add_argument("--stack",
-                        help="Beginning address of the stack space for Default Core 1 (Cemu only, see README).",
-                        metavar="Address (in hex)")
     parser.add_argument("-sl", "--single-log", help="Enable single log file mode.", action="store_true")
     parser.add_argument("-s", "--silent", help="Disable printing logs to the console.", action="store_true")
 
@@ -136,7 +130,7 @@ CONFIG_TEMPLATE = """# Splatlogger Configuration
 # Target network service: "pretendo", "altendo", or "none"
 # service = "pretendo"
 
-# Log level: "standard", "extended", "stats", or "none"
+# Log level: "standard", "extended", "full", or "none"
 # log_level = "standard"
 
 # Auto logging: "all", "latest" (omit for manual logging)
@@ -155,9 +149,6 @@ CONFIG_TEMPLATE = """# Splatlogger Configuration
 # Cemu process ID (set to -1 to find automatically)
 # Uncomment this option to enable Cemu mode
 # cemu = -1
-
-# Beginning address of the stack space for Default Core 1 (set only if stat logging doesn't work by default)
-# stack = "0xE101440"
 """
 
 

splatlogger-1.3.1/src/splatlogger/enums.py

@@ -0,0 +1,137 @@
+# Splatlogger (c) 2025 Shadow Doggo.
+
+from enum import Enum, IntEnum
+
+
+class Pointers(IntEnum):
+    SESSION = 0x101E8980
+    STATIC_MEM = 0x101DD330
+    MAIN_MGR_BASE = 0x101E2814
+    MAIN_MGR_VS_GAME = 0x101E4FF8
+    FRAMEWORK = 0x101E80A8
+
+    def convert(self, platform: str) -> int:
+        return self.value + Offsets.WIIU_BSS_OFFSET if platform == "wiiu" else self.value
+
+
+class Offsets(IntEnum):
+    WIIU_BSS_OFFSET = 0x503000
+    SESSION_ID_IDX = 0xBD
+    SESSION_ID = 0xCC
+    SESSION_ACTIVE_STATION_LIST_SENTINEL = 0xD8
+    SESSION_ACTIVE_STATION_LIST_FIRST_NODE_PTR = 0xDC
+    SESSION_ACTIVE_STATION_LIST_COUNT = 0xE0
+    SESSION_STATION_NODE_CAPACITY = 0xFC
+    STATION_LIST_NODE_PREV_PTR = 0x0
+    STATION_LIST_NODE_NEXT_PTR = 0x4
+    STATION_LIST_NODE_STATION_ID = 0x8
+    STATION_LIST_NODE_SIZE = 0x10
+    MAINMGR_PLAYER_MGR_PTR = 0x268
+    PLAYERMGR_PLAYER_COUNT = 0x320
+    MAINMGR_VS_GAME_SEQ_MGR_VS_GAME_PTR = 0x2A4
+    MAINMGR_VS_GAME_PAGE_HANDLER_PTR = 0x2D8
+    SEQ_MGR_VS_GAME_FINAL_RESULT_PTR = 0xAA8
+    SEQ_MGR_VS_GAME_FINAL_RESULT_SCORE_PTR = 0x294
+    SCORE_OBJECT_TEAM_RESULTS_ARY_PTR = 0x10
+    TEAM_RESULTS_ARY_SIZE_REGULAR = 0x18
+    TEAM_RESULTS_ARY_SIZE_RANKED = 0x2C
+    TEAM_RESULTS_PAINT_PC = 0x4
+    TEAM_RESULTS_WON = 0xC
+    TEAM_RESULTS_RANKED_OBJ_COUNT = 0x10
+    TEAM_RESULTS_POINTS = 0x14
+    PAGE_HANDLER_RESULTS_PAGE_PTR = 0x118
+    PAGE_HANDLER_LEADERBOARD_PAGE_PTR = 0x11C
+    RESULTS_PAGE_PHASE = 0x1E8
+    LEADERBOARD_PAGE_SLOTS = 0x214
+    LEADERBOARD_PAGE_ROWS_PTR = 0x218
+    ROWS_PLAYER_STRIDE = 0x20
+    ROWS_PLAYER_IDX = 0x0
+    ROWS_PLAYER_PLAYERINFO_PTR = 0x4
+    ROWS_PLAYER_TEAM = 0x8
+    ROWS_PLAYER_POINTS = 0xC
+    ROWS_PLAYER_KILLS = 0x10
+    ROWS_PLAYER_DEATHS = 0x14
+    ROWS_PLAYER_LOCAL_PLAYER_FLAG = 0x1C
+    FRAMEWORK_PEER_MGR_PTR = 0x14
+    PEER_MGR_ID_MGR_PTR = 0x84
+    ID_MGR_SLOT_ARY_PTR = 0x8
+    SLOT_SIZE = 0x14
+    SLOT_STATE = 0x0
+    SLOT_PID = 0x4
+    SLOT_PLAYER_ID = 0x12
+    STATICMEM_PLAYER_INFO_ARY_PTR = 0x10
+    STATICMEM_STAGE = 0x28
+    STATICMEM_MATCH_HOUR = 0x234
+    STATICMEM_VERSUS_MODE = 0x238
+    STATICMEM_VERSUS_RULE = 0x23C
+    PLAYER_INFO_NAME = 0x6
+    PLAYER_INFO_NAME_LENGTH = 0x20
+    PLAYER_INFO_REGION = 0x2C
+    PLAYER_INFO_TEAM = 0x33
+    PLAYER_INFO_GENDER = 0x37
+    PLAYER_INFO_SKIN_TONE = 0x3B
+    PLAYER_INFO_EYE_COLOR = 0x3F
+    PLAYER_INFO_WEAPON_SET = 0x42
+    PLAYER_INFO_MAIN_WEAPON = 0x46
+    PLAYER_INFO_SUB_WEAPON = 0x4A
+    PLAYER_INFO_SPECIAL_WEAPON = 0x4F
+    PLAYER_INFO_SHOES = 0x54
+    PLAYER_INFO_CLOTHES = 0x70
+    PLAYER_INFO_HEADGEAR = 0x8C
+    PLAYER_INFO_INK_TANK = 0xAA
+    PLAYER_INFO_LEVEL = 0xAF
+    PLAYER_INFO_RANK = 0xB3
+    PLAYER_INFO_FEST_TEAM = 0xB7
+    PLAYER_INFO_FEST_ID = 0xBA
+    PLAYER_INFO_FEST_RANK = 0xBF
+    PLAYER_INFO_PID = 0xD0
+    PLAYER_INFO_FEST_POWER = 0xD6
+    PLAYER_INFO_SIZE = 0xD8
+
+
+class OffsetChains(Enum):
+    ID_MANAGER = (
+        Offsets.FRAMEWORK_PEER_MGR_PTR,
+        Offsets.PEER_MGR_ID_MGR_PTR,
+        0
+    )
+    ID_MANAGER_SLOT_ARRAY = (
+        Offsets.ID_MGR_SLOT_ARY_PTR,
+        0
+    )
+    RESULTS_PHASE_ADDRESS = (
+        Offsets.MAINMGR_VS_GAME_PAGE_HANDLER_PTR,
+        Offsets.PAGE_HANDLER_RESULTS_PAGE_PTR,
+        Offsets.RESULTS_PAGE_PHASE
+    )
+    LEADERBOARD_PAGE = (
+        Offsets.MAINMGR_VS_GAME_PAGE_HANDLER_PTR,
+        Offsets.PAGE_HANDLER_LEADERBOARD_PAGE_PTR,
+        0
+    )
+    TEAM_RESULTS_ARRAY = (
+        Offsets.MAINMGR_VS_GAME_SEQ_MGR_VS_GAME_PTR,
+        Offsets.SEQ_MGR_VS_GAME_FINAL_RESULT_PTR,
+        Offsets.SEQ_MGR_VS_GAME_FINAL_RESULT_SCORE_PTR,
+        Offsets.SCORE_OBJECT_TEAM_RESULTS_ARY_PTR,
+        0
+    )
+
+    @property
+    def offsets(self) -> list[int]:
+        return list(self.value)
+
+
+class VSMode(IntEnum):
+    REGULAR = 0
+    GACHI = 1
+    FEST = 2
+    PRIVATE = 3
+    PARTY = 4
+
+
+class VSRule(IntEnum):
+    TURF = 0
+    RAINMAKER = 1
+    ZONES = 2
+    TOWER = 3