RedLightGreenLight by Vineurodev

# Vineurodev RLGL **Red Light, Green Light — two ways to play, and not a single dependency.** Freeze the entire server with one command, or build proper race arenas with a lobby, a start line, a finish line and bounds players cannot leave. Select them by clicking two blocks. Let a wizard tell you what is still missing. No database. No Citizens. No WorldGuard. No economy plugin. Everything is YAML you can read, and the plugin argues with you when you get it wrong instead of quietly falling back to a default. --- ## ⚠️ Requires Java 25 Paper 26.2 ships Java 25 class files, so this is a hard floor, not a preference — a Java 21 server cannot load it. Check your runtime before you download. | | | |---|---| | Server | Paper 26.2+ | | Java | 25+ | | Optional | PlaceholderAPI 2.11.6+ | --- ## 🟥 Two ways to play **Global mode needs no setup at all.** One command enrols every online player, wherever they are standing. Survive to the timer without dying and you win. ``` /rlgl start global 2m ``` **Arena mode is the full race.** Players queue in a lobby, spawn together when the countdown ends, and run for a finish line. A start line stops anyone creeping forward early. A play region teleports anyone who wanders out back inside. Spectator bounds hold the eliminated where you want them. Two life modes per arena: `CONTINUOUS` lets the dead respawn and try again, `ONE_LIFE` puts them straight into spectator for the rest of the round. ## 🏗️ Build an arena by clicking blocks No coordinates to type. Four tools, one per thing you need to define: ``` /rlgl regionstick myarena ``` Right-click two blocks, left-click to confirm, and the tool removes itself. Wrong corner? Right-click again before confirming — nothing is written until you do. The arena name lives inside the item, so two tools for two arenas never collide, and block interaction is cancelled while you hold one. Then let the wizard drive: ``` /rlgl wizard myarena ``` A live checklist of every requirement, ticked or crossed, each with a clickable command for the next step. It refreshes itself as you finish steps. Leave it open and work down the list. `/rlgl arena enable` **refuses an unfinished arena**, so players can never join a course they are unable to complete. ## 🎯 The rules that make it a game Two details that are easy to leave out, and change how it plays: - **A reaction window.** The light turning red does not kill you for momentum you had already committed to. Configurable, default 1.25 s. - **A green-light idle penalty.** Standing still while the light is green costs health. Without it, the optimal strategy is to never move at all, and the round is dull. Set the damage to `0` and the check stops running entirely. Light durations are randomised between a floor and a ceiling you set. Get the range backwards and it is repaired with a warning rather than aborting the light cycle mid-round. ## 🧱 Config that checks itself Every value is validated when the file is read. Anything unusable is repaired to a known default **and named in the console**, so a typo is visible on the first restart instead of six weeks later: ``` 2 problem(s) found in config.yml: - 'arena.default-life-mode' has invalid value 'ONELIFE', using CONTINUOUS instead - 'global.max-light-delay-seconds' value '1' is out of range, clamped to 2 ``` Keys you leave out use their defaults, so trimming the file is safe. Values are read once into a snapshot rather than looked up during play — nothing does a string-keyed map lookup on the movement path. A mid-match `/rlgl reload` cannot change the rules of a round already running. ## 🛡️ It will not eat your arenas Two things this plugin refuses to do: - **Overwrite a coordinate it could not read.** If an arena's world is not loaded when the server starts — routine with world managers that load worlds after plugins — the stored coordinates are left untouched on disk and load once the world exists. `/rlgl status` lists which arenas are waiting. Saving never writes nothing over something. - **Delete on one command.** `/rlgl arena delete myarena` deletes nothing. It shows what would be lost, warns you if players are standing in it, and arms a confirmation valid for 30 seconds. The confirmation is bound to that exact arena name *and* to you, and is single use — so a stale "yes" can never land on a different arena than the one you were shown. Arena names are validated before they reach storage, because a name becomes a YAML key: a dot would otherwise nest one arena inside another and quietly corrupt the file. ## 📊 Statistics and leaderboards Arena wins, flawless wins, global survivals and deaths, per player. Statistics are batched and flushed periodically instead of writing the whole file on every kill, and always saved on shutdown. Main-thread file I/O in the middle of a match is not a feature. With PlaceholderAPI: ``` %rlgl_arena_wins% %r