PvP区块管理器

PvP区块管理器

每区块PvP控制,含豁免区、战斗标记与边界执行。

管理

PvP Chunk Manager

面向 Fabric 服务器的逐区块 PvP 控制。标记出原版 PvP 游戏规则被反转的区块,在战斗中给玩家打上标签,并阻止他们通过逃跑、末影珍珠逃脱或退出登录来逃离战斗。

模组功能

豁免区块

使用 PvP 区块工具(一把名为“PvP Chunk Tool”的钻石锄)来切换 PvP 规则被反转的区块:

  • 当原版 pvp 游戏规则开启时,如果攻击者或目标站在豁免区块内,则阻止 PvP 伤害。
  • 当原版 pvp 游戏规则关闭时,仅当双方玩家都站在豁免区块内时才允许 PvP 伤害(在支持的情况下会遵守队伍和友军伤害规则)。

战斗标签

攻击另一名玩家会给攻击者和目标都打上可配置时长(combat_tag_duration)的战斗标签。每次新的命中都会刷新该标签。

边界强制执行

处于标签状态时,玩家与其锚点(他们最后站立的豁免区块;当未使用豁免区块时,则为战斗开始的区块)的距离不得超过 pvp_border_distance 个区块。离开允许半径会在每个 tick 触发配置的逃脱动作,直到玩家回到范围内:

  • INVISIBLE_WALL(默认):将玩家推回边界,如同锚点周围有一堵隐形墙。
  • TELEPORT_BACK:将玩家传送到锚点区块的中心。
  • KILL:杀死玩家。

传送会通过高度图查找来确定安全的地表位置,因此玩家永远不会被放置在方块内部或下方。

末影珍珠拦截

战斗中投掷的末影珍珠如果会落在允许半径之外,则会被丢弃,因此珍珠无法用于逃脱。

防退出登录

在带有战斗标签时断开连接,会将玩家的整个物品栏掉落在其所在位置的地面上,并清除所有战斗状态。为逃避死亡而退出登录会让玩家损失其物品。

死亡重置

因任何原因死亡都会清除所有战斗追踪(锚点位置、战斗标签、攻击者记录),因此边界强制执行会在重生时重置。

管理员选项(26.3 版本)

区块工具命令、重载命令以及物理工具使用可以限制为具有可配置权限等级的操作员(tool_requires_op、reload_requires_op、op_permission_level)。

安装

  1. 为你的 Minecraft 版本安装 Fabric Loader 和 Fabric API。
  2. 下载与你的 Minecraft 版本匹配的文件(1.21.x、26.1.x、26.2 或 26.3),并将其放入 mods 文件夹。
  3. 启动服务器一次以生成 config/pvp_chunks.json。
  4. 使用 /pvpzone hoe 标记你的区域,调整设置,然后运行 /pvpzone reload。

设置 PvP 区域

  1. 通过原版 pvp 游戏规则决定基础行为。
  2. 运行 /pvpzone hoe 获取区块工具。
  3. 在每个你想要豁免的区块中右键点击一个方块。更改会立即保存到配置文件,并有一条聊天消息确认。
  4. 如有需要,编辑 config/pvp_chunks.json 中的 pvp_border_distance、combat_tag_duration 和 action_on_escape,然后运行 /pvpzone reload 以应用。

命令

命令 描述
/pvpzone hoe 给予钻石锄区块工具。右键点击方块以切换其所在区块的豁免状态。
/pvpzone reload 从磁盘重新加载 config/pvp_chunks.json。

所有命令名称均可通过配置文件的 commands 部分进行配置。

配置(config/pvp_chunks.json)

如果文件缺失,首次启动时会自动创建。示例:

{
  "commands": {
    "base_pvp_command": "pvpzone",
    "sub_get_tool": "hoe",
    "sub_reload": "reload"
  },
  "settings": {
    "pvp_border_distance": 2,
    "combat_tag_duration": 20,
    "action_on_escape": "INVISIBLE_WALL",
    "tool_requires_op": true,
    "reload_requires_op": true,
    "op_permission_level": 2
  },
  "exemptChunks": []
}
设置 默认值 描述
pvp_border_distance 2 带有标签的玩家在逃脱动作触发前可以离开其锚点的区块数。
combat_tag_duration 20 最后一次命中后战斗标签持续的时长(秒)。
action_on_escape INVISIBLE_WALL 带有标签的玩家离开允许半径时会发生什么:INVISIBLE_WALL、TELEPORT_BACK 或 KILL。
tool_requires_op true 仅操作员可以获取区块工具并切换区块(26.3 版本)。
reload_requires_op true 仅操作员可以重新加载配置(26.3 版本)。
op_permission_level 2 上述受限操作所需的权限等级(26.3 版本)。
base_pvp_command pvpzone 基础命令名称。
sub_get_tool hoe 给予区块工具的子命令。
sub_reload reload 重新加载配置的子命令。
exemptChunks [] 通过区块工具管理的区块坐标列表。

支持的版本

文件 Minecraft 版本
1.21.x 版本 1.21 至 1.21.11
26.1.x 版本 26.1 至 26.1.2
26.2 版本 26.2
26.3 版本 26.3(包含管理员权限选项)

所有版本均需要 Fabric Loader 和 Fabric API。仅服务端。