Grace999

插件

· 作者 Erik9994857

GracePlugin 提供可配置的、按世界划分的宽限期,包含 PvP 和生物伤害保护、Boss 栏倒计时、声音提醒,以及基于标志位保护的自定义安全区域。

0 本站下载 0 关注 更新于 2 个月前

最新 1.0.9 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

功能系统

  • 每个世界独立计时,拥有专属的生命倒计时栏。
  • 可选自动启动保护期。
  • 可选按玩家独立的保护期计时。
  • 可选基于加入游戏触发个人保护期。
  • 提供管理个人保护期的命令,用于授予、查看和重置玩家计时。
  • 支持区域认领及针对特定区域的保护规则。
  • 全局保护规则。
  • 世界默认的特定规则值。
  • 规则优先级:区域规则优先于其所属世界的规则,而世界规则又优先于全局规则。
  • 保护期内显示 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 值。

规则与标志

所有规则均使用以下逻辑:

  • true = 允许
  • false = 禁止

这些是永久性的保护规则——它们始终生效,不仅限于保护期内。当玩家执行操作时,插件会首先检查其所在区域的规则,其次是世界默认值,最后才是全局值。

可用标志:

  • 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%)。未知标志将返回空值。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源