Skip to content

8. Admin Menu Guide

cjcarw edited this page Jul 15, 2026 · 1 revision

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.


Opening the Menu

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.


How Saving Works (read this first)

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

Tabs

General

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

Alarms

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.

Containers

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.

Teleport

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.

AI Spawns

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's ExpansionMod/Loadouts folder; factions list every Expansion faction. The Class|Loadout|Faction format is composed automatically.
  • Set Position via hologram.

Vehicles

Vehicle rewards: classname, spawn chance, fuel, attachments list, min/max, hologram placement.

Keycards

Edits BS_KeyRoom_ItemNames.json in-game: display name, description and MaxUses per keycard class, with 3D preview and filter.

Global Loot

Full editor for the global loot pools (shared across doors). Same item/attachment editor as the per-door pools window.

Status

Live state of every configured door with Force Open / Force Close buttons.

Admin Log

Shows the mod's latest session log from $profile:\BS_KeyRoom\logs\.


Door Indices & the Door Scanner

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.


Placement Hologram Controls

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.


Item Browsers & Compatibility Filter

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.

Clone this wiki locally