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.