Spark198rus/black-pc

🇺🇸 English | 🇧🇷 Português

An unofficial native Windows port (and playable on Linux) of BLACK (Criterion Games, 2006), made from the original Xbox version (NTSC-U).

black.exe loads your own copy of the game's default.xbe and runs the original x86 game code directly on the PC.

You need your own copy of the game. This repository and the release downloads contain no game code or data.

The game is fully playable. Please report problems in the issue tracker and include port\black.log (or port/black.log on Linux).

• Any render resolution (720p to 4K and beyond, or a multiple of the window size), anti-aliasing
• Widescreen 16:9 (the game's own widescreen mode) or 4:3, adjustable field of view
• 60 fps (the default) or the original 30 fps
• Mouse look, with the weapon swaying as it does with the stick; keys bound to the game's actions; XInput controllers
• The port's settings in the game's own menus (Options > PC SETTINGS, and in the pause menu), including borderless fullscreen
• Room reverb, the game's own brightness and gamma ramp; auto-aim off by default; every movie can be skipped
• Fixes for things the Xbox hides by its low resolution: flickering seams between pieces of destructible objects, a grid pattern in the blur effects

For Windows:

• Windows 10 or 11. The program is 32-bit and runs on 64-bit Windows.
• A graphics card with Direct3D 9 (Shader Model 3). On old laptops with Intel graphics (HD 4400 class) play at 30 fps.
• Nothing else needs installing: the C runtime is built in, and Direct3D 9, the shader compiler and XAudio2 ship with Windows.

For Linux:

• A modern Linux distribution (Ubuntu, Fedora, Arch, Parrot OS, etc.).
• Distrobox installed on the host system.
• WineHQ version 9+ (Staging) and DXVK (Vulkan).
• A graphics card supporting Vulkan 1.1 or higher (e.g., AMD Radeon Vega 8 or better).

For both systems:

• The NTSC-U (North America) Xbox disc of BLACK. Other regions and builds have different code addresses and are not supported.

1. Dump your NTSC-U version of the game to an ISO and extract it with extract-xiso (extract-xiso -x Black.iso). Rename the extracted folder to game.
2. Check that you have the supported build. In PowerShell:

   Get-FileHash game\default.xbe -Algorithm SHA256

   It must print DF2739C372D254A90AEECCF5971D12097F22D89FBB90DB021FDA96DD4DEB68F6.
3. Download the zip from Releases and extract it next to the game folder, so the port folder sits beside it:

   BLACK\
     game\
       default.xbe
       ...
     port\
       black.exe
       blackrt.dll
   

4. Start port\black.exe.

The port keeps everything it writes in the port folder: savedata\ holds the Xbox hard disk (saved games and the game's settings), black.ini the port's settings, black.log the log of the last run and cache\menus the game's menu files with the PC SETTINGS pages added.

To avoid rendering issues (such as the hlsl.y compiler crash in older Wine versions) and ensure maximum performance via Vulkan, follow these steps.

Using Ubuntu 22.04 isolates the 32-bit dependencies without cluttering your main system.

1. Open your host machine's terminal and create the container:

   distrobox create --name gaming-env --image ubuntu:22.04

2. Enter the container:

   distrobox enter gaming-env

Modern Wine 9 eliminates chronic shader bugs found in legacy versions.

1. Enable 32-bit architecture:

   sudo dpkg --add-architecture i386

2. Download the official keys and add the Ubuntu Jammy repository:

   sudo mkdir -pm755 /etc/apt/keyrings
   sudo wget -O /etc/apt/keyrings/winehq-archive.key https://dl.winehq.org/wine-builds/winehq.key
   sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/ubuntu/dists/jammy/winehq-jammy.sources

3. Update packages and install WineHQ Staging:

   sudo apt update
   sudo apt install --install-recommends winehq-staging -y

Version 1.10.3 ensures maximum Vulkan compatibility for integrated GPUs (like the AMD Vega line).

1. Download DXVK and extract it inside the container:

   wget https://github.com/doitsujin/dxvk/releases/download/v1.10.3/dxvk-1.10.3.tar.gz
   tar -zxf dxvk-1.10.3.tar.gz

2. Copy the 32-bit translation libraries directly to your game directory (adjust /path/to/game/port to your actual path):

   cp dxvk-1.10.3/x32/d3d9.dll /path/to/game/port/
   cp dxvk-1.10.3/x32/dxgi.dll /path/to/game/port/

Windows .zip archives extracted on Linux might generate files with literal backslashes (\) in their names. We must clean this up.

1. Navigate to the port folder:

   cd /path/to/game/port/

2. Rename the base files (removing the port\ prefix if it exists):

   mv 'port\black.exe' black.exe
   mv 'port\blackrt.dll' blackrt.dll
   mv 'port\LICENSE.txt' LICENSE.txt
   mv 'port\README.md' README.md

3. Run the game, forcing Wine to use the native DXVK libraries we just copied:

   WINEDLLOVERRIDES="d3d9=n;dxgi=n" wine black.exe

Keys and mouse buttons are bound to the game's own actions, not to controller buttons, and can be changed in PC SETTINGS > CONTROLS > KEY BINDINGS (two keys per action, saved to black.ini). Controllers work as well. Click the window to capture the mouse; Esc lets go of it (in play it also pauses), and play starting or resuming takes it again.

In menus the arrow keys move, Enter selects and Backspace goes back; Enter also passes PRESS START, skips movies and intro text, and closes hints. QUIT at the bottom of the main menu closes the game.

The port's settings are in the game's menus: Options > PC SETTINGS on the main menu, and PC SETTINGS in the pause menu.

black.exe --help lists the command-line options. They override black.ini for that run (e.g., --fullscreen --resolution 1080 --fps 30 --fov 86).

• The game was made for 30 fps; at 60 (the default) something may still run at the wrong speed.
• On-screen prompts show Xbox controller buttons, even when playing with a keyboard.
• Audio: the reverb is an approximation, some effect sends are not mixed, there is no subwoofer channel, and 3D sound uses distance and panning only.
• Only the NTSC-U build is supported.

Visual Studio 2022 or 2026 with C++ x86 tools, and CMake 3.24+.

cd loader
cmake --preset win32            # VS 2026; use win32-vs2022 for VS 2022
cmake --build build/win32 --config RelWithDebInfo

This project is not affiliated with Criterion Games or Electronic Arts. BLACK is a trademark of Electronic Arts Inc.; Xbox is a trademark of Microsoft Corporation. No original code or SDK is included. You need your own legally obtained copy of the game. Developed by Spark198rus. Linux setup structured via AI.

Um port não oficial nativo para Windows (e executável no Linux) de BLACK (Criterion Games, 2006), feito a partir da versão original de Xbox (NTSC-U).

O executável black.exe carrega a sua própria cópia do arquivo default.xbe do jogo e roda o código x86 original diretamente no PC.

Você precisa ter a sua própria cópia do jogo. Este repositório e os downloads de release não contêm nenhum código ou dado do jogo original.

O jogo é totalmente jogável. Por favor, reporte problemas no rastreador de issues (issue tracker) e inclua o arquivo port\black.log (ou port/black.log no Linux).

• Qualquer resolução de renderização (de 720p a 4K e além), anti-aliasing.
• Widescreen 16:9 (o próprio modo widescreen nativo do jogo) ou 4:3, com campo de visão (FOV) ajustável.
• 60 fps (padrão) ou os 30 fps originais.
• Visão pelo mouse (Mouse look), com a arma balançando; teclas vinculadas às ações do jogo; suporte a controles XInput.
• Configurações do port integradas aos próprios menus do jogo (Options > PC SETTINGS e no menu de pausa), incluindo tela cheia sem bordas (borderless fullscreen).
• Reverberação de ambiente, rampa de brilho e gama do próprio jogo; mira automática (auto-aim) desativada por padrão; todas as cutscenes podem ser puladas.
• Correções para artefatos que o Xbox escondia devido à baixa resolução (costuras piscantes e grade no blur).

Para Windows:

• Windows 10 ou 11. O programa é de 32 bits e roda no Windows de 64 bits.
• Uma placa de vídeo com Direct3D 9 (Shader Model 3).
• Nenhuma instalação extra é necessária (o Direct3D 9 e XAudio2 já vêm com o Windows).

Para Linux:

• Uma distribuição Linux moderna (Ubuntu, Fedora, Arch, Parrot OS, etc).
• Distrobox instalado no sistema host.
• WineHQ versão 9+ (Staging) e DXVK (Vulkan).
• Placa de vídeo compatível com Vulkan 1.1 ou superior (ex: AMD Radeon Vega 8 ou superior).

Para ambos os sistemas:

• O disco original de BLACK do Xbox na versão NTSC-U (América do Norte). Outras regiões e builds não são suportadas.

1. Faça o dump da sua versão NTSC-U do jogo para uma ISO e extraia-a usando o extract-xiso (extract-xiso -x Black.iso). Renomeie a pasta extraída para game.
2. Verifique se você possui a build suportada. No PowerShell, execute:

   Get-FileHash game\default.xbe -Algorithm SHA256

   O resultado DEVE ser: DF2739C372D254A90AEECCF5971D12097F22D89FBB90DB021FDA96DD4DEB68F6.
3. Baixe o arquivo .zip na aba Releases e extraia-o ao lado da pasta game, de modo que a pasta port fique ao lado dela:

   BLACK\
     game\
       default.xbe
       ...
     port\
       black.exe
       blackrt.dll
   

4. Execute port\black.exe.

Para evitar problemas de renderização (como o crash nativo do compilador hlsl.y em versões antigas do Wine) e garantir o máximo de performance via Vulkan, siga as etapas abaixo.

O uso do Ubuntu 22.04 isola as dependências de 32 bits sem sujar o seu sistema principal.

1. Abra o terminal nativo da máquina host e crie o contêiner:

   distrobox create --name gaming-env --image ubuntu:22.04

2. Acesse o interior do contêiner:

   distrobox enter gaming-env

O Wine 9 moderno elimina bugs crônicos de shaders presentes nas versões legadas.

1. Ative a arquitetura de 32 bits:

   sudo dpkg --add-architecture i386

2. Baixe as chaves oficiais e adicione o repositório do Ubuntu Jammy:

   sudo mkdir -pm755 /etc/apt/keyrings
   sudo wget -O /etc/apt/keyrings/winehq-archive.key https://dl.winehq.org/wine-builds/winehq.key
   sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/ubuntu/dists/jammy/winehq-jammy.sources

3. Atualize os pacotes e instale o WineHQ Staging:

   sudo apt update
   sudo apt install --install-recommends winehq-staging -y

A versão 1.10.3 garante compatibilidade máxima de Vulkan para placas de vídeo integradas (como a linha AMD Vega).

1. Baixe o DXVK e extraia-o no terminal do contêiner:

   wget https://github.com/doitsujin/dxvk/releases/download/v1.10.3/dxvk-1.10.3.tar.gz
   tar -zxf dxvk-1.10.3.tar.gz

2. Copie as bibliotecas de tradução de 32 bits diretamente para o diretório do jogo (ajuste o caminho de acordo com o seu pc):

   cp dxvk-1.10.3/x32/d3d9.dll /caminho/para/jogo/port/
   cp dxvk-1.10.3/x32/dxgi.dll /caminho/para/jogo/port/

Como arquivos .zip criados no Windows geram nomes com barras invertidas literais (\) ao serem extraídos no Linux, é necessário limpar a sujeira.

1. Navegue até a pasta do port:

   cd /caminho/para/jogo/port/

2. Renomeie os arquivos base (removendo o port\ do nome, se existir):

   mv 'port\black.exe' black.exe
   mv 'port\blackrt.dll' blackrt.dll
   mv 'port\LICENSE.txt' LICENSE.txt
   mv 'port\README.md' README.md

3. Execute o jogo forçando o Wine a utilizar as bibliotecas nativas do DXVK que copiamos:

   WINEDLLOVERRIDES="d3d9=n;dxgi=n" wine black.exe

As teclas e botões do mouse são vinculados diretamente às ações do jogo (não aos botões físicos do controle original) e podem ser alterados em PC SETTINGS > CONTROLS > KEY BINDINGS. Controles (gamepads) também funcionam nativamente.

Clique na janela para capturar o mouse; a tecla Esc libera o mouse.

Os ajustes do port ficam dentro do menu do jogo: Options > PC SETTINGS e no menu de pausa.

Você pode usar argumentos de linha de comando (ex: black.exe --fullscreen --resolution 1080 --fps 30 --fov 86).

• O jogo foi feito para 30 fps; a 60 fps (padrão) alguma física pode rodar na velocidade errada.
• Os botões na tela mostram a interface do Xbox, mesmo no teclado.
• Áudio: a reverberação é aproximada e não há canal de subwoofer.
• Apenas a versão NTSC-U é suportada.

Requer Visual Studio 2022 ou 2026 com as ferramentas C++ x86 e CMake 3.24+.

cd loader
cmake --preset win32
cmake --build build/win32 --config RelWithDebInfo

Este projeto não é afiliado à Criterion Games ou Electronic Arts. BLACK e Xbox são marcas registradas. Nenhum código original está incluso neste repositório. Você precisa de uma cópia obtida legalmente do jogo. Desenvolvido por Spark198rus. Guia Linux estruturado via IA.