Help center

Troubleshooting and manual install

The manager is the recommended path. If you want to install manually or recover a broken setup, use the checks below before changing game files.

Troubleshooting

Start with the state, then check the files

Manager says incompatible

Compare the mod targetGameBuild with the runtime profile game build.

Open runtime profile

Mod does not load

Confirm the mod folder exists under UE4SS Mods/ and is enabled in Mods/mods.txt.

UE4SS does not start

Verify dwmapi.dll, UE4SS.dll, and UE4SS-settings.ini are in the Starminer Win64 directory.

Manual install warning

Manual install is for advanced users. Back up or use a copied Starminer install first. You are responsible for placing files correctly and verifying hashes from the API metadata.

1. Install the pinned runtime

Use the runtime profile as the source of truth for the UE4SS payload and file layout.

GET /api/v1/runtime/latest.json
Install directory: ILLSpace/Binaries/Win64
Required files: dwmapi.dll, UE4SS.dll, UE4SS-settings.ini

2. Install Starminer Framework

Download the framework ZIP from the framework metadata, verify SHA256, then place it under the UE4SS Mods folder.

Download framework ZIP Framework metadata

GET /api/v1/framework/latest.json
Mods directory: ILLSpace/Binaries/Win64/Mods

3. Install mods

Download only installable catalog mods with downloadEnabled: true. Verify the ZIP hash, extract to the UE4SS Mods folder, and add the mod id to Mods/mods.txt.

GET /api/v1/catalog.json
GET /api/v1/mods/example.hello-lua/index.json

4. Recover safely

Disable a suspect mod by removing or commenting its line in Mods/mods.txt.
Restore the pinned UE4SS files if the loader no longer starts.
Reinstall the framework before enabling framework-dependent mods.
Use the manager again when you want the portal to verify and update artifacts for you.