portingpete / Black-2006-Recomp

# Black 2006 Recomp
An experimental Windows recompilation of the original Xbox release of
**BLACK (2006)**, built with XboxRecomp. It includes a Direct3D 11 renderer,
keyboard and mouse controls, XInput controller support, video settings, a PC
launcher, and native audio output. Movies are enabled by default. The Windows
build can also run on x86_64 Linux through Wine/Proton; see Linux setup.
## The launcher
**BLACK Launcher** sets the game up and starts it. It is written in C++ on Walnut
and drawn like the game's own menu pages, with the game's menu fonts once your disc is in place.
- **Your disc**: choose an ISO (XISO or a full Redump dump) or a folder of extracted files, or drop it onto the
 window. The launcher checks it is the supported release, then copies it into `game/` with progress; a stopped
 copy carries on where it left off.
- **Build the game** turns your disc into the PC game. It looks for the tools that needs (Visual Studio's C++
 tools, CMake, Python and Rust), installs the missing ones with winget when you ask, then runs each step with
 its progress: preparing the tools, translating the code from your disc, setting up the build, compiling and
 making the menu languages. A stopped build carries on where it left off, a failed one shows the step and its
 output, and everything is logged in `reports/build- .log`.
- **Play** starts the game and keeps its output in `reports/launcher- /`. While it runs, the same row
 stops it. `BLACK Launcher --play` starts it with no window, for shortcuts.
- **Settings**: display, graphics, controls with key bindings read by key position (as the game stores them),
 game options and the menu language, and diagnostics. Changes are saved at once to `local/video.ini`,
 `local/controls.ini` and `local/xbox-launcher.json`, which the game's own settings pages also edit.
 **Diagnostics** turns on the detailed traces and prepares a GitHub issue about the last game run, without your
 folder names, for you to check and send.
- **Save game**: rename a profile slot, open or lock missions and set their results, or unlock them all. Every save
 backs the profile up first (`local/profile-backups/`), and any backup can be put back.
- It speaks the six menu languages (Settings > Game > Menu language).
See launcher/README.md to build or change it.
| Main menu | Your disc |
| --- | --- |
| | |
| **Checking the disc** | **Copying** |
| | |
| **Settings** | **Key bindings** |
| | |
| **Save game** | **In Portuguese** |
| | |
## HD textures
The game can use BLACK HD Reimagined, a texture pack made by HD REIMAGINED for the PS2
version in PCSX2. It is not included here.
To install it:
1. Download the pack from ModDB:
 BLACK HD Reimagined Texture Pack.
2. Make a folder named `texture_pack_hd` next to `BLACK Launcher.exe`.
3. Extract the download into it. Any layout of subfolders works: the PCSX2 one
 (`texture_pack_hd/SLUS-21376/replacements/...`) is fine as it is.
4. In the launcher