GracePlugin is a comprehensive and highly customizable grace period plugin for your Minecraft server. It allows you to create a safe environment for your players at the beginning of the game, with per-world configuration, region protection, and a wide range of flags to control player actions. This update, "The Control Update," introduces new features that give you even more control over the grace period and protected regions.
## Core Systems and Features
* **Grace Period:** The core feature of the plugin, the grace period is a configurable amount of time at the beginning of the game where PvP and other actions are disabled. The grace period can be started automatically when the server starts, or manually by an admin.
* **Region Protection:** You can create protected regions, or "safe zones," where you can control player actions with a high degree of granularity. Each region can have its own set of flags to enable or disable specific actions.
* **Per-World Configuration:** You can configure the grace period on a per-world basis, allowing you to have different grace period durations, or disable it entirely, in specific worlds.
* **Boss Bar Countdown:** A customizable boss bar is displayed to all players during the grace period, showing the time remaining.
## Commands
| Command | Description | Permission |
| --- | --- | --- |
| `/grace start` | Starts the grace period. | `grace.start` |
| `/grace pause` | Pauses the grace period timer. | `grace.pause` |
| `/grace resume` | Resumes the grace period timer. | `grace.resume` |
| `/grace status` | Shows the current status of the grace period. | `grace.status` |
| `/grace reload` | Reloads the plugin's configuration. | `grace.reload` |
| `/grace tools` | Gives the player the region selection tools. | `grace.tools` |
| `/grace claim <name>` | Claims a new protected region. | `grace.claim` |
| `/grace <region> <flag> <true/false>` | Sets a flag for a protected region. | `grace.flags` |
| `/grace help` | Displays the help menu. | `grace.help` |
## Permissions
| Permission | Description | Default |
| --- | --- | --- |
| `grace.start` | Allows the player to start the grace period. | `op` |
| `grace.pause` | Allows the player to pause the grace period. | `op` |
| `grace.resume` | Allows the player to resume the grace period. | `op` |
| `grace.status` | Allows the player to check the status of the grace period. | `true` |
| `grace.reload` | Allows the player to reload the plugin's configuration. | `op` |
| `grace.tools` | Allows the player to get the region selection tools. | `op` |
| `grace.claim` | Allows the player to claim a new protected region. | `op` |
| `grace.flags` | Allows the player to set flags for a protected region. | `op` |
| `grace.help` | Allows the player to view the help menu. | `true` |
## Flags
| Flag | Description |
| --- | --- |
| `block-breaking` | Prevents players from breaking blocks in the region. |
| `block-placing` | Prevents players from placing blocks in the region. |
| `mob-damage` | Prevents mobs from taking damage in the region. |
| `mob-spawning` | Prevents mobs from spawning in the region. |
| `invincible-players` | Makes players invincible in the region. |
| `command-blocking` | Blocks the commands listed in the `blocked-commands` list in the `config.yml` file. |
| `allow-flight` | Allows players to fly in the region, even if they are not in creative mode. |
| `item-drop` | Prevents players from dropping items in the region. |
| `item-pickup` | Prevents players from picking up items in the region. |
## Configuration
The `config.yml` file allows you to configure the plugin to your liking.
| Setting | Description |
| --- | --- |
| `auto-start` | Whether to automatically start the grace period when the server starts. |
| `grace-duration-seconds` | The default duration of the grace period in seconds. |
| `auto-start-duration-seconds` | The duration of the grace period when it is started automatically. |
| `worlds` | A list of worlds and their per-world grace period settings. |
| `messages` | A list of customizable messages. |
| `blocked-commands` | A list of commands to block when the `command-blocking` flag is enabled for a region. |
