Skip to content
cjcarw edited this page Jul 15, 2026 · 6 revisions

🔐 Welcome to the BS KeyRoom Wiki

Thank you for choosing BS KeyRoom! This mod is a powerful tool designed to create dynamic, high-stakes events on your DayZ server. By turning regular doors into locked, loot-filled objectives, you can create unique points of interest and encourage intense player interaction.

This wiki covers everything from first-time installation to the most advanced configuration scenarios — and every part of the system is configured through JSON files or the in-game admin menu. No scripting or PBO repacking required.


🎯 What is BS KeyRoom?

BS KeyRoom allows server owners to designate specific doors across the map to be locked. To open them, players must find a corresponding keycard or item. Once a keycard is used, a timed event begins: the door unlocks (and optionally swings open) for a configurable duration, loot spawns inside, defenders can appear, alarms can sound, and the whole server can be notified — turning the location into an instant hotspot.


✨ Features

Feature Description
🚪 Keycard-Locked Doors Lock any door on the map and require a specific keycard or item to open it.
⏱️ Timed Open/Close Cycles Doors stay open for a configurable duration, then lock again with restock cooldowns before they can be reopened.
📦 Advanced Loot Containers Spawn loot containers inside the room with weighted loot pools, guaranteed fixed loot, and replacement item variants.
🔒 Lockable Crates Crates can be locked with timed opening mechanics for an extra layer of tension.
🤖 AI Defenders Spawn AI guards to defend the location, including full support for DayZ Expansion AI bots.
🚗 Vehicle Rewards Spawn vehicles nearby as high-value rewards for completing the event.
🚨 Alarms & Announcements Trigger audible alarms at the site and broadcast server-wide announcements to draw players in.
🛟 Safety Teleport Safely teleport players out of rooms so nobody gets trapped when doors lock.
🔗 Linked Doors Open or close multiple doors together from a single keycard event.
💾 Hacked Crate Support Integration with hackable crates that spawn when a door opens.
🖥️ Full In-Game Admin Menu Create doors, edit loot, manage AI and vehicles, and toggle settings live — all without touching a JSON file.
🧭 Expansion Quests Integration Tie keyroom events into DayZ Expansion Quests for objective-driven gameplay.

📋 Requirements

ℹ️ Note: BS KeyRoom requires a DayZ server (PC) and Community Framework (CF) as a dependency. DayZ Expansion is optional — it unlocks extras like Expansion AI bots, richer notifications, and Quests integration, but the mod works fully without it. See 10. Expansion Integration for details.


🗺️ Where to Start?

I want to… Go to…
Install the mod for the first time 0. Installation
Understand the file structure & set up admins 1. Initial Setup
Create my first locked door 2. Door Configuration
Configure loot inside the room 3. Advanced Loot System
Add AI defenders to my door 4. AI Spawning System
Add vehicle rewards to my door 5. Vehicle Spawning System
Customize keycard names and uses 6. Keys and Keycards Configuration
Configure global mod settings 7. Main Settings
Use the in-game admin menu 8. Admin Menu Guide
Configure sounds and alarms 9. Sounds and Alarms
Integrate with DayZ Expansion (AI, Quests) 10. Expansion Integration
Fix a problem 11. FAQ & Troubleshooting

⚡ Quick Workflow

Getting from zero to your first working keycard door takes five steps:

  1. Install the mod on both server and clients, with @CF loaded first — see 0. Installation.
  2. Add yourself as an admin by putting your Steam64ID in admins.txt — see 1. Initial Setup.
  3. Open the admin menu in-game by pressing K — see 8. Admin Menu Guide.
  4. Create a door using the BS_DoorLocker tool or directly from the admin menu — see 2. Door Configuration.
  5. Test it — swipe your keycard, watch the door open, loot the room, and tune from there.

💡 Tip: The mod auto-generates an example door config (GreenMountainRedKeycard.json) on first boot, so you always have a working reference to copy from.


📚 All Wiki Pages

  1. 0. Installation
  2. 1. Initial Setup
  3. 2. Door Configuration
  4. 3. Advanced Loot System
  5. 4. AI Spawning System
  6. 5. Vehicle Spawning System
  7. 6. Keys and Keycards Configuration
  8. 7. Main Settings (BS_KeyRoom_Settings.json)
  9. 8. Admin Menu Guide
  10. 9. Sounds and Alarms
  11. 10. Expansion Integration
  12. 11. FAQ & Troubleshooting

Clone this wiki locally