K0NL/B2recomp

选用指南

AI 根据 README 整理 · 2026/10/18 07:36:20

使用方式

可通过图形界面（B2recomp.exe）或命令行（Build B2recomp.bat、scripts/play.ps1）进行构建和启动游戏。构建过程约需5分钟，生成的文件保存在build/目录。

查看 README 依据

- Windows 10/11 x64 and a GPU with a Vulkan 1.3 driver. AMD RX 400/500 cards (Polaris) run on a fallback path that is new and not yet confirmed on a real card: a log from one is welcome. - With the builder package: nothing else. From the source alone: Python 3.10+ and the free tools listed in [BUILDING.md](BUILDING.md#what-you-need-on-your-pc). ## Build **With the builder package** (`B2recomp-builder-<version>.zip`, from this repository's Releases page): unzip it and start **`B2recomp.exe`**. Choose your dump folder (Browse, or drag it onto the window) and press **Build**; the window

shows each step and the progress, and when the build is done it turns into the launcher. (`Build B2recomp.bat` does the same from a console.) The package holds no game files: only this source, the compiler (llvm-mingw), Python, SDL3, the Vulkan headers, the shader-compiler shim and their licences (`THIRD-PARTY-NOTICES.md`). **From the source**, with the tools installed yourself: ``` git clone <URL of the B2recomp repository> cd B2recomp python scripts/setup.py --dump <your dump folder> ```

Either way it is one command with resumable steps; about **5 minutes** on a 16-thread PC and 0.8 GB in `build/`. Details, options, measured times and troubleshooting: [BUILDING.md](BUILDING.md). `targets/` and `build/` (and the generated files in `runtime/gen/`) hold material made from your copy of the game. They are ignored by git: never commit, upload or share them. ## Play ``` B2recomp.exe (builder package) build\launcher.exe (either way) ``` The launcher has the settings (`config/graphics.ini`, `config/controllers.ini`: resolution scale, filtering, frame

部署要求

需要Windows 10/11 x64、支持Vulkan 1.3驱动的GPU，以及用户自己从主机提取的《猎天使魔女2》1.2版本（更新v131072）的ExeFS和RomFS文件。加密包（.nsp、.xci等）不被接受。

查看 README 依据

- **Your own extracted copy of Bayonetta 2, version 1.2 (update v131072) applied** (the ExeFS and RomFS as plain files; see [BUILDING.md](BUILDING.md#what-you-extract-from-your-own-console)). 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. - Optional: your console's system font in `<dump>\sysdata\fonts\` ([BUILDING.md](BUILDING.md#system-fonts)); without it a font of your PC stands in.

- Windows 10/11 x64 and a GPU with a Vulkan 1.3 driver. AMD RX 400/500 cards (Polaris) run on a fallback path that is new and not yet confirmed on a real card: a log from one is welcome. - With the builder package: nothing else. From the source alone: Python 3.10+ and the free tools listed in [BUILDING.md](BUILDING.md#what-you-need-on-your-pc). ## Build **With the builder package** (`B2recomp-builder-<version>.zip`, from this repository's Releases page): unzip it and start **`B2recomp.exe`**. Choose your dump folder (Browse, or drag it onto the window) and press **Build**; the window

已知限制

项目明确不包含任何游戏代码、资源、SDK代码或密钥，且不能在没有用户自己转储的游戏副本的情况下运行。目前仅测试了开发者PC（Windows 11、16线程、Vulkan 1.3 GPU），其他PC、GPU和Windows 10尚未测试，可能存在bug。

查看 README 依据

> **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](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