Atmosphere mods/ folder layout
NX2navi includes a built-in mod loader rooted at mods/ next to ocarina.exe (overrideable via mods_dir in nx2navi.ini). Each subfolder inside mods/ is one mod, accepting either flat folders or standard Atmosphere contents/0400486024DEC000/ paths:
mods/
hd-hud-example/
romfs/ # Overrides matching game files at runtime
gameplay-patch/
exefs/ # .ips or .pchtxt targeting nsobid-E0F3CCFA...
cheats/ # Standard Switch cheat text files- mods_order & mods_disabled
- Control load priority with comma-separated folder names in
mods_order = base,tweaks(later entries win file conflicts) and mute packs temporarily viamods_disabled = tweaks. - mods_rebuild = auto (Code mods)
- Because NX2navi is statically recompiled ahead of time rather than interpreted by an ARM JIT,
exefs.ips/.pchtxtpatches targeting main builde0f3ccfatrigger an automatic local rebuild intoocarina-mod.exe(orocarina-modon Linux) when mod hashes change. - RomFS-only mods
- Texture, audio, message, and layout replacements inside
romfs/mount instantaneously at launch with zero recompilation.
Button prompts & glyph baking
During the initial local build, tools/pad_prompts.py generates five ready-to-swap button-icon patch archives (romfs-patches-nintendo, xbox, playstation, steamdeck, and pc). Switch between them instantly in F1 or nx2navi.ini:
prompts = auto # auto | nintendo | xbox | playstation | steamdeck | pc
pad_layout = auto # auto | nintendo | xbox | playstation (swaps A/B & X/Y confirm)
sprint_button = l3 # off | l3 | b
sprint_mode = toggle # toggle | holdModders designing custom UI icon themes can edit the source glyph sheets fed into tools/pad_prompts.py and regenerate a custom romfs-patches-* pack.
SDL3, 6-axis gyro & DualShock 3
| Input Capability | nx2navi.ini Keys | Notes |
|---|---|---|
| 6-Axis Motion Aim | motion = 1, motion_sens = 100 | Works out of the box over USB/Bluetooth on DualSense, DualShock 4, Switch Pro, 8BitDo (Switch mode), and Steam Deck internal gyro. |
| Switch HD Rumble | rumble = 1, rumble_hd = 1 | Sends dual-band frequency envelopes to Switch Pro and DualSense controllers; set rumble_hd = 0 for standard ERM motors. |
| Direct DualShock 3 USB | ds3 = 1 | Reads Sony Sixaxis / DualShock 3 controllers directly over USB without third-party XInput wrapper drivers. |
| Mouse Camera Look | mouse_mode = direct, mouse_sens = 100 | direct maps raw mouse deltas to free camera; stick emulates right-stick deflection. |
| Per-Button Remapping | bind_a, bind_b, bind_cam_up... | Every controller action and keyboard chord can be rebound inside nx2navi.ini or the F1 Controls tab. |
5.1 Surround, mic & BC3 textures
- audio_channels = auto | stereo | 5.1
- Outputs discrete 6-channel surround PCM over HDMI eARC or multi-channel desktop DACs when
5.1(orautoon a 5.1/7.1 Windows endpoint) is active. - microphone = 1
- Enables host audio input for any game mechanic polling microphone amplitude.
- discord_rpc = 1
- Publishes current Hyrule region presence to Discord Desktop; set
discord_rpc = 0for complete offline privacy. - astc_bc = 1 / astc_bc1 = 1
- Transcodes Switch 2 ASTC blocks into native desktop BC3/BC1 textures, cutting VRAM consumption in half compared to uncompressed RGBA8 (
astc_bc = 0).
Controllers for SDL3 & Gyro
NX2navi reads SDL3 gamepads directly with 6-axis motion aiming (motion = 1), HD rumble (rumble_hd = 1), and prebuilt Nintendo, Xbox, PlayStation, and Steam Deck button prompt packs:
| Controller | NX2navi Input & Prompt Features | Connection | Amazon |
|---|---|---|---|
| 8BitDo Ultimate 2 Bluetooth Controller | Switch / XInput mode, 6-axis gyro aim & Hall-effect sticks (prompts = nintendo) | Bluetooth / 2.4G / USB-C | View controller |
| Sony DualSense Wireless Controller | 6-axis gyro bow & hookshot aim, adaptive triggers & prompts = playstation | USB-C / Bluetooth | View controller |
| GameSir Cyclone 2 Wireless Controller | TMR sticks, low-latency PC wireless & gyro motion in Switch mode | 2.4G Dongle / Bluetooth / USB-C | View controller |
| Xbox Wireless Controller | Plug-and-play Windows & Linux SDL3 mapping with prompts = xbox | Bluetooth / USB-C | View controller |
As an Amazon Associate, this site earns from qualifying purchases.