Grace Period¶

The grace period is an admin-controlled feature that temporarily disables death bans. During a grace period, players who die simply respawn normally — no Trapped Souls are consumed and no bans are issued.

How It Works¶

When active, deaths bypass the entire hardcore system
Players auto-respawn after a 3-tick delay
A server-wide broadcast announces when the grace period starts
When disabled, another broadcast warns that hardcore rules are back in effect

Commands¶

All grace period commands require the hardcorerevive.grace permission (OP only by default).

Check Status¶

/graceperiod duration

Shows whether the grace period is active, when it ends, and how much time remains.

Add Time¶

/graceperiod duration add <days>

Adds days to the grace period. If no grace period is active, starts one from now. The end time is always rounded up to the nearest hour.

Examples:

/graceperiod duration add 7    → Adds 7 days
/graceperiod duration add 1    → Adds 1 day
/graceperiod duration add 30   → Adds 30 days

Subtract Time¶

/graceperiod duration subtract <days>

Removes days from the grace period. If subtracting would put the end time in the past, the grace period is automatically disabled.

Disable¶

/graceperiod disable

Immediately ends the grace period. A server-wide broadcast warns all players that hardcore death rules are now active.

Broadcasts¶

When grace period starts/extends:

[HardcoreRevive] Grace period is now active for 7d! Deaths will not result in bans.

When grace period is disabled:

[HardcoreRevive] Grace period has ended. Hardcore death rules are now active!

Technical Details¶

The grace period end timestamp is stored in config.yml as grace-period-end (Unix epoch seconds)
Setting it to 0 disables the grace period
End times are rounded up to the nearest hour boundary for clean expiration times