B3-Express

B3-Express is a native Windows port of Bayonetta 3 that recompiles the game's code on your PC for smooth 60 FPS.

README

B3-Express

An undergraduate graduate project: Bayonetta 3 v1.2.0 running natively on Windows through ScarletNX, a static ARM64 to x86 recompiler. The game's code is recompiled on your own PC, and an NVN-level renderer on Vulkan draws it. The goal is butter smooth 60 FPS and a friendly launcher, not higher frame rates.

No game files are included, and none ever will be. You need your own legally dumped copy of the game.

Current state, measurements and what's left: docs/STATUS.md.

Layout

folderwhat
source/ScarletNX at commit 5c97949, with this project's changes. See source/README.md
launcher/the launcher: install from an extracted dump, compile, settings, play
docs/STATUS.mdwhat works, measured results, what's left
diagnostics/*/README.mdthe notes behind each measurement. Logs and captures stay local

Use

Players: download a release and follow docs/INSTALL.md. To build it yourself:

  1. Build the runtime from source/ (source/docs/BUILD.md).
  2. Extract your own 1.2.0 dump into a folder holding exefs and romfs.
  3. Start B3-Express.exe (built by launcher/exe/build.py), then Install on that folder. It checks the version against game-files.txt, copies the files and compiles the game code on your PC. It never asks for keys.

The launcher's bundled Python isn't in this repo. Releases include it.

Credits

Thanks to the ScarletNX contributors, who are happy to see this project. Witch Time and B2recomp are references and a comparison, see source/docs/CREDITS.md.

License

GPL-3.0-or-later, as ScarletNX. See LICENSE. launcher/ATTRIBUTION.md lists what the launcher adapts.