How to set up ledger and graphs for Hardspace: Shipbreaker on Windows

README.md

v1, updated 2023-01-07
In this little guide I'll describe how to set up graphs for Hardspace: Shipbreaker game. Should take no more than 10mins.

1. Download plugins/mods

1. Download the latest BepInEx from their repo.
2. Download the latest racers-ledger mod from their repo
3. Download the latest racers-ledger .dll file or use this link to discord if you don't like downloading random DLLs from the internet.
4. Download the latest hardspace_viewer tool from their repo.

2. Putting it together

1. Open Shipbreaker game folder, on Steam this is as easy as right-clicking the game in Library list, and navigating to Manage -> Browse local files.
2. Extract BepInEx to the root of Shipbreaker folder so winhttp.dll is in the same folder as Shipbreaker.exe.
3. Create a plugins folder in BepInEx folder so that you get this structure - Hardspace Shipbreaker\BepInEx\plugins\.
4. Extract the racers-ledger .zip into plugins. You should end up with structure like Hardspace Shipbreaker\BepInEx\plugins\RACErsLedger\.
5. Replace Hardspace Shipbreaker\BepInEx\plugins\RACErsLedger\RACErsLedger.dll with the latest .dll file from download step 3.

3. Use

1. Run Shipbreaker. Besides Shipbreaker game window, you should also see a racers-ledger-lamprey.exe window opening
2. Open charter.html file from hardspace_viewer.
3. Do a run. Viewer should use data from ledger to show something like this:

4. Uninstalling

Disable BepInEx by renaming the winhttp.dll file in Shipbreaker root to something else.

5. Troubleshooting

Game freezes

Shipbreaker likely has a new version and you don't have a working .dll for it. Disable BepInEx for now (see uninstalling section).

Something else

Reach out in Discord, specifically the RACE channel.