How to Set Up CXBX-Reloaded

CXBX-R & CE QUICKSTART GUIDE by ycarcomed

v2 June 2020 (original version here)

1. Which build?

Cxbx-r is in active development, and each build might behave differently for JSRF. Some significant points:

  • ~March-April 2018: Boost dash no longer a black screen. Heavy performance hit.

  • January 2nd 2019: Upscaling support. Boost dash is all blur, unplayable again.

  • 2020: Boost works again. Graffiti still broken. Unplayable performance hits on AMD CPUs.

I use Mar 19, before boost dash fix. I find it’s the build that has been most stable for me and have had zero crashes with it. Fuse uses Mar 25.

I have AMD, so my main build is Dec 6 2018. Available here.

To grab any build, go to https://github.com/Cxbx-Reloaded/Cxbx-Reloaded/releases. Click Assets > CxbxReloaded-Release-VS20XX.zip.

Builds earlier than April 2020 are not available on Github releases. The only way to acquire them is to clone the repo and build them yourself.

If even Dec 6 is too slow for you, you can grab Mar 19 here (the date says Nov 17, because that’s the day I built it after I formatted my PC and lost it).

2. Save files and cache folder

Save files for JSRF are located at your %appdata%\Cxbx-Reloaded\EmuDisk\Partition1\UDATA\5345000a\99271B32E8BB

The game is hard coded to load the file named JSRFDATA.SAV.

At https://www.speedrun.com/jsrf/resources you can find a selection of vanilla save files (manual renaming needed to use) or Fuse’s quicksave mod with a selection of premade save slots all in one place (recommended).

The cache is at %appdata%\Roaming\Cxbx-Reloaded\EmuDisk\Partition5

What this folder does is emulate the location where the original hardware stores game assets on the HDD for faster loading. At load time, the game will first look for every (cacheable) file in the cache folder. If it doesn’t find it there, it will load it from “disc” i.e. the location where your xbe and game assets are. Keep that in mind when modding files. If you edit just the original file, the game will just load the unedited cached file (you can just edit the cached file instead). The original and cached version of the file are not necessarily interchangeable (file size may change)! Don’t lose track of your stuff! Keep backups! Deleting any part of the cache will cause it to be rebuilt from game assets when it is time for the game to load them.

3. Controller

If your controller supports Xinput it should be the better choice. Otherwise use DirectInput and set up your mappings. Under DirectInput Cxbx-r does not support a hat switch, so your D-pad might not work. I use an original Xbox S controller with a homemade USB adapter and XBCD. In XBCD, I reprogrammed the D-pad as 4 digital buttons instead of a hat switch, so I can use it with Cxbx-r.