How tangerineturtle1/nx2navi works
NX2navi turns a user’s legally obtained game dump into a native x86-64 game build, then launches and updates it. The runtime replays the game through Vulkan and supplies platform, input, audio, settings, and menu features. The graph retains the documented installation/build stages and major runtime capabilities; some subsystem links are supported only by README statements or source-index references, so unsampled implementation details are not inferred.
Main entry points: main.c Runtime entry · host.h Guest host · app.py Launcher UI · build.py Build orchestration
Components 21
Setup and launch
- Installer workflow
installer/steps.py - Launcher UI
launcher/ui/app.py - Launcher jobs
launcher/jobs.py - Build orchestration
launcher/build.py - Launcher settings
launcher/settings.py
Game build
- Game files
launcher/gamefiles.py - Static recompiler
recomp/lifter.py - SIMD lowering
recomp/simd_c.py - Shader translator
tools/xlate/Program.cs
Runtime core
- Runtime entry
runtime/main.c - Guest host
runtime/host.h - Platform services
runtime/platform/platform.h - Runtime settings
runtime/cfg.h
Graphics
- Vulkan replay
runtime/vk_pipeline.c - Frame generation
runtime/vk_fg.cpp
Player experience
- Input handling
runtime/input.c - Audio system
runtime/audren.c - In-game menu
runtime/ui/menu.cpp
Other components
- Player
- Game dump
- Discord presence
Connections 24
- Player → Installer workflow: starts setup
README.md - Game dump → Installer workflow: provides dump
README.md - Installer workflow → Game files: extracts game data
installer/steps.py - Player → Launcher UI: launches game
README.md - Launcher UI → Launcher jobs: starts jobs
launcher/ui/app.py - Launcher jobs → Build orchestration: runs build
launcher/jobs.py - Build orchestration → Game files: prepares game files
- Game files → Static recompiler: supplies game input
- Static recompiler → SIMD lowering: uses lowering
recomp/lifter.py - Build orchestration → Shader translator: builds shaders
- Player → Runtime entry: runs built game
README.md - Runtime entry → Guest host: runs guest code
runtime/main.c - Runtime entry → Platform services: uses platform services
runtime/main.c - Runtime entry → Runtime settings: initializes settings
runtime/main.c - Guest host → Vulkan replay: replays graphics
runtime/vk_pipeline.c - Shader translator → Vulkan replay: translates shaders for
runtime/vk_pipeline.c - Vulkan replay → Frame generation: supports frame generation
- Guest host → Input handling: handles controls
- Guest host → Audio system: provides game audio
- Runtime entry → In-game menu: runs settings menu
- In-game menu → Runtime settings: changes settings
runtime/cfg.h - Launcher UI → Launcher settings: reads settings
launcher/ui/app.py - Launcher settings → Runtime settings: configures game
- Runtime entry → Discord presence: reports play status