47 lines
3.5 KiB
Markdown
47 lines
3.5 KiB
Markdown
# Cxbx-Reloaded - Original Xbox Emulator
|
|
[](https://img.shields.io/badge/License-GPL%20v2-blue.svg)
|
|
[](https://ci.appveyor.com/project/SoullessSentinel/cxbx-reloaded)
|
|
[](https://gitter.im/Cxbx-Reloaded/Lobby)
|
|
|
|
Cxbx-Reloaded is an emulator for running Microsoft Xbox (and eventually, Chihiro) games on Microsoft Windows.
|
|
|
|
The project began its life as a fork of Cxbx, with added 64-bit support. Work is currently underway to backport some of the improvements made from Dxbx.
|
|
|
|
Cxbx-Reloaded is early in development and still pretty unstable, so don't expect it to run much at this stage.
|
|
|
|
## System Requirements
|
|
### Minimum
|
|
* OS: Windows 7 64-bit or newer. 32-bit installations are not supported.
|
|
* Video card: anything that supports Direct3D 8.
|
|
### Prerequisites
|
|
* Visual C++ 2015 and 2017 redistributables may be required. Download them [here](https://support.microsoft.com/en-gb/help/2977003/the-latest-supported-visual-c-downloads).
|
|
|
|
## Automated Builds
|
|
Cxbx-Reloaded is not yet ready for general release, but the latest development build can always be downloaded from our [AppVeyor](https://ci.appveyor.com/project/SoullessSentinel/cxbx-reloaded/branch/master) (navigate to Configuration: Release => Artifacts => export\Release.zip).
|
|
|
|
## Compatibility
|
|
Cxbx-Reloaded has a separate [compatibility list](https://github.com/Cxbx-Reloaded/game-compatibility/issues). If you have something to report on a title, please create or update the issue for it over there. (Please, read the [Read-me file](https://github.com/Cxbx-Reloaded/game-compatibility/blob/master/README.md) first!)
|
|
|
|
## Bug Reports
|
|
As Cxbx-Reloaded is in early stages of development right now, most software will either crash or do nothing. Please do not submit issues for this.
|
|
|
|
Software that actually does something (for example, it outputs graphics or audio before crashing), can be reported in the [compatibility list](https://github.com/Cxbx-Reloaded/game-compatibility/issues).
|
|
|
|
For emulation issues that are suspected to be generic (NOT specific to any single piece of software), a bug report can be submitted at [the Cxbx-Reloaded issue tracker](https://github.com/Cxbx-Reloaded/Cxbx-Reloaded/issues).
|
|
|
|
Make sure bug reports contains the build tested with, error message displayed (if any), screenshots, an Xbe dump (created via [Edit -> Dump Xbe Info To -> File]), and a Kernel Debug file (created when running a game when [View -> Debug Output (Kernel) -> File] is selected).
|
|
|
|
## Additional information
|
|
Cxbx-Reloaded has a [wiki](http://github.com/Cxbx-Reloaded/Cxbx-Reloaded/wiki) containing various subjects and background information.
|
|
Chat on [Gitter](https://gitter.im/Cxbx-Reloaded/Lobby) or [Discord](https://discord.gg/26Xjx23).
|
|
You can find a screenshot gallery at [imgur](http://imgur.com/a/Bzvti).
|
|
|
|
## Contributing
|
|
We welcome contributions, large and small. If you want to do some coding, be sure to read the [Developer notes](https://github.com/Cxbx-Reloaded/Cxbx-Reloaded/wiki/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.
|
|
|
|
## Support
|
|
You can support Luke Usher (initiator of Cxbx-Reloaded) on [Patreon](https://www.patreon.com/LukeUsher).
|
|
|
|
## Special Thanks
|
|
All contributors to the original Cxbx and Dxbx projects, without which Cxbx-Reloaded would not exist at all.
|