Chunks - 区块认领

💡简介

本插件为服务器添加了区块认领（Chunk Claiming）功能，支持管理、访客权限与领地交互，并与 Vault、WorldGuard、PlaceholderAPI 深度集成。

🔧支持与要求

• 支持版本: 1.21.11
• Java 版本: 21
• 必须依赖:
• Vault
• WorldGuard
• PlaceholderAPI
• 可选依赖: Harvester, Capture

✨安装

• 下载最新版本的插件文件
• 将文件上传至服务器的 plugins 文件夹
• 重启服务器

⭐API

• 详细 API 文档请参阅：[文档链接](#)（原文未提供具体链接）

🎮反馈

感谢所有为改进插件提供宝贵反馈的用户。

❓PlaceholderAPI（变量占位符）

在消息或插件中使用以下占位符获取区块信息

chunk-owner:      "%chunks_owner%"       # 当前区块的拥有者
has-access:       "%chunks_access%"      # 是否有访问权限
claim-count:      "%chunks_claims%"      # 已认领区块数量
claim-left:       "%chunks_claims_left%" # 剩余可认领区块数量
claim-max:        "%chunks_claims_max%"  # 最大可认领区块数量

❓命令

`/chunk` – 玩家区块认领命令

• 描述: 执行区块认领相关操作
• 权限: chunks.command.chunk
• 无权限提示: You are do not have the permission to execute the command
• 用法: /chunk help

`/chunks` – 管理员区块管理命令

• 描述: 执行管理员区块操作
• 权限: chunks.command.chunks
• 无权限提示: You are do not have the permission to execute the command
• 用法: /chunks help

🔧权限列表

玩家命令权限

• chunks.command.chunk — 执行 /chunk 命令（默认: op）
• chunks.command.chunk.ban — 禁止玩家进入认领区（默认: op）
• chunks.command.chunk.banned — 查看被禁玩家列表（默认: op）
• chunks.command.chunk.claim — 认领当前区块（默认: op）
• chunks.command.chunk.claim.multiple.default — 一次性认领多个区块（默认: op）
• chunks.command.chunk.help — 查看 /chunk 帮助列表（默认: op）
• chunks.command.chunk.members — 列出区块成员（默认: op）
• chunks.command.chunk.tnt — 开关当前区块的 TNT 破坏（默认: op）
• chunks.command.chunk.unban — 解除玩家禁入（默认: op）
• chunks.command.chunk.unclaim — 解除认领当前区块（仅所有者，默认: op）
• chunks.command.chunk.view — 查看当前世界的已认领区块（默认: op）
• chunks.command.chunk.view.others — 查看其他玩家的已认领区块（默认: op）

管理员命令权限

• chunks.command.chunks — 执行 /chunks 命令（默认: op）
• chunks.command.chunks.edit — 切换区块编辑模式（默认: op）
• chunks.command.chunks.effect — 展示认领/解除认领的特效（默认: op）
• chunks.command.chunks.help — 查看 /chunks 帮助列表（默认: op）
• chunks.command.chunks.info — 获取当前区块详细信息（默认: op）
• chunks.command.chunks.reload — 重载插件配置文件（默认: op）
• chunks.command.chunks.protect — 管理员区块保护相关命令（默认: op）
• chunks.command.chunks.setowner — 设置当前区块的拥有者（默认: op）
• chunks.command.chunks.unclaim — 强制解除认领当前区块（默认: op）

这个文档包含了领地插件的配置文件和消息文件，帮助你自定义领地行为、经济系统、权限以及玩家交互提示。

🎮配置文件（config.yml）

• notify-update: true — 是否在更新时通知管理员
• worlds: 允许声明领地的世界列表
• world
• world_nether
• world_the_end
• test

经济系统

• cost: 1000.0 — 第一次声明领地的费用
• refund: 750.0 — 解除领地时退还的金额
• multiply: 25 — 每多声明一块领地，费用增加基础费用的 25%（建议先在测试环境验证）

最大领地数（按权限组）

• default: 32
• vip: 36
• staff: 64
• op: 9999

领地声明设置

• claim:
• manipulate-fly: true — 是否允许在领地内操控飞行状态
• expires: 31 — 领地过期天数（0 为永不过期）
• particle:

- `type`: `TOTEM_OF_UNDYING` — 粒子类型

- `spread`: `4` — 扩散范围

- `height`: `6` — 粒子高度

- `amount`: `75` — 粒子数量

• sound:

- `type`: `BLOCK_AMETHYST_BLOCK_BREAK` — 音效类型

- `volume`: `0.75`

- `pitch`: `1.0`

解除领地设置

• unclaim:
• particle:

- `type`: `SPELL_INSTANT`

- `spread`: `4`

- `height`: `6`

- `amount`: `75`

• sound:

- `type`: `BLOCK_AMETHYST_BLOCK_BREAK`

- `volume`: `0.75`

- `pitch`: `1.0`

领地行为控制

• pvp-inside-claims: true — 允许在领地内 PVP
• redstone-only-in-claims: false — 红石机器仅在领地内生效

禁止的操作（全局开关）

• disable-block-break: true — 禁止非领地成员破坏方块
• disable-block-fertilize: true — 禁止骨粉催熟
• disable-block-place: true — 禁止放置方块
• disable-cauldron-level-change: true — 禁止改变炼药锅水位
• disable-tnt-block-damage: true — 禁止 TNT 破坏方块
• disable-sign-change: true — 禁止修改告示牌内容
• disable-fluid-from-outside: true — 禁止来自领地外的流体流入
• disable-piston-from-outside: true — 禁止领地外的活塞推动领地内方块

禁止的物理方块（压力板、耕地等）

以下方块在领地内被禁止按压/交互（所有均设为 true）：

• 各类木质/石质压力板（ACACIA_PRESSURE_PLATE 等）
• 重型测重压力板 (HEAVY_WEIGHTED_PRESSURE_PLATE)
• 耕地 (FARMLAND)
• 嗅探兽蛋 (SNIFFER_EGG)
• 海龟蛋 (TURTLE_EGG)

禁止交互的方块

非领地成员将无法与以下方块交互（全部设为 true）：

• 按钮、门、栅栏门、活板门（所有木材变种）
• 铁砧、雕纹书架、炼药台、箱子、陷阱箱、漏斗、发射器、投掷器、唱片机、讲台、拉杆、阳光探测器等
• 花盆、装饰罐
• 蜡烛（所有颜色）、潜影盒（所有颜色）、床（所有颜色）
• 各类铜门/铜活板门（包括生锈/打蜡变种）
• 控制杆、比较器、中继器、红石线
• 试炼刷怪笼 (TRIAL_SPAWNER)、宝库 (VAULT)

禁止收获的方块

非领地成员无法采集以下作物的掉落物

• 蜂巢 (BEE_NEST, BEEHIVE)
• 洞穴藤蔓 (CAVE_VINES, CAVE_VINES_PLANT)
• 甜浆果丛 (SWEET_BERRY_BUSH)

禁止改变的方块

以下方块的形态变化（如氧化、剥皮、耕耘等）被禁用：

• 各类原木、木头（所有木材变种）
• 铜块及其变种（铜块、切制铜块、铜门/活板门/格栅/灯泡等，含所有氧化和打蜡阶段）
• 泥土、草径、草方块、菌丝、灰化土、粗泥、缠根泥土
• 南瓜 (PUMPKIN)
• 试炼刷怪笼、宝库

禁止使用的桶

领地内无法使用以下桶

• 水桶、熔岩桶、牛奶桶、细雪桶
• 鱼桶（所有鱼类）、蝾螈桶、蝌蚪桶、热带鱼桶

禁止使用的床

领地内无法使用所有颜色的床（16 种颜色全部列出）。

友好生物（允许在领地内存在）

以下生物被视为友好生物，可在领地内生成/存在（全部设为 true）：

• 全息生物：悦灵、犰狳、盔甲架、美西螈、蜜蜂、骆驼、猫、鸡、鳕鱼、牛、海豚、驴、狐狸、青蛙、山羊、马、铁傀儡、物品展示框、拴绳结、羊驼、矿车、哞菇、骡子、豹猫、画、熊猫、鹦鹉、猪、河豚、兔子、鲑鱼、羊、骷髅马、嗅探兽、雪傀儡、鱿鱼、炽足兽、蝌蚪、商羊驼、热带鱼、海龟、村民、流浪商人、狼、僵尸马

---

❓消息文件（message.yml）

命令消息

/chunk claim（声明领地）

• success: '&6你已声明一个区块，花费 &a{0}'
• insufficient-funds: '&c你没有足够的余额，需要 &a{0}'
• reached-limit: '&c你已达到了 &f{0}&c/&f{1}&c 的领地上限'
• claimed: '&c该区块已被 &f{0}&c 声明'
• disabled-area: '&c你无法在此区域声明领地'

/chunk unclaim（解除领地）

• success: '&6你解除了一个区块，退还 &a{0}'
• claimed: '&c该区块由 &f{0}&c 拥有'
• unclaimed: '&c该区块尚未被声明'

/chunk unclaim all（解除所有领地）

• success: '&6你解除了所有区块，每个退还 &a{0}'

/chunk tnt（切换 TNT 权限）

• enable: '&6当前区块允许 TNT 爆炸'
• disable: '&6当前区块不再允许 TNT 爆炸'
• claimed: '&c该区块已被 &f{0}&c 声明'
• unclaimed: '&c该区块未被声明'

/chunk help（帮助）

• title: '&6区块帮助：'
• ban: '&f/chunk ban 玩家&7 - 禁止玩家进入区块'
• banned: '&f/chunk banned&7 - 查看被禁止的玩家'
• claim: '&f/chunk claim&7 - 声明当前区块'
• help: '&f/chunk help&7 - 显示此帮助'
• members: '&f/chunk members add/remove 玩家&7 - 添加或移除区块成员'
• tnt: '&f/chunk tnt&7 - 切换当前区块的 TNT 权限'
• unban: '&f/chunk unban 目标&7 - 解除玩家的区块禁令'
• unclaim: '&f/chunk unclaim&7 - 解除当前区块'
• view: '&f/chunk view&7 - 查看已声明的区块'
• view-others: '&f/chunk view 目标&7 - 查看目标的区块'

/chunk ban（禁止玩家）

• success: '&6你已将 &f{0}&6 禁止进入你的区块'
• already-banned: '{0}&c 已被禁止'
• self: '&c你不能将自己从自己的区块中禁止'

/chunk unban（解除禁止）

• success: '&6你已解除了 &f{0}&6 的区块禁令'
• invalid: '{0}&c 不在禁止列表中'

/chunk members add（添加成员）

• success: '&6你已将 &f{0}&6 添加为成员'
• already-member: '{0}&c 已是成员'
• self: '&c你不能将自己添加为区块成员'

/chunk members remove（移除成员）

• success: '&6你已将 &f{0}&6 移除成员'
• invalid: '{0}&c 不是成员'

/chunk members（查看成员列表）

• title: '&6成员：'
• listed: '- {0}'
• empty: '&c当前没有成员'

/chunk banned（查看被禁止的玩家）

• title: '&6被禁止的玩家：'
• listed: '- {0}'
• empty: '&c当前没有禁止的玩家'

事件消息

操作被取消

• cancelled:
• claimed: '&c该区块由 &f{0}&c 拥有'
• pvp: '&c在已声明的区块内禁止 PVP'
• command: '&c你不能在 &f{1}&c 的区块内使用 &f{0}&c 命令'

移动进入/离开领地

• move:
• banned: '&c你被禁止进入 &f{0}&c 的区块'
• visit: '&6你进入了 &f{0}&6 的区块'
• exit: '&6你离开了 &f{0}&6 的区块'

飞行控制

• fly:
• claimed: '&c你不能在 &f{0}&c 的区块内飞行！'
• unclaimed: '&c你不能在非自己的区块内飞行！'