Grace999

New Features

Admin GUI Panels

• Added /grace gui to open a full admin control panel.
• Added a timer control panel for start, pause/resume, stop, extend, reduce, and reload actions.
• Added a global flag panel with live click-to-toggle controls.

Bug Fixes

Deathban Bypass

• Fixed deathban bypass handling so the bypass permission is respected when enabled.

Warning Intervals

• Fixed warning interval behavior so warnings trigger on threshold crossing instead of firing early in batches.
• Improved warning state tracking after time changes.

Pause and Resume

• Fixed pause behavior to stop only the timer task without destroying the boss bar.
• Fixed resume behavior to correctly continue countdown state and warnings.

Per-Player Grace Rejoin Abuse

• Fixed personal grace rejoin abuse by persisting completed personal grace records.
• Players who finish personal grace no longer receive a fresh timer on reconnect.

Reload and Defaults

• Fixed reload flow to refresh default flag baselines before rebuilding world/global runtime values.

Auto-Start and World Duration

• Fixed auto-start so it starts once instead of repeatedly restarting per enabled world.
• Fixed grace start duration resolution to use world duration defaults when no manual duration is provided.

Command Blocking

• Fixed blocked command matching to normalize namespaced command forms.

New Features

Warning Intervals System

• Configurable warning broadcasts before grace period ends
• Set custom times for warnings (e.g., 10 minutes, 5 minutes, 1 minute, 30 seconds)
• Custom messages for each warning interval with time placeholder support
• Optional warning sounds

Configurable Sounds

• Customize the sound played when grace period starts
• Customize the sound played when grace period ends
• Customize the sound played for warning broadcasts
• Customize the sound played when an action is blocked
• Adjustable volume and pitch for all sounds

World-Specific Flag Defaults

• Set different default flag values for each world
• Example: Disable PVP protection in the Nether but enable it in the Overworld
• Falls back to global defaults if world-specific settings are not defined

New Commands

• /grace extend <seconds> - Extend the current grace period by a specified amount
• /grace reduce <seconds> - Reduce the current grace period by a specified amount

PlaceholderAPI Integration

• Full PlaceholderAPI support for use with scoreboards, holograms, and other plugins
• Global grace placeholders (active status, time remaining, paused status)
• Per-player grace placeholders (personal grace status and time)
• Region placeholders (current region name)
• World placeholders (grace enabled status)
• Flag placeholders (value of any flag)
• Multiple time format options (seconds, formatted, short)

Changes

Flag Naming Convention

• Renamed all flags to use allow-* prefix for clarity
• pvp → allow-pvp
• block-breaking → allow-block-breaking
• block-placing → allow-block-placing
• mob-damage → allow-mob-damage
• mob-spawning → allow-mob-spawning
• item-drop → allow-item-drop
• item-pickup → allow-item-pickup
• command-blocking → allow-commands
• true now means the action is allowed
• false now means the action is blocked

Configuration Documentation

• Added complete command reference to config.yml
• Added complete permission reference to config.yml
• Added complete placeholder reference to config.yml
• Added complete flag reference to config.yml

New Features

Commands

• Added /grace stop command to manually stop an active grace period
• Added /grace start [duration] command with optional duration parameter in seconds
• Added /grace delete <regionName> command to remove existing regions
• Added /grace list command to display all created regions
• Added /grace info <regionName> command to view detailed region information including all flag states
• Added /grace setflag <regionName> <flag> <true|false> command as an alternative syntax for setting region flags
• Added full tab completion support for all commands, subcommands, region names, flag names, and boolean values

Configuration

• Added default-flags section in config.yml allowing server admins to configure the default state of each flag
• All flags now default to true (enabled) when not explicitly set
• Added grace-stopped message configuration option
• Flags can now be pre-configured before the plugin loads

Permissions

• Added grace.stop permission for stopping grace periods
• Added grace.delete permission for deleting regions
• Added grace.list permission for listing regions
• Added grace.info permission for viewing region information

Quality of Life

• Status command now displays the state of all global flags
• Help menu now only shows commands the player has permission to use
• Time formatting now includes hours for longer durations
• Improved feedback messages with color coding for flag states
• Region creation now validates that both corners are in the same world
• Region creation now checks for duplicate region names
• Added helpful hints after command execution

---

Bug Fixes

Combat and Damage

• Fixed projectile damage (arrows, tridents, etc.) not being blocked during grace period
• Fixed invincible-players flag logic being inverted
• Fixed PVP checks not properly considering per-player grace status
• Fixed mob damage flag not applying correctly in some situations

Grace Period Management

• Fixed grace period not properly ending when time expires
• Fixed boss bar progress calculation going negative or above 100%
• Fixed paused grace time not being calculated correctly when resumed
• Fixed grace period persisting across server restarts incorrectly
• Fixed auto-start not finding valid worlds when worlds section is missing

Per-Player Grace

• Fixed personal grace period not starting for new players
• Fixed players receiving duplicate grace start notifications
• Fixed personal grace expiry check not removing expired entries
• Fixed extra life feature not properly preserving inventory and experience

Deathban System

• Fixed deathban not properly kicking players after the delay
• Fixed spectator mode not being applied before deathban kick
• Fixed IP ban using incorrect method
• Fixed deathban ignore permission not being checked correctly

Regions and Flags

• Fixed region flag values not being read correctly from grace.yml
• Fixed global flags not loading default values from config
• Fixed command blocking flag logic being inverted
• Fixed flight not being disabled when leaving a flight-allowed region
• Fixed null pointer exception when checking regions in unloaded worlds

General

• Fixed cooldown messages being sent too frequently
• Fixed null pointer exceptions when items have no metadata
• Fixed region selection tools not being recognized after relog
• Fixed mob spawning flag blocking custom/plugin spawns
• Fixed movement event firing on head rotation without position change
• Fixed configuration not reloading all values on /grace reload

Version 1.0.5

New Features

• No damage from everything: Players can be protected from all types of damage during grace period
• Grace starts from join: Individual grace periods start for each player when they join the server
• 1 Extra Life: Players get one extra chance during grace period to prevent immediate death
• No Hunger Loss: Players don't lose hunger during grace period
• Deathban Settings: Comprehensive deathban system with configurable options:
  • Custom ban reason
  • Configurable ban delay
  • Spectator mode after death
  • Ban duration in seconds
  • IP ban option
  • Permission handling for spectator mode

Configuration Changes

• Added new settings to config.yml for all new features
• Enhanced deathban configuration with detailed comments
• Added data persistence for extra life usage

Added

• Global Flag System: A new system to control plugin features globally.
  • New command /grace flag <flagname> <true|false> to set global flags (e.g., /grace flag pvp false).
  • Flag states are saved in grace.yml and persist across server restarts.
  • New permission grace.globalflag to control usage of the global flag command.

Changed

• All Flags Now Work Globally: All existing flags can now be controlled at a global level, acting as a master switch. This includes:
  • pvp
  • block-breaking
  • block-placing
  • mob-damage
  • mob-spawning
  • invincible-players
  • command-blocking
  • allow-flight
  • item-drop
  • item-pickup
• PvP Region Flag: The pvp flag can now also be applied to specific regions, in addition to being a global flag.