{"id":77460,"date":"2026-06-04T14:21:50","date_gmt":"2026-06-04T11:21:50","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/graceperiod\/"},"modified":"2026-06-04T14:21:50","modified_gmt":"2026-06-04T11:21:50","slug":"graceperiod","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/graceperiod\/","title":{"rendered":"GracePeriod+"},"content":{"rendered":"<p># \u2694 GracePeriod+<\/p>\n<p>**GracePeriod+** is a PaperMC plugin that protects new and specific players from PvP (and optionally mobs) for a configurable amount of time \u2014 perfect for survival, SMP, and competitive servers.<\/p>\n<p>&#8212;<\/p>\n<p>## Features<\/p>\n<p>&#8211;  **New player grace period** &#8211; automatically protects players the first time they join<br \/>\n&#8211;  **Server-wide grace period** &#8211; disable PvP for all players with a live countdown timer<br \/>\n&#8211;  **Per-player grace** &#8211; grant individual players an additional grace period at any time<br \/>\n&#8211;  **Mob protection** &#8211; optionally prevent mobs from targeting or damaging grace players<br \/>\n&#8211;  **Action bar \/ BossBar timer** &#8211; real-time countdown shown above the hotbar or at the top of the screen, with a smooth fade-out when done<br \/>\n&#8211;  **LuckPerms integration** &#8211; automatically assigns and removes a configurable `[GRACE]` group with a coloured prefix while a player is protected<br \/>\n&#8211;  **Persistent grace periods** &#8211; grace timers survive server restarts and player disconnects<br \/>\n&#8211;  **Live config reload** &#8211; change settings without restarting the server<\/p>\n<p>&#8212;<\/p>\n<p>## Special Mention<\/p>\n<p>&#8211; Plugin idea from the owner of Purgatory SMP!<br \/>\n&#8211; Check it out at the Discord<\/p>\n<p>&#8212;<\/p>\n<p>## Requirements<\/p>\n<p>| Dependency | Type |<br \/>\n|&#8212;|&#8212;|<br \/>\n| PaperMC 1.21.1+ | Required |<br \/>\n| LuckPerms | Required |<\/p>\n<p>&#8212;<\/p>\n<p>## Installation<\/p>\n<p>1. Drop `GracePeriodPlus-1.0.0.jar` into your `plugins\/` folder<br \/>\n2. Make sure **LuckPerms** is installed<br \/>\n3. Start the server &#8211; the plugin will generate a `config.yml` and create the `grace` LuckPerms group automatically<\/p>\n<p>&#8212;<\/p>\n<p>## Commands<\/p>\n<p>All commands require the `graceplugin.admin` permission (default: OP).<\/p>\n<p>| Command | Description |<br \/>\n|&#8212;|&#8212;|<br \/>\n| `\/grace specific <player> <time>` | Give a specific player a personal grace period |<br \/>\n| `\/grace period <time>` | Start a server-wide grace period (disables PvP for everyone) |<br \/>\n| `\/grace end` | End the active server-wide grace period early |<br \/>\n| `\/grace end <player>` | End a specific player&#8217;s personal grace period early |<br \/>\n| `\/grace status [player]` | Check the grace status of yourself or another player |<br \/>\n| `\/grace reload` | Reload the config.yml without restarting |<\/p>\n<p>### Time Format<\/p>\n<p>| Input | Meaning |<br \/>\n|&#8212;|&#8212;|<br \/>\n| `30s` | 30 seconds |<br \/>\n| `5m` | 5 minutes |<br \/>\n| `2h` | 2 hours |<br \/>\n| `3d` | 3 days (max: 999d) |<br \/>\n| `120` | 120 seconds (plain number = seconds) |<\/p>\n<p>&#8212;<\/p>\n<p>## Permissions<\/p>\n<p>| Permission | Description | Default |<br \/>\n|&#8212;|&#8212;|&#8212;|<br \/>\n| `graceplugin.admin` | Access to all `\/grace` commands | OP |<br \/>\n| `graceplugin.bypass` | Can attack grace-protected players freely | false |<\/p>\n<p>&#8212;<\/p>\n<p>## Configuration<\/p>\n<p>&#8220;`yaml<br \/>\n# How long (in seconds) a brand-new player is protected after their first join.<br \/>\n# Set to 0 to disable.<br \/>\nnew-player-grace-duration: 300<\/p>\n<p>protection:<br \/>\n  # Prevent players from attacking grace-protected players (and vice versa)<br \/>\n  block-player-damage: true<br \/>\n  # Prevent mobs from targeting or damaging grace-protected players<br \/>\n  block-mob-damage: false<\/p>\n<p>luckperms:<br \/>\n  # Name of the LuckPerms group assigned during grace (created automatically)<br \/>\n  group-name: &#8220;GRACE&#8221;<br \/>\n  # Colour of the group prefix \u2014 MiniMessage format<br \/>\n  # Options: <green>, <red>, <gold>, <aqua>, <yellow>, <blue>, <white>, etc.<br \/>\n  group-prefix-color: &#8220;<green>&#8221;<\/p>\n<p>messages:<br \/>\n  grace-start: &#8220;<green><bold>\u2726 Grace Period<\/bold><\/green> <gray>You are protected from PvP for <yellow>{time}<\/yellow>.<\/gray>&#8221;<br \/>\n  grace-end: &#8220;<red><bold>\u2726 Grace Period Over<\/bold><\/red> <gray>You are no longer protected from PvP.<\/gray>&#8221;<br \/>\n  cannot-attack: &#8220;<red>You cannot attack players during your grace period!<\/red>&#8221;<br \/>\n  cannot-be-attacked: &#8220;<red><yellow>{player}<\/yellow> is currently in a grace period and cannot be attacked!<\/red>&#8221;<br \/>\n  specific-success: &#8220;<green>Grace period of <yellow>{time}<\/yellow> applied to <aqua>{player}<\/aqua>.<\/green>&#8221;<br \/>\n  period-start-broadcast: &#8220;<gold><bold>\u2694 Server Grace Period<\/bold><\/gold> <gray>PvP disabled for <yellow>{time}<\/yellow>. Enjoy the peace!<\/gray>&#8221;<br \/>\n  period-end-broadcast: &#8220;<red><bold>\u2694 Server Grace Period Over<\/bold><\/red> <gray>PvP has been re-enabled. Good luck!<\/gray>&#8221;<br \/>\n  reload-success: &#8220;<green>GracePeriod+ config reloaded successfully.<\/green>&#8221;<br \/>\n  no-permission: &#8220;<red>You don&#8217;t have permission to use this command.<\/red>&#8221;<br \/>\n  usage: &#8220;<red>Usage: \/grace <specific|period|reload><\/red>&#8221;<\/p>\n<p>timer:<br \/>\n  # How to display the countdown \u2014 &#8220;actionbar&#8221; (above hotbar) or &#8220;bossbar&#8221; (top of screen)<br \/>\n  display-type: &#8220;actionbar&#8221;<br \/>\n  actionbar-format: &#8220;<gold><bold>\u2694 Grace Period:<\/bold><\/gold> <yellow>{time}<\/yellow>&#8221;<br \/>\n  bossbar-title: &#8220;<gold>\u2694 Grace Period: <yellow>{time}<\/yellow>&#8221;<br \/>\n  bossbar-color: &#8220;YELLOW&#8221;   # WHITE, YELLOW, GREEN, BLUE, RED, PURPLE, PINK<br \/>\n  bossbar-style: &#8220;SOLID&#8221;    # SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20<br \/>\n  # How long the timer takes to fade out when the grace period ends (in ticks, 20 = 1 second)<br \/>\n  fade-out-ticks: 40<br \/>\n&#8220;`<\/p>\n<p>&#8212;<\/p>\n<p>## LuckPerms Group<\/p>\n<p>On first startup, GracePeriod+ automatically creates a LuckPerms group named `grace` (configurable) with a coloured prefix. Players are added to this group when their grace period starts and removed when it ends &#8211; even if they go offline mid-grace.<\/p>\n<p>The prefix colour is configurable via MiniMessage tags in `config.yml`.<\/p>\n<p>&#8212;<\/p>\n<p>## How It Works<\/p>\n<p>**New player grace:** When a player joins for the first time, they are automatically placed in a personal grace period for the configured duration. During this time only that specific player is protected \u2014 other players are unaffected.<\/p>\n<p>**Personal grace (`\/grace specific`):** Grants an individual player a grace period at any time. Useful for welcoming returning players or staff discretion.<\/p>\n<p>**Server grace (`\/grace period`):** Disables PvP for the entire server for the specified duration. A live countdown is shown to all players via action bar or BossBar. PvP is automatically restored when the timer ends.<\/p>\n<p>**Mob protection:** When `block-mob-damage: true`, mobs will completely ignore grace-protected players &#8211; they won&#8217;t target, pathfind toward, or deal damage to them. Works for all mob types including projectiles.<\/p>\n<p>&#8212;<\/p>\n<div align=\"center\">\n<p>## License<\/p>\n<p>\u00a9 2025 JustBuddy. All Rights Reserved.<\/p>\n<p>The compiled JAR is free to download and use on your server. The source code is available via my Patreon.<\/p>\n<p>Purchasing grants you a personal, non-transferable license to view and modify the source code for private use only. This license is granted to the purchasing account only and may not be transferred to another person.<\/p>\n<p>You may NOT redistribute or publish the source code, resell or relicense it, or share your copy with others. Violation of any of these terms immediately terminates your license and you must delete all copies of the source code.<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Grace Period Plugin with all the config needed.<\/p>\n","protected":false},"featured_media":77461,"template":"","meta":{"_minecraft_slug":"graceperiod+","_minecraft_project_id":"NYWWuOYt","_minecraft_author":"JustBuddyy","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":10,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"graceperiod+.zip","_minecraft_size_bytes":35530,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:07:43.672542Z","_minecraft_date_created":"2026-05-05T23:07:39.799221Z","_minecraft_date_modified":"2026-04-27T15:24:48.541568Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/graceperiod+","_minecraft_icon_attachment_id":77461,"_minecraft_imported_at":"2026-06-04T11:21:51+00:00","_minecraft_import_hash":"14b2e9955e4802ee3326be356b2b90b4","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,137,127,91,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-77460","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-management","mod_category-mobs","mod_category-paper","mod_category-storage","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.6 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>GracePeriod+ - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/graceperiod\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"GracePeriod+ - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Grace Period Plugin with all the config needed.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/graceperiod\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/graceperiod\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/graceperiod\\\/\",\"name\":\"GracePeriod+ - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/graceperiod\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/graceperiod\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/graceperiod-icon-0384098ccf3044a09356f6973822289dc12cdbf5_96.webp\",\"datePublished\":\"2026-06-04T11:21:50+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/graceperiod\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/graceperiod\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/graceperiod\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/graceperiod-icon-0384098ccf3044a09356f6973822289dc12cdbf5_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/graceperiod-icon-0384098ccf3044a09356f6973822289dc12cdbf5_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/graceperiod\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"GracePeriod+\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"GracePeriod+ - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/graceperiod\/","og_locale":"en_US","og_type":"article","og_title":"GracePeriod+ - Minecraft","og_description":"Grace Period Plugin with all the config needed.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/graceperiod\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/graceperiod\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/graceperiod\/","name":"GracePeriod+ - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/graceperiod\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/graceperiod\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/graceperiod-icon-0384098ccf3044a09356f6973822289dc12cdbf5_96.webp","datePublished":"2026-06-04T11:21:50+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/graceperiod\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/graceperiod\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/graceperiod\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/graceperiod-icon-0384098ccf3044a09356f6973822289dc12cdbf5_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/graceperiod-icon-0384098ccf3044a09356f6973822289dc12cdbf5_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/graceperiod\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"GracePeriod+"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/77460","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/77461"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=77460"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=77460"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=77460"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=77460"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}