gamboozino / ngbrecomp

# Ninja Gaiden Black Recompiled
**A PC port of Ninja Gaiden Black by static recompilation.**
A native Linux and Windows version of *Ninja Gaiden Black* (Xbox, 2005), made by statically
recompiling the game's own code to run directly on a PC — not an emulator. It draws with its own
Vulkan renderer, which takes over the game's Direct3D calls instead of emulating the Xbox GPU. It
plays at a steady 60 fps on modest hardware (including the Steam Deck) and adds PC options: higher
resolutions, widescreen and ultrawide, keyboard and mouse, rebindable controls and more.
**You need your own copy of the game.** This project contains none of the game's data (graphics,
sound, movies, text): on first start it asks for your disc image and installs the game from it. It is made for the **retail USA
release** (NTSC-U, title ID `5443000D`) and checks for it.
## Features
- Native Linux (AppImage) and Windows (x64) builds; Steam Deck friendly
- Render resolution up to 10x, anisotropic filtering, MSAA, sharper shadows
- 16:9, 16:10 and 21:9 as well as 4:3: the 3D fills the screen, the HUD goes to the screen's
 corners, menus keep the game's own 16:9 look
- Keyboard and mouse with key prompts in the game, rebindable controls for keyboard, mouse and
 controller, mouse support in the menus
- Skippable intros and movies, unlock-all options for difficulties and costumes, optional cheats
- Smooth frame pacing and low input latency; shaders prepared in the background (no first-time
 stutter)
## Getting started
### Linux and Steam Deck
1. Download `NinjaGaidenBlack-x86_64.AppImage` from the releases page and make it executable
 (`chmod +x`, or Properties → Allow executing).
2. Run it. On the first start a window asks for your copy of the game: a disc image (`.iso`, a full
 Redump dump, or the `.7z`/`.zip` it came in) or a folder of extracted files with `default.xbe`.
 The game is installed once (about 6 GB).
3. On a Steam Deck, add the AppImage to Steam (Add a Non-Steam Game) to play it in Game Mode, and
 choose 16:10 in the settings.
Needs a 64-bit Linux with glibc 2.35 or newer and a GPU with Vulkan 1.3 drivers.
### Windows
1. Download `NinjaGaidenBlack-windows-x64.zip` and extract it anywhere.
2. Run `NinjaGaidenBlack.exe` and choose your disc image as above.
Needs Windows 10 or 11 (64-bit) and a GPU with Vulkan 1.3 drivers.
### macOS (experimental)
Build the Apple Silicon app using the commands below, extract the resulting zip, and open
`Ninja Gaiden Black.app`. Choose your own disc image or extracted game folder on first start.
Current dependencies require macOS 26. Intel Macs and the xemu renderer are unsupported;
packages are signed ad hoc, without Developer ID signing or notarization.
### Where things are kept
| | Linux | Windows | macOS |
|---|---|---|---|
| Installed game, saves | `~/.local/share/NinjaGaidenBlack` | `%LOCALAPPDATA%\NinjaGaidenBlack` | `~/Library/Application Support/NinjaGaidenBlack/saves` |
| Settings (`settings.ini`, `controls.ini`) | `~/.config/Ni