Easyland
一款高性能的 PaperMC 土地管理插件,涵盖土地创建、访问控制、保护规则以及基于粒子的可视化功能。
[!note]
升级至 2.0.0 版本时,请使用 migrate 命令迁移旧版本的数据!
✨ 亮点
- ?️ 土地管理:创建、认领、放弃、列出、重命名及传送至土地。
- ?️ 子区域(Sub-claims):在您的土地上创建更小的子区域,实现更精细的控制。
- ? 信任系统:灵活的成员管理,支持预设信任(pre-trust)。
- ?️ 保护策略:阻止破坏、爆炸、容器交互、玩家互动以及进入控制保护。
- ? 数据存储:基于 SQLite,确保数据安全高效处理。
- ? 边界可视化:粒子效果直接在游戏内渲染土地边界。
- ? 内置本地化:包含简体中文、英文和日文翻译。
?️ 命令概览
主命令:/easyland(别名:/el, /land)
| 子命令 |
描述 |
权限节点 |
select |
获取选择工具 |
easyland.select |
create [id] |
创建土地 |
easyland.create |
claim [id] |
认领土地 |
easyland.claim |
abandon [id] |
放弃土地 |
easyland.abandon |
subcreate <parent> [name] |
创建子区域 |
easyland.subcreate |
trust <land> <player> |
信任玩家 |
easyland.trust |
untrust <land> <player> |
取消信任玩家 |
easyland.trust |
trustlist <land> |
查看信任列表 |
easyland.trust |
info [land] |
查看土地信息 |
easyland.info |
show [land] [time] |
显示边界 |
easyland.show |
list [page] |
列出土地 |
easyland.list |
rename <land> <new_name> |
重命名土地 |
easyland.rename |
setspawn |
设置土地出生点 |
easyland.setspawn |
tp <land> |
传送到土地 |
easyland.tp |
delete <id> |
删除土地 |
easyland.delete |
rule [land] [rule] [on/off] |
管理规则 |
easyland.rule |
reload |
重载配置 |
easyland.admin |
migrate |
迁移数据 |
easyland.admin.migrate |
help |
查看帮助 |
None |
? 权限节点
| 权限节点 |
描述 |
默认值 |
| 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: en_us
| 代码 |
语言 |
zh_cn |
简体中文 |
en_us |
英文 |
ja_jp |
日文 |
欢迎社区贡献翻译——请发送 PR 以添加您的语言。
? 部署指南
环境要求
- 服务端:Paper 1.21.x
- Java:21 或更高版本
安装步骤
- 下载最新的
easyland-2.0.0.jar 构建文件。
- 将插件放入服务端的
plugins 目录。
- 启动或重启服务器以生成配置文件。
- 根据需要调整
config.yml 和权限节点。
从源码构建(可选)
- 克隆仓库:
git clone https://github.com/railgun19457/Easyland.git.
- 在项目根目录运行
mvn clean package 以生成构建产物。
- 将
target/easyland-2.0.0.jar 部署到您的 Paper 服务器。
? 更新日志
v2.0.0 · 重大重构
- ? 核心重构:完全重写代码库,以获得更好的架构和性能。
- ? SQLite 存储:将文件存储替换为 SQLite 数据库,提升安全性和效率。
- ?️ 子区域支持:新增对子区域的支持,以便管理土地内的较小区域。
- ? 进入控制:新增
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 发布。重新分发时请保留版权声明和许可证信息。
? 支持
- ⭐ 为仓库点星以支持该项目
- ? 通过 GitHub Issues 报告问题
- ? 通过 Pull Requests 贡献新功能或翻译内容
感谢选择 Easyland——祝你建造繁荣社区!
Easyland
A high-performance PaperMC land management plugin that covers land creation, access control, protection rules, and particle-based visualization.
[!note]
When updating to version 2.0.0, please use the migrate command to migrate data from older versions!
✨ Highlights
- ?️ Land Management: Create, claim, abandon, list, rename, and teleport to lands.
- ?️ Sub-claims: Create smaller sub-areas within your land for finer control.
- ? Trust System: Flexible member management with pre-trust support.
- ?️ Protection Policies: Block, explosion, container, player, and entry control protection.
- ? Data Storage: Powered by SQLite for secure and efficient data handling.
- ? Visualized Boundaries: Particle effects render land borders directly in-game.
- ? Built-in Localization: Chinese, English, and Japanese translations included.
?️ Command Overview
Main command: /easyland (aliases: /el, /land)
| Subcommand |
Description |
Permission |
select |
Get selection tool |
easyland.select |
create [id] |
Create land |
easyland.create |
claim [id] |
Claim land |
easyland.claim |
abandon [id] |
Abandon land |
easyland.abandon |
subcreate <parent> [name] |
Create sub-claim |
easyland.subcreate |
trust <land> <player> |
Trust player |
easyland.trust |
untrust <land> <player> |
Untrust player |
easyland.trust |
trustlist <land> |
View trust list |
easyland.trust |
info [land] |
View land info |
easyland.info |
show [land] [time] |
Show boundaries |
easyland.show |
list [page] |
List lands |
easyland.list |
rename <land> <new_name> |
Rename land |
easyland.rename |
setspawn |
Set land spawn |
easyland.setspawn |
tp <land> |
Teleport to land |
easyland.tp |
delete <id> |
Delete land |
easyland.delete |
rule [land] [rule] [on/off] |
Manage rules |
easyland.rule |
reload |
Reload config |
easyland.admin |
migrate |
Migrate data |
easyland.admin.migrate |
help |
View help |
None |
? Permission Nodes
| Permission |
Description |
Default |
| easyland.select |
Get selection tool |
true |
| easyland.create |
Create land |
op |
| easyland.claim |
Claim land |
true |
| easyland.abandon |
Abandon land |
true |
| easyland.subcreate |
Create sub-claim |
true |
| easyland.trust |
Manage trust |
true |
| easyland.info |
View info |
true |
| easyland.show |
Show boundaries |
true |
| easyland.list |
View list |
true |
| easyland.rename |
Rename land |
true |
| easyland.setspawn |
Set spawn |
true |
| easyland.tp |
Teleport to land |
true |
| easyland.rule |
Manage rules |
true |
| easyland.delete |
Delete land |
true |
| easyland.admin |
Admin bundle |
op |
easyland.admin inherits every sub-permission above—no extra assignment required.
⚙️ Core Configuration
| Key |
Purpose |
Default |
land.max-per-player |
Max lands per player |
10 |
land.max-area |
Max area per land |
10000 |
land.min-area |
Min area per land |
100 |
land.min-distance |
Min distance between lands |
5 |
visualization.default-duration |
Boundary show duration (s) |
10 |
sub-claim.max-per-land |
Max sub-claims per land |
5 |
sub-claim.max-depth |
Max sub-claim depth |
2 |
Protection Rules
Each rule provides two flags:
enable: Whether the rule is available on the server
default: Default state for newly created lands
| Rule Name |
Description |
build |
Allow building/placing blocks |
break |
Allow breaking blocks |
interact |
Allow interaction (chests/doors) |
use |
Allow item usage |
pvp |
Allow PvP |
pve |
Allow PvE (mob damage) |
explosions |
Allow explosions |
fire_spread |
Allow fire spread |
enter |
Allow entry |
mob_spawning |
Allow mob spawning |
? Localization
Set the language value in config.yml to switch the UI language:
# Supported values: zh_cn, en_us, ja_jp
language: en_us
| Code |
Language |
zh_cn |
Simplified Chinese |
en_us |
English |
ja_jp |
Japanese |
Community translations are welcome—send a PR to add your language.
? Deployment
Environment
- Server: Paper 1.21.x
- Java: 21 or newer
Installation
- Download the latest
easyland-2.0.0.jar build.
- Drop the plugin into your server's
plugins directory.
- Start or restart the server to generate configuration files.
- Adjust
config.yml and permission nodes as needed.
Build from Source (Optional)
- Clone the repository:
git clone https://github.com/railgun19457/Easyland.git.
- Run
mvn clean package in the project root to produce artifacts.
- Deploy
target/easyland-2.0.0.jar to your Paper server.
? Changelog
v2.0.0 · Major Refactor
- ? Core Refactor: Complete rewrite of the codebase for better architecture and performance.
- ? SQLite Storage: Replaced file storage with SQLite database for improved security and efficiency.
- ?️ Sub-claims: Added support for sub-claims to manage smaller areas within a land.
- ? Entry Control: Added
enter protection rule to prevent unauthorized entry (with knockback and visual feedback).
- ? Teleportation: Added
/el setspawn and /el tp for easy travel.
- ✏️ Renaming: Added
/el rename command.
- ? Better Alerts: Comprehensive Action Bar notifications for clearer feedback.
- ? Localization Sync: Full support for Chinese, English, and Japanese.
v1.4.1
- ? Introduced a full i18n system
- ? Fixed infinite resource duplication caused by vein-miner style plugins
- ➕ Added
reload and help commands
v1.4 · Paper 1.21.8 Compatibility
- ? Updated to support Paper 1.21.8 and Java 21
- ? Fixed
LandEnterListener NullPointerException
- ⚡ Streamlined explosion protection checks
- ?️ Player protection no longer includes natural damage (falling, etc.)
- ♻️ Remains compatible with Paper 1.20.4+
v1.3.1
- ? Spatial index optimization improves lookup performance by 60–80%
- ? Adopted
ConcurrentHashMap throughout for thread safety
- ? Reduced memory usage by 20–30%
- ? Refactored configuration to remove hard-coded values
v1.3
- ? Completely overhauled the land protection system
- ? Added the
/easyland rule command flow
- ?️ Stored protection rules per land instead of globally
- ? Upgraded configuration structure
v1.2
- ?️ Introduced the configuration management system
- ?️ Added an administrator permission group
- ?
show command supports custom durations
v1.1
- ? Trust system now supports pre-trusting players
- ? Added the
trustlist command
v1.0
- ? Delivered the core land management feature set
? License
Released under the MIT License. Please retain copyright and license notices when redistributing.
? Support
- ⭐ Star the repository to support the project
- ? Report issues via GitHub Issues
- ? Contribute features or translations through Pull Requests
Thanks for choosing Easyland—have fun building thriving communities!
评论 0
登录后参与评分
还没有评论,来抢沙发吧