LSE CMland领地｜2D/3D自由圈地 · 门位传送 · 领地飞行 · 自动回收 1.0.0

Calman领地是一款基于 LeviLamina 与 LSE QuickJS 开发的 Minecraft 基岩版领地保护插件，集自由圈地、双经济系统、门位传送、金币付费飞行、成员权限管理和智能领地回收于一体。​

---

一、插件介绍​

Calman领地（CMland） 是一款面向 Minecraft 基岩版服务器的综合领地管理插件。

插件以方便玩家操作、灵活管理领地、降低服务器资源占用为设计方向，提供可视化表单操作和指令操作两种方式。

玩家可以使用木斧自由选择 2D 或 3D 领地，通过金币购买土地、设置专属门位、邀请成员共同管理，并通过领地告示牌实现跨领地传送、留言和点赞等互动功能。

插件还加入了独立的付费飞行套餐系统，以及可由管理员自行配置的自动回收机制，适合生存、养老及综合玩法服务器。

二、主要功能​

1. 2D / 3D 自由圈地​

• 支持二维平面领地和三维空间领地。
• 使用木斧左键选择起点、右键选择终点。
• 支持通过指令设置选区坐标。
• 自动计算领地面积或体积及购买价格。
• 支持领地边界粒子可视化。
• 自动检测领地重叠，避免重复占地。
• 管理员可配置领地数量、面积限制及购买价格。

2. 选区暂存与取消​

玩家不想立即购买时，可以自由暂存或取消选区。

• 木斧选取两点后自动弹出购买核对表单。
• 表单支持确认购买、暂存选区、取消选区、继续调整。
• 暂存后可以退出游戏，重新登录继续圈地。
• 服务器重启后仍然可以恢复未过期的选区。
• 默认暂存 4320 分钟（3 天）。
• 管理员可通过表单按分钟修改暂存时间。
• 过期选区自动清理，不影响已购买的领地。

未购买的选区不会产生领地保护，也不会扣除金币。

3. 专属门位与领地告示牌​

每块领地都可以设置自己的专属门位。

• 玩家购买领地后，使用木斧指定门位位置。
• 系统自动生成门位基石和信息告示牌。
• 默认基石为基岩，管理员可修改方块类型。
• 门位基石与告示牌受到保护，无法正常破坏。
• 支持后续重新设置门位位置。
• 领地传送会寻找门位附近的安全落脚位置。

点击门位告示牌可以打开交互表单，查看领地名称、主人、创建时间等信息，并进行传送、点赞或留言。

领地主人及管理员还可以直接通过门位告示牌进入领地管理页面。

4. 主领地与副领地系统​

• 玩家创建的第一块领地自动成为主领地。
• 支持自行更换主领地。
• 其他领地作为副领地管理。
• 每块领地均可设置独立门位。
• 同一玩家的多个领地可以通过门位表单串联。
• 可单独设置副领地是否允许访客查看和传送。

5. 公开领地广场​

提供公共领地浏览功能，方便玩家互相参观。

• 默认展示公开的主领地。
• 支持按领地名称或主人名称模糊搜索。
• 支持分页浏览。
• 玩家可以关闭自己的领地公开状态。
• 可单独设置是否允许其他玩家传送参观。
• 领地主人与管理员保留相应管理权限。

6. 双经济系统​

支持两种经济方式，由管理员自行选择：

• LLMoney：使用 LSE 经济接口。
• Scoreboard：使用原版记分板经济，默认计分项为 money。

支持分别配置 2D、3D 领地的基础价格及面积、体积计费参数。

7. 个人付费飞行套餐​

不同于普通的永久飞行权限，Calman领地采用可购买、可叠加的个人飞行时间系统。

默认飞行套餐：

管理员可以通过管理表单新增、修改或删除任意套餐。

飞行计费规则：

• 玩家可以手动开启或关闭领地飞行。
• 默认只能在自己的领地内使用。
• 领地主人可以单独授权成员飞行。
• 被授权成员必须使用自己购买的飞行额度。
• 只有实际离地飞行时才消耗时间。
• 玩家落地、关闭飞行或离开授权领地后停止计费。
• 飞行额度可以多次购买并累加。
• 额度耗尽后自动停止飞行，需要重新购买。

8. 领地权限与安全保护​

支持多种领地行为权限控制，包括：

• 放置和破坏方块
• 容器使用与方块交互
• 门、机关与红石操作
• 玩家 PVP
• 动物及怪物攻击
• 物品拾取与丢弃
• 展示框、床、传送门使用
• 水流、火焰、爆炸与活塞保护
• 农田、漏斗及部分自然事件保护
• 访客进入权限

领地主人可以邀请其他玩家加入领地，并单独管理成员权限与飞行授权。

9. 领地点赞与留言​

玩家可以通过领地门位进行互动：

• 给其他玩家的领地点赞。
• 取消已经点过的赞。
• 发布或修改自己的留言。
• 领地主人在线时收到互动通知和提示音。
• 领地主人离线时保存通知，上线后提醒。

10. 领地进入提示​

支持两种领地进入提示模式：

• Subtitle 副标题：默认显示 5 秒，减少对游戏画面的遮挡。
• ActionBar 动作栏：管理员可切换为动作栏显示。

另有独立的手持时钟信息功能。

玩家手持钟（Clock）时，可以在 ActionBar 查看所在领地的名称、主人、面积和创建时间等信息。切换其他物品后停止持续显示。

11. 智能领地回收​

提供两套可同时启用的自动回收规则，默认均关闭。

玩家离线回收：

玩家连续指定天数未登录服务器，自动回收其领地，默认阈值为 14 天。

单领地未访问回收：

玩家连续指定天数没有进入某块领地时回收该领地，默认阈值为 7 天。

• 默认忽略主领地。
• 默认豁免管理员领地。
• 回收前 3 天通过红色 ActionBar 提醒。
• 回收仅处理领地数据，不改变世界方块。
• 回收站默认保留 3 天。
• 管理员可以在保留期内恢复领地。
• 超期回收记录自动清理。

12. 性能优化​

Calman领地针对多领地服务器进行了查询优化：

• 采用 16×16 区块空间索引。
• 使用玩家位置缓存减少重复查询。
• 玩家静止或在已知区域移动时复用查询结果。
• 领地变更采用增量索引维护。
• 门位采用独立坐标索引。
• 高频保护事件优先筛选相关领地。
• 进出提示和飞行检测复用位置查询结果。
• 减少不必要的数据库读取和全量遍历。

安全保护不会因为位置缓存而直接跳过权限验证。

以上优化已通过模拟测试，实际服务器性能提升幅度以运行环境和压测结果为准。

---

三、指令说明​

插件唯一主指令：/cmland

为减少与其他插件冲突，所有子指令均采用 cm 前缀。

基础及选区指令​

领地管理指令​

成员与飞行指令​

管理员指令​

大部分常用操作都可以通过表单完成，无需记忆全部指令。

---

四、安装与运行环境​

插件信息

安装方法：

1. 确保服务器已安装兼容版本的 LeviLamina 和 LSE QuickJS。
2. 下载并解压插件。
3. 将 CMland 文件夹放入服务器 plugins 目录。
4. 完整重启服务器。
5. 进入游戏输入 /cmland 打开主菜单。

插件首次运行会自动生成配置文件和数据目录。

插件目录：

plugins/
└── CMland/
├── manifest.json
├── CMland.js
├── README.md
├── CHANGELOG.md
├── config.json
└── data/
其中 config.json 和 data/ 为首次运行后自动生成。

经济系统使用 LSE 经济接口或原版记分板，不需要额外安装专门的领地插件。

---

五、快速使用教程​

第一步：新建领地

输入 /cmland，选择新建领地，再选择 2D 或 3D 模式。

第二步：木斧选区

手持木斧，左键选择起点，右键选择终点。

第三步：确认购买

在弹出的选区表单中查看价格，填写领地名称并购买。

如果暂时不想购买，可以直接暂存或取消。

第四步：设置门位

购买完成后，在领地范围内使用木斧指定门位，生成基石与告示牌。

第五步：管理领地

通过 /cmland cmmy 或门位告示牌管理权限、成员、公开状态和其他领地功能。

---

六、版本更新记录​

v0.0.4​

• 修复未购买选区无法正常取消的问题。
• 新增木斧选区表单暂存与取消操作。
• 新增选区暂存、恢复和取消指令。
• 支持退出游戏、服务器重启后恢复选区。
• 支持管理员自定义暂存分钟数。
• 新增过期清理和旧表单防误操作检查。

v0.0.3​

• 优化领地区块索引与位置查询。
• 减少玩家静止时的重复检索。
• 优化门位查找及高频保护事件处理。
• 保留实时权限检查机制。

v0.0.2​

• 统一插件展示名称为 Calman领地。
• 统一主指令为 /cmland。
• 子指令统一采用 cm 前缀。

v0.0.1​

• 首个功能测试版本。
• 实现领地保护、门位、双经济、飞行套餐、公开领地及回收机制等基础系统。

---

Calman领地（CMland）—— 自由规划你的领地，让每一块土地都有自己的故事。