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

1. Download the latest easyland-2.0.0.jar build.
2. Drop the plugin into your server's plugins directory.
3. Start or restart the server to generate configuration files.
4. Adjust config.yml and permission nodes as needed.

Build from Source (Optional)

1. Clone the repository: git clone https://github.com/railgun19457/Easyland.git.
2. Run mvn clean package in the project root to produce artifacts.
3. 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!