Grace999

## Feature Systems

• Independent per-world grace timers, each with its own boss bar.
• Optional automatic startup grace.
• Optional per-player grace timers.
• Optional join-based personal grace start.
• Personal grace management commands to grant, check, and reset player timers.
• Region claiming and region-specific protection rules.
• Global protection rules.
• World-specific default rule values.
• Rule priority: a region rule overrides its world's rule, which overrides the global rule.
• Boss bar countdown during active grace, with customizable color and style per world.
• Optional action bar countdown showing each player's remaining personal grace time.
• Warning broadcast system at configurable time checkpoints.
• Configurable sounds for start, end, warnings, and blocked actions.
• Optional extra-life system with configurable lives per player, optional daily reset, and per-permission amounts.
• Optional hunger freeze during grace (eating still restores hunger).
• Deathban system with a master switch, per-world settings, delay, duration, reason, spectator transition, and optional IP ban. The deathban applies when a player dies while protected by an active grace.
• Start/end automation: console commands and broadcasts on grace start or end, plus scheduled start/stop times of day.
• Region management panel for viewing, editing, teleporting to, and deleting regions.
• Particle outlines for region selections and claimed regions.
• Protection bypass permission exempting players from all restrictions.
• Dedicated runtime storage so grace state, personal grace, and extra lives survive reloads and restarts.
• Placeholder support for scoreboards, chat formats, and HUD plugins.
• Admin GUI panels for fast timer, flag, and region management.

## Commands

• `/grace help`
• Show the help menu.

• `/grace start `
• Start grace. Without a world, starts all grace-enabled worlds. With a custom duration, that duration is used for the started timer only and never changes the configured defaults.

• `/grace stop `
• End grace immediately. Without a world, stops all active worlds.

• `/grace pause `
• Pause the active grace timer. Without a world, pauses all active worlds.

• `/grace resume `
• Resume a paused grace timer. Without a world, resumes all active worlds that are paused.

• `/grace extend `
• Add time to active grace. Without a world, extends all active worlds. Works correctly while paused.

• `/grace reduce `
• Remove time from active grace. If the remaining time drops to zero or below, grace ends.

• `/grace status`
• Show grace status, remaining time per world, and current global rule values.

• `/grace reload`
• Reload plugin settings, messages, and region data. Runtime state is never lost.

• `/grace tools`
• Get the region selection tools: a wooden pickaxe for corner 1 and a wooden shovel for corner 2. Right-click a block with each tool to set its corner, then use `/grace claim`.

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

• `/grace regions`
• Open the region management panel. Left-click a region to edit its flags, right-click to teleport to it, shift-click to delete it.

• `/grace claim `
• Create a region from the two selected corners. Names may only contain letters, numbers, dashes, and underscores. All rules start enabled; use `/grace setflag` or the region panel to change them.

• `/grace delete `
• Delete a region.

• `/grace list`
• List all regions.

• `/grace info `
• Show region details and rule values.

• `/grace setflag `
• Set a region rule value.

• `/grace flag `
• Set a global rule value.

• `/grace grant `
• Grant (or refresh) personal grace to a player. Without seconds, the personal grace duration from the config is used.

• `/grace check `
• Show a player's personal grace status and remaining time.

• `/grace reset `
• Clear a player's personal grace data so their grace can start again.

• `/grace visualize `
• Toggle the particle outline for a claimed region.

• `/grace `
• Legacy shorthand for setting region rule values. Only works when the first argument matches an existing region.

## 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.regions`
• Open the region management panel.

• `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