# Easyland<\/p>\n
\n
\n
\n<\/p>\n
A high-performance PaperMC land management plugin that covers land creation, access control, protection rules, and particle-based visualization.<\/p>\n
> [!note]
\n> **When updating to version 2.0.0, please use the `migrate` command to migrate data from older versions!**<\/p>\n
## \u2728 Highlights<\/p>\n
– \ud83c\udfd7\ufe0f **Land Management**: Create, claim, abandon, list, rename, and teleport to lands.
\n– \ud83c\udfd8\ufe0f **Sub-claims**: Create smaller sub-areas within your land for finer control.
\n– \ud83d\udc65 **Trust System**: Flexible member management with pre-trust support.
\n– \ud83d\udee1\ufe0f **Protection Policies**: Block, explosion, container, player, and **entry control** protection.
\n– \ud83d\udcbe **Data Storage**: Powered by SQLite for secure and efficient data handling.
\n– \ud83c\udf08 **Visualized Boundaries**: Particle effects render land borders directly in-game.
\n– \ud83c\udf0d **Built-in Localization**: Chinese, English, and Japanese translations included.<\/p>\n
## \ud83d\udee0\ufe0f Command Overview<\/p>\n
Main command: `\/easyland` (aliases: `\/el`, `\/land`)<\/p>\n
| Subcommand | Description | Permission | ## \ud83d\udd10 Permission Nodes<\/p>\n | Permission | Description | Default | `easyland.admin` inherits every sub-permission above\u2014no extra assignment required.<\/p>\n ## \u2699\ufe0f Core Configuration<\/p>\n | Key | Purpose | Default | ### Protection Rules<\/p>\n Each rule provides two flags:<\/p>\n – `enable`: Whether the rule is available on the server | Rule Name | Description | ## \ud83c\udf0d Localization<\/p>\n Set the `language` value in `config.yml` to switch the UI language:<\/p>\n “`yaml | Code | Language | Community translations are welcome\u2014send a PR to add your language.<\/p>\n ## \ud83d\udce6 Deployment<\/p>\n ### Environment<\/p>\n – Server: Paper 1.21.x ### Installation<\/p>\n 1. Download the latest `easyland-2.0.0.jar` build. ### Build from Source (Optional)<\/p>\n 1. Clone the repository: `git clone https:\/\/github.com\/railgun19457\/Easyland.git`. ## \ud83d\udcdd Changelog<\/p>\n ### v2.0.0 \u00b7 Major Refactor<\/p>\n – \ud83d\udd04 **Core Refactor**: Complete rewrite of the codebase for better architecture and performance. ### v1.4.1<\/p>\n – \ud83c\udf0d Introduced a full i18n system ### v1.4 \u00b7 Paper 1.21.8 Compatibility<\/p>\n – \ud83d\ude80 Updated to support Paper 1.21.8 and Java 21 ### v1.3.1<\/p>\n – \ud83d\udcc8 Spatial index optimization improves lookup performance by 60\u201380% ### v1.3<\/p>\n – \ud83d\udd01 Completely overhauled the land protection system ### v1.2<\/p>\n – \ud83d\uddc3\ufe0f Introduced the configuration management system ### v1.1<\/p>\n – \ud83d\udc65 Trust system now supports pre-trusting players ### v1.0<\/p>\n – \ud83c\udf89 Delivered the core land management feature set<\/p>\n ## \ud83d\udcc4 License<\/p>\n Released under the [MIT License](LICENSE). Please retain copyright and license notices when redistributing.<\/p>\n ## \ud83e\udd1d Support<\/p>\n – \u2b50 Star the repository to support the project —<\/p>\n Thanks for choosing Easyland\u2014have fun building thriving communities!<\/p>\n","protected":false},"excerpt":{"rendered":" Easyland \u2014 a high-performance PaperMC land-claim plugin for Minecraft (Paper 1.21.x, Java 21). Provides land creation\/claiming, trust management, flexible protection rules, visual boundary display, and multi-language support.<\/p>\n","protected":false},"featured_media":61055,"template":"","meta":{"_minecraft_slug":"easyland","_minecraft_project_id":"vxD8h5y6","_minecraft_author":"railgun19457","_minecraft_license":"MIT","_minecraft_downloads":171,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"easyland.zip","_minecraft_size_bytes":315552,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T13:06:40.280097Z","_minecraft_date_created":"2025-10-09T04:24:33.250457Z","_minecraft_date_modified":"2025-12-06T18:45:58.198841Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/easyland","_minecraft_icon_attachment_id":61055,"_minecraft_imported_at":"2026-06-03T13:22:25+00:00","_minecraft_import_hash":"f4e54c02766f2b6ae5f5207d384b2ba9","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127],"mod_loader":[132],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-61054","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n| :— | :— | :— |
\n| `select` | Get selection tool | easyland.select |
\n| `create [id]` | Create land | easyland.create |
\n| `claim [id]` | Claim land | easyland.claim |
\n| `abandon [id]` | Abandon land | easyland.abandon |
\n| `subcreate
\n| `trust
\n| `untrust
\n| `trustlist
\n| `info [land]` | View land info | easyland.info |
\n| `show [land] [time]` | Show boundaries | easyland.show |
\n| `list [page]` | List lands | easyland.list |
\n| `rename
\n| `setspawn` | Set land spawn | easyland.setspawn |
\n| `tp
\n| `delete
\n| `rule [land] [rule] [on\/off]` | Manage rules | easyland.rule |
\n| `reload` | Reload config | easyland.admin |
\n| `migrate` | Migrate data | easyland.admin.migrate |
\n| `help` | View help | None |<\/p>\n
\n| :— | :— | :— |
\n| easyland.select | Get selection tool | true |
\n| easyland.create | Create land | op |
\n| easyland.claim | Claim land | true |
\n| easyland.abandon | Abandon land | true |
\n| easyland.subcreate | Create sub-claim | true |
\n| easyland.trust | Manage trust | true |
\n| easyland.info | View info | true |
\n| easyland.show | Show boundaries | true |
\n| easyland.list | View list | true |
\n| easyland.rename | Rename land | true |
\n| easyland.setspawn | Set spawn | true |
\n| easyland.tp | Teleport to land | true |
\n| easyland.rule | Manage rules | true |
\n| easyland.delete | Delete land | true |
\n| easyland.admin | Admin bundle | op |<\/p>\n
\n| :— | :— | :— |
\n| `land.max-per-player` | Max lands per player | 10 |
\n| `land.max-area` | Max area per land | 10000 |
\n| `land.min-area` | Min area per land | 100 |
\n| `land.min-distance` | Min distance between lands | 5 |
\n| `visualization.default-duration` | Boundary show duration (s) | 10 |
\n| `sub-claim.max-per-land` | Max sub-claims per land | 5 |
\n| `sub-claim.max-depth` | Max sub-claim depth | 2 |<\/p>\n
\n– `default`: Default state for newly created lands<\/p>\n
\n| :— | :— |
\n| `build` | Allow building\/placing blocks |
\n| `break` | Allow breaking blocks |
\n| `interact` | Allow interaction (chests\/doors) |
\n| `use` | Allow item usage |
\n| `pvp` | Allow PvP |
\n| `pve` | Allow PvE (mob damage) |
\n| `explosions` | Allow explosions |
\n| `fire_spread` | Allow fire spread |
\n| `enter` | Allow entry |
\n| `mob_spawning` | Allow mob spawning |<\/p>\n
\n# Supported values: zh_cn, en_us, ja_jp
\nlanguage: en_us
\n“`<\/p>\n
\n| ——- | ———– |
\n| `zh_cn` | Simplified Chinese |
\n| `en_us` | English |
\n| `ja_jp` | Japanese |<\/p>\n
\n– Java: 21 or newer<\/p>\n
\n2. Drop the plugin into your server’s `plugins` directory.
\n3. Start or restart the server to generate configuration files.
\n4. Adjust `config.yml` and permission nodes as needed.<\/p>\n
\n2. Run `mvn clean package` in the project root to produce artifacts.
\n3. Deploy `target\/easyland-2.0.0.jar` to your Paper server.<\/p>\n
\n– \ud83d\udcbe **SQLite Storage**: Replaced file storage with SQLite database for improved security and efficiency.
\n– \ud83c\udfd8\ufe0f **Sub-claims**: Added support for sub-claims to manage smaller areas within a land.
\n– \ud83d\udeab **Entry Control**: Added `enter` protection rule to prevent unauthorized entry (with knockback and visual feedback).
\n– \ud83d\udccd **Teleportation**: Added `\/el setspawn` and `\/el tp` for easy travel.
\n– \u270f\ufe0f **Renaming**: Added `\/el rename` command.
\n– \ud83d\udce2 **Better Alerts**: Comprehensive Action Bar notifications for clearer feedback.
\n– \ud83c\udf0d **Localization Sync**: Full support for Chinese, English, and Japanese.<\/p>\n
\n– \ud83d\udc1b Fixed infinite resource duplication caused by vein-miner style plugins
\n– \u2795 Added `reload` and `help` commands<\/p>\n
\n– \ud83d\udc1b Fixed `LandEnterListener` NullPointerException
\n– \u26a1 Streamlined explosion protection checks
\n– \ud83d\udee1\ufe0f Player protection no longer includes natural damage (falling, etc.)
\n– \u267b\ufe0f Remains compatible with Paper 1.20.4+<\/p>\n
\n– \ud83d\udd12 Adopted `ConcurrentHashMap` throughout for thread safety
\n– \ud83d\udcbe Reduced memory usage by 20\u201330%
\n– \ud83e\uddf9 Refactored configuration to remove hard-coded values<\/p>\n
\n– \ud83c\udd95 Added the `\/easyland rule` command flow
\n– \ud83d\uddc2\ufe0f Stored protection rules per land instead of globally
\n– \ud83e\uddf1 Upgraded configuration structure<\/p>\n
\n– \ud83d\udee0\ufe0f Added an administrator permission group
\n– \ud83c\udfaf `show` command supports custom durations<\/p>\n
\n– \ud83d\udccb Added the `trustlist` command<\/p>\n
\n– \ud83d\udc1b Report issues via GitHub Issues
\n– \ud83d\udcac Contribute features or translations through Pull Requests<\/p>\n