Skip to content

11. FAQ and Troubleshooting

cjcarw edited this page Jul 15, 2026 · 1 revision

11. FAQ & Troubleshooting

Real issues from real servers, with the actual causes.


"I walk up to the door with the right keycard and there's NO prompt"

#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 BuildingClassName matches 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.


"Doors don't reset with !kcreload" / Persist Cooldown

!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.


"A door I deleted is stuck closed/locked"

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.


"I ticked options on several doors and some got unchecked"

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.


"My players log out inside the keyroom to loot it later"

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).


"Expansion bots spawn naked"

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.


"Magazines invisible on spawned guns" / "wrong mags"

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.


"My crate turned tiny (0.1 scale)"

Fixed — an empty scale value used to get clamped to the minimum. Empty now means default size. Re-save the affected container.


"Loot chances feel wrong"

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.


"Where are the logs?"

$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.


"The admin menu won't open"

  1. Your Steam64ID must be in $profile:\BS_KeyRoom\admins.txt (one per line, no quotes).
  2. Wait up to 30s after editing (cache) or run !kcreload.
  3. Try !kcmenu in chat if the K keybind conflicts with another mod (rebindable in controls).

"Can I use keyrooms in Expansion Quests?"

Yes — see 10. Expansion Integration for the ActionNames and the door setting you need.


Reporting Bugs

Open a ticket on Discord with:

  1. The client crash log (if it crashed),
  2. The server script log,
  3. Your door JSON (the relevant one),
  4. Your mod list — most "KeyRoom bugs" turn out to be mod conflicts we can spot from the list.

Clone this wiki locally