Cxbx-Reloaded is an emulator for running Microsoft Xbox (and eventually, Chihiro) games on Microsoft Windows and Wine.

• OS: Windows 7+ x64, or x86-64 Linux with Wine. 32-bit is not supported.
• GPU: Direct3D 9.0c with Pixel Shader Model 2.x, and Vertex Shader Model 3.0.

• 32-bit (x86) Visual C++ 2019 Redistributable
• Npcap (used for network emulation)
  • Make sure to enable winpcap compatibility mode!
• WinUSB compliant driver (optional, only needed for USB pass-through of original xbox controllers and the steel battalion controller)

NOTICE: Please use the latest stable release version of Wine. If it does not work for you, then roll back to Wine 5.0.3 which is the last known working version.

• Winetricks
  • vcrun2017 or vcrun2019
    • NOTE: vcrun2019 requires the latest winetricks script!
  • d3dcompiler_47
    • NOTE: May be subject to change over time.
• Winpcap is built-in, no installation is required.

Cxbx-Reloaded doesn't currently have stable builds, but you can obtain pre-release builds from the Releases tab, or the links below:

• Release Builds
  • Wine users will need to use CxbxReloaded-Release-VS2017.zip for it to run correctly.
• Full build history

Cxbx-Reloaded has a compatibility list.

If you would like to submit compatibility reports, please request permission in our Discord server.

Game or software specific issues can be reported in the compatibility website.

For emulation issues that are not specific to any single piece of software, a bug report can be submitted at the Cxbx-Reloaded issue tracker.

Make sure to follow the issue template and that it contains:

• The build tested with, error message displayed (if any)
  • (You can copy and paste any popup messages. However, please keep it clean by paste and trimming down to only the message itself.)
• Screenshots
  • (optional unless has any graphic bug for references)

NOTICE: Failure to follow template will auto close your ticket.

Cxbx-Reloaded has a wiki containing various subjects and background information.

Chat on Discord.

We welcome contributions, large and small.

If you want to do some coding, be sure to read the Developer notes.

IMPORTANT: Pull-Requests containing code derived from XQEMU will not be approved until an agreement is reached to make work mutually beneficial. This includes updates to existing XQEMU derived code. We should not/will not become a hostile fork.

Please contact us before you start working on something, so we can make sure your work is going to be accepted once finished.

1. Git for Windows
2. CMake
   • Some IDEs already have CMake support, this is optional.

1. Run the following command in the command line:

   git clone --recurse-submodules https://github.com/Cxbx-Reloaded/Cxbx-Reloaded.git

   • Please note the --recurse-submodules parameter. This is required to fetch submodules.

     • If Cxbx-Reloaded was checked out without submodules, they can be updated/fetched with the following command:

       git submodule update --init --recursive

NOTE: Don't open CMakeLists.txt from Visual Studio, as it won't generate files in the build directory.

1. Visual Studio 2017 or later
   • C++ and C# desktop development
   • Windows Universal CRT SDK
   • C++ CMake tools for Windows
     • Optional if CMake is installed
   • Microsoft Child Process Debugging Power Tool

1. If you don't have CMake installed, open ___ Native Tools Command Prompt for VS 20##.
2. cd to the Cxbx-Reloaded directory.
3. Run these commands.
   1. mkdir build & cd build
   2. cmake .. -G "Visual Studio 16 2019" -A Win32
      • Visual Studio 2019 16.1 or later has CMake 3.14 bundled, and is required for the Visual Studio 2019 generator.
      • Use cmake .. -G "Visual Studio 15 2017" -A Win32 for Visual Studio 2017.
4. Open Cxbx-Reloaded.sln from the build directory.
5. Select the Release configuration, then click Build.
   • Debug builds are significantly slower, and only for developers.

Currently not supported.

You can support Luke Usher, initiator of Cxbx-Reloaded, on Patreon.

• All contributors to the original Cxbx and Dxbx projects. Without them Cxbx-Reloaded would not exist at all.
• XQEMU - While the majority of Cxbx-R is our own work (Kernel, HLE, etc), the NV2A LLE and NVNet implementation are primarily the work of the XQEMU developers.
• XboxDev - Providing Xbox hardware research & useful tooling.