Find your guide

Independent port guide.

Mods · Hookshot

Ocarina of Time Remake PC Mods: Install and Manage

Hookshot loads RomFS replacement mods, which replace files in the game's data folder. Manage them through the mods directory beside the built game, check the loading log, and keep the separate experimental co-op installation apart from your main game.

On this page

Install and Manage Mods

  1. 1
    Back up your settings and existing mods before adding replacements.
  2. 2
    Place each mod's replacement files inside its own romfs folder under the game's mods directory.
  3. 3
    Choose folder names for the desired loading order; prefix a mod's name with - or _ to disable it.
  4. 4
    Launch the game and check hookshot_log.txt for the files that loaded or were replaced.

Keep the mod's folder between mods and romfs; the game-data replacements go inside that mod's romfs tree.

Example folder layout

  • Hookshot/
    • mods/
      • TexturePack/
        • romfs/

TexturePack is an example mod-folder name; place your replacement data under its romfs folder. To disable that example while keeping its files, rename the mod folder with a leading - or _.

Use Hookshot-Textures

For replacement textures generated from your installed game, follow Hookshot-Textures' instructions with your own built Hookshot folder. Install its generated replacements using the same mod-folder layout.

Load Order and Compatibility

A resource size table records how much memory each game file needs.

Situation Action
Two mods replace the same file Last folder in sorted order wins
A mod makes resources larger Supply the matching resource size table
Two mods change the resource size table Enable only one of those mods at a time
A code patch (.ips or .pchtxt) Use a mod made for the RomFS data-replacement loader instead

Use the table supplied with a mod that makes files larger, and match the mod to your game build. If two mods change that table, disable one by adding - or _ at the start of its folder name; keep only one enabled.

For frame-rate changes, use the built-in cap and frame-generation options in Settings. The regular RomFS loader skips executable patches; co-op also rejects code/cheat mods.

Textures fail to load or a modded start stops

  1. 1
    Check hookshot_log.txt to see which replacement files loaded.
  2. 2
    Check which active mods replace the same paths and which table handles enlarged resources.
  3. 3
    Disable a conflicting mod by prefixing its folder with - or _, then launch with the remaining set.

For a driver crash or a graphics fault that also occurs with the mod disabled, use Troubleshooting.

Online co-op (experimental)

Ocarina of Time Remake Multiplayer, by daurosk, adds other Links and shared progress in an online session. The test10 kit, version v0.1.0-test10, is a prerelease that builds a separate Hookshot v2.2.0-rc.1 build modified for multiplayer. Keep that installation separate from the mainline Hookshot game used by this guide.

Use the co-op release and its setup instructions for that separate build; its checked game version is 1.1.1. The kit also contains its own Fritchii emulator modified for multiplayer, and the author describes mixed sessions with the patched Hookshot and emulator builds. Everyone needs their own game and compatible multiplayer builds.