Update README.md
--recursive is deprecated. Formatting. Fix small error in 'Fetching the code' section. Removed screenshot gallery as it's now outdated.
This commit is contained in:
parent
46887a60dc
commit
0dfa290360
53
README.md
53
README.md
|
@ -5,9 +5,13 @@
|
||||||
|
|
||||||
Cxbx-Reloaded is an emulator for running Microsoft Xbox (and eventually, Chihiro) games on Microsoft Windows.
|
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.
|
The project began its life as a fork of Cxbx, with added 64-bit support.
|
||||||
|
|
||||||
Cxbx-Reloaded is early in development, however it is progressing almost daily: We now boot more titles than ever before, with more and more reaching gameplay.
|
Work is currently underway to backport some of the improvements made from Dxbx.
|
||||||
|
|
||||||
|
Cxbx-Reloaded is early in development, however it is progressing almost daily:
|
||||||
|
|
||||||
|
We now boot more titles than ever before, with more and more reaching gameplay.
|
||||||
|
|
||||||
## System Requirements
|
## System Requirements
|
||||||
### Minimum
|
### Minimum
|
||||||
|
@ -17,50 +21,65 @@ Cxbx-Reloaded is early in development, however it is progressing almost daily: W
|
||||||
* 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).
|
* 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
|
## Automated Builds
|
||||||
Cxbx-Reloaded is not yet ready for general release, but the latest development builds can always be downloaded from our [AppVeyor](https://ci.appveyor.com/project/SoullessSentinel/cxbx-reloaded/branch/master) service:
|
Cxbx-Reloaded is not yet ready for general release, but the latest development builds can be downloaded from our [AppVeyor](https://ci.appveyor.com/project/SoullessSentinel/cxbx-reloaded/branch/master):
|
||||||
|
|
||||||
* [Latest build (Release-mode)](https://ci.appveyor.com/api/projects/SoullessSentinel/cxbx-reloaded/artifacts/export/Release.zip?branch=master&job=Configuration:%20Release&pr=false)
|
* [Latest build (Release-mode)](https://ci.appveyor.com/api/projects/SoullessSentinel/cxbx-reloaded/artifacts/export/Release.zip?branch=master&job=Configuration:%20Release&pr=false)
|
||||||
* [Latest build (Debug-mode)](https://ci.appveyor.com/api/projects/SoullessSentinel/cxbx-reloaded/artifacts/export/Debug.zip?branch=master&job=Configuration:%20Debug&pr=false)
|
* [Latest build (Debug-mode)](https://ci.appveyor.com/api/projects/SoullessSentinel/cxbx-reloaded/artifacts/export/Debug.zip?branch=master&job=Configuration:%20Debug&pr=false)
|
||||||
* [Full build history](https://ci.appveyor.com/project/SoullessSentinel/cxbx-reloaded/history)
|
* [Full build history](https://ci.appveyor.com/project/SoullessSentinel/cxbx-reloaded/history)
|
||||||
|
|
||||||
## Compatibility
|
## 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!)
|
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 [Readme file](https://github.com/Cxbx-Reloaded/game-compatibility/blob/master/README.md) first!
|
||||||
|
|
||||||
## Bug Reports
|
## Bug Reports
|
||||||
Game or software specific issues can be reported in the [compatibility list](https://github.com/Cxbx-Reloaded/game-compatibility/issues).
|
Game or software specific issues 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).
|
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).
|
Make sure bug reports contains:
|
||||||
|
* 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 when [View -> Debug Output (Kernel) -> File] is selected).
|
||||||
|
|
||||||
## Additional information
|
## Additional information
|
||||||
Cxbx-Reloaded has a [wiki](http://github.com/Cxbx-Reloaded/Cxbx-Reloaded/wiki) containing various subjects and background information.
|
Cxbx-Reloaded has a [wiki](https://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).
|
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
|
## 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.
|
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.
|
||||||
|
|
||||||
### Prerequisites
|
### Prerequisites
|
||||||
1. [Git for Windows](https://git-scm.com/)
|
1. [Git for Windows](https://git-scm.com/)
|
||||||
2. [Visual Studio 2017](https://www.visualstudio.com/downloads/) (2015 should work, but is not officially supported)
|
2. [Visual Studio 2017](https://www.visualstudio.com/downloads/) (2015 might work, but is not officially supported)
|
||||||
3. Windows 8.1 SDK (Should be included with Visual Studio)
|
3. Windows 8.1 SDK (Should be included with Visual Studio)
|
||||||
4. [Microsoft Child Process Debugging Power Tool](https://marketplace.visualstudio.com/items?itemName=GreggMiskelly.MicrosoftChildProcessDebuggingPowerTool)
|
4. [Microsoft Child Process Debugging Power Tool](https://marketplace.visualstudio.com/items?itemName=GreggMiskelly.MicrosoftChildProcessDebuggingPowerTool)
|
||||||
|
|
||||||
### Fetching the code
|
### Fetching the code
|
||||||
Run the following command on the command line.
|
Run the following command on the command line.
|
||||||
`git clone --recursive https://github.com/Cxbx-Reloaded/Cxbx-Reloaded/`
|
`git clone --recurse-submodules https://github.com/Cxbx-Reloaded/Cxbx-Reloaded/`
|
||||||
|
|
||||||
Please note that `--recursive` parameter: This is required to fetch sub-modules Without this, Cxbx-Reloaded will fail to build.
|
Please note the `--recurse-submodules` parameter. This is required to fetch sub-modules.
|
||||||
If Cxbx-Reloaded was previously checked out without the submodules, they can be updated/fetched with the following command
|
|
||||||
`git submodule update --recursive`
|
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
|
### Compiling
|
||||||
Simply open `build/Win32/Cxbx.sln` within Visual Studio, select your configuration (Release or Debug) and hit Build.
|
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 do include much more detailed kernel logging, so these may help diagnose a problematic title.
|
|
||||||
|
Please note that Debug builds are significantly slower, but do include much more detailed kernel logging, so they may help diagnose a problematic title.
|
||||||
|
|
||||||
## Support
|
## Support
|
||||||
You can support Luke Usher (initiator of Cxbx-Reloaded) on [Patreon](https://www.patreon.com/LukeUsher).
|
You can support [Luke Usher](https://github.com/LukeUsher), initiator of Cxbx-Reloaded, on [Patreon](https://www.patreon.com/LukeUsher).
|
||||||
|
|
||||||
## Special Thanks
|
## Special Thanks
|
||||||
All contributors to the original Cxbx and Dxbx projects, without which Cxbx-Reloaded would not exist at all.
|
All contributors to the original Cxbx and Dxbx projects. Without them Cxbx-Reloaded would not exist at all.
|
||||||
|
|
Loading…
Reference in New Issue