Repository navigation
8. Admin Menu Guide
The in-game admin menu is the main way to configure BS KeyRoom. Everything the JSON files do can be done from here — no file editing, no restarts.
| Method | Notes |
|---|---|
K key |
Default keybind (rebindable in DayZ controls: KeyCard Admin Menu) |
!kcmenu |
Chat command (vanilla or Expansion chat) |
⚠️ Both require your Steam64ID in$profile:\BS_KeyRoom\admins.txt. Changes to that file take up to 30 seconds to apply (cache), or apply instantly after!kcreload.
- Save Door Changes saves only the door currently selected in the left list. It does NOT save every door at once.
- Correct workflow: select door → edit → Save Door Changes → next door. Ticks you leave on other doors without saving are dropped when you switch.
- Save Global Loot & Keycards saves the global loot pools, keycard names and global flags — separate button, separate data.
- Reload Configs re-reads all JSON files from disk and resets every door (closes, locks, wipes cooldowns — including doors with Persist Cooldown).
- The UNSAVED CHANGES indicator (top right) warns you before closing with pending edits.
Door identity and behavior: location name, unlock/restock timers (min/max), Door Indices (see below), required keycards list, linked doors, Unlock Only, Containers Only, Persist Cooldown, Show Required Keys, Continuous Action + hold time, reputation reward. Also the global flags (Debug Build, Admin Log, Show Door Timer).
Accept/deny sounds with a sound picker (All / This Mod / Others), alarm sound + duration + loop delay, and the global announcement (title, text, RGBA color, duration). See 9. Sounds and Alarms.
The loot containers that spawn when the door opens. Add / Duplicate (full deep copy, loot pools included) / Remove, classname with item browser, position via placement hologram, scale, spawn chance, loot pools (single, random list, or all), fixed items editor with nested attachments, the replacement container system, and the crate lock options (required item, unlock time, open countdown, skip item). Simulate Loot runs 1000 virtual openings and shows you drop rates before going live.
Safety teleport toggle + radius (also used at login — players who log out inside get moved out when they reconnect), custom teleport points on an interactive map, and the hacked crate.
Min/max AI to spawn and the spawn list. Each spawn has:
-
ClassName with
...picker — categorized browser: ZOMBIES / ANIMALS / HUMANS-AI, with search and 3D preview. -
Expansion AI Bot checkbox — reveals Loadout and Faction fields, each with their own
...picker. Loadouts are listed live from your server'sExpansionMod/Loadoutsfolder; factions list every Expansion faction. TheClass|Loadout|Factionformat is composed automatically. - Set Position via hologram.
Vehicle rewards: classname, spawn chance, fuel, attachments list, min/max, hologram placement.
Edits BS_KeyRoom_ItemNames.json in-game: display name, description and MaxUses per keycard class, with 3D preview and filter.
Full editor for the global loot pools (shared across doors). Same item/attachment editor as the per-door pools window.
Live state of every configured door with Force Open / Force Close buttons.
Shows the mod's latest session log from $profile:\BS_KeyRoom\logs\.
Every building model numbers its doors internally (0, 1, 2...). The Door Indices list tells the mod which doors of the building to lock — the single most common misconfiguration is a wrong index (symptom: no prompt at the door).
Door Scanner: with Debug Build enabled, hold the DoorLocker item and every door around you shows a floating tag with its index, color-coded:
| Color | Meaning |
|---|---|
| 🟦 Cyan | Door already managed by a keyroom |
| 🟥 Red | Locked |
| 🟩 Green | Open |
| ⬜ Grey | Closed & free |
Aim at a door and the DOOR SCANNER panel (bottom left) shows its index, state, distance, the building classname (you need it for configs) and which keyroom owns it.
Used by Set Position buttons (containers, AI, vehicles, teleports, hacked crate):
| Input | Action |
|---|---|
| Scroll | Rotate |
| Ctrl + Scroll | Height |
| PgUp / PgDn | Scale (containers) |
| Hold Shift | Faster steps |
| LMB (hold) | Confirm placement |
AI spawns show a humanoid ghost as the placement marker.
When browsing for attachments in any loot editor, the list is filtered to what actually fits the selected weapon/item (config slots + magazines). The header shows what it's filtering for and how many items match; SHOW ALL ITEMS toggles the full list. If a class has no attachment info, the full list is shown automatically.
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