块保护器

块保护器

Chunk Protector 是一个高性能、仅服务端的管理保护矩阵。它提供基于标志的细粒度领地主权控制,并配有直观的箱子 GUI——无需客户端模组。

游戏机制

Chunck Protector

Chunck Protector 是一个仅服务端的 Fabric 模组,通过按区域设置标志来保护基于区块的领地。它完全在服务端运行,因此玩家使用原版客户端加入即可,无需安装任何模组。除 Fabric Loader 外没有其他依赖(不需要 Fabric API)。

工作原理:管理员使用游戏内工具选择区块,从选择范围创建命名的受保护区域,然后通过游戏内的箱子 GUI 或命令切换保护标志。当对应事件触及受保护区块时,每个标志都会在服务端立即生效:方块编辑、PvP 攻击、爆炸、弹射物、末影珍珠、液体流动、火焰蔓延、飞行、生物生成等。

支持的版本

下载与你的 Minecraft 版本匹配的文件。

文件 Minecraft Java Fabric Loader
chunck-protector-1.0.0+1.21.11.jar 1.21.11 21 0.19.3
chunck-protector-1.0.0+26.1.jar 26.1 - 26.1.2 25 0.19.3
chunck-protector-1.0.0+26.2.jar 26.2 25 0.19.3
chunck-protector-1.0.0+26.3.jar 26.3 25 0.19.5

安装

  1. 在服务端为你的 Minecraft 版本安装 Fabric Loader。
  2. 将匹配的 .jar 文件放入服务端的 mods 文件夹。
  3. 启动服务端。默认配置文件会创建在 config/chunk_protector.json。
  4. 给自己授予管理员权限。所有管理命令都需要配置的权限等级(默认:管理员等级 4)。
  5. 客户端无需安装任何内容。

命令

所有命令均以 /chunkprotector 开头,并且需要管理员权限(可配置,默认等级 4)。

命令 描述
/chunkprotector info 在聊天中显示命令帮助
/chunkprotector reload 从磁盘重新加载配置文件
/chunkprotector list 列出所有受保护区域及其区块数量
/chunkprotector check 显示你当前所在区块是否受保护,并列出其标志
/chunkprotector menu 为你所站区域打开标志 GUI
/chunkprotector tool stick 给予你用于选择区块的管理保护工具(木棍)
/chunkprotector tool shovel 给予你认领工具(下界合金锹)
/chunkprotector selection 列出你当前选择的区块
/chunkprotector selection clear 清除你当前的区块选择
/chunkprotector area create <id> 从你选择的区块创建受保护区域
/chunkprotector area <id> menu 为指定区域打开标志 GUI
/chunkprotector area <id> toggle <flag> <true|false> 从命令行设置区域的某个标志

区域 ID 和标志名称支持 Tab 补全。

典型设置流程:/chunkprotector tool stick,右键点击方块选择区块,/chunkprotector area create spawn,然后 /chunkprotector area spawn menu 配置标志。

配置

主文件:config/chunk_protector.json。

字段 默认值 描述
admin_tool_item minecraft:stick tool stick 命令发放的物品
claim_tool_item minecraft:netherite_shovel tool shovel 命令发放的物品
required_permission_level 4 运行管理命令所需的管理员等级
safety_border_buffer_blocks 16 液体流动保护使用的受保护区域周围缓冲距离
protected_areas [] 受保护区域定义数组

protected_areas 中的每个条目具有以下结构:

字段 默认值 描述
area_id (必填) 区域的唯一名称,用于命令和 GUI 标题
chunks (必填) 区块坐标数组,每个为 {"x": <int>, "z": <int>}
auto_merge true 填充所列区块之间的空隙,使区域作为单个区域运作
flags (见下文) 每个区域的保护标志

标志

每个区域都有自己的一份这些标志。可以在 GUI 中切换标志,或使用 /chunkprotector area <id> toggle <flag> <true|false>。

标志 默认值 描述
pvp_enabled false 为 false 时,区域内玩家对其他玩家的攻击会被取消
block_edit_admin_only true 为 true 时,只有管理员可以在区域内放置或破坏方块
ender_pearls_allowed false 为 false 时,阻止末影珍珠传送到区域内或区域内部传送
tnt_explosions_allowed false 为 false 时,区域内 TNT 爆炸会被抑制
liquid_flow_allowed false 为 false 时,熔岩和水无法流入区域
griefing_protection_active true 通用破坏检查的主开关
projectiles_disabled true 为 true 时,区域内箭等弹射物会被阻挡
no_flight_zone true 为 true 时,区域内非管理员玩家禁用飞行
no_fight_zone true 为 true 时,区域内阻止所有战斗和实体伤害
mob_spawning_allowed false 为 false 时,区域内阻止自然生物生成
wither_creeper_grief_allowed false 为 false 时,凋灵和苦力怕的爆炸不会破坏方块
hostile_despawn_proximity_radius 8 玩家在此区块数范围内的敌对生物会被清除;设为 0 以禁用
sulfur_cube_damage_disabled true 为 true 时,硫磺立方体无法在区域内爆炸(26.2 及更新版本)
fire_spread_disabled true 为 true 时,火焰无法在区域内蔓延
crop_trample_disabled true 为 true 时,区域内无法踩踏耕地和作物
item_drop_disabled false 为 true 时,非管理员玩家无法在区域内掉落物品
vehicle_entry_disabled false 为 true 时,玩家无法在区域内进入船、矿车和其他载具
animal_breeding_disabled false 为 true 时,区域内阻止动物繁殖

标志 GUI

/chunkprotector menu 和 /chunkprotector area <id> menu 命令会打开一个 54 格的箱子菜单。顶行显示区域名称、区块数量和自动合并状态。标志按类别分组(战斗、建造、移动、世界、实体),每个物品显示其当前 ON/OFF 状态、标志的作用、ON 和 OFF 的含义,以及点击提示。已启用的标志会发光。左键点击标志即可切换;更改会立即保存。空槽位为填充面板,无法取走。

服务端管理员注意事项

  • 该模组仅服务端。不要将其放在客户端;原版客户端照常工作。
  • 手动编辑 JSON 后,使用 /chunkprotector reload 重新加载配置。
  • 重叠的区块选择通过内部缓存解析,该缓存在加载和重载时重建。
  • 许可证:MIT。