Breaking Doors — a Door-Breaking Mini-Game
An automatically-built arena, a signup panel, a race where only the right doors break (a wrong pick knocks you back), a live results table, place rewards and a scheduler out of the box.
What is it?
Breaking Doors is a self-contained mini-event. The plugin builds a corridor of doors, every player gets a signup panel, and the race begins: sprint down the corridor, find the breakable doors in each row, smash through row after row and cross the finish line first. Wrong doors slam shut and throw you back.
No world editing, no map work, no dependencies — the arena is spawned, raced on and fully removed automatically.
-
Configurable gate ladder — each row defines its own door count and number of breakable doors; the default 7-row setup ramps difficulty from 7 doors / 4 correct down to 3 doors / 2 correct.
-
Real race mechanics — a correct door breaks; a wrong door slams shut and knocks you back (distance and cooldown configurable) and fires a "Wrong door!" notify.
-
Placement, results & rewards — finish order is tracked live with winner broadcasts, a results table with place / doors broken / mistakes / DNF, and item rewards per place (any items, amounts, skins, custom names).
-
Signup UI + command — every player gets a countdown panel with JOIN / CANCEL buttons; a chat command works too. Minimum- and maximum-players gates included, with a live joined counter (updates for everyone as players sign up).
-
Auto scheduling — run the event on an interval (default every 30 minutes) with an online-players check, or start / stop it manually from console, RCON or chat.
-
Fair-play enforcement — racers' inventories are locked and belts parked for the duration, weapons holstered, PvP between racers disabled, fall damage off, players re-anchored to their lane while the arena streams in. Everything is restored and everyone is teleported back after the race.
-
Full arena control — ground vs sky placement (sky height, water / slope / building avoidance checks on ground), building grade from Wood to TopTier, optional ceiling with height, distance between gates, platform height, finish path length, door skin.
-
Integrations — announcements through Notify / UINotify when present; registers itself as an event in Multi Events (start it from the panel or hand it to the scheduler), with winners sent to the Multi Events leaderboard.
Commands
All commands are configurable in the plugin config. Console commands work from the in-game F1 console, server console and RCON:
- bd — join the event during signup (chat command).
- bdstart — start an event manually (admin).
- bdstop — stop the current event and clean up the arena (admin).
Permissions
- breakingdoors.admin — access to the start / stop commands.
- Optional use permission for joining, set in the config (empty by default — everyone can join).
API
Every finisher fires a hook that statistics plugins can implement to record results:
void OnBreakingDoorsWin(ulong userId, string eventName, int place, int doorsBroken) // fires when crosses the finish; doorsBroken = correct doors smashed
UltimateLeaderboard is supported natively — every finisher is recorded automatically when it is installed.
Requirements
- Carbon or Oxide.
- No dependencies — Notify / UINotify, UltimateLeaderboard and Multi Events are optional and picked up automatically when installed.
