RACErs Ledger -- a mod for Hardspace: Shipbreaker to save salvage data in real time to enable visualization and analysis of salvaging strategies!
Right now it can:
- Save shift summaries (time started, ended, duration, value you salvaged, value you destroyed, probably more in the future!) after every shift!
- Save salvage ledgers (lists of everything you salvaged and destroyed) after every shift!
In the future it will be able to:
- Do magic
- Read minds
- Shit gold and spawn butterflies
- Probably other things if you suggest them!
Hardspace Shipbreaker.
BepInEx: https://github.com/BepInEx/BepInEx/releases (You want the x64 .zip.)
This mod (click here or on the Releases tab and download the .zip file for your operating system )
Extract BepInEx to the root Hardspace Shipbreaker folder so winhttp.dll is in the same folder as Shipbreaker.exe.
Extract the .zip you downloaded. Drag the entire RACErsLedger plugin folder into Hardspace Shipbreaker\BepInEx\plugins\RACErsLedger -- the folder should stay together.
Follow the Windows instructions. Afterwards you need to enable the DLL override.
For this either follow the official instructions of BepInEx or do it manually.
In order to manually enable the override open steamapps/compatdata/1161580/pfx/user.reg in a text editor and go to section [Software\\Wine\\DllOverrides].
Add a line to it:
[Software\\Wine\\DllOverrides]
…
"winhttp"="native,builtin"
Afterwards you can start the game as regular.
After following Installation instructions (above), run Shipbreaker.exe once. You can close it after you get to the main menu.
After this, navigate to Hardspace Shipbreaker\BepinEx\config\ and edit BepinEx.cfg. Under Logging.Console, set Enabled = true.
Next time you run Shipbreaker.exe (directly or through steam), a console window should pop up too. If it didn't, I dunno, ping me on Discord and I can try to help debug or something.
The mod's config file will be in Hardspace Shipbreaker\BepInEx\config\dev.sariya.racersledger.cfg after you've run Shipbreaker.exe with RACErsLedger.dll installed properly at least once.
Config options:
| key | description | default |
|---|---|---|
DataFolder |
Where to store the CSVs of your salvage summaries |
HardspaceShipbreaker\RACErsLedger |
UseLamprey |
Enable sidecar process for streaming events to interested clients (i.e. live data visualizers) | true |
LampreyListenPort |
(Advanced users only) What port does the lamprey process listen on? | 42069 |
WebsocketListenPort |
(Advanced users only) What port does the mod serve a stream of salvage data on? | 32325 |
LampreyBindToAllInterfaces |
(Advanced users only) Does the Lamprey bind to 127.0.0.1 (false) or 0.0.0.0 (true)? | false |
To update to a new RACErs Ledger version, navigate to the latest release, download the .zip and drag the entire folder into your BepInEx plugins path (like you did during installation), overwriting any conflicts.
If Hardspace: Shipbreaker is already running, you will need to close it to be able to overwrite the file.
BepInEx uses winhttp.dll as an injector/loader. Renaming or deleting this file is enough to disable both this mod and the loader.
Or just remove the RACErsLedger folder from the plugins folder.
This mod is provided on an AS-IS basis, with no implied warranty or guarantee that it will work at all. It might fuck up, it might accidentally delete your save, it might destroy spacetime, it might punch you in the face.
It probably won't do any of those things, since we test every release myself before giving it to anyone else, but it might, and you should be prepared for that harsh reality. Back up your saves, etc.
If the mod doesn't work in some way, ping me on the HSSB Discord in #modding-discussion or something. Also feel free to open issues or pull requests directly in GitHub. We might not want to deal with the thing, or might not be able to deal with it, but we'll definitely at least read your plight ;)
Thank you to Synthlight for making the Furnace Performance Improvements mod -- I've cribbed the structure and README of this mod heavily from them, so thank you Synthlight for helping get me started on this route! Before this I was binary editing the DLLs with dnSpy and that was no fun whatsoever, and hard to source control :-)