More formatting, fix broken English.

Margen67 2018-04-26 10:01:53 -07:00
parent 51eba16220
commit 50f4c572d8
1 changed files with 44 additions and 30 deletions

@ -1,28 +1,28 @@
### How do I download specific Cxbx-Reloaded builds? ### How/Where do I download Cxbx-Reloaded builds?
For manual download from specific day/commit from AppVeyor by clicking the checkmark icon from github, follow this steps. * Go to [this link](https://github.com/Cxbx-Reloaded/Cxbx-Reloaded/commits/master), and scroll all the way up to see the latest commit.
* Click the checkmark icon next to the date.
Go to [this link](https://github.com/Cxbx-Reloaded/Cxbx-Reloaded/commits/master) and scroll all the way down to see the latest commit. * Click `Configuration: Release` > `Artifacts` > `export\Release.zip`
Look for checkmark icon next to date, select it.
Select release configure if you're not a developer.
Select Artifacts tab.
Click the zip file to download.
*** ***
### How do I dump/extract my games? ### How do I dump/extract my games?
The recommended method is to insert your game disk into a modded Xbox and directly transfer the files off the disc via FTP (usually in the /D/ directory) using a program such as [FileZilla](https://filezilla-project.org/) or [WinSCP](https://winscp.net/). Ensure the disc is clean and your Xbox's DVD drive is in working order. The recommended method is to insert your game disk into a modded Xbox and directly transfer the files off the disc via FTP (usually in the /D/ directory) using a program such as [FileZilla](https://filezilla-project.org/) or [WinSCP](https://winscp.net/). Ensure the disc is clean and your Xbox's DVD drive is in working order.
That is the most straightforward method, though there are more methods that make more complete dumps such as using a [special drive such as one flashed with 'Kreon' firmware](http://forum.redump.org/topic/6073/xbox-1-360-dumping-instructions/). Once completed you can extract the resulting .iso using a tool such as XDVDmulleter or exiso. That is the most straightforward method, though there are methods that make more complete dumps, such as using a [special drive flashed with 'Kreon' firmware](http://forum.redump.org/topic/6073/xbox-1-360-dumping-instructions/).
Once completed you can extract the .iso using a tool such as XDVDmulleter or exiso.
These are not standard .iso files and *cannot* be extracted by WinRAR or 7-Zip. These are not standard .iso files and *cannot* be extracted by WinRAR or 7-Zip.
Methods such as DVD2Xbox or other similar tools are *not* recommended due to their tendency to make modifications to the Xbe file like region check or anti-piracy bypasses. _These are unneeded for Cxbx-Reloaded and may cause issues._ DVD2Xbox and other similar tools are *not* recommended due to their tendency to make modifications to the Xbe file like region check or anti-piracy bypasses.
_These are unneeded for Cxbx-Reloaded and may cause issues._
*** ***
### Can't I just download games? ### Can't I just download games?
Downloading copies of games - even ones that you own a disc of is illegal. Downloading copies of games including ones that you own a disc of is illegal.
_The Cxbx-Reloaded developers and contributors will not provide support for these pirated copies._ _The Cxbx-Reloaded developers and contributors will not provide support for these pirated copies._
@ -31,56 +31,72 @@ _Please do not submit bug reports of them._
*** ***
### How do I install and use a dashboard? ### How do I install and use a dashboard?
To install a dashboard, first, make sure to check the [compatibility page](https://github.com/Cxbx-Reloaded/game-compatibility/wiki/Dashboard-Compatibility#official-ms-dashboards). Once you've dumped it move all the files to: To install a dashboard, first, make sure to check the [compatibility page](https://github.com/Cxbx-Reloaded/game-compatibility/wiki/Dashboard-Compatibility#official-ms-dashboards). Once you've dumped it:
``%AppData%\Cxbx-Reloaded\EmuDisk\Partition2\`` * Move all the files to `%AppData%\Cxbx-Reloaded\EmuDisk\Partition2\`
When done, check if xboxdash.xbe is located at the root of the Partition2 folder. * Make sure xboxdash.xbe is located at the root of the Partition2 folder.
Now open Cxbx-Reloaded and select ``File -> Open Dashboard`` (Hotkey F7) * Open Cxbx-Reloaded and select `File -> Open Dashboard` or press `F7` to launch the dashboard.
*** ***
### Where are save files stored? ### Where are save files stored?
Save files are stored inside Partition1 of Cxbx-Reloaded's EmuDisk: Save files are stored inside Partition1 of Cxbx-Reloaded's EmuDisk:
``%AppData%\Cxbx-Reloaded\EmuDisk\Partition1\ `` `%AppData%\Cxbx-Reloaded\EmuDisk\Partition1\`
*** ***
### Why don't the save files from my Xbox work? ### Why don't the save files from my Xbox work?
Xbox saves are encrypted and require a key from the actual console to use. Xbox saves are encrypted and require a key from the actual console to use.
Unfortunately there is currently no easy way to get this key from your Xbox. There is currently no easy way to get this key from your Xbox.
*** ***
### A game stopped working after I updated Cxbx-Reloaded ### A game stopped working after I updated Cxbx-Reloaded
If you were using an older version and upgraded, files in Cxbx-Reloaded's AppData may have been corrupted. Cxbx-Reloaded's AppData and/or settings may have been corrupted by an older version, and need to be reset:
To reset everything open Cxbx-Reloaded, then go to ``Settings -> Reset to Defaults``. * Open Cxbx-Reloaded, go to `Settings -> Reset to Defaults`.
After Cxbx-Reloaded closes, delete the Cxbx-Reloaded folder in ``%AppData%``. * Close Cxbx-Reloaded, and delete the Cxbx-Reloaded folder in `%AppData%`.
If this does not help, please report the issue in our [game compatibility tracker](https://github.com/Cxbx-Reloaded/game-compatibility). If that doesn't help, please report the issue to the appropriate tracker:
* [Game compatibility tracker](https://github.com/Cxbx-Reloaded/game-compatibility) for game-specific issues.
* [Cxbx-Reloaded issue tracker](https://github.com/Cxbx-Reloaded/Cxbx-Reloaded/issues) for everything else.
*** ***
### How do I run games in a higher resolution such as 720p, 1080p, or 4K? ### How do I run games in a higher resolution such as 720p, 1080p, 1440p, or 4K?
There are multiple ways to run games in higher resolution in Cxbx-Reloaded, but most of them require hacks made by the user, and because of this not officially supported by Cxbx-Reloaded: There are multiple ways to run games in a higher resolution on Cxbx-Reloaded.
Most of them require hacks made by a user, and because of this not officially supported by Cxbx-Reloaded:
* Patching the .xbe (xbox executable) file of the game to change values related to the resolution with a program like [OgXHD](http://bmkeyscom.ipage.com/marvelousmirth/ogxhd.html) or [HxD](https://mh-nexus.de/en/hxd/). * Patching the .xbe (xbox executable) file of the game to change values related to the resolution with a program like [OgXHD](http://bmkeyscom.ipage.com/marvelousmirth/ogxhd.html) or [HxD](https://mh-nexus.de/en/hxd/).
* Using an external program or script like [Cheat Engine](http://cheatengine.org/) to inject and change values inside the Cxbx-Reloaded process while the emulator is running. * Using an external program or script like [Cheat Engine](http://cheatengine.org/) to inject and change values inside the Cxbx-Reloaded process while the emulator is running.
Also see: http://ps2wide.net/xbox.html https://assemblergames.com/threads/xbox-widescreen-hacks.68347 * Changing the `Video Resolution` option in the Video settings. (Least compatible/working method)
Also see:
* http://ps2wide.net/xbox.html
* https://assemblergames.com/threads/xbox-widescreen-hacks.68347
Due to the variance in work and hacking knowledge required for each game, there isn't one tutorial we can provide that would apply to every game. Due to the variance in work and hacking knowledge required for each game, there isn't one tutorial we can provide that would apply to every game.
If you are inexperienced and want a simple way to change resolution that will work for most games, it is best to wait for an official option within the emulator. If you are inexperienced and want a simple way to change resolution that will work for most games, it is best to wait for an official option within the emulator.
*** ***
### What are the LLE options for? Should I enable them? ### What are the LLE options for? Should I enable them?
As of April 9th, 2018 only one LLE option is implemented: LLE GPU. LLE stands for [Low Level Emulation](https://github.com/Cxbx-Reloaded/Cxbx-Reloaded/wiki/Overview-of-the-project-&-Glossary-of-terms#lle).
As of [582b39e](https://github.com/Cxbx-Reloaded/Cxbx-Reloaded/commit/582b39e3c7531845af966263ae768cddb56a4218) only LLE GPU is implemented.
Enabling this option will emulate the Xbox's NV2A GPU using OpenGL instead of passing calls to DirectX. Enabling this option will emulate the Xbox's NV2A GPU using OpenGL instead of passing calls to DirectX.
@ -91,15 +107,13 @@ It may provide more accurate results, but is currently much slower than the defa
### What is LTCG (Link-Time Code Generation)? ### What is LTCG (Link-Time Code Generation)?
LTCG is an optimization that may be applied to games, especially later in the Xbox's lifespan. LTCG is an optimization that may be applied to games, especially later in the Xbox's lifespan.
This results in slight deviations in the way Functions are represented in the XBE. This results in slight deviations in the way Functions are represented in the XBE, and as such makes function detection unreliable which leads to unused patches, and emulation errors.
This makes Function detection unreliable, resulting in unused Patches, and emulation errors. For more terminology and definitions, see the _[Overview of the project & Glossary of terms](https://github.com/Cxbx-Reloaded/Cxbx-Reloaded/wiki/Overview-of-the-project-&-Glossary-of-terms)_ page.
For more terminology and definitions, see the '[Overview of the project & Glossary of terms](https://github.com/Cxbx-Reloaded/Cxbx-Reloaded/wiki/Overview-of-the-project-&-Glossary-of-terms)' page.
*** ***
### What does 'LED' in the upper right of the window mean? ### What does 'LED' in the upper right of the window mean?
This is the light that would normally be on the front of the Xbox. This is the light that would normally be on the front of the Xbox.
Some dashboards may change it or it may flash different colors to show error codes. Some dashboards change it, or it may flash different colors to show error codes.