Grace999

Feature Systems

- Global grace system with start, stop, pause, resume, extend, and reduce controls. - Optional automatic startup grace. - Optional per-player grace timers. - Optional join-based personal grace start. - Region claiming and region-specific protection rules. - Global protection rules. - World-specific default rule values. - Boss bar countdown during active grace. - Warning broadcast system at configurable time checkpoints. - Configurable sounds for start, end, warnings, and blocked actions. - Optional extra-life system during grace. - Optional hunger freeze during grace. - Deathban system with delay, duration, reason, spectator transition, and optional IP ban. - Placeholder support for scoreboards, chat formats, and HUD plugins. - Admin GUI panels for fast timer and flag management.

Commands

- `/grace help` Show the help menu.

- `/grace start [seconds]` Start grace with optional custom duration.

- `/grace stop` End grace immediately.

- `/grace pause` Pause the active grace timer.

- `/grace resume` Resume a paused grace timer.

- `/grace extend <seconds>` Add time to active grace.

- `/grace reduce <seconds>` Remove time from active grace.

- `/grace status` Show grace status and current global rule values.

- `/grace reload` Reload plugin settings.

- `/grace tools` Get region corner selection tools.

- `/grace gui` Open the admin control panel.

- `/grace claim <name>` Create a region from selected corners.

- `/grace delete <name>` Delete a region.

- `/grace list` List all regions.

- `/grace info <name>` Show region details and rule values.

- `/grace setflag <region> <flag> <true/false>` Set a region rule value.

- `/grace flag <flag> <true/false>` Set a global rule value.

- `/grace <region> <flag> <true/false>` Legacy shorthand for setting region rule values.

Permissions

- `grace.start` Start grace.

- `grace.stop` Stop grace.

- `grace.pause` Pause grace.

- `grace.resume` Resume grace.

- `grace.extend` Extend grace.

- `grace.reduce` Reduce grace.

- `grace.status` View grace status.

- `grace.reload` Reload settings.

- `grace.tools` Receive region tools.

- `grace.gui` Open admin GUI panels.

- `grace.claim` Create regions.

- `grace.delete` Delete regions.

- `grace.list` List regions.

- `grace.info` View region details.

- `grace.flags` Edit region rule values.

- `grace.globalflag` Edit global rule values.

- `grace.deathban.ignore` Bypass deathban when bypass mode is enabled.

Rules and Flags

All rules use:

- `true` = allowed - `false` = blocked

Available flags:

- `allow-pvp` - `allow-block-breaking` - `allow-block-placing` - `allow-mob-damage` - `allow-mob-spawning` - `allow-player-damage` - `allow-commands` - `allow-flight` - `allow-item-drop` - `allow-item-pickup`

Configuration Guide

Core Timing

- `grace-duration-seconds` Default grace length for manual starts.

- `auto-start-duration-seconds` Fallback duration used for auto-start when a world duration is not set.

- `auto-start` If enabled, grace starts automatically at server startup.

- `grace-active` Runtime state value saved by the plugin.

- `grace-end-time` Runtime end timestamp saved by the plugin.

Personal Grace

- `per-player-grace-enabled` Enables individual grace timers per player.

- `per-player-grace-duration` Length of personal grace.

- `grace-starts-from-join` Starts personal grace when a player first joins.

Protection Toggles

- `no-damage-everything` Blocks all player damage during grace.

- `extra-life-enabled` Gives one extra life during grace.

- `no-hunger-loss` Prevents hunger depletion during grace.

Sound Settings

- `sounds.grace-start` - `sounds.grace-end` - `sounds.warning` - `sounds.action-blocked` - `sounds.volume` - `sounds.pitch`

Warning Intervals

- `warning-intervals` Map of seconds-to-end and message text. Use `%time%` in messages for formatted remaining time.

Global Defaults

- `default-flags.*` Server-wide default values for all flags.

Blocked Commands

- `blocked-commands` Commands blocked when `allow-commands` is `false`.

World Settings

- `worlds.<world>.grace-enabled` Enables grace handling for that world.

- `worlds.<world>.duration` Per-world grace duration used by start logic when no custom duration is provided.

- `worlds.<world>.flags.*` Per-world default flag values.

Deathban Settings

- `deathban.banreason` - `deathban.ban-delay` - `deathban.spectator-after-death` - `deathban.ban-time` - `deathban.ban-ip` - `deathban.ignore-permission`

Message Settings

- `messages.grace-end-title` - `messages.grace-end-subtitle` - `messages.grace-end-message` - `messages.pvp-disabled-message` - `messages.no-permission` - `messages.grace-started` - `messages.config-reloaded` - `messages.grace-active-already` - `messages.grace-stopped`

Placeholder Support

- `%grace_active%` - `%grace_paused%` - `%grace_remaining%` - `%grace_remaining_formatted%` - `%grace_remaining_short%` - `%grace_player_active%` - `%grace_player_remaining%` - `%grace_player_remaining_formatted%` - `%grace_player_remaining_short%` - `%grace_region%` - `%grace_world_grace_enabled%` - `%grace_flag_<flagname>%`