Repository navigation
11. FAQ and Troubleshooting
Real issues from real servers, with the actual causes.
#1 cause: wrong door index. The door_indices list must contain the index of the exact door you're standing at — every building numbers its doors internally (0, 1, 2...), and they differ per building model.
- Enable Debug Build, hold the DoorLocker and read the index straight off the Door Scanner tags.
- Also verify
BuildingClassNamematches the building you're at (the scanner panel shows it).
#2 cause: another mod is breaking door actions. Quick test: if you can't open normal doors either (but can shoot them open), a different mod is overriding door actions — remove mods in halves until the prompt returns. Crashes when closing the KeyRoom menu are usually the same conflicting mod.
!kcreload (and the menu's Reload Configs) performs a full reset: reloads all JSON, wipes all cooldowns — including doors with Persist Cooldown — and closes + locks everything. Persist Cooldown only applies across actual server restarts.
If you lock a door with the mod and then delete its config, nothing manages that lock anymore. Since it's no longer a keycard door, a lockpick opens it normally.
Save Door Changes saves only the currently selected door. Edit one door → save → next door. Unsaved ticks on other doors are dropped when you switch. See saving behavior.
Enable Safety Teleport on the door. It teleports players out when the room closes and when they log back in inside the room (the login check uses the door's teleport radius — raise it for very large rooms).
Loadout file missing or misnamed on the server: $profile:ExpansionMod\Loadouts\, exact name with .json. Use the Loadout ... picker in the AI tab — it only lists files that actually exist.
Both fixed. Mags are visible immediately (weapon state sync) and configured modded mags are no longer replaced by the weapon's default mag. If you still see it, you're on an old version.
Fixed — an empty scale value used to get clamped to the minimum. Empty now means default size. Re-save the affected container.
chanceToSpawn in loot pools is a relative weight, not a percentage. Two items with 1.0 and 0.5 → 66% / 33%, not 100% / 50%. Use Simulate Loot (Containers tab) to see the real distribution over 1000 openings before going live.
Also note: with spawnFromAllPools, lootMin/lootMax applies per pool, not in total.
$profile:\BS_KeyRoom\logs\ — one file per session, also viewable in the menu's Admin Log tab. Only real errors are mirrored to the server RPT/script.log.
- Your Steam64ID must be in
$profile:\BS_KeyRoom\admins.txt(one per line, no quotes). - Wait up to 30s after editing (cache) or run
!kcreload. - Try
!kcmenuin chat if theKkeybind conflicts with another mod (rebindable in controls).
Yes — see 10. Expansion Integration for the ActionNames and the door setting you need.
Open a ticket on Discord with:
- The client crash log (if it crashed),
- The server script log,
- Your door JSON (the relevant one),
- Your mod list — most "KeyRoom bugs" turn out to be mod conflicts we can spot from the list.
Getting Started
Configuration
- 2. Door Configuration
- 3. Advanced Loot System
- 4. AI Spawning System
- 5. Vehicle Spawning System
- 6. Keys & Keycards
- 7. Main Settings
In-Game Tools
Integrations & Help