Black Ops II Recompiled

Warning: This game has issues, but is in a playable state.

This repository contains a ReXGlue-based recompiled setup for Call of Duty: Black Ops II.

It currently targets:

• default for default.xex
• default_mp for default_mp.xex

This repo does not ship the game, extracted assets, or Xbox 360 executables. You must provide your own legally obtained dump.

What This Repo Expects

The codegen configs point at:

• assets/default.xex
• assets/default_mp.xex

The runtime also expects the rest of the game data under assets/.

Minimum working layout:

bo2/
  assets/
    default.xex
    default_mp.xex
    ...other extracted BO2 assets...
  default/
  default_mp/
  scripts/

assets/ is intentionally ignored by git and must be supplied locally.

Required Game Dump

Reference ISO used for this setup:

• File: Call of Duty - Black Ops II (World).iso
• SHA-1: A5F56AD3EC9FE2F1D45A92FB141FD046ED9D5C13

Use your own dump and verify the hash if you want to match the same source image.

Required Assets

You need to extract the game contents from your own BO2 dump and place them in assets/.

At minimum:

• assets/default.xex
• assets/default_mp.xex
• the supporting fastfiles / packages / media the game normally loads at runtime

If default.xex or default_mp.xex are missing, codegen and runtime launch will fail.

Requirements

Windows:

• CMake 3.25+
• Ninja
• Clang / LLVM
• ReXGlue SDK checked out separately
• rexglue available on PATH

Linux:

• CMake 3.25+
• Ninja
• Clang 20 / clang++-20
• ReXGlue SDK checked out separately
• rexglue available on PATH

Both projects also expect the SDK to be available via REXSDK_DIR or the existing local CMake setup.

Setup Flow

The normal flow is:

1. Extract your BO2 game files into assets/
2. Run codegen
3. Run CMake preset/configure
4. Build

Supported Platforms

Platform	Status	Support
Windows	Tested	Supported
Linux	Untested	Unsupported (temporarily)

Windows

Codegen:

scripts\windows\codegen.bat sp
scripts\windows\codegen.bat mp
scripts\windows\codegen.bat both

Preset/configure:

scripts\windows\preset.bat sp
scripts\windows\preset.bat mp
scripts\windows\preset.bat both
scripts\windows\preset.bat both --preset win-amd64-debug

Build:

scripts\windows\build_and_setup.bat sp
scripts\windows\build_and_setup.bat mp
scripts\windows\build_and_setup.bat both
scripts\windows\build_and_setup.bat both --preset win-amd64-relwithdebinfo

Accepted target aliases:

• sp or default
• mp or default_mp
• both

Accepted preset style:

• --preset win-amd64-debug
• or bare preset name such as win-amd64-debug

Linux

Codegen:

scripts/linux/codegen.sh sp
scripts/linux/codegen.sh mp
scripts/linux/codegen.sh both

Preset/configure:

scripts/linux/preset.sh sp
scripts/linux/preset.sh mp
scripts/linux/preset.sh both
scripts/linux/preset.sh both --preset linux-amd64-debug

Build:

scripts/linux/build_and_setup.sh sp
scripts/linux/build_and_setup.sh mp
scripts/linux/build_and_setup.sh both
scripts/linux/build_and_setup.sh both --preset linux-amd64-relwithdebinfo

Output

Built executables are copied to:

out/
  default.exe
  default_mp.exe

On Linux, the build script copies:

out/
  default
  default_mp

Notes

• This repo is source + build logic only. It does not include redistributable game content.
• assets/ must stay local.
• If you change the supplied XEX files, rerun codegen before rebuilding.
• default and default_mp each have their own codegen config:
  • default/default_config.toml
  • default_mp/default_mp_config.toml