NX2NAVI / MODS WALKTHROUGH

NX2navi GitHub mods: install, order and restore

Open Mods in the NX2navi launcher, choose Add a Mod for an archive or Add a Mod Folder for extracted files, then check the mod’s On/Off row. Load Order decides which duplicate resource wins. A new code patch can require a rebuild before Play.

NX2navi 0.10.1 · Switch 2 Ocarina of Time 1.1.1 · Reviewed 14 November 2026

English NX2navi Mods controls: Add a Mod and Add a Mod Folder.
The launcher’s Mods screen is separate from the running game’s F1 settings.

What should I check before installing NX2navi mods?

Start with a working, unmodified game. These steps use the 0.10.1 launcher and game update 1.1.1. Mods for the N64 game or Ship of Harkinian use a different project and file layout.

  • Update the launcher. The Mods manager arrived in 0.9.1; 0.10.1 also fixes 0.10.0’s camera-related video-memory growth. Use the version comparison to match older instructions.
  • Export progress. Close the game, then use Saves → Export Save. Keep the ZIP outside the game folder.
  • Check the mod’s target. Match Switch 2 Ocarina of Time 1.1.1, the author’s required update and any required companion mod.
  • Add one change at a time. Load the same save and revisit the same scene before installing the next mod.

If the base game has not launched yet, finish the NX2navi installation guide first.

How do I install a mod archive or folder?

Close the game and choose Mods on the launcher’s main menu, below Saves. Use the import control that matches the files you have.

Close-up of the English Add a Mod and Add a Mod Folder buttons.

Archive → Add a Mod; extracted folder → Add a Mod Folder

Choose the correct import control

Actual English controls from the 0.10.1 source launcher: Add a Mod selects an archive; Add a Mod Folder selects a directory.

Image source ↗
View the captured import controls NX2navi English Add a Mod Choose a File and Add a Mod Folder Choose a Folder controls.Open full-size image ↗
01

Choose the archive or its extracted mod folder

For a .zip, choose Add a Mod. Windows 10/11 also uses its system archive tool for .7z and .rar. For an extracted mod, choose Add a Mod Folder and select the folder containing romfs, exefs, cheats or the supported Atmosphere tree.

02

Wait for the mod to appear

The launcher unpacks or copies the chosen files into a separate folder under mods. An archive with one extra wrapper folder is normalised automatically. Keep the original download so you can return to it if the mod package has options to select.

03

Read its On/Off row and description

Select the imported mod. Its description lists replacement resources, code patches or cheats, and any conflicting mod.

An enabled, usable mod is read at the game’s next start. If the row says Not Usable, follow the stated reason before pressing Play.

NX2navi Example B and Example A On/Off switches and the Load Order entry.

On enables a mod for the next game start

English Example B description: its shared file wins over Example A because it is higher in the load order.

The description names the competing mod and winner

Read the mod’s state before Play

The real 0.10.1 launcher with two original sample folders, Example A and Example B. Each holds the same harmless example.txt path so the description can show a file conflict; these are folder-layout examples.

Image source ↗
View the complete window English NX2navi sample mod rows and the selected mod’s resource-conflict description.Open full-size image ↗
04

Start once and compare

Return to the main menu and choose Play. Let a requested code rebuild finish, then load your usual save and check the area the mod changes. Quit the game before changing the next mod or its order.

Where is the NX2navi mods folder?

Use Mods → Open Mods Folder to open the active location. The default is mods inside the built game folder, with one directory for each mod. mods_dir in nx2navi.ini can name another resource-mod location; code-mod builds read the game folder’s own mods directory.

Default layout · a mod can contain one or more supported parts
game/
└── mods/
    └── My Mod/
        ├── romfs/
        ├── exefs/
        └── cheats/

The launcher also recognises the Atmosphere form below. The title directory must match 0400486024DEC000. Keep the author’s relative resource paths inside romfs.

Supported Atmosphere layout · same game, different wrapping
My Mod/
└── atmosphere/
    └── contents/
        └── 0400486024DEC000/
            ├── romfs/
            ├── exefs/
            └── cheats/
romfs / romfslite
Replacement resources such as models, text or textures. Place files at the exact game-relative paths expected by the mod.
exefs
Supported .ips or .pchtxt code patches. Their game build ID must match; a code-module download such as subsdk* has a different requirement and can be refused.
cheats
Supported cheat definitions. The build incorporates code changes, while the running game’s Cheats tab switches individual cheats.

A download containing several alternative mod folders needs a choice. Select the intended option’s folder rather than treating every alternative as one mod.

Which mod wins when two replace the same file?

The higher mod in Load Order wins a duplicate resource path. This applies to enabled resource replacements. It does not combine two code patches or make an incompatible patch usable.

WORKED FOLDER EXAMPLE

  1. 1 · Example BReplaces romfs/example.txt → this file wins.
  2. 2 · Example AReplaces the same path → its duplicate is overridden.

Move Example A above Example B to reverse the winner. Disable one of them to remove this resource conflict.

NX2navi English Load Order arrows and numbered sample mod priority.

Position 1 wins the shared resource

Load Order · higher entry takes priority

Actual 0.10.1 Load Order controls with the same Example B / Example A sample folders. Select a row and use its left/right control to move it. The number is its priority position.

Image source ↗
View the captured priority controls English NX2navi Load Order with Example B at position one and Example A at position two.Open full-size image ↗
  1. Quit the game, open Mods → Load Order and select the mod to move.
  2. Use the left arrow to move it above the competing replacement. The right arrow moves it down.
  3. Return to Mods and read the conflict description; it names which mod now wins.
  4. Start the game again and check the same scene.

Changing the order affects duplicate files. Each mod’s non-conflicting resources can still load, so disabling the whole mod is the clearer test when isolating a fault.

Why does Play say Build Waiting or rebuild after adding a mod?

Ahead-of-time code patches must be included in the compiled game. When an enabled mod adds code that the current build has not incorporated, the launcher shows Build Waiting; Play rebuilds the changed code first and starts the game afterward.

Resource-only change

romfs replacement → check priority → start the game again. These files do not require lifting the console’s code again.

New code patch or cheat

exefs / code cheat → build checks patch files → translate and compile affected code → Play. Existing prepared shaders stay.

  • Keep code mods under the built game folder’s own mods directory.
  • Wait for the requested rebuild instead of deleting build-cache or shader folders.
  • When launching through Steam, a required mod rebuild can open the launcher’s build window first.
  • After changing cheat settings, restart as the menu requests; select individual cheats in the game’s Cheats tab.

The build records incorporated mod code in build-cache/mod-code.json. Keep that file with the build cache. For an ordinary program update, use the separate version-specific upgrade steps.

How do I disable or remove a mod safely?

  1. Close the game. Mod choices are read on startup; an already running game retains its current state.
  2. Switch the changed mod Off. Keep the files while testing. Start the game, load the same save and check the affected area.
  3. Restore your known order. If you moved several mods, restore their positions and enable them one at a time.
  4. Remove both copies when deleting. Open Mods Folder and remove the mod’s extracted folder and any archive still inside mods. A retained archive can be unpacked again on the next preparation pass.

Turning a mod Off keeps it installed for later use. Deleting its files is separate from restoring progress: use your exported save if you also need to return to an earlier game state. Follow the save backup and restore steps →

Why is my NX2navi mod missing or not working?

The row says Not Usable

Select it and read the reason. The launcher distinguishes an unsupported code module, alternatives that need selecting, another game or update, unsupported patch content, and a folder with no readable mod files. Choose a package matching this game’s 1.1.1 update, or import the selected alternative folder.

The mod is On, but the old texture or resource remains
  1. Check the game-relative file path inside romfs.
  2. Read the selected mod’s conflict description and move it above the competing replacement.
  3. Close and restart the game after changing its switch or order.
  4. Test with other mods Off to isolate the replacement.
A code mod never takes effect

Use the game folder’s own mods directory and match the code patch’s build ID. Check whether Play requests a rebuild and let it complete. The folder’s existence alone does not make a patch for another game update compatible.

The archive is refused or a Windows filename is named

Keep the error text. The importer rejects paths that escape their destination and names Windows cannot preserve, including device names, trailing dots/spaces and invalid characters. Use a corrected package or rename the offending entry if the mod author’s layout permits it; renaming only the outer ZIP does not change files inside.

The game crashes or changes behaviour after installing a mod
  1. Quit, disable the most recent mod and load the same scene again.
  2. If the base game works, test that mod alone with the required game update.
  3. On 0.10.1, press F8 while the faulty state is visible, then keep the numbered capture folder.
  4. Include the mod name, load order, NX2navi version and the difference with it disabled.

Find the F8 capture and report steps → · Continue with base-game troubleshooting →

Sources and your next step

English screenshots show the unmodified 0.10.1 launcher. The conflict example uses two original sample folders so you can follow the priority change independently of any downloaded mod.