GracePeriod🛡️
A lightweight yet feature-packed grace period plugin for PaperMC 1.21.x servers. Perfect for world starts, post-restart cooldowns, or any event where you want to give players a safe window to get settled before PvP kicks in. ⚔️
What it does ⚙️
When a grace period is active, all forms of PvP are completely disabled — not just melee hits, but also arrows, tridents, snowballs, eggs, fireballs, wither skulls, wind charges, shulker bullets, splash potions, lingering potion clouds, fire charges, and player-primed TNT. No loopholes. 🚫
As the timer runs down, the plugin keeps everyone informed automatically. A chat message announces the start along with the full duration. ⏳ Warnings are broadcast at 5 minutes, 3 minutes, 1 minute, and 30 seconds remaining. When 10 seconds are left, a per-second countdown begins in chat. 🔔 When time is up, a title screen is shown to all players and a sound plays to signal that PvP is now live. 💥
An optional bossbar can be enabled in the config that displays the remaining time and smoothly depletes as the grace period counts down. 📊
Commands 💬
/graceperiod start — Start a grace period for the given number of seconds. /graceperiod stop — Manually end the grace period early. /graceperiod status — Check whether a grace period is active and how much time is left. The alias /gp works for all of the above.
Permissions 🔑
graceperiod.start — Start the grace period (default: op) graceperiod.stop — Stop the grace period (default: op) graceperiod.status — Check the status (default: everyone)
Configuration 📝
Nearly everything is configurable in config.yml — all messages, sounds, title texts and timings, permission nodes, and bossbar settings (toggle, title, color, overlay style). All text fields support legacy &x color codes, hex colors via &#RRGGBB or #RRGGBB, and full MiniMessage syntax including gradients and rainbow text. 🎨
