sRooms — Advanced Rooms System ⭑ 26.2 ✅

Overview

sRooms is a compact zone-based PvP plugin built for Paper 1.19x–1.21x, made to run 1v1 duels, team duels and clan squad battles without babysitting arenas. Draw a WorldGuard region, create the zone, and sRooms handles the rest: automatic bounds detection, doors that open on countdown, bossbar HUD, winner fireworks, per-zone wagers and persistent stats. Every zone is tuned from an in-game editor GUI, everything reloads live with one command — no server restart, no downtime, no players yelling at you.

✨ Features

Yes, all of this is included:

Unlimited zones — each one defined by a WorldGuard region
Two zone kinds: DUEL and SQUAD
DUEL zones from 1v1 up to XvX with configurable team size
Custom team names and colors per side
SQUAD zones for clan battles with a full challenge system
Automatic bounds and entrance detection from the region
Automatic doors with configurable material and open delay
Custom barrier / wall block per zone
Per-zone potion effects manager
Keep inventory / keep experience toggles
Combat-log protection per zone
Block protection inside zones
Configurable denied-command list inside zones
Container rules (allow or reject chests, furnaces, etc.)
Timed or endless matches per zone
Bossbar HUD with per-mode formats, colors and styles
Titles, action bar and chat toggles per zone
Winner FX: fireworks with count, power, flicker, trail and colors
Winner chime sounds and area titles in a radius
Squad join FX: title, action bar and sound
Wager module: OFF / OPTIONAL / REQUIRED per zone
Wager payouts through configurable console commands
Economy link via Vault
SQLite storage — persistent per-player and per-zone records
Personal stats: kills, deaths, wins, losses, streak, KDR
Per-mode stats: duel and squad separated
Leaderboard placeholders with async caching and zero main-thread queries
Spectator mode with configurable viewpoint
Squad challenge flow: arm, call, confirm, abort
Session recovery after server restart
Automatic late-hook rebind (hooks plugins that enable after sRooms)
Multi-language support: English and Spanish included
Live reload of everything — no restart needed
Full tab-completion on all subcommands
No NMS — only public Bukkit / Spigot API

Compatibility

Paper 1.19x through 1.21x (tested on 1.21.4)
No NMS — only public Bukkit / Spigot API
Java 17 or higher
Compatible with all major Paper forks

⌨️ Commands

Main command: /srooms (aliases: /sr, /sroom)

Command	Description
/srooms	Shows the full help message
/srooms new <name> <DUEL|SQUAD>	Creates a new zone bound to your region
/srooms remove <name>	Deletes an existing zone
/srooms gui [name]	Opens the in-game zone editor
/srooms enter <name>	Joins a zone
/srooms exit	Leaves the current zone
/srooms watch <zone|out>	Spectates a zone in shadow mode
/srooms me	Shows your personal record
/srooms wager <name>	Opens the wager menu of a zone
/srooms begin <zone>	Arms a SQUAD face-off
/srooms call <zone> <squad>	Challenges a squad to battle
/srooms confirm <zone>	Accepts an incoming challenge
/srooms abort <zone>	Drops the current face-off
/srooms a1 <zone>	Saves side A start position
/srooms a2 <zone>	Saves side B start position
/srooms viewpoint <zone>	Saves the spectator viewpoint
/srooms lobby	Saves the hub point players return to
/srooms sync <starts|bounds|full> [zone]	Pushes saved setup to live zones
/srooms refresh	Reloads the entire configuration

All commands support intelligent tab-completion — your fingers will thank you.

Permissions

Permission	Description	Default
srooms.use	Use /srooms and enter zones	true
srooms.wager	Place wagers on zones	true
srooms.stats	View personal statistics	true
srooms.create	Create and manage zones	op
srooms.bypass.off	Enter zones marked as off	op
srooms.admin	Full administrative access (includes all below)	op

Placeholders (PlaceholderAPI)

Main identifier: %srooms_...% — mirrored as %zones_...% for admins who prefer it.

Placeholder	Description
%srooms_zone%	Zone the player is in, or "none"
%srooms_state_<zone>%	State of a zone (idle / live / running)
%srooms_players_<zone>%	Players currently inside a zone
%srooms_max_<zone>%	Capacity of a zone
%srooms_kills% / %srooms_deaths%	Total kills / deaths (duel + squad)
%srooms_wins% / %srooms_losses%	Total wins / losses (duel + squad)
%srooms_streak%	Current win streak
%srooms_kdr%	Kill/death ratio, 2 decimal places
%srooms_duelwins% ... %srooms_duellosses%	DUEL-only stats (kills, deaths, wins, losses)
%srooms_squadwins% ... %srooms_squadlosses%	SQUAD-only stats (kills, deaths, wins, losses)
%srooms_top_duel_wins_1%	Name of #1 in duel wins (global)
%srooms_top_duel_wins_value_1%	Value of #1 in duel wins (global)
%srooms_top_<stat>_<rank>_<zone>%	Per-zone leaderboards — stats: duel_wins, squad_wins, duel_kills, squad_kills, duel_deaths, squad_deaths, streak

Leaderboards refresh asynchronously and are cached — scoreboard and hologram plugins can spam them all they want.

Dependencies

Mandatory
WorldGuard — every zone binds to a region for automatic bounds and entrances (no way around this one)

Optional
PlaceholderAPI — placeholders
Vault — economy for wagers
UltimateClans / uClans / ByteClans / ApexClan — squad battles (first plugin found wins, priority configurable)

sRooms re-hooks automatically if any of these load after it — PlugMan, weird load orders and late economies included.

Zone Kinds

DUEL — classic arena fights. Defaults to 1v1, scales up to XvX with a configurable team size, team names and per-side start positions.
SQUAD — clan battles. Squads challenge each other with call / confirm / abort, spawn on opposite sides, and the last clan standing takes the zone.

Wager System

Three modes per zone, edited in-game or in the config:

OFF — the zone replies with the disabled notice
OPTIONAL — players can place a wager from the menu, default mode
REQUIRED — no entry without a wager

Payouts run as console commands with the {player} token, so any economy works — Vault, points, items, whatever your commands can do.

Match Flow

Every zone runs a clean state cycle:

IDLE — waiting for players, minimum configurable (2 to 40)
COUNTDOWN — doors sealed, bossbar ticking, titles firing
LIVE — fight. Timed or endless (last one standing)
RESULTS — winner FX: fireworks, chime and area title, then teleport back

Sessions survive restarts — players online during a reboot are safely returned to the hub point on the next start.

Zone Editor

The in-game /srooms gui editor tunes every zone live:

Kind, team size, minimum players, door material and delay, custom wall block, keep inventory / experience, combat log, block protection, titles / action bar / chat toggles, wager mode, match time, post-match teleport delay, zone status, and a potion effects manager. All of it clickable — zero YAML editing required.

Configuration

One job per file — all of them live in plugins/sRooms/:

File	Purpose
config.yml	General settings, guard rules, integrations, HUD, FX, ladder, wager payouts
texts/en.yml	English messages
texts/es.yml	Spanish messages
zones.yml	All zones and their settings
storage/srx.db	SQLite records, zone records, wagers and KV store

Included languages
en, es

️ Database

SQLite — local file, zero configuration, created automatically on first boot. Records are stored per player and per zone, so zone-specific leaderboards come for free.

️ Developer Notes

sRooms exposes its full stat surface through PlaceholderAPI — every kill, death, win, loss, streak and leaderboard is queryable by any plugin, scoreboard or hologram system. Hook rebinds are automatic, so integrations survive reloads and load-order chaos.

⚠️ Requirements

Paper 1.13x or higher
WorldGuard installed (mandatory — zones bind to regions)
Vault recommended (for wager payouts)
Java 17 or higher

Installation

1. Drop sRooms-1.0.0.jar into your plugins/ folder
2. Make sure WorldGuard is installed
3. Restart the server
4. Create a WorldGuard region where the arena will live
5. Stand inside it and run /srooms new <name> <DUEL|SQUAD>
6. Set /srooms a1, /srooms a2, /srooms viewpoint and /srooms lobby
7. Run /srooms refresh — and you're done