Repository navigation
Home
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.
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.
| 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. |
ℹ️ 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.
| 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 |
Getting from zero to your first working keycard door takes five steps:
-
Install the mod on both server and clients, with
@CFloaded first — see 0. Installation. -
Add yourself as an admin by putting your Steam64ID in
admins.txt— see 1. Initial Setup. -
Open the admin menu in-game by pressing
K— see 8. Admin Menu Guide. -
Create a door using the
BS_DoorLockertool or directly from the admin menu — see 2. Door Configuration. - 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.
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