PerfCrystalEvents
Full-featured Crystal/Sword/Mace PvP and arena events: queue, shrinking borders, kits, GUIs, stats, and configurable rank event starts.
Paper and Folia 1.21 - 26.x
Support
Report bugs and get support here: https://discord.gg/VvM6k2eBDa
Features
• Folia support – runs on Folia and standard Paper backends
• Event presets – Crystal PvP, Mace PvP, and Sword PvP out of the box; add or edit presets in presets.yml and the admin GUI
• Procedural arenas – flat end-stone arenas with terrain, per-preset layout, and a fresh world folder per event
• Queue & phases – join queue, countdown, grace period, running phase, and optional time limit
• Shrinking border – multi-phase world border with smooth shrink, outside-border damage, and obsidian clearing in the final phase
• Player GUI – /event opens a menu to join, leave, view stats, and more
• Spectator mode – eliminated players and public /event spectate with compass GUI and vanish from outsiders
• Admin GUI – configure presets, start events, and stop the active event from /perfcrystalevents
• Live control GUI – adjust border size, time, grace, shrink pause, force start, add or kick players, and end with or without rewards while an event runs
• Kit system – save kits from inventory and assign them per preset
• Inventory handling – backup, empty-required, or keep-own modes with restore after the event
• Stats & leaderboard – wins, kills, deaths, streaks, /event top, /event stats, and last-event podium
• Rank event starts – trusted ranks start events with /event start (preset); daily limits per permission in config
• Rewards – participation, kill, and placement console commands with offline pending payout on rejoin
• Boss bar & scoreboard – MiniMessage boss bar for queue, countdown, grace, and live stats; in-event scoreboard
• Action bar – countdown, grace, border warnings, combat tag, and nearest-player indicator in late game
• Arena protection – block break/place/interact, command whitelist, forced PvP, escape-teleport block, and hub return after leave or death
• Reconnect grace – short window to rejoin after disconnect without elimination
Commands
/event – Open player event menu (perfcrystalevents.use)
/event join – Join the active event queue (perfcrystalevents.use, perfcrystalevents.join)
/event leave – Leave the current event (perfcrystalevents.use)
/event spectate [player] – Spectate a live participant (perfcrystalevents.use, perfcrystalevents.spectate)
/event top – Show top event winners (perfcrystalevents.use)
/event stats [player] – Show event stats (perfcrystalevents.use)
/event lastevent – Show the last event podium (perfcrystalevents.use)
/event start (preset) – Start an event preset (perfcrystalevents.use + configured start permission, e.g. perfcrystalevents.start.media)
/perfcrystalevents – Open admin GUI (perfcrystalevents.admin)
/perfcrystalevents reload – Reload config and data files (perfcrystalevents.admin)
/perfcrystalevents status – Show active event status (perfcrystalevents.admin)
/perfcrystalevents presets – List all event presets (perfcrystalevents.admin)
/perfcrystalevents gui – Open admin GUI (perfcrystalevents.admin)
/perfcrystalevents live – Open live control GUI (perfcrystalevents.admin)
/perfcrystalevents configure (preset) – Open preset settings GUI (perfcrystalevents.admin)
/perfcrystalevents info (preset) – Show preset details in chat (perfcrystalevents.admin)
/perfcrystalevents broadcast (message) – Broadcast to everyone in the event (perfcrystalevents.admin)
/perfcrystalevents start (preset) – Start an event (perfcrystalevents.admin)
/perfcrystalevents stop – Stop the active event (perfcrystalevents.admin)
/perfcrystalevents forcestart [duration] – Force-start or set countdown, e.g. 30s, 1m (perfcrystalevents.admin)
/perfcrystalevents forceshrink – Force border to the next phase (perfcrystalevents.admin)
/perfcrystalevents kick (player) – Remove a player from the event (perfcrystalevents.admin)
/perfcrystalevents kit save (name) – Save your inventory as a kit (perfcrystalevents.admin)
/perfcrystalevents kit delete (name) – Delete a saved kit (perfcrystalevents.admin)
/perfcrystalevents kit list – List saved kits (perfcrystalevents.admin)
Database
• SQLite (default)
• MySQL (configurable)
