K0NL / B2recomp

# B2recomp
*by K0NL*
**B2recomp** (short for *Bayonetta 2 Recompiled*) is an unofficial static recompilation of *Bayonetta 2* (Nintendo
Switch) for Windows. It translates the Switch version's AArch64 program code to C **on your own PC**, from **your own**
legally dumped copy of the game, and runs it natively on Windows with a re-implemented system layer (threads, file
system, audio, input, and the NVN graphics API on Vulkan).
It is not an emulator (no CPU interpreter, no JIT) and it is **not a way to get the game**.
> **This repository contains no game code, no game assets, no Nintendo SDK code, no firmware, no system fonts and no
> encryption keys, and it does not tell you where to get any of them.** It cannot do anything without a copy of the
> game you dumped yourself from a console and a game you own. Everything derived from the game (the translated code,
> the compiled game DLL, icons, shaders, textures) is generated on your PC from your dump and must stay there. Please
> do not share it, and do not open issues asking for it.
## Status
Measured on the developer's PC (Windows 11, 16 threads, a Vulkan 1.3 GPU):
| What | Result |
|---|---|
| Title screen, attract sequence, new game | runs |
| Prologue (cutscenes, chapter card, first fights) | played through: 900 s, no crash, every system call the game makes handled |
| Chapter 1 with a controller (DualSense, Xbox, Switch Pro and other SDL3 pads) | played by hand past the first part |
| Standard test run (`scripts/bench.py`: tutorial and the first fight, scripted) | 59.5 fps (the display rate), 0 faults |
| Later chapters | being played and tested |
| Other PCs, GPUs, Windows 10 | not tested yet |
Expect bugs. Builds are compared with a scripted test run (`python scripts/bench.py`, see BUILDING.md).
## The game is never downloaded
There is no prebuilt game, no `game.dll`, no `game_native.exe` to download, and there never will be: the game is
translated and compiled **on your PC, from your files**. What you can download is this source code, either alone or as
the **builder package**: the same source plus the free tools the build needs, so you install nothing.
## What you need
- **Your own extracted copy of Bayonetta 2, version 1.2 (update v131072) applied** (the ExeFS and RomFS as plain files; see
 BUILDING.md). The build checks that it is exactly that version
 and explains a mismatch. Encrypted packages (`.nsp`, `.xci`, `.nca`, ...) are refused: this project decrypts nothing
 and reads no keys.
- Windows 10/11 x64 and a GPU with a Vulkan 1.3 driver. A Linux version is in testing (the Linux builder on the
 **Releases** page, with its own `START HERE.txt`).
- **AMD Radeon RX 400 / 500 cards (Polaris):** AMD's Windows driver for these cards lacks Vulkan features that
 B2recomp's renderer normally uses (dynamic vertex input and pipeline libraries), and it offers no mailbox vsync.
 B2recomp works around that on Windows: the game runs (confirmed on an RX 560), but its first runs build more shaders
 wh