Grace Period

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. 🎨