GracePeriod+
Running a survival or SMP server means balancing fairness with the thrill of open-world PvP. New players often get targeted before they can even craft a wooden sword, and server-wide events can turn into chaos without warning. GracePeriod+ solves both problems elegantly. This PaperMC plugin grants temporary PvP immunity to fresh joiners and lets admins activate a global grace period with a visible countdown — all while integrating seamlessly with LuckPerms for group-based permissions.
Why Your Server Needs GracePeriod+
First impressions matter. When a player logs in for the first time and immediately gets spawn‑killed, they rarely come back. GracePeriod+ automatically shields newcomers from player damage for a configurable duration, giving them time to gather resources and find shelter. The protection is personal — it does not affect other players — and a sleek action bar or BossBar timer shows exactly how long the safety lasts. For community events or server maintenance, admins can toggle a server‑wide grace period that disables PvP for everyone, with a broadcasted countdown that fades out smoothly when the timer ends.
Key Features at a Glance
- Automatic New‑Player Protection — First‑time joiners get a personal grace period with a configurable duration.
- Server‑Wide PvP Disable — Start a global grace period with a live countdown timer visible to all players.
- Per‑Player Grace — Grant individual players an extra grace period at any time, perfect for returning members or staff discretion.
- Mob Protection — Optionally prevent mobs from targeting or damaging grace‑protected players.
- Real‑Time Countdown — Display remaining time via action bar or BossBar, with a smooth fade‑out when protection ends.
- LuckPerms Integration — Automatically adds and removes a configurable [GRACE] group with a colored prefix during the grace period.
- Persistent Timers — Grace periods survive server restarts and player disconnects, so no one loses protection unfairly.
- Live Config Reload — Tweak settings without restarting the server using
/grace reload.
How to Install GracePeriod+
Installing GracePeriod+ is straightforward. First, ensure your server runs PaperMC 1.21.1 or newer and that LuckPerms is already installed — the plugin depends on it for group management. Then, simply drop the GracePeriodPlus-1.0.0.jar file into your server’s plugins/ folder and restart. The plugin will generate a default config.yml and automatically create the LuckPerms group named “GRACE” with a green prefix. If you’re using the foxygame.net launcher, adding GracePeriod+ is even easier: the launcher’s add‑on catalog lets you install it with one click and keeps the plugin updated automatically, so you never miss a compatibility patch.
Configuration Made Simple
All settings live in plugins/GracePeriodPlus/config.yml. You can adjust the new‑player grace duration (in seconds), enable or disable mob protection, change the LuckPerms group name and prefix color, and customize every message the plugin sends. The timer display can be switched between action bar and BossBar, with full control over colors and styles. After editing, just run /grace reload to apply changes without downtime.
Sample Configuration Snippet
Here’s a quick look at the core options:
new-player-grace-duration: 300— 5 minutes of protection for first joiners.block-player-damage: true— Prevents PvP during grace.block-mob-damage: false— Mobs can still attack (set to true for full safety).luckperms.group-name: "GRACE"— The LuckPerms group assigned during grace.timer.display-type: "actionbar"— Shows countdown above the hotbar.
Commands and Permissions
All commands require the graceplugin.admin permission (default for operators). The graceplugin.bypass permission allows players to attack grace‑protected players — useful for staff or trusted veterans.
/grace specific <player> <time>— Give a personal grace period (e.g.,/grace specific Steve 10m)./grace period <time>— Start a server‑wide grace period (e.g.,/grace period 2h)./grace end— End the active server‑wide grace period early./grace end <player>— End a specific player’s personal grace period./grace status [player]— Check remaining grace time./grace reload— Reload the configuration.
Time inputs accept 30s, 5m, 2h, 3d (up to 999 days), or a plain number for seconds.
How GracePeriod+ Works Behind the Scenes
When a player joins for the first time, the plugin records their UUID and starts a personal timer. During this period, they cannot deal or receive player damage, and if mob protection is enabled, hostile creatures ignore them entirely. The timer persists even if they log out — when they return, the remaining time is restored. For server‑wide grace, a global timer is broadcast to all players, and PvP is disabled until it expires or an admin ends it early. LuckPerms integration ensures the grace group is assigned and removed automatically, so you can use the prefix to visually identify protected players in chat or tab lists.
Perfect for Any Server Type
Whether you run a hardcore anarchy world, a friendly SMP, or a competitive event server, GracePeriod+ adapts to your needs. The per‑player grace command lets you welcome returning friends without altering global rules, and the server‑wide mode is ideal for building contests or peaceful trading sessions. The plugin’s lightweight design means no lag, and the live reload keeps administration hassle‑free.
Download GracePeriod+ today and give your community the fair start they deserve. With its intuitive commands, deep LuckPerms integration, and real‑time feedback, managing PvP protection has never been smoother.