Easyland 领地管理插件

语言 / Language： English · 简体中文

高性能、易上手的 PaperMC 领地管理插件，覆盖领地创建、权限分配、保护规则与可视化展示等完整功能。

Note

更新至2.0.0版本时请使用migrate指令迁移旧版本数据!

✨ 功能亮点

• 🏗️ 领地管理：支持创建、认领、放弃、列表查看、重命名、传送等操作
• 🏘️ 子领地系统：支持在领地内划分更细致的子区域（Sub-claims）
• 👥 信任系统：灵活的成员管理，包含预信任机制
• 🛡️ 保护策略：方块、爆炸、容器、玩家、访问控制等多维度防护
• 💾 数据存储：采用 SQLite 数据库存储，数据更安全、查询更高效
• 🌈 可视化边界：粒子特效展示领地范围，所见即所得
• 🌍 内置多语言：提供中文、英文、日文本地化

🛠️ 指令总览

主命令：/easyland（别名：/el、/land）

子命令	说明	权限
select	获取选择工具	easyland.select
create [id]	创建领地	easyland.create
claim [id]	认领领地	easyland.claim
abandon [id]	放弃领地	easyland.abandon
subcreate <父领地> [子领地名]	创建子领地	easyland.subcreate
trust <领地> <玩家>	信任玩家	easyland.trust
untrust <领地> <玩家>	取消信任	easyland.trust
trustlist <领地>	查看信任列表	easyland.trust
info [领地]	查看领地信息	easyland.info
show [领地] [时间]	显示边界	easyland.show
list [页码]	查看领地列表	easyland.list
rename <领地> <新名>	重命名领地	easyland.rename
setspawn	设置领地传送点	easyland.setspawn
tp <领地>	传送至领地	easyland.tp
delete <id>	删除领地	easyland.delete
rule [领地] [规则] [on/off]	管理保护规则	easyland.rule
reload	重载配置	easyland.admin
migrate	数据迁移	easyland.admin.migrate
help	查看帮助	无

🔐 权限节点

权限节点	描述	默认值
easyland.select	获取选择工具	true
easyland.create	创建领地	op
easyland.claim	认领领地	true
easyland.abandon	放弃领地	true
easyland.subcreate	创建子领地	true
easyland.trust	信任管理	true
easyland.info	查看信息	true
easyland.show	显示边界	true
easyland.list	查看列表	true
easyland.rename	重命名领地	true
easyland.setspawn	设置传送点	true
easyland.tp	领地传送	true
easyland.rule	保护规则	true
easyland.delete	删除领地	true
easyland.admin	管理员合集	op

easyland.admin 自动继承上表所有子权限，无需重复分配。

⚙️ 核心配置

配置项	作用	默认值
land.max-per-player	玩家最大领地数	10
land.max-area	单领地最大面积	10000
land.min-area	单领地最小面积	100
land.min-distance	领地间最小距离	5
visualization.default-duration	边界显示持续时间(秒)	10
sub-claim.max-per-land	最大子领地数量	5
sub-claim.max-depth	子领地最大嵌套层级	2

保护规则

保护规则均包含两个字段：

• enable：是否允许服务器启用该规则
• default：新领地的默认启用状态

规则名称	功能说明
build	允许建造/放置方块
break	允许破坏方块
interact	允许交互(容器/门等)
use	允许使用物品
pvp	允许玩家PVP
pve	允许PVE(受怪物伤害)
explosions	允许爆炸破坏
fire_spread	允许火焰蔓延
enter	允许进入领地
mob_spawning	允许怪物生成

🌍 多语言支持

在 config.yml 中设置 language 完成切换：

# 支持的取值：zh_cn, en_us, ja_jp
language: zh_cn

语言代码	语言名称
zh_cn	中文简体
en_us	English
ja_jp	日本語

📦 安装部署

运行环境

• 服务端：Paper 1.21.x
• Java 版本：21 或更高

安装步骤

1. 下载最新构建 easyland-2.0.0.jar。
2. 将插件放入服务器 plugins 目录。
3. 启动或重启服务器生成配置文件。
4. 按需调整 config.yml 与权限节点。

从源码构建（可选）

1. 克隆仓库 git clone https://github.com/railgun19457/Easyland.git。
2. 在项目根目录执行 mvn clean compile package 生成产物。
3. 使用 target/easyland-2.0.0.jar 部署到服务器。

📝 更新日志

v2.0.0 · 全新重构

• 🔄 核心重构：代码库全面重写，优化架构与性能。
• 💾 SQLite 存储：引入 SQLite 数据库，替代原有文件存储，提升数据安全性与读写效率。
• 🏘️ 子领地系统：支持创建子领地（Sub-claims），实现更精细的区域管理。
• 🚫 访问控制：新增 enter 保护规则，可禁止未授权玩家进入领地（带击退效果与边界提示）。
• 📍 传送功能：新增 /el setspawn 和 /el tp，方便玩家快速回到领地。
• ✏️ 重命名：新增 /el rename 指令。
• 📢 提示优化：全方位的 Action Bar 提示，操作反馈更直观。
• 🌍 多语言同步：中、英、日三语完整支持。

v1.4.1

• 🌍 引入完整国际化（i18n）框架
• 🐛 修复与连锁破坏类插件联动导致的无限刷资源问题
• ➕ 新增 reload、help 命令

v1.4 · Paper 1.21.8 适配

• 🚀 升级支持 Paper 1.21.8 与 Java 21
• 🐛 修复 LandEnterListener 空指针异常
• ⚡ 优化爆炸保护逻辑，减少额外检查
• 🛡️ 玩家保护剥离自然伤害，行为更符合直觉
• ♻️ 兼容 Paper 1.20.4+

v1.3.1

• 📈 空间索引优化，查询性能提升 60–80%
• 🔒 全面换用 ConcurrentHashMap 提升并发安全
• 💾 降低 20–30% 内存占用
• 🧹 重构配置与常量，方便维护

v1.3

• 🔁 全面重写领地保护系统
• 🆕 新增 /easyland rule 指令体系
• 🗂️ 保护规则改为领地级独立存储
• 🧱 配置文件结构升级

v1.2

• 🗃️ 新增配置文件管理系统
• 🛠️ 增加管理员权限组
• 🎯 show 指令支持自定义时间

v1.1

• 👥 信任系统支持预信任
• 📋 新增 trustlist 指令

v1.0

• 🎉 实现基础领地管理能力

📄 许可证

本项目基于 MIT License 发布，使用或分发时请保留版权和许可声明。

🤝 支持反馈

• ⭐ 欢迎 Star 本仓库支持项目发展
• 🐛 如遇问题请在 Issues 中反馈
• 💬 也可通过 Pull Request 贡献功能或翻译

---

感谢选择 Easyland，祝你和玩家在领地里玩得开心！