feat/mods-exefs-patches #1

Merged

DeathWrench merged 6 commits from snaildev99/Hookshot-fork:feat/mods-exefs-patches into main

2026-11-13 23:57:55 +00:00

DeathWrench commented

2026-11-13 23:57:41 +00:00

Owner

No description provided.

DeathWrench added 6 commits

2026-11-13 23:57:41 +00:00

feat(mods): a Mods tab, merged resource size tables, ExeFS patches and Atmosphere cheats 0df270d844

Mods that each grow files (HD texture packs) could not be combined: only one
resource size table was used. Hookshot now merges every enabled mod's table
into the game's at start (the button prompts' entries kept) and raises the
entry of every file a mod serves to fit its size (host/mods.c, host/restbl.c,
host/zs.c). #2270's merge of the prompts' entries into the winning mod's table
stays as the fallback when no merged table can be made.

The Insert menu gets a Mods tab (shown only when there are mods): each mod on
or off and its place in the list, kept in hookshot_mods.txt and applied at the
next start (the restart question names them), and the cheats of the enabled
mods, switched at once.

ExeFS patches (IPS, IPS32, IPSwitch .pchtxt) are applied to main's image when
the game is built (nx2/exefs_patches.py, nx2/image.py), so the code is
translated from the patched instructions; a write into the padding after the
code (a code cave) makes it code. exefs_patches.txt in the game folder lists
what a build applied; the Mods tab says when a patch waits for a build.

Atmosphere cheat-code files (separate from the Debug tab's built-in cheats)
run in a cheat VM after dmnt's (host/cheats.c), every presented frame, on
guest memory the game was given; cheats that write the game's code are
listed as not supported.

The list, order and switches, the size table's merge, the patch formats and
the cheat VM follow valentderah/totk-pc-recomp (MIT), whose notice is kept in
host/restbl.h and nx2/exefs_patches.py.

Co-authored-by: Valiantsin Dzerakh <[email protected]>
Co-authored-by: conongnang <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(menu): the control bridge's tab names include the Mods tab 1edd0f6a11

The control bridge's bridge_fill names each MenuTab and checks the count: with the Mods tab
added before Debug, its table needs "mods" there.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

fix(menu): the compact bar leaves the Mods tab its full page 0c891e4452

The compact bar (added to main after the Mods tab was written) draws the
selected row of the current tab. The Mods tab has no such rows: its lines come
from the host. With the bar asked for on the Mods tab the full page is drawn.

Co-Authored-By: Claude Fable 5.2 <[email protected]>

fix(mods): the review of the port: the size table for the prompts, mods that are off, Longshot's name, the game's case e3c9c9efab

- hos_mods_file gives prompts.c no table when the merged one is served.
- A mod that is off: its ExeFS files are not counted as waiting for a build
  (the Mods tab's text and the log's line).
- The Mods tab's texts and longshot_mods.txt's header say Longshot.
- A Restart or Quit waiting for its second press is cleared on the Mods tab.
- The merged size table: a mod file whose path is in another case than the
  game's takes the game's entry (looked up only when the mod's own case
  misses the table).
- exefs_patches.py: bytes into a relocated word are left out and the file's
  note says so; the comment on DT_RELR words says what happens.
- The compact bar on the Mods tab dims the game behind, as the full menu.

Co-Authored-By: Claude Fable 5.2 <[email protected]>

docs(mods): the Mods tab's file and the two written beside it, in the development guide e75e352dd4

Co-Authored-By: Claude Fable 5.2 <[email protected]>

fix(mods): the port to Hookshot's main: Hookshot's names, and API version 23 for the Mods tab's functions b5e3f992e3

main took version 22 for wide_cover while this was on its branch: the Mods tab's five functions come after it, as
version 23 (vk_api.h, can_mods, tests/test_mods_menu.py). The file of the Mods tab is hookshot_mods.txt and its texts
say Hookshot.

Co-Authored-By: Claude Fable 5.2 <[email protected]>