BLRevive module for saving and loading user settings
- save and load integer settings and keybinds
- on windows, vcrun 2015 x86 has to be installed (vcrun 140) for Proxy.dll to load correctly, you can find it at https://www.microsoft.com/en-us/download/details.aspx?id=52685
- recent versions of wine should be able to run it without installing msvc, do
winetricks vcrun2015
if that's not the case
first make sure proxy.dll is ready and is capable of loading modules: https://gitlab.com/blrevive/tools/proxy
install settings-manager.dll
to <blr>/Binaries/Win32/Modules/
change <blr>/FoxGame/Config/BLRevive/default.json
to load settings-manager on client
for example:
{
"Proxy": {
"Server": {
"Host": "127.0.0.1",
"Port": "+1"
},
"Modules": {
"Server": [ ],
"Client": [ "settings-manager" ]
}
}
}
settings are saved under <blr>/FoxGame/Config/BLRevive/settings_manager_<player_name>
, invalid modifications to json dumps might crash the game during loading
In order to succesfully compile and run the module you need the following applications:
- Visual Studio 2019/2022 (with C++/MSVC)
- patched Blacklight: Retribution installation
Because Blacklight: Retribution itself is compiled for Win32, the modules target that platform too and only that one. It may be possible to compile the modules for another platform but there is no point in doing so.
- start VS developer shell inside project
- run
cmake -A Win32 -B build/
to generate build files for VS 2019/2022 / Win32 - configure debugging feature with cmake options (see below)
option | description | default |
---|---|---|
BLR_INSTALL_DIR |
absolute path to Blacklight install directory | C:\\Program Files (x86)\\Steam\\steamapps\\common\\blacklightretribution |
BLR_EXECUTABLE |
filename of BLR applicaiton | BLR.exe |
BLR_SERVER_CLI |
command line params passed to server when debugging | server HeloDeck |
BLR_CLIENT_CLI |
command line params passed to client when debugging | 127.0.0.1?Name=superewald |
Use build/settings-manager.sln
to compile the module with VS 2019/2022.
The solution offers the following targets:
target | description |
---|---|
Client | compile debug version and run BLR client |
Server | compile debug version and run BLR server |
Release | compile release version |