功能系统
- 每个世界独立计时,拥有专属的生命倒计时栏。
- 可选自动启动保护期。
- 可选按玩家独立的保护期计时。
- 可选基于加入游戏触发个人保护期。
- 提供管理个人保护期的命令,用于授予、查看和重置玩家计时。
- 支持区域认领及针对特定区域的保护规则。
- 全局保护规则。
- 世界默认的特定规则值。
- 规则优先级:区域规则优先于其所属世界的规则,而世界规则又优先于全局规则。
- 保护期内显示 Boss 栏倒计时,颜色与样式可按世界自定义。
- 可选动作栏倒计时,显示每位玩家剩余的个人保护时间。
- 可配置的时间节点警告广播系统。
- 保护开始、结束、警告及被阻止操作时的音效均可配置。
- 可选额外生命系统,支持为每位玩家配置生命值,可选每日重置,并支持按权限组分配不同数值。
- 保护期内可选冻结饥饿值(进食仍可恢复饥饿度)。
- 死亡惩罚系统,包含总开关、每世界设置、延迟、持续时间、原因、观察者模式切换以及可选的 IP 封禁。当玩家在活跃的保护期受保护时死亡,将触发死亡惩罚。
- 启动/结束自动化:保护期开始或结束时执行控制台命令并发送广播,支持设定每天的定时启动/停止时间。
- 区域管理面板,用于查看、编辑、传送至或删除区域。
- 区域选择及已认领区域显示粒子轮廓。
- 保护豁免权限,使玩家不受任何限制。
- 专用的运行时存储,确保保护状态、个人保护期和额外生命在重载和重启后得以保留。
- 支持记分板、聊天格式和 HUD 插件中的占位符。
- 管理员 GUI 面板,用于快速管理计时、标志和区域。
命令
-
/grace help
显示帮助菜单。
-
/grace start [world] [seconds]
启动保护期。不指定世界时,启动所有启用了保护期的世界。若指定自定义时长,该时长仅对此次启动的计时器生效,不会更改配置的默认值。
-
/grace stop [world]
立即结束保护期。不指定世界时,停止所有正在运行的世界。
-
/grace pause [world]
暂停当前的保护期计时。不指定世界时,暂停所有正在运行的世界。
-
/grace resume [world]
恢复暂停的保护期计时。不指定世界时,恢复所有处于暂停状态的世界。
-
/grace extend <seconds> [world]
向当前保护期增加时间。不指定世界时,延长所有正在运行的世界。即使处于暂停状态也能正常工作。
-
/grace reduce <seconds> [world]
从当前保护期扣除时间。如果剩余时间降至零或以下,保护期将结束。
-
/grace status
显示保护期状态、各世界剩余时间及当前全局规则值。
-
/grace reload
重新加载插件设置、消息和区域数据。运行时状态不会丢失。
-
/grace tools
获取区域选择工具:木镐用于设置角点 1,木铲用于设置角点 2。使用每种工具右键点击方块以设置角点,然后使用 /grace claim 进行认领。
-
/grace gui
打开管理员控制面板。
-
/grace regions
打开区域管理面板。左击区域以编辑其标志,右击传送至该区域,Shift+左击删除该区域。
-
/grace claim <name>
根据两个选定的角点创建一个区域。名称只能包含字母、数字、连字符和下划线。所有规则默认启用;请使用 /grace setflag 或区域面板进行修改。
-
/grace delete <name>
删除一个区域。
-
/grace list
列出所有区域。
-
/grace info <name>
显示区域详情和规则值。
-
/grace setflag <region> <flag> <true/false>
设置区域规则值。
-
/grace flag <flag> <true/false>
设置全局规则值。
-
/grace grant <player> [seconds]
为玩家授予(或刷新)个人保护期。若不指定秒数,则使用配置中的个人保护期时长。
-
/grace check <player>
显示玩家的个人保护期状态及剩余时间。
-
/grace reset <player>
清除玩家的个人保护期数据,使其可以再次开始计时。
-
/grace visualize <region>
切换已认领区域的粒子轮廓显示。
-
/grace <region> <flag> <true/false>
设置区域规则值的旧式简写形式。仅当第一个参数匹配现有区域时才有效。
权限
-
grace.start
启动保护期。
-
grace.stop
停止保护期。
-
grace.pause
暂停保护期。
-
grace.resume
恢复保护期。
-
grace.extend
延长保护期。
-
grace.reduce
缩短保护期。
-
grace.status
查看保护期状态。
-
grace.reload
重新加载设置。
-
grace.tools
接收区域选择工具。
-
grace.gui
打开管理员 GUI 面板。
-
grace.regions
打开区域管理面板。
-
grace.claim
创建区域。
-
grace.delete
删除区域。
-
grace.list
列出区域。
-
grace.info
查看区域详情。
-
grace.flags
编辑区域规则值。
-
grace.globalflag
编辑全局规则值。
-
grace.grant
为玩家授予个人保护期。
-
grace.check
检查玩家的个人保护期。
-
grace.reset
重置玩家的个人保护期。
-
grace.visualize
切换区域轮廓显示。
-
grace.bypass
豁免玩家的所有保护限制(包括伤害、方块规则、物品规则、命令和飞行规则)。
-
grace.deathban.ignore
当启用 ignore-permission 选项时,绕过死亡惩罚。
-
grace.extralives.<n>
在保护期内授予 <n> 个额外生命(范围为 2 到 10)。优先级最高且匹配的权限生效;否则使用配置中的 extra-lives 值。
规则与标志
所有规则均使用以下逻辑:
这些是永久性的保护规则——它们始终生效,不仅限于保护期内。当玩家执行操作时,插件会首先检查其所在区域的规则,其次是世界默认值,最后才是全局值。
可用标志:
allow-pvp — 控制玩家之间的 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 — 控制拾取物品。
配置指南
运行时状态(活跃的宽限期计时器、个人宽限期、额外生命)存储在插件文件夹中单独的 data.yml 文件内,并由插件自动管理。设置项位于 config.yml 中。
核心计时
-
grace-duration-seconds
手动启动时的默认宽限时长(秒)。更改此项会影响未来没有指定世界时长且无自定义时长的 /grace start 命令。如果在启动时提供了自定义时长,则不会覆盖此值。
-
auto-start-duration-seconds
当未设置世界时长时,用于自动启动和计划启动的回退时长。
-
auto-start
如果启用,服务器启动时将在所有启用了宽限期的世界中自动开始宽限期。设置为 true 以启用,false 以禁用。
个人宽限期
-
per-player-grace-enabled
为每个玩家启用独立的宽限期计时器。启用后,玩家将受到其个人宽限期的保护,而不是世界计时器。玩家的个人宽限期在其首次加入服务器时开始,并在个人持续时间结束后结束;一旦结束,除非管理员授予或重置,否则不会再给予。
-
per-player-grace-duration
个人宽限期的时长(秒)。也用作 /grace grant 的默认值。
-
grace-starts-from-join
在玩家首次加入服务器时开始个人宽限期。无论是否启用个人宽限期均可生效。
保护开关
-
no-damage-everything
在宽限期内阻止所有对玩家的伤害,覆盖其他规则。设置为 true 以启用。
-
extra-life-enabled
在宽限期内为玩家提供额外生命——每次玩家在拥有剩余生命的状态下死亡时,将消耗一次生命并以保留物品的形式重生,而不是被踢出服务器。设置为 true 以启用。
-
extra-lives
每位玩家获得的额外生命数量。0 表示完全禁用安全网。
-
extra-lives-daily-reset
如果启用,每天会将额外生命恢复至满额。
-
no-hunger-loss
防止在宽限期内饥饿值下降。进食仍可恢复饥饿值。设置为 true 以启用。
-
action-bar-countdown
如果启用,拥有活跃个人宽限期的玩家会在动作栏中看到剩余时间。
Boss 栏设置
-
bossbar.color
按世界划分的 Boss 栏颜色(PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE)。
-
bossbar.style
按世界划分的 Boss 栏样式(SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20)。
-
worlds.<world>.bossbar-color / worlds.<world>.bossbar-style
可选的按世界 Boss 栏颜色和样式的覆盖设置。
声音设置
-
sounds.grace-start
宽限期开始时在该世界的玩家播放的声音。
-
sounds.grace-end
宽限期结束时在该世界的玩家播放的声音。
-
sounds.warning
触发警告广播时播放的声音。
-
sounds.action-blocked
玩家操作被阻止时播放的声音。
-
sounds.volume
所有插件声音的音量(0.0 到 1.0)。
-
sounds.pitch
所有插件声音的音调。
警告间隔
warning-intervals
秒数与消息文本的映射。当剩余时间跨越这些值之一时,消息将广播给该世界的玩家。在消息中使用 %time% 以显示格式化后的剩余时间。
全局默认值
default-flags.*
所有标志的全局默认值。用于全局规则以及作为没有自己值的世界的回退值。
被屏蔽的命令
blocked-commands
当 allow-commands 为 false 时被屏蔽的命令列表。每项均为不带斜杠的命令名称。仅列出的命令会被屏蔽;其他命令仍然有效。
世界设置
-
worlds.<world>.grace-enabled
为该世界启用宽限期处理。只有将此设置为 true 的世界才会在活跃宽限期内受到保护并包含在自动启动中。
-
worlds.<world>.duration
在没有提供自定义时长时,启动逻辑使用的按世界宽限期时长。值为 0 时将回退到默认时长。
-
worlds.<world>.flags.*
按世界的默认标志值,当没有区域规则适用时使用。
-
worlds.<world>.bossbar-color / worlds.<world>.bossbar-style
可选的按世界 Boss 栏外观覆盖设置。
-
worlds.<world>.deathban.*
可选的按世界禁赛覆盖设置(参见下方的禁赛设置)。
禁赛设置
当玩家在受保护的活跃宽限期内死亡时,将应用禁赛。以下每个值都可以在 worlds.<world>.deathban 下按世界进行覆盖。
-
deathban.enabled
整个禁赛系统的主开关。设置为 false 以禁用所有禁赛。
-
deathban.banreason
玩家被封禁并被踢出时显示的原因。
-
deathban.ban-delay
死亡后到应用禁赛前的秒数。
-
deathban.spectator-after-death
如果启用,玩家在被踢出前会作为观察者观看几秒钟。如果禁用,他们将立即被踢出。
-
deathban.ban-time
禁赛的持续时长(秒)。值为 0 表示禁赛是永久的。适用于名称封禁和 IP 封禁。
-
deathban.ban-ip
如果启用,玩家所在的 IP 地址也会被封禁,且具有相同的过期时间。
-
deathban.ignore-permission
如果启用,拥有绕过权限的玩家不会被封禁。
自动化
-
automation.on-start-commands
在任何世界中的宽限期开始时运行的控制台命令。使用 %world% 表示世界名称。
-
automation.on-end-commands
在任意世界保护期结束时执行的控制台命令。
-
automation.on-start-broadcast / automation.on-end-broadcast
当任意世界的保护期开始或结束时,向整个服务器广播的消息。使用 %world% 表示世界名称。留空则不广播任何内容。
-
automation.schedule.enabled
如果启用,将在每天配置的时间自动启动和停止保护期。
-
automation.schedule.start-time / automation.schedule.end-time
在所有启用了保护期的世界中,保护期开始和结束的时间(服务器本地时间,格式为 HH:mm)。
区域可视化
-
region-visualization.enabled
粒子轮廓的主开关。设置为 false 以禁用。
-
region-visualization.particle
用于轮廓的粒子效果(例如 FLAME)。
-
region-visualization.show-selection
如果启用,将在你选定的两个角点周围显示轮廓。
消息设置
所有消息均支持 & 颜色代码。每个事件和被阻止的操作都在 messages.* 下提供可配置的消息。在适用处可使用如下占位符:%time%、%player%、%region%、%world%、%flag%、%value%、%lives%、%reason% 和 %location%。主要消息包括:
messages.grace-started — 保护期开始时在世界内广播。
messages.grace-end-title / messages.grace-end-subtitle / messages.grace-end-message — 保护期自然结束时显示的标题、副标题和消息。
messages.grace-stopped-title / messages.grace-stopped-subtitle / messages.grace-stopped — 保护期被手动停止时显示的内容。
messages.pvp-disabled / messages.pvp-disabled-grace — 当 PvP 因规则或被保护期阻止时显示。
messages.block-break-disabled, messages.block-place-disabled, messages.mob-damage-disabled, messages.item-drop-disabled, messages.item-pickup-disabled, messages.command-blocked — 当某项操作被阻止时显示。
messages.personal-grace-start, messages.personal-grace-end, messages.personal-grace-end-title, messages.personal-grace-end-subtitle, messages.personal-grace-actionbar — 个人保护期相关消息。
messages.grace-paused-broadcast, messages.grace-resumed-broadcast, messages.grace-extended-broadcast, messages.grace-reduced-broadcast — 计时器控制相关的广播消息。
messages.deathban-broadcast — 玩家被死亡禁赛时广播。
messages.extra-life-used, messages.extra-life-used-broadcast, messages.extra-life-lives-left — 额外生命相关消息。
messages.region-* — 所有区域创建、删除、选择和可视化的消息。
messages.no-permission, messages.config-reloaded, messages.unknown-command — 通用消息。
占位符支持
需要 PlaceholderAPI 插件。所有占位符均使用 grace 标识符。
-
%grace_active%
是否有任何世界的保护期处于激活状态。
-
%grace_paused%
是否有任何保护期处于暂停状态。
-
%grace_remaining%
剩余保护时间(秒数),取最长活跃的世界。
-
%grace_remaining_formatted%
格式化后的剩余保护时间(例如 “5 minute(s) and 30 second(s)”)。
-
%grace_remaining_short%
简短格式下的剩余保护时间(例如 “05:30”)。
-
%grace_player_active%
玩家当前是否受到保护期的保护。
-
%grace_player_remaining%
玩家剩余的个性化保护时间(秒数)。
-
%grace_player_remaining_formatted%
格式化后的玩家剩余个性化保护时间。
-
%grace_player_remaining_short%
简短格式下的玩家剩余个性化保护时间。
-
%grace_region%
玩家当前所在区域的名称,若无则为 none。
-
%grace_world_grace_enabled%
玩家所在世界是否启用了保护期。
-
%grace_flag_<flagname>%
全局标志的当前值(例如 %grace_flag_allow-pvp%)。未知标志将返回空值。
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 [world] [seconds]
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 [world]
End grace immediately. Without a world, stops all active worlds.
-
/grace pause [world]
Pause the active grace timer. Without a world, pauses all active worlds.
-
/grace resume [world]
Resume a paused grace timer. Without a world, resumes all active worlds that are paused.
-
/grace extend <seconds> [world]
Add time to active grace. Without a world, extends all active worlds. Works correctly while paused.
-
/grace reduce <seconds> [world]
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 <name>
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 <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 grant <player> [seconds]
Grant (or refresh) personal grace to a player. Without seconds, the personal grace duration from the config is used.
-
/grace check <player>
Show a player's personal grace status and remaining time.
-
/grace reset <player>
Clear a player's personal grace data so their grace can start again.
-
/grace visualize <region>
Toggle the particle outline for a claimed region.
-
/grace <region> <flag> <true/false>
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
Edit global rule values.
-
grace.grant
Grant personal grace to players.
-
grace.check
Check a player's personal grace.
-
grace.reset
Reset a player's personal grace.
-
grace.visualize
Toggle region outlines.
-
grace.bypass
Exempts the player from all protection restrictions (damage, block rules, item rules, commands, and flight rules).
-
grace.deathban.ignore
Bypass deathban when the ignore-permission option is enabled.
-
grace.extralives.<n>
Grants <n> extra lives during grace (2 through 10). The highest matching permission wins; otherwise the extra-lives config value is used.
Rules and Flags
All rules use:
true = allowed
false = blocked
Rules are permanent protection rules — they apply at all times, not only during grace. When a player acts, the plugin checks the region they are in first, then the world defaults, then the global value.
Available flags:
allow-pvp — Controls PvP between players.
allow-block-breaking — Controls breaking blocks.
allow-block-placing — Controls placing blocks.
allow-mob-damage — Controls damaging mobs.
allow-mob-spawning — Controls mob spawning.
allow-player-damage — Controls players taking damage.
allow-commands — Controls command usage.
allow-flight — Controls flight ability.
allow-item-drop — Controls dropping items.
allow-item-pickup — Controls picking up items.
Configuration Guide
Runtime state (active grace timers, personal grace, extra lives) is stored in a separate data.yml file in the plugin folder and is managed automatically. Settings live in config.yml.
Core Timing
-
grace-duration-seconds
Default grace length in seconds for manual starts. Changing this affects future /grace start commands that have no world duration and no custom duration. A custom duration on a start never overwrites this value.
-
auto-start-duration-seconds
Fallback duration used for auto-start and scheduled starts when a world duration is not set.
-
auto-start
If enabled, grace starts automatically at server startup in all grace-enabled worlds. Set to true to enable, false to disable.
Personal Grace
-
per-player-grace-enabled
Enables individual grace timers per player. While enabled, players are protected by their own personal grace instead of world timers. A player's personal grace starts on their first join and ends after the personal duration; once it ends it is not granted again unless an admin grants or resets it.
-
per-player-grace-duration
Length of personal grace in seconds. Also used as the default for /grace grant.
-
grace-starts-from-join
Starts personal grace when a player first joins the server. Works with or without per-player grace enabled.
Protection Toggles
-
no-damage-everything
Blocks all damage to players during grace, overriding rules. Set to true to enable.
-
extra-life-enabled
Gives players extra lives during grace — each time they die while protected with a life remaining, one life is used and they respawn with their items instead of being deathbanned. Set to true to enable.
-
extra-lives
Number of extra lives each player gets. 0 disables the safety net entirely.
-
extra-lives-daily-reset
If enabled, extra lives are restored to the full amount once per day.
-
no-hunger-loss
Prevents hunger from decreasing during grace. Eating still restores hunger. Set to true to enable.
-
action-bar-countdown
If enabled, players with active personal grace see their remaining time in the action bar.
Boss Bar Settings
-
bossbar.color
Color of the per-world boss bars (PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE).
-
bossbar.style
Style of the per-world boss bars (SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20).
-
worlds.<world>.bossbar-color / worlds.<world>.bossbar-style
Optional per-world overrides for the boss bar color and style.
Sound Settings
-
sounds.grace-start
Sound played to players in the world when grace starts.
-
sounds.grace-end
Sound played to players in the world when grace ends.
-
sounds.warning
Sound played when a warning broadcast fires.
-
sounds.action-blocked
Sound played when a player's action is blocked.
-
sounds.volume
Volume of all plugin sounds (0.0 to 1.0).
-
sounds.pitch
Pitch of all plugin sounds.
Warning Intervals
warning-intervals
Map of seconds-to-end and message text. When the remaining time crosses one of these values, the message is broadcast to the world's players. Use %time% in messages for formatted remaining time.
Global Defaults
default-flags.*
Server-wide default values for all flags. Used for the global rules and as the fallback for worlds without their own value.
Blocked Commands
blocked-commands
List of commands blocked when allow-commands is false. Each entry is a command name without the slash. Only the listed commands are blocked; all other commands still work.
World Settings
-
worlds.<world>.grace-enabled
Enables grace handling for that world. Only worlds with this set to true are protected during an active grace and are included in automatic starts.
-
worlds.<world>.duration
Per-world grace duration used by start logic when no custom duration is provided. A value of 0 falls back to the default duration.
-
worlds.<world>.flags.*
Per-world default flag values, used when no region rule applies.
-
worlds.<world>.bossbar-color / worlds.<world>.bossbar-style
Optional per-world boss bar appearance overrides.
-
worlds.<world>.deathban.*
Optional per-world deathban overrides (see Deathban Settings below).
Deathban Settings
The deathban applies when a player dies during an active grace they are protected by. Every value below can be overridden per world under worlds.<world>.deathban.
-
deathban.enabled
Master switch for the entire deathban system. Set to false to disable all deathbans.
-
deathban.banreason
The reason shown when a player is banned and kicked.
-
deathban.ban-delay
Seconds after death before the ban is applied.
-
deathban.spectator-after-death
If enabled, the player watches as a spectator for a few seconds before being kicked. If disabled, they are kicked immediately.
-
deathban.ban-time
Length of the ban in seconds. A value of 0 makes the ban permanent. Applies to name and IP bans alike.
-
deathban.ban-ip
If enabled, the player's IP address is banned as well, with the same expiry.
-
deathban.ignore-permission
If enabled, players with the bypass permission are not banned.
Automation
-
automation.on-start-commands
Console commands run when a grace period starts in any world. Use %world% for the world name.
-
automation.on-end-commands
Console commands run when a grace period ends in any world.
-
automation.on-start-broadcast / automation.on-end-broadcast
Messages broadcast to the whole server when grace starts or ends in any world. Use %world% for the world name. Leave empty to broadcast nothing.
-
automation.schedule.enabled
If enabled, grace is started and stopped automatically at the configured times each day.
-
automation.schedule.start-time / automation.schedule.end-time
Times of day (server local time, HH:mm format) at which grace starts and stops in all grace-enabled worlds.
Region Visualization
-
region-visualization.enabled
Master switch for particle outlines. Set to false to disable.
-
region-visualization.particle
The particle used for outlines (e.g. FLAME).
-
region-visualization.show-selection
If enabled, an outline is shown around your two selected corners.
Message Settings
All messages support & color codes. Every event and blocked action has a configurable message under messages.*. Placeholders like %time%, %player%, %region%, %world%, %flag%, %value%, %lives%, %reason%, and %location% are available where relevant. The main ones:
messages.grace-started — Broadcast in the world when grace starts.
messages.grace-end-title / messages.grace-end-subtitle / messages.grace-end-message — Title, subtitle, and message when grace ends naturally.
messages.grace-stopped-title / messages.grace-stopped-subtitle / messages.grace-stopped — Shown when grace is stopped.
messages.pvp-disabled / messages.pvp-disabled-grace — Shown when PvP is blocked by rules or by grace.
messages.block-break-disabled, messages.block-place-disabled, messages.mob-damage-disabled, messages.item-drop-disabled, messages.item-pickup-disabled, messages.command-blocked — Shown when an action is blocked.
messages.personal-grace-start, messages.personal-grace-end, messages.personal-grace-end-title, messages.personal-grace-end-subtitle, messages.personal-grace-actionbar — Personal grace messages.
messages.grace-paused-broadcast, messages.grace-resumed-broadcast, messages.grace-extended-broadcast, messages.grace-reduced-broadcast — Timer control broadcasts.
messages.deathban-broadcast — Broadcast when a player is deathbanned.
messages.extra-life-used, messages.extra-life-used-broadcast, messages.extra-life-lives-left — Extra life messages.
messages.region-* — All region creation, deletion, selection, and visualization messages.
messages.no-permission, messages.config-reloaded, messages.unknown-command — General messages.
Placeholder Support
Requires the PlaceholderAPI plugin. All placeholders use the grace identifier.
-
%grace_active%
Whether any world grace is active.
-
%grace_paused%
Whether any grace is paused.
-
%grace_remaining%
Remaining grace time in seconds (the longest active world).
-
%grace_remaining_formatted%
Remaining grace time, formatted (e.g. "5 minute(s) and 30 second(s)").
-
%grace_remaining_short%
Remaining grace time in short format (e.g. "05:30").
-
%grace_player_active%
Whether the player is currently protected by grace.
-
%grace_player_remaining%
Player's remaining personal grace time in seconds.
-
%grace_player_remaining_formatted%
Player's remaining personal grace time, formatted.
-
%grace_player_remaining_short%
Player's remaining personal grace time in short format.
-
%grace_region%
Name of the region the player is currently in, or none.
-
%grace_world_grace_enabled%
Whether grace is enabled in the player's world.
-
%grace_flag_<flagname>%
Current value of a global flag (e.g. %grace_flag_allow-pvp%). Unknown flags return nothing.
评论 0
登录后参与评分
还没有评论,来抢沙发吧