Skip to content

About

Native mod loader and graphical mod manager for Workers & Resources: Soviet Republic.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Soviet Mod Loader

A Windows-native prototype for launching Workers & Resources: Soviet Republic with enabled native mod DLLs. It contains a graphical mod manager, a bootloader that starts the game suspended and injects one shared runtime loader, and an example mod.

Project layout

SovietModManager.exe       Graphical mod manager (build output)
SovietBootloader.exe       Native launcher/injector (build output)
loader/SovietModLoader.dll Shared injected runtime loader (build output)
mods/<mod-id>/mod.ini      Mod manifest
mods/<mod-id>/bin/*.dll    Mod entry DLL (build output)
profiles/enabled-mods.ini  Local enabled-mod state

Build output, logs, and profiles/*.ini are intentionally ignored by Git.

Prerequisites

  • Visual Studio 2022 with MSVC C++ tools and Windows SDK
  • CMake 3.25+
  • .NET 8 SDK

Build the native loader

From a Visual Studio Developer PowerShell:

cmake -S C:\projects\soviet -B C:\projects\soviet\build -G "Visual Studio 17 2022" -A x64
cmake --build C:\projects\soviet\build --config Release

The build copies SovietBootloader.exe, loader\SovietModLoader.dll, and the example mod DLL into their runtime locations under the project root.

Build the graphical manager

dotnet build C:\projects\soviet\src\manager\SovietModManager.csproj --configuration Release --output C:\projects\soviet\manager-build
Copy-Item C:\projects\soviet\manager-build\SovietModManager* C:\projects\soviet

Run SovietModManager.exe to toggle discovered mods, select Soviet64.exe, and launch through the bootloader. It displays a preview directly from the configured game installation; no game assets are copied or modified.

Command-line bootloader

.\SovietBootloader.exe list
.\SovietBootloader.exe enable example-mod
.\SovietBootloader.exe disable example-mod
.\SovietBootloader.exe launch "C:\Program Files (x86)\Steam\steamapps\common\SovietRepublic\Soviet64.exe"

Mod manifest

[mod]
id = example-mod
name = Example Mod
version = 0.1.0
entry = bin\ExampleMod.dll

The injected loader reads profiles\enabled-mods.ini, loads each enabled manifest entry with LoadLibraryW, and invokes an optional exported SovietModInitialize function. This prototype intentionally has no compatibility, dependency, conflict, or hook-policy checks.

About

Native mod loader and graphical mod manager for Workers & Resources: Soviet Republic.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages