Skip to content

docs: mods that make files bigger need the resource size table grown - #1325

Merged
hckrman101 merged 1 commit into
NotRexed:mainfrom
Joey-Magnus:docs/mods-size-table
Nov 9, 2026
Merged

hckrman101 merged 1 commit into
NotRexed:mainfrom
Joey-Magnus:docs/mods-size-table

Conversation

@Joey-Magnus

Copy link
Copy Markdown
Contributor

What

A paragraph in the readme's Mods section: a mod file bigger than the game's own only loads if the resource size table (System/Resource/ResourceSizeTable.Product.111.Nin_Ounce_NVN2.rsizetable.zs) allows for it, and only one mod's table is used.

Why

Making an HD texture pack, the 2x textures were packed correctly but never reached the GPU (RX_VK_WATCH_DIM at the new size: no textures made), and a pack of every colour texture left the game on a loading screen. Each texture's entry in the table is exactly its decompressed size + 280; with the entries grown, the same pack loads and every replaced texture shows in game (a magenta-tinted test pack, Kokiri Forest, Linux + RTX 4070 Ti). Because Hookshot replaces whole files and the last-sorting mod wins, two mods that each grow files need one merged table.

Checked

  • The table round-trips byte for byte (RESTBL v1: 219,968 CRC32 entries, 10 by name).
  • Without the grown table: no 2x textures created, all-texture pack stuck loading. With it: loads into gameplay, textures sampled at the new size.
  • Readme only; no code change.

The builder this came from, for anyone making texture mods (no game data in it): https://github.com/Joey-Magnus/Hookshot-Textures

AI assistance: written with Claude Opus 5.5 (trailers on the commit).

Assisted-by: Claude Opus 5.5 (Anthropic)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@hckrman101
hckrman101 merged commit 6b7e89b into NotRexed:main Nov 9, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant