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
migratecommand 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 serverdefault: 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.jarbuild. - Drop the plugin into your server's
pluginsdirectory. - Start or restart the server to generate configuration files.
- Adjust
config.ymland permission nodes as needed.
Build from Source (Optional)
- Clone the repository:
git clone https://github.com/railgun19457/Easyland.git. - Run
mvn clean packagein the project root to produce artifacts. - Deploy
target/easyland-2.0.0.jarto 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
enterprotection rule to prevent unauthorized entry (with knockback and visual feedback). - π Teleportation: Added
/el setspawnand/el tpfor easy travel. - βοΈ Renaming: Added
/el renamecommand. - π’ 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
reloadandhelpcommands
v1.4 Β· Paper 1.21.8 Compatibility
- π Updated to support Paper 1.21.8 and Java 21
- π Fixed
LandEnterListenerNullPointerException - β‘ 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
ConcurrentHashMapthroughout 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 rulecommand flow - ποΈ Stored protection rules per land instead of globally
- π§± Upgraded configuration structure
v1.2
- ποΈ Introduced the configuration management system
- π οΈ Added an administrator permission group
- π―
showcommand supports custom durations
v1.1
- π₯ Trust system now supports pre-trusting players
- π Added the
trustlistcommand
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!
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
Easyland 2.0.1 2.0.1 |
1.21, 1.21.1, 1.21.10, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
paper
|
Download |
|
Easyland 2.0.0 2.0.0 |
1.21, 1.21.1, 1.21.10, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9
|
paper
|
Download |
|
Easyland 1.4.1 1.4.1 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8
|
paper
|
Download |