Xbox (Original) Emulator
Go to file
Luke Usher 030c21922d
Update README.md
2018-06-18 08:14:30 +01:00
.github Update ISSUE_TEMPLATE.md 2018-05-16 02:18:04 -07:00
build/win32 Temporarily remove D3D8to9: Fixes missing graphics in some titles (Lego Star Wars) 2018-06-06 19:47:15 +01:00
doc Remove old documents: These predate Cxbx-R and are no longer valid 2018-06-06 08:27:05 +01:00
import XbSymbolDatabase update 2018-06-07 22:02:40 -05:00
resource Add new speedhack: Render Directly to Host BackBuffer 2018-06-09 08:01:01 +01:00
src Show title_id/version in Cxbx-Reloaded header: Now we can tell what title and version is in screenshots! 2018-06-14 13:46:21 +01:00
.gitattributes Revert "Revert rc files to binary (changed in 02141bd1c6)" 2018-05-29 11:37:06 -05:00
.gitignore Update gitignore to ignore unicorn buuild artifacts 2018-04-26 11:38:22 +02:00
.gitmodules Start using XbSymbolDatabase library 2018-05-12 07:24:10 -05:00
CONTRIBUTORS Add Patreon to Contributors 2017-12-02 15:15:35 +00:00
COPYING Update gitattributes (with line ending fixes) 2012-10-07 23:58:52 +11:00
README.md Update README.md 2018-06-18 08:14:30 +01:00
appveyor-build.bat Separated ci build logic 2018-02-15 23:36:25 +00:00
appveyor-gather.bat Add controller port configuration GUI and support virtual SB controller with feedback status (#1196) 2018-05-29 13:33:01 +01:00
appveyor.yml Build all branches 2018-06-14 14:14:29 +01:00

README.md

Cxbx-Reloaded - Original Xbox Emulator

License: GPL v2 AppVeyor Gitter or Discord

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

System Requirements

Minimum

  • OS: Windows 7+ x64. 32-bit installations are not supported.
  • GPU: Anything that supports Direct3D 8 (HLE) and OpenGL 3.3 (LLE).
  • Due to poor driver support for Direct3D8 on modern cards, some users may see better results when using a wrapper, such as D3D8to9

Prerequisites

  • Visual C++ 2015 and 2017 redistributables may be required. Download them here.

Automated Builds

Cxbx-Reloaded is not yet ready for general release, but the latest development builds can be downloaded from our AppVeyor:

Compatibility

Cxbx-Reloaded has a compatibility list.

If you have something to report on a title, please create or update the issue for it there.

Please read the Readme file first!

Bug Reports

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

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 bug reports contain:

  • The build tested with, error message displayed (if any)
  • Screenshots
  • Xbe dump (created via [Edit > Dump Xbe Info To > File])
  • Kernel Debug log (created when running a game with [View > Debug Output (Kernel) > File] selected).

Additional information

Cxbx-Reloaded has a wiki containing various subjects and background information. Chat on Gitter, or Discord.

Contributing

We welcome contributions, large and small.

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

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

Prerequisites

  1. Git for Windows
  2. Visual Studio 2017 (2015 might work, but is not officially supported)
  3. Windows 8.1 SDK (Should be included with Visual Studio)
  4. Microsoft Child Process Debugging Power Tool

Fetching the code

Run the following command on the command line: git clone --recurse-submodules https://github.com/Cxbx-Reloaded/Cxbx-Reloaded/

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

Without this, Cxbx-Reloaded will fail to build.

If Cxbx-Reloaded was previously checked out without the submodules, they can be updated/fetched with the following command: git submodule update --recurse-submodules

Compiling

Simply open build/Win32/Cxbx.sln within Visual Studio, select your configuration (Release or Debug) and hit Build.

Please note that Debug builds are significantly slower, but include much more detailed kernel logging, and may help diagnose a problematic title.

Support

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

Special Thanks

All contributors to the original Cxbx and Dxbx projects. Without them Cxbx-Reloaded would not exist at all.