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>%