A RESTful API server for allowing externally reading data from and interacting with games built with the Secret Histories engine.
It currently supports:
At the moment, this mod is not published to the steam workshop or provided as a download, it must be built manually.
The Book of Hours build requires BepInEx to be installed into Book of Hours. This is needed both for the build step, and to run the mod.
The Cultist Simulator build is standalone and uses the game's built in mod loader. Since it is a DLL mod, the GHIRBI mod must also be installed.
To build this project, some environment variables must be specified:
- The
GAMEenv var must be set toBHfor Book of Hours, orCSfor Cultist Simulator - The
BOHDirenv var must be set to the steam installation folder for Book of Hours. - The
CSDirenv var must be set to the steam installation folder for Cultist Simulator.
Once these are set, the project can be built with dotnet publish. The build output will automatically be copied into your game's mod folder.
Once the mod is installed, it will open port 8081 from within the game engine and listen to requests there.
See the API docs for usage information.
If you are looking to build a webapp or nodejs application that interacts with the game, you may wish to see the companion secrethistories-api npm library providing a typescript-typed API wrapper around the endpoints of this mod.
Documentation for the API can be found at:
https://sunsetfi.github.io/secrethistories-api-mod
I tried really hard to get WebSockets working in this thing, but Unity/Mono doesn't implement them and all external implementations I can find have crippled basic http support. Should either write our own http server (not as hard as it sounds, but time consuming), or run a crippled third party websocket server on a different port.
For now, using long polling.