Claim Plugin

XiceClaim 领地插件

XiceClaim 用于把服务器领地保护做成可视化、物品化的交互功能，让玩家不用记复杂命令也能创建和管理自己的建设空间。

功能概述

XiceClaim 在服务器上表现为“领地戒指”“领地图腾”和三维领地保护系统。玩家手持领地戒指右键即可打开虚拟容器 GUI，完成领地创建、绑定已有领地、查看范围和进入管理菜单等操作，不再需要依赖一组复杂的领地命令。

插件按立方体保护空间，领地大小会受最小尺寸、最大水平尺寸、世界边界和重叠检测限制。创建、预览、查询和进入领地时，插件会用仅该玩家可见的粒子短暂显示领地范围，帮助确认边界位置。

领地保护会拦截未授权玩家的常见破坏与交互行为，并处理火焰、爆炸、活塞跨越边界等会影响领地安全的事件。领地所有者可以在戒指管理菜单中调整授权成员和领地功能权限；每项功能可以处于允许所有人、禁止未授权或全体禁止状态。

领地图腾是领地的实体锚点。图腾放置后占用 1 x 1 x 2 空间，使用带插件标记的方块实体保存身份，并通过展示实体和资源包模型显示自定义外观。图腾放在领地内部时会自动绑定到该领地；绑定关系会写入领地数据，图腾被破坏、失去支撑或爆炸波及时会整体回收并同步解绑。

绑定了领地图腾的领地支持传送。玩家通过绑定领地的戒指进入管理菜单后，可以传送到图腾正前方；传送会先进行倒计时和粒子施法，期间移动会取消，真正传送前还会再次检查图腾是否存在、目标空间是否安全以及玩家是否拥有对应领地权限。

图腾核心是可放入领地图腾的增强物品。已放入核心且图腾仍完整绑定时，领地内玩家会周期性获得夜视、抗火、水下呼吸、速度、抗性提升、生命恢复、急迫、力量和伤害吸收等短时光环效果。该效果只在玩家位于对应领地内时刷新。

部署方式

插件基于 Paper API 运行，当前项目按 Paper 1.21.11 和 Java 21 构建。构建产物安装为 /opt/xicemc/runtime/plugins/XiceClaim.jar。插件声明了 XiceMorePotionEffects 软依赖：没有该插件时领地保护、戒指、图腾和核心光环仍可工作；有该插件时，领地图腾传送完成后会额外施加跃迁抑制，避免连续传送。

插件运行时配置目录为 /opt/xicemc/runtime/plugins/XiceClaim/。主要配置文件是 config.yml，包含领地数量、尺寸限制、世界边界、粒子预览参数、默认保护策略、/xicecustomitem give 发放权限、领地图腾/图腾核心提示文案和传送提示文案。领地数据保存为 /opt/xicemc/runtime/plugins/XiceClaim/claims.yml，其中包含领地、成员、权限状态、戒指绑定、图腾绑定和图腾核心状态。

领地戒指、领地图腾和图腾核心使用服务器资源包中的自定义图标与模型。玩家侧能看到的物品和图腾外观由资源包提供，插件侧负责识别物品、保存绑定数据、处理右键交互、阻止原版合成误用并在玩家获得戒指后解锁后续配方。