ChunkClaimPlugin

插件

· 作者 ashinmc

一个 Chunk Claiming 的 Spigot 和 Paper 插件

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

最新 0.8.5 · 26.3 · Bukkit / Paper

一键开服(送7天)

ChunkClaimPlugin (CCP)

ChunkClaimPlugin 是一款轻量级、高性能的土地保护插件,适用于现代 Spigot 和 Paper 服务器(1.19.4 至 26.x)。它提供基于网格的区块认领功能、命名领地、细粒度的保护标志、可选的渐进式经济引擎以及按玩家划分的本地化设置。

ChunkClaimPlugin 专为生存服从头设计,用原生的 Minecraft 区块边界(16 × 16 × 世界高度)取代了复杂的wand选择和无规则的多边形计算,确保在方块交互时零刻数延迟。


命令参考

玩家命令

命令 权限 描述
/claimchunk [name] ccp.claim 认领当前所在区块,并可选择性地为其指定一个组名
/chunkexpand <name> ccp.expand 将当前区块添加到现有的命名认领组中
/unclaimchunk [name] ccp.unclaim 取消指定认领组的认领,或取消当前所在区块的认领
/checkchunk ccp.check 检查当前区块的所有权和认领状态
/infochunk [page] ccp.info 列出你的认领组,支持分页浏览
/visualizechunk [name] ccp.visualize 在精确的认领边界周围显示临时的、针对每个玩家的粒子边框
/chunktp <name> ccp.teleport 安全地传送到你拥有的某个认领组
/chunksettings [subcommand] ccp.settings 打开交互式设置 GUI 或运行 CLI 子命令
/chunklang [locale] ccp.lang 设置你个人的显示语言

市场命令

命令 权限 描述
/claimtrade sell <claim> <price> ccp.trade 将拥有的认领组上架到服务器市场进行出售
/claimtrade cancel <claim> ccp.trade 从市场中移除你的认领组
/claimtrade buy [<seller> <claim>|<seller>:<claim>|<claim>] ccp.trade 购买认领(站在其中或通过卖家/认领名称指定)
/claimtrade list ccp.trade 显示服务器上所有当前上架待售的认领
/claimtrade claim ccp.trade 当背包空间可用时,收取待处理的经济收益

管理员命令

命令 权限 描述
/chunkadmin chunkclaim.admin 打开管理员管理面板
/chunkadmin reload chunkclaim.admin 重新加载 config.yml、本地化文件、缓存设置和经济引擎
/chunkadmin unclaim chunkclaim.admin 强制取消当前所在区块的认领
/chunkadmin unclaimplayer <player> [name|--all] chunkclaim.admin 强制取消特定玩家的所有或指定认领
/chunkadmin setlimit <player> <amount> chunkclaim.admin 为玩家设置自定义认领数量上限覆盖值(0 = 无限制)
/chunkadmin removelimit <player> chunkclaim.admin 将玩家的认领上限恢复为服务器默认值
/chunkadmin resetflag <flag> [action] chunkclaim.admin 清除或覆盖所有服务器认领中的某项认领标志

主要特性

命名领地组

玩家可以将其土地组织成不同的命名认领组,而不是孤立的区块(例如 /claimchunk Base、/chunkexpand Base)。保护标志、受信任玩家权限和交易状态将无缝应用于整个组。

渐进式经济与动态降价

完全可选(默认 enabled: false)。支持 Vault 虚拟余额、Gringotts 实体金币银行,或内置的物品货币(GOLD_INGOT、DIAMOND),无需任何外部依赖。

  • 递增价格曲线: 可设置免费起始区块、基础区块成本以及每拥有一个区块后的渐进式价格增量,以防止地图囤积。
  • 取消认领时的动态降价: 成本公式严格根据玩家的当前活跃区块数量计算。当玩家取消认领土地时,其下一个区块的成本会立即降低以匹配新的较低等级,并发放可配置的回扣。
  • 点对点市场 (/claimtrade): 玩家可以直接买卖已建立的基础设施。离线卖家的收益将在其上线时自动发放。

细粒度保护标志

可以在 /chunksettings 或通过 CLI 命令按认领组切换标志:

标志 描述 默认值
mob-griefing 阻止苦力怕爆炸和末影人拾取方块 已启用
mob-spawning 禁止在领地内自然生成敌对生物 已禁用
mob-entry 在边界处将敌对生物推开(隐形屏障) 已禁用
mob-protection 保护友方农场动物免受外部访客伤害 已启用
explosions 阻挡 TNT、矿车 TNT 和凋灵造成的爆炸伤害 已启用
pvp 阻挡领地内的玩家间战斗(包括水晶/锚 PvP)(在 config.yml 中为 block-pvp) 已启用
fire-spread 阻止火焰点燃、燃烧或蔓延 已启用
interact-chest 限制箱子、 barrels 和潜影盒仅受信任成员使用 已启用
interact-furnace 限制熔炉、高炉和烟熏炉 已启用
interact-stonecutter 限制工作台、切石机和锻造台 已启用
interact-door 限制门、陷阱门和栅栏门 已启用
interact-redstone 限制拉杆、按钮、比较器和中继器 已启用
interact-villagers 限制与村民及流浪商人的交易,以防止交易锁定 已启用

自定义菜单就绪 (DeluxeMenus / ChestCommands)

/chunksettings 中的每项设置都配有专用的 CLI 子命令 (flag, trust, untrust, particle, rename, transfer, unclaim),并支持完整的 Tab 补全。服务器管理员可以将 DeluxeMenus 或自定义 GUI 插件中的按钮直接绑定到 CCP 子命令。

非侵入式领土警报

领土入口和荒野提示默认通过 动作栏 直接显示在快捷栏上方,确保在建造和战斗时屏幕中心区域保持清晰。同时也支持标题、副标题和聊天模式。

原生逐玩家本地化

玩家可以使用 /chunklang set <locale> 独立配置其显示语言。包含以下语言的完整一致性:

  • 英语 (en_US)、西班牙语 (es_ES)、法语 (fr_FR)、德语 (de_DE)、葡萄牙语 (pt_BR)、俄语 (ru_RU) 和中文 (zh_CN)。

技术规格与架构

  • 空间查找复杂度: O(1) 并发内存查找 (ConcurrentHashMap),通过区块坐标键 (world:x:z) 实现,异步安全,适用于 PlaceholderAPI 扩展,并由原子异步磁盘持久化支持。
  • 服务器兼容性: Paper, Purpur 和 Spigot (Minecraft 1.19.4, 1.20.x, 1.21.x, and 26.x)。
  • Java 运行时: Java 17 或更高版本(完全支持 Java 21)。
  • 世界控制与 WorldGuard: 原生 disabled-worlds 黑名单以及 WorldGuard 区域重叠保护 (Flags.BUILD & __global__-safe)。
  • PlaceholderAPI: 完整的玩家领地统计、限制、组名和市场价格的扩展 (%ccp_claimed_chunks%, %ccp_max_chunks%, %ccp_claim_name%, %ccp_is_for_sale%, %ccp_claim_price%)。
  • 开发者 API: 程序化单例 ChunkClaimAPI,包含可取消的 Bukkit 事件 (ChunkClaimEvent, ChunkUnclaimEvent, ChunkRenameEvent, ChunkTransferEvent)。

文档与支持


版本历史

v0.8.5 (重大安全、性能与稳定性更新)

  • 全面破坏与漏洞审计 (50 项修复):
    • 阻止了水桶放置/拾取、流体与龙蛋跨边界流入、活塞在领地边界处的伸出/收回、直接使用打火石/火球点燃、末地水晶与重生锚爆炸、滞留型药水云、 chorus fruit 与末影珍珠入侵保险库、冰霜行者冰块破坏、1.20+ 告示牌文本编辑、钓鱼竿实体拉动、拴绳/解拴盗窃、灾厄袭击、船/矿车放置与实体骑乘、实体踩踏作物/海龟蛋、跨边界树木生长以及下界传送门覆盖。
    • 保护了染色潜影盒、压力板、绊线、锚、锅、堆肥桶、蛋糕、钟、讲台、雕纹书架和装饰瓶;将盔甲架破坏保护与 mob-protection 解耦。
  • 性能与线程安全:
    • 将 mob-entry 中的全局世界实体扫描替换为仅加载区块检查,并保护宠物 (Tameable)、自定义命名生物、村民和铁傀儡不被移除。
    • 添加了异步原子保存 (chunkclaims.yml.tmp),将所有 ChunkManager 集合转换为 ConcurrentHashMap,移除了 PlaceholderAPI 中的异步 .getChunk() 调用,在 PlayerMoveListener 中添加了位移位预检查,将热路径配置设置缓存在内存中,并消除了 /chunkadmin 中的阻塞 Mojang API 查找。
  • 经济与市场强化:
    • 追踪每个区块的历史购买价格,并将交易领地的退款归零以消除无限货币套利;添加了 /claimtrade buy <seller> <claim> 消歧义、/claimtrade claim 溢出恢复、RPG/自定义元数据物品保护、Material.AIR 崩溃预防以及 singular-name / plural-name 货币标签。
  • 导航、世界与管理配置:
    • 在 /chunktp 中添加了安全的垂直下界/地下扫描,准确的逐区块外围粒子边界(逐玩家数据包,可配置高度和间距,REDSTONE/DUST 别名),WorldGuard __global__ 绕过修复,disabled-worlds 黑名单,/infochunk [page] 分页,/chunkadmin reload,保留注释的 YAML 写入,以及 block-pvp: true 配置语义。

v0.8.0

  • 管理员领地管理: 提供 CLI 和 GUI 工具来检查并强制取消认领玩家领地(/chunkadmin unclaim, /chunkadmin unclaimplayer)。
  • 村民交易保护与战斗升级: 新增 interact-villagers 认领标志,防止陌生人耗尽村民交易或允许设立公共交易商场。解锁了对敌对生物右键点击交互以支持自定义剑战,并允许防御愤怒的蜜蜂和中立生物。
  • 多经济支持: 灵活的经济集成,支持 Vault、Gringotts/金币银行以及原生物理物品货币(GOLD_INGOT, DIAMOND),并支持离线支付队列。
  • 动态价格缩放与回落: 渐进式认领成本,当玩家取消认领领地时动态降低。
  • 玩家领地交易: 在 /claimtrade 下统一的市场平台(buy, sell, cancel, list)。
  • 自定义 GUI 的 CLI 子命令: /chunksettings 中完整的 CLI 子命令,用于标志位、信任、粒子效果、重命名和转移,以集成 DeluxeMenus。
  • 动作栏问候语: 通过动作栏发送可定制的领地进入和荒野通知。
  • 本地化完成: 所有 7 种支持语言的字符串完全一致,达到 100% 完整度。
  • 开发者 API 扩展: ChunkClaimAPI 中新增的管理和市场查询方法。
  • PlaceholderAPI 新增项: %ccp_is_for_sale% 和 %ccp_claim_price%。

v0.7.0

  • 开发者 API 与事件: 公开 ChunkClaimAPI 单例和可取消的 Bukkit 事件(ChunkClaimEvent, ChunkUnclaimEvent, ChunkRenameEvent, ChunkTransferEvent)。
  • PlaceholderAPI 集成: 提供认领数量、限制、所有权和组详情的扩展。
  • 火焰蔓延保护: 新增 fire-spread 标志,保护认领区域免受燃烧和引燃事件影响。
  • 基于权限的标志位: 细粒度的 ccp.flag.* 权限节点,用于 GUI 标志位切换。
  • 按玩家限制: 管理员命令 /chunkadmin setlimit 用于覆盖单个玩家的限制。
  • 事件命令触发器: 在区块认领和取消认领事件时执行控制台命令的钩子。

v0.6.0

  • 命令别名: 添加 /ccp 快捷别名。
  • 基于物品的认领: 使用可配置的工具进行右键认领(默认:木铲)。
  • 区块进入问候语: 进入认领领地时可配置的欢迎标题和副标题。
  • 细粒度交互设置: 针对箱子、熔炉、实用方块、门和红石的保护标志位。
  • 被动生物保护: 标志位防止访客在认领区域内伤害动物。
  • 领地重命名与转移: 直接从 GUI 无缝进行领地重命名和所有权转移。
  • 领地传送: 通过名称使用 /chunktp 传送到认领区域。
  • 新增语言: 添加德语 (de_DE)、葡萄牙语 (pt_BR) 和俄语 (ru_RU)。

v0.5.0 – v0.5.2

  • 管理员仪表盘: 初始化的 /chunkadmin 管理 GUI。
  • 命名认领组: 用命名认领组取代仅基于坐标的追踪(/claimchunk <name>, /chunkexpand <name>)。
  • 信任系统: 通过 GUI 玩家头像管理每个认领区域的受信任玩家。
  • 粒子选择: 在 /chunksettings 中为每个玩家定制边界可视化效果。
  • 中文语言: 添加简体中文 (zh_CN) 本地化。
  • 平台支持: Minecraft 1.21.11 和 26.1 API 兼容性。

v0.2 – v0.4

  • 核心重写与现代化: 为现代 Spigot/Paper 架构重构引擎。
  • 交互式 GUI: 引入玩家设置菜单 (/chunksettings),用于认领、删除和语言设置。
  • 边界可视化器: 基于粒子的区块边界渲染。
  • WorldGuard 集成: 全区块区域重叠验证。
  • 初始本地化: 英语 (en_US)、西班牙语 (es_ES) 和法语 (fr_FR)。

许可证

ChunkClaimPlugin 是开源软件,根据 MIT License 条款分发。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源