\n
\n
\n
\n
\n \n<\/p>\n
The modern land-claiming & town management plugin.<\/b><\/p>\n
Drop-in replacement for Towny & Lands \u2014 familiar \n \ud83d\udcac Discord \u00b7 <\/p>\n —<\/p>\n ## \ud83d\uddc2\ufe0f Choose Your Edition<\/p>\n ### \ud83c\udf81 Free Edition **[Jump to Free Features \u2193](#-free-edition)**<\/p>\n<\/td>\n ### \u2b50 Premium Edition **[Jump to Premium Features \u2193](#-premium-edition)**<\/p>\n<\/td>\n<\/tr>\n<\/table>\n —<\/p>\n # \ud83c\udf81 Free Edition<\/p>\n > **Zero cost. Fully functional.** Create lands, invite members, manage permissions, wage wars, and protect your builds \u2014 everything you need out of the box.<\/p>\n —<\/p>\n ### \ud83c\udfe0 Land Management ### \ud83c\udf10 Public Warp System ### \ud83d\udc65 Members & Roles ### \ud83d\udee1\ufe0f Protection ### \ud83d\udcb0 Economy (Vault) ### \u2694\ufe0f War System (Kill Point Mode) ### \ud83c\udfa8 Visual & UI ### \ud83d\udd27 Admin Tools ### \ud83d\udcbe Data & Storage ### \ud83d\udd0c Integration —<\/p>\n # \u2b50 Premium Edition<\/p>\n > **One-time purchase. Every feature unlocked.** Just swap the JAR \u2014 all your data carries over instantly. Premium includes **everything in Free** plus the features below.<\/p>\n > \ud83d\uded2 **Get Premium \u2192** discord.gg\/Y8QhgYaq6K<\/p>\n —<\/p>\n ### \ud83c\udfdb\ufe0f Nations | Feature | Details | ### \u2694\ufe0f Full Conquest War (Capture Mode) | Feature | Details | ### \ud83d\udcc8 Land Levels | Level | Title | Members Required | Balance Required | Bonus Chunks | ### \ud83e\udd1d Relations ### \ud83d\udc8e Resource Nodes | Resource | Bonus | ### \ud83d\uddc2\ufe0f Sub-Areas ### \ud83c\udfea Rent & Sell ### \ud83d\udce6 Land Storage ### \ud83d\udd4a\ufe0f Fly ### \ud83d\udcb8 Upkeep & Taxes ### \ud83d\uddc4\ufe0f MySQL Storage ### \u270d\ufe0f Custom Messages ### \ud83c\udfa8 GUI Text Style ### \ud83d\udce5 Migration ### \ud83d\uddfa\ufe0f Minimap —<\/p>\n ## \ud83d\udcca Free vs Premium at a Glance<\/p>\n | Feature | \ud83c\udf81 Free | \u2b50 Premium | —<\/p>\n ## \ud83d\udcdc Commands<\/p>\n ### Main Commands (Multiple Aliases)<\/p>\n > All main commands open the same land GUI. Use whichever feels natural.<\/p>\n | Command | Aliases | Description | ### Land Subcommands<\/p>\n | Command | Description | ### War Subcommands<\/p>\n | Command | Description | ### Nation Subcommands *(Premium)*<\/p>\n | Command | Description | ### Admin Subcommands<\/p>\n | Command | Description | —<\/p>\n ## \u2699\ufe0f Configuration Reference<\/p>\n > Full breakdown of every option in `config.yml`. Lines marked with \u2b50 are **Premium Only**.<\/p>\n —<\/p>\n ### \ud83d\udd27 Core Settings<\/p>\n “`yaml ### \ud83c\udf9b\ufe0f Feature Toggles<\/p>\n “`yaml ### \ud83c\udf0d General Settings<\/p>\n “`yaml ### \ud83d\udcb0 Economy Cycle<\/p>\n “`yaml ### \ud83c\udfda\ufe0f Upkeep *(\u2b50 Premium)*<\/p>\n “`yaml ### \ud83d\udccb Taxes *(\u2b50 Premium)*<\/p>\n “`yaml ### \ud83d\ude80 Teleportation<\/p>\n “`yaml ### \u2694\ufe0f Combat Tag<\/p>\n “`yaml ### \ud83c\udfe0 Land Settings<\/p>\n “`yaml ### \ud83d\udce6 Chunk Settings<\/p>\n “`yaml ### \ud83d\udcd0 Limits<\/p>\n “`yaml > **Permission nodes:** `peatowny.chunks. ### \u2728 Visualization<\/p>\n “`yaml ### \u2694\ufe0f War Settings<\/p>\n “`yaml ### \ud83c\udfdb\ufe0f Nation Settings *(\u2b50 Premium)*<\/p>\n “`yaml ### \ud83d\udcc8 Land Levels *(\u2b50 Premium)*<\/p>\n “`yaml ### \ud83c\udf3f Natural Flags<\/p>\n “`yaml ### \ud83d\udc8e Resources *(\u2b50 Premium)*<\/p>\n “`yaml ### \ud83c\udf0d Wilderness Flags<\/p>\n “`yaml ### \ud83d\udcbe Storage Backend<\/p>\n “`yaml ### \ud83c\udfdb\ufe0f Nation Claims<\/p>\n “`yaml ### \ud83e\udd1d Relations *(\u2b50 Premium)*<\/p>\n “`yaml ### \ud83c\udfa8 GUI & Messages<\/p>\n “`yaml gui: messages: —<\/p>\n ## \ud83d\ude80 Getting Started<\/p>\n 1. \ud83d\udce5 Download **PeaTowny** from our Discord ### \ud83d\udd13 Upgrading to Premium<\/p>\n 1. \ud83d\uded2 Purchase from our Discord —<\/p>\n ## \ud83d\udc9a Support & Community<\/p>\n Need help? Have a suggestion? Want to grab Premium?<\/p>\n > \ud83d\udcac **Discord:** discord.gg\/Y8QhgYaq6K Minecrafts greatest Kingdoms and Towns plugin!<\/p>\n","protected":false},"featured_media":120120,"template":"","meta":{"_minecraft_slug":"peatowny","_minecraft_project_id":"5ZFa0B5I","_minecraft_author":"SaturnXP","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":11,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"peatowny.zip","_minecraft_size_bytes":821960,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T23:05:01.930483Z","_minecraft_date_created":"2026-04-15T22:08:54.964309Z","_minecraft_date_modified":"2026-04-08T21:33:55.101260Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/peatowny","_minecraft_icon_attachment_id":120120,"_minecraft_imported_at":"2026-06-07T01:42:02+00:00","_minecraft_import_hash":"a484460c781ac9ecaee54e004b12b780","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,844,89,126,866,127,128,867,129,869,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-120119","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-economy","mod_category-game-mechanics","mod_category-management","mod_category-minigame","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-transportation","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","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\/lands<\/code> commands, zero learning curve.<\/p>\n
\n \ud83c\udf81 Free Edition<\/a> \u00b7
\n \u2b50 Premium Edition<\/a> \u00b7
\n \u2699\ufe0f Config<\/a>\n<\/p>\n\n
\n \n
\nEverything you need to run a land-claiming server.
\nFull protection, wars, GUI, economy, and admin tools.<\/p>\n\n
\nThe complete experience \u2014 nations, conquest wars,
\nlevels, sub-areas, rent, fly, and much more.<\/p>\n
\n| Feature | Details |
\n|:—|:—|
\n| \ud83c\udfd7\ufe0f **Create & Delete** | Players can own up to 3 lands (configurable) |
\n| \ud83d\udce6 **Chunk Claiming** | Claim with `\/lands claim` \u2014 creation auto-claims a 3×3 area |
\n| \ud83d\udeb6 **Auto-Claim** | Walk to claim chunks automatically with `\/lands autoclaim` |
\n| \ud83e\uddf1 **Claim Block** | Place a physical block to instantly create a land (3×3 area) |
\n| \ud83e\ude84 **Selection Tool** | Visual tool given on first join for selecting areas |
\n| \ud83d\udccd **Land Spawn** | Set and teleport to a spawn point within your land |
\n| \u270f\ufe0f **Rename** | Change your land’s name anytime through GUI or command |
\n| \ud83d\udd0e **Land Browser** | Browse all server lands via the GUI |
\n| \ud83d\udcd0 **Expand** | Expand your land’s borders in a direction |<\/p>\n
\n| Feature | Details |
\n|:—|:—|
\n| \ud83d\udd14 **Beacon Warps** | Step on any land beacon to open the public warp browser |
\n| \ud83d\uddfa\ufe0f **Warp Browser** | Paginated GUI showing all public lands \u2014 click to teleport |
\n| \ud83d\udd0d **Search** | Click the sign icon to search for a specific land by name |
\n| \ud83d\udd12 **Warp Manager** | Land owners can toggle public\/private and set a custom icon |
\n| \ud83c\udfa8 **Custom Icons** | Choose from 56+ block\/item icons to represent your land |<\/p>\n
\n| Feature | Details |
\n|:—|:—|
\n| \ud83d\udc8c **Invite System** | Invite players to join your land |
\n| \ud83c\udf96\ufe0f **4 Default Roles** | Owner, Officer, Member, Visitor (built-in & undeletable) |
\n| \ud83d\udee0\ufe0f **Custom Roles** | Create additional roles with custom names & colors |
\n| \ud83d\udd10 **Role Flags** | Fine-grained control: build, break, interact, containers, doors, PvP, etc. |
\n| \u2705 **Trust \/ Untrust** | Quickly add or remove members from your land |<\/p>\n
\n| Feature | Details |
\n|:—|:—|
\n| \ud83e\udde9 **Chunk-Based** | Claimed chunks are fully protected from outsiders |
\n| \ud83c\udf3f **Natural Flags** | Toggle explosions, fire spread, mob spawning, PvP, pistons, liquid flow, etc. |
\n| \ud83c\udf0d **Wilderness Rules** | Configurable protection rules for unclaimed land |
\n| \u2694\ufe0f **Combat Tag** | Configurable duration, boss bar countdown, remove-on-death option |<\/p>\n
\n| Feature | Details |
\n|:—|:—|
\n| \ud83c\udfe6 **Land Bank** | Deposit and withdraw funds from your land’s treasury |
\n| \ud83d\udc8e **Chunk Costs** | Configurable price per chunk with scaling options |
\n| \ud83d\ude80 **Teleport Costs** | Optional economy cost for spawn teleportation |<\/p>\n
\n| Feature | Details |
\n|:—|:—|
\n| \ud83c\udff4 **Declare War** | Challenge another land to a kill-count war |
\n| \ud83d\udc80 **Kill Tracking** | Per-player kill counts tracked and displayed |
\n| \ud83d\udcca **War Scoreboard** | `\/wars status` shows detailed scoreboard with sides, kills, progress bars |
\n| \ud83c\udfaf **Action Bar** | Live kill-point updates on your action bar during war |
\n| \ud83c\udfc6 **Victory** | First side to reach the kill threshold wins |
\n| \ud83c\udff3\ufe0f **Transfer** | Winner receives the loser’s land \u2014 transfer within 24hrs or it reverts |
\n| \u23f1\ufe0f **Timeout** | Wars auto-end after a configurable duration |
\n| \ud83d\udea9 **War Flags** | Configurable block break\/place permissions during war with block whitelists |
\n| \ud83d\udccb **War GUI** | View active wars and status from the land menu |<\/p>\n
\n| Feature | Details |
\n|:—|:—|
\n| \ud83d\uddb1\ufe0f **Full GUI** | Manage everything through clean inventory menus |
\n| \u2728 **Border Viz** | See land borders with particles or glowing block entities |
\n| \ud83d\udce2 **Enter\/Leave** | Action bar notifications when crossing land borders |
\n| \ud83d\udd14 **Beacons** | Each land gets a beacon at its home chunk |
\n| \ud83c\udf08 **Beacon Color** | Customize your beacon’s color through the GUI |<\/p>\n
\n| Feature | Details |
\n|:—|:—|
\n| \ud83d\udee1\ufe0f **`\/landadmin`** | Full admin management suite |
\n| \ud83d\udc41\ufe0f **Bypass Mode** | Admins bypass all land protections |
\n| \ud83c\udff0 **Admin Lands** | Create server-protected areas (spawn, arenas) |
\n| \u2694\ufe0f **Force War** | `\/landadmin forcewar` \u2014 declare war between any two lands |
\n| \ud83d\uded1 **End War** | `\/landadmin endwar` \u2014 force-end any active war |
\n| \u2699\ufe0f **Limits** | Chunk, land, and member limits via permissions |
\n| \ud83d\udd11 **Permissions** | `peatowny.chunks.
\n| Feature | Details |
\n|:—|:—|
\n| \ud83d\udcc4 **YAML** | Simple file-based data, no setup required |
\n| \ud83d\uddc4\ufe0f **SQLite** | Lightweight database for better performance |
\n| \ud83d\udcbe **Auto-Save** | Data saved every 5 minutes automatically |<\/p>\n
\n| Feature | Details |
\n|:—|:—|
\n| \ud83d\udcb5 **Vault** | Full economy support |
\n| \ud83d\uddfa\ufe0f **Dynmap & BlueMap** | Land claims rendered on your web map |
\n| \ud83d\udcac **Land Chat** | Private chat channel for land members |<\/p>\n
\nGroup multiple lands into a powerful nation with shared governance, taxes, and diplomacy.<\/p>\n
\n|:—|:—|
\n| \ud83d\udc51 **Create Nations** | Form a nation from your level-5 capital land |
\n| \ud83c\udfd8\ufe0f **Member Lands** | Invite other lands to join your nation |
\n| \ud83d\udcb8 **Nation Taxes** | Collect taxes from member lands |
\n| \ud83c\udfda\ufe0f **Nation Upkeep** | Per-chunk upkeep for national territory |
\n| \ud83c\udf10 **Nation Chat** | Dedicated chat channel shared across all nation lands |
\n| \ud83e\udd1d **Diplomacy** | Nation-level relations and war declarations |<\/p>\n
\nTransform combat into full-scale territorial warfare:<\/p>\n
\n|:—|:—|
\n| \ud83d\udea9 **Chunk Capturing** | Place a capture fence in enemy territory and hold the chunk |
\n| \ud83d\udcca **Boss Bar Progress** | Real-time capture progress visible to both sides |
\n| \ud83d\udee1\ufe0f **Contestation** | Defenders entering a captured chunk pause the timer |
\n| \ud83d\udca5 **Beacon Win** | Capture the enemy’s home beacon to win instantly |
\n| \ud83c\udff3\ufe0f **Surrender & Tribute** | Losing side can surrender and pay up to 75% tribute |
\n| \ud83d\udee1\ufe0f **War Shields** | Protection periods after creation, surrender, and war end |
\n| \ud83d\udcb8 **Robbery** | Winners claim a percentage of the loser’s bank |
\n| \ud83d\udd04 **Territory Transfer** | Captured land transferred to the winner with 24hr deadline |<\/p>\n
\nLands progress through **5 tiers** as they grow:<\/p>\n
\n|:—:|:—|:—:|:—:|:—:|
\n| \u2b50 1 | Settlement | \u2014 | \u2014 | \u2014 |
\n| \u2b50 2 | Village | 4 | $7,500 | +1 |
\n| \u2b50 3 | Town | 8 | $17,000 | +2 |
\n| \u2b50 4 | Province | 14 | $30,000 | +4 |
\n| \u2b50 5 | Land | 24 | $55,000 | +8 |<\/p>\n
\n| Feature | Details |
\n|:—|:—|
\n| \ud83d\udfe2 **Ally** | Shared protections between allied lands |
\n| \u26aa **Neutral** | Default relation |
\n| \ud83d\udd34 **Enemy** | Hostile relation with PvP enabled |
\n| \ud83c\udfdb\ufe0f **Nation Auto-Ally** | Lands in the same nation are automatically allied |<\/p>\n
\nEach land is assigned a random resource type with bonus drops:<\/p>\n
\n|:—|:—|
\n| \u26cf\ufe0f Diamond | Bonus diamond drops while mining stone\/deepslate |
\n| \ud83e\udea8 Iron | Bonus raw iron drops while mining |
\n| \ud83e\udd47 Gold | Bonus raw gold drops while mining |
\n| \ud83c\udf3e Wheat | Bonus crop yields on harvest |
\n| \ud83d\udc1f Fish | Bonus catches while fishing |
\n| \ud83d\udc04 Mob | Bonus spawns from breeding |
\n| \u26fd Fuel | Collectible fuel sent to your fuel chest |<\/p>\n
\nDivide your land into sub-areas with **independent permission sets**. Perfect for public markets, member housing, restricted zones, or visitor areas within a single land.<\/p>\n
\nList lands for rent or sale on the marketplace. Players browse available listings, rent on a recurring cycle, or purchase outright.<\/p>\n
\nPer-land shared storage accessible through the GUI \u2014 a communal chest for your land members.<\/p>\n
\nMembers can fly freely within their own land. Automatically disabled when leaving territory or entering combat.<\/p>\n
\n| Feature | Details |
\n|:—|:—|
\n| \ud83c\udfda\ufe0f **Upkeep** | Lands pay per-chunk upkeep on a configurable cycle |
\n| \ud83d\udccb **Taxes** | Land owners set a member tax rate \u2014 auto-untrust on failure to pay |<\/p>\n
\nConnect to a MySQL database for large networks and multi-server setups.<\/p>\n
\nEdit **every single message** in `messages.yml` \u2014 change wording, colors, and placeholders to match your server brand.<\/p>\n
\nToggle between normal text and **Unicode small-caps** for a sleek, premium GUI look.<\/p>\n
\nImport data from **Lands** and **Towny** with a single command. Switch without losing anything.<\/p>\n
\nIn-game chunk minimap showing nearby claims, wilderness, and resource types right on your screen.<\/p>\n
\n|:—|:—:|:—:|
\n| \ud83c\udfe0 Land claiming & protection | \u2705 | \u2705 |
\n| \ud83c\udf96\ufe0f Roles & permissions | \u2705 | \u2705 |
\n| \ud83d\udcb0 Economy & land bank | \u2705 | \u2705 |
\n| \ud83d\uddb1\ufe0f GUI menus | \u2705 | \u2705 |
\n| \u2728 Border visualization | \u2705 | \u2705 |
\n| \ud83d\udd14 Beacon markers & color | \u2705 | \u2705 |
\n| \ud83c\udf10 Public warp system | \u2705 | \u2705 |
\n| \ud83d\udcac Land chat | \u2705 | \u2705 |
\n| \ud83d\uddfa\ufe0f Dynmap \/ BlueMap | \u2705 | \u2705 |
\n| \ud83d\udcbe YAML & SQLite storage | \u2705 | \u2705 |
\n| \ud83d\udd27 Admin tools & bypass | \u2705 | \u2705 |
\n| \u2694\ufe0f War (kill-point mode) | \u2705 | \u2705 |
\n| \ud83c\udfc6 War land transfer | \u2705 | \u2705 |
\n| \ud83d\udcca War scoreboard & action bar | \u2705 | \u2705 |
\n| \ud83d\udea9 War flags (block break\/place) | \u2705 | \u2705 |
\n| \u2694\ufe0f Combat tag with boss bar | \u2705 | \u2705 |
\n| | | |
\n| \ud83d\udea9 War (chunk capture & conquest) | \u274c | \u2705 |
\n| \ud83c\udfdb\ufe0f Nations & nation chat | \u274c | \u2705 |
\n| \ud83d\udcc8 Land levels (5 tiers) | \u274c | \u2705 |
\n| \ud83e\udd1d Relations (ally\/enemy) | \u274c | \u2705 |
\n| \ud83d\udc8e Resource nodes | \u274c | \u2705 |
\n| \ud83d\uddc2\ufe0f Sub-areas | \u274c | \u2705 |
\n| \ud83c\udfea Rent & sell | \u274c | \u2705 |
\n| \ud83d\udce6 Land storage | \u274c | \u2705 |
\n| \ud83d\udd4a\ufe0f Fly in land | \u274c | \u2705 |
\n| \ud83d\udcb8 Upkeep & taxes | \u274c | \u2705 |
\n| \ud83d\uddc4\ufe0f MySQL support | \u274c | \u2705 |
\n| \u270d\ufe0f Custom messages | \u274c | \u2705 |
\n| \ud83c\udfa8 GUI small-caps style | \u274c | \u2705 |
\n| \ud83d\udce5 Plugin migration | \u274c | \u2705 |
\n| \ud83d\uddfa\ufe0f Minimap | \u274c | \u2705 |<\/p>\n
\n|:—|:—|:—|
\n| `\/lands` | `\/land`, `\/l` | Main land command & GUI |
\n| `\/pea` | `\/p`, `\/peatowny`, `\/pt` | Same as `\/lands` |
\n| `\/town` | `\/t` | Same as `\/lands` |
\n| `\/nations` | `\/nation`, `\/n` | Nation management *(Premium)* |
\n| `\/wars` | `\/war`, `\/defeated` | War commands |
\n| `\/landadmin` | `\/la`, `\/ladmin` | Admin commands |<\/p>\n
\n|:—|:—|
\n| `\/lands create
\n| `\/lands claim` | \ud83d\udce6 Claim the chunk you’re in |
\n| `\/lands unclaim` | \u21a9\ufe0f Unclaim the current chunk |
\n| `\/lands autoclaim` | \ud83d\udeb6 Toggle auto-claim mode |
\n| `\/lands expand` | \ud83d\udcd0 Expand your land borders |
\n| `\/lands invite
\n| `\/lands trust
\n| `\/lands untrust
\n| `\/lands setrole
\n| `\/lands spawn [name]` | \ud83d\udccd Teleport to land spawn |
\n| `\/lands setspawn` | \ud83d\udccd Set your land’s spawn point |
\n| `\/lands movebeacon` | \ud83d\udd14 Move your land’s beacon |
\n| `\/lands fly` | \ud83d\udd4a\ufe0f Toggle flight *(Premium)* |
\n| `\/lands chat` | \ud83d\udcac Toggle land chat |
\n| `\/lands map` | \ud83d\uddfa\ufe0f Toggle minimap *(Premium)* |
\n| `\/lands menu` | \ud83d\uddb1\ufe0f Open land management GUI |
\n| `\/lands info [name]` | \u2139\ufe0f View land info |
\n| `\/lands list` | \ud83d\udccb List all lands |
\n| `\/lands top` | \ud83c\udfc6 View top lands |
\n| `\/lands deposit
\n| `\/lands withdraw
\n| `\/lands balance` | \ud83d\udcb0 Check land balance |
\n| `\/lands rename
\n| `\/lands delete` | \ud83d\uddd1\ufe0f Delete your land |
\n| `\/lands view` | \ud83d\udc41\ufe0f Toggle border visualization |
\n| `\/lands buy` | \ud83d\uded2 Buy a land listing *(Premium)* |
\n| `\/lands storage` | \ud83d\udce6 Access land storage *(Premium)* |<\/p>\n
\n|:—|:—|
\n| `\/wars declare
\n| `\/wars surrender` | \ud83c\udff3\ufe0f Surrender the current war |
\n| `\/wars status` | \ud83d\udcca View detailed war scoreboard |
\n| `\/wars info` | \u2139\ufe0f View war info |
\n| `\/wars list` | \ud83d\udccb List active wars |
\n| `\/wars transfer
\n|:—|:—|
\n| `\/nations create
\n| `\/nations invite
\n| `\/nations kick
\n| `\/nations leave` | \ud83d\udeaa Leave your nation |
\n| `\/nations info [name]` | \u2139\ufe0f View nation info |
\n| `\/nations list` | \ud83d\udccb List all nations |<\/p>\n
\n|:—|:—|
\n| `\/landadmin bypass` | \ud83d\udc41\ufe0f Toggle admin bypass mode |
\n| `\/landadmin unclaim` | \u21a9\ufe0f Force unclaim a chunk |
\n| `\/landadmin delete
\n| `\/landadmin give
\n| `\/landadmin setowner
\n| `\/landadmin setresource
\n| `\/landadmin forcewar
\n| `\/landadmin endwar
\n| `\/landadmin migrate
\n| `\/landadmin reload` | \ud83d\udd04 Reload plugin config |<\/p>\n
\nbasic-mode: false # Simplified mode \u2014 disables advanced features for a simpler experience
\n“`<\/p>\n
\nfeatures:
\n upkeep: true # \u2b50 Enable per-chunk upkeep costs (lands pay to maintain chunks)
\n taxes: true # \u2b50 Enable land owner taxation of members
\n relations: true # \u2b50 Enable ally\/enemy relations between lands
\n wars: true # Enable the war system (kill-point and capture modes)
\n nations: true # \u2b50 Enable the nations system (group lands together)
\n levels: true # \u2b50 Enable land leveling progression (Settlement \u2192 Land)
\n“`<\/p>\n
\ngeneral:
\n claim-worlds: # Which worlds allow claiming (* = all worlds)
\n – ‘*’
\n language: ‘en-US’ # Language locale for messages
\n edit-by-loc: false # Allow editing land settings based on location
\n first-join-items: # Items given to players on their first join
\n selection:
\n enabled: true # Give the selection wand tool
\n slot: 1 # Inventory slot for the selection tool
\n info:
\n enabled: true # Give the info tool (right-click to inspect chunks)
\n slot: 2 # Inventory slot for the info tool
\n camp:
\n enabled: false # Give the camp item (portable base)
\n claim-block:
\n enabled: true # Give a claim block (place to create a land instantly)
\n slot: 3 # Inventory slot for the claim block
\n date-format: ‘MM\/dd\/yyyy hh:mm a’ # Date display format throughout the plugin
\n eco-format: ‘$#,##0.00′ # Economy number format (currency display)
\n“`<\/p>\n
\neconomic:
\n interval:
\n days: 7 # Days between each economy cycle (upkeep\/tax collection)
\n time: ’23:00:00’ # Time of day when the cycle runs (HH:mm:ss)
\n“`<\/p>\n
\nupkeep:
\n per-chunk: 3.0 # Cost per chunk each economy cycle
\n unclaim-on-fail: false # Auto-unclaim chunks when a land can’t pay upkeep
\n no-pay-period: 2d # Grace period after land creation before upkeep starts
\n“`<\/p>\n
\ntaxes:
\n min: 0 # Minimum tax rate a land owner can set
\n max: 10.0 # Maximum tax rate a land owner can set
\n untrust-on-fail: true # Auto-remove members who fail to pay taxes
\n“`<\/p>\n
\nteleport:
\n cost: 0 # Economy cost to teleport to a land spawn
\n delay: 3 # Seconds to wait before teleporting (warmup)
\n cancel-on-move: true # Cancel teleport if the player moves during warmup
\n cooldown: 30 # Seconds between teleport uses
\n“`<\/p>\n
\ncombat:
\n enabled: true # Enable the combat tag system
\n duration: 15 # Combat tag duration in seconds after last hit
\n boss-bar: true # Show a boss bar countdown during combat tag
\n remove-on-death: true # Clear combat tag when the tagged player dies
\n“`<\/p>\n
\nland:
\n creation:
\n force: false # Force players to create a land before claiming
\n cost: 0.0 # Economy cost to create a new land
\n claim-radius: 1 # Initial claim radius on creation (1 = 3×3 area)
\n name:
\n spaces: false # Allow spaces in land names
\n max-length: 24 # Maximum characters in a land name
\n color: true # Allow color codes (&a, &b, etc.) in names
\n numbers: true # Allow numbers in land names
\n chunk-distance:
\n mode: EUCLIDEAN # Distance calculation mode (EUCLIDEAN or MANHATTAN)
\n land: 1 # Minimum chunk distance between different lands
\n nation: 3 # Minimum chunk distance between different nations
\n force-near:
\n enabled: true # New claims must be adjacent to existing claims
\n treat-as-new: true # Treat first claim as a “new land” (no adjacency needed)
\n spawn:
\n auto-set: true # Automatically set spawn when a land is created
\n cost:
\n set: 0.0 # Cost to set a land spawn
\n change: 0.0 # Cost to change an existing spawn
\n teleport:
\n cost: 0.0 # Cost to teleport to spawn (overrides global teleport.cost)
\n cooldown: 0 # Spawn-specific teleport cooldown in seconds
\n re-spawn: true # Respawn at land spawn on death
\n invite:
\n enabled: true # Enable the invite system
\n invite-owner: true # Allow inviting players who already own a land
\n broadcast:
\n create: true # Broadcast a message when a land is created
\n delete: true # Broadcast a message when a land is deleted
\n chat:
\n forward-to-console: false # Forward land chat messages to the server console
\n mute-global: false # Mute global chat when land chat is active
\n fly: # \u2b50 Premium Only
\n enabled: true # Enable \/lands fly command
\n disable-delay: 3 # Seconds of hover time before fly disables on leaving land
\n setowner:
\n enabled: true # Allow transferring land ownership
\n cost: 5000.0 # Cost to transfer ownership
\n rent: # \u2b50 Premium Only
\n rent: true # Enable renting lands
\n sell: true # Enable selling lands
\n expiration:
\n owner-offline: 60d # Delete land after owner is offline for this duration
\n delete-land: true # Actually delete the land on expiration (vs just flagging)
\n storage: true # \u2b50 Enable per-land shared storage chests
\n“`<\/p>\n
\nchunk:
\n cost:
\n buy: 0.0 # Cost per chunk claimed
\n refund: 0 # Refund percentage when unclaiming (0-100)
\n increase: 0.0 # Additive price increase for each additional chunk
\n max-claims: 0 # Hard max chunks per land (0 = use permission-based limits)
\n initial-claims: 10 # Default max chunks for new lands (no permission set)
\n scaling:
\n enabled: true # Scale max chunks based on member count
\n base-chunks: 10 # Starting chunk limit
\n per-member: 5 # Additional chunks per member joined
\n“`<\/p>\n
\nlimits:
\n default-chunks: 10 # Default max chunks if no permission node set
\n default-lands: 3 # Default max lands per player
\n default-members: 10 # Default max members per land
\n permission-stacking: false # Stack multiple permission nodes (add) vs take highest
\n“`<\/p>\n
\nvisualization:
\n type: ENTITY # Border display type: ENTITY (glowing blocks) or PARTICLE
\n duration: 15 # How long borders stay visible (seconds)
\n show-on-enter: true # Auto-show borders when entering a land
\n particle: FLAME # Particle type for PARTICLE mode
\n border-block: GLOWSTONE # Block type for ENTITY mode border display
\n“`<\/p>\n
\nwar:
\n enabled: true # Enable the war system
\n mode: killpoint # War mode: ‘killpoint’ (free+premium) or ‘capture’ (\u2b50 premium only)
\n # killpoint = kills determine the winner
\n # capture = chunk capturing determines the winner
\n only-nations: false # Only allow war between nations (not individual lands)
\n declaration:
\n min-players:
\n attacker: 0 # Minimum online members required for the attacking side
\n defender: 0 # Minimum online members required for the defending side
\n preparation-time: 1d # Time between declaration and war start
\n mutual: false # Require both sides to agree before war starts
\n min-balance:
\n attacker: 5000 # Minimum land bank balance to declare war
\n defender: 0 # Minimum defender balance required
\n points:
\n kill: 1 # Points awarded per player kill
\n capture: 5 # Points awarded per chunk captured (\u2b50 capture mode)
\n to-win-per-player: 5 # Points-to-win calculated per online player on each side
\n min-to-win: 100 # Minimum total points needed to win regardless of player count
\n timeout: 36h # Auto-end war after this duration (supports d, h, m)
\n surrender:
\n tribute-max: 75% # Maximum bank percentage the winner can demand on surrender
\n shield:
\n creation: 1d # War shield after land creation (can’t be attacked)
\n surrender: 4d # War shield after surrendering
\n end: 7d # War shield after a war ends
\n end:
\n robbery: 75% # Percentage of loser’s bank the winner takes
\n transfer:
\n timeout: 24 # Hours the winner has to transfer captured land before it reverts
\n keep-inventory: false # Keep inventory on death during war
\n capture: # \u2b50 Premium Only \u2014 chunk capture settings
\n enabled: true # Enable chunk capturing mechanic
\n hold-time: 600 # Seconds a capture fence must be held to capture a chunk
\n max-active: 3 # Maximum simultaneous capture attempts per war
\n fence-block: OAK_FENCE # Block type used as the capture fence
\n boss-bar-color: GREEN # Boss bar color during active capture
\n pause-bar-color: RED # Boss bar color when capture is contested\/paused
\n flags: # War flags \u2014 permissions bypassed between warring lands
\n enabled: [] # Flags to enable: BLOCK_BREAK, BLOCK_PLACE, INTERACT,
\n # CONTAINER_ACCESS, DOOR_USE, EXPLOSIONS
\n block-whitelist: # Per-flag block whitelists (empty = all blocks allowed)
\n BLOCK_BREAK: [] # Only these blocks can be broken during war
\n BLOCK_PLACE: [] # Only these blocks can be placed during war
\n“`<\/p>\n
\nnation:
\n enabled: true # Enable nations
\n creation:
\n cost: 20000.0 # Economy cost to create a nation
\n capital-level: 5 # Minimum land level required for the capital
\n name:
\n max-length: 24 # Maximum nation name length
\n spaces: false # Allow spaces in nation names
\n color: true # Allow color codes in nation names
\n taxes:
\n min: 0 # Minimum nation tax rate
\n max: 5.0 # Maximum nation tax rate
\n remove-on-fail: true # Remove lands that fail to pay nation taxes
\n upkeep:
\n enabled: true # Enable nation-level upkeep
\n per-chunk: 3.0 # Per-chunk upkeep cost for nation territory
\n delete-on-fail: true # Delete nation if it can’t pay upkeep
\n“`<\/p>\n
\nlevels:
\n enabled: true # Enable the level progression system
\n keep-level: false # Keep level when members leave (false = auto-downgrade)
\n land:
\n 1:
\n title: ‘Settlement’ # Display title for level 1
\n attributes:
\n bonus-chunks: 0 # Extra chunk slots at this level
\n 2:
\n title: ‘Village’
\n requirements:
\n members: 4 # Members needed to reach level 2
\n balance: 7500 # Land bank balance needed for level 2
\n attributes:
\n bonus-chunks: 1
\n 3:
\n title: ‘Town’
\n requirements:
\n members: 8
\n balance: 17000
\n attributes:
\n bonus-chunks: 2
\n 4:
\n title: ‘Province’
\n requirements:
\n members: 14
\n balance: 30000
\n attributes:
\n bonus-chunks: 4
\n 5:
\n title: ‘Land’
\n requirements:
\n members: 24
\n balance: 55000
\n attributes:
\n bonus-chunks: 8
\n“`<\/p>\n
\nnatural-flags: # Default values for land-wide flags (toggled per-land in GUI)
\n EXPLOSIONS: false # Allow explosions within the land
\n FIRE_SPREAD: false # Allow fire to spread
\n MOB_SPAWNING: true # Allow passive mob spawning
\n HOSTILE_SPAWNING: true # Allow hostile mob spawning
\n LEAF_DECAY: true # Allow leaf block decay
\n PISTON: true # Allow pistons to push\/pull blocks
\n LIQUID_FLOW: false # Allow water\/lava flow
\n SNOW_MELT: true # Allow snow to melt
\n PVP: false # Allow PvP between members
\n ENTRY: true # Allow non-members to enter the land
\n ENTER_NOTIFY: true # Show action bar notification when entering
\n“`<\/p>\n
\nresources:
\n enabled: true # Enable the resource node system
\n types:
\n DIAMOND:
\n chance: 0.005 # 0.5% chance per qualifying block mined
\n blocks: [STONE, DEEPSLATE, COBBLED_DEEPSLATE] # Blocks that trigger the bonus
\n drop: DIAMOND # Item dropped as bonus
\n IRON:
\n chance: 0.02 # 2% chance
\n blocks: [STONE, DEEPSLATE, COBBLED_DEEPSLATE]
\n drop: RAW_IRON
\n GOLD:
\n chance: 0.01 # 1% chance
\n blocks: [STONE, DEEPSLATE, COBBLED_DEEPSLATE]
\n drop: RAW_GOLD
\n WHEAT:
\n chance: 0.15 # 15% chance on crop harvest
\n bonus-amount: 2 # Extra wheat dropped
\n FISH:
\n chance: 0.25 # 25% chance for bonus catch
\n MOB:
\n chance: 0.20 # 20% chance for extra mob from breeding
\n FUEL:
\n chance: 0.03 # 3% chance per qualifying block
\n blocks: [STONE, DEEPSLATE, COBBLED_DEEPSLATE, NETHERRACK]
\n“`<\/p>\n
\nwilderness: # Global rules for unclaimed (wilderness) land
\n block-break: true # Allow block breaking in wilderness
\n block-place: true # Allow block placing in wilderness
\n pvp: true # Allow PvP in wilderness
\n mob-spawning: true # Allow mob spawning in wilderness
\n hostile-spawning: true # Allow hostile mob spawning in wilderness
\n explosions: true # Allow explosions in wilderness
\n fire-spread: true # Allow fire spread in wilderness
\n ender-pearl: true # Allow ender pearl teleportation in wilderness
\n chorus-fruit: true # Allow chorus fruit teleportation in wilderness
\n“`<\/p>\n
\nstorage:
\n type: sqlite # Storage type: yaml, sqlite, or mysql (\u2b50 mysql = premium)
\n mysql: # \u2b50 Premium Only \u2014 MySQL connection settings
\n host: localhost # Database server hostname
\n port: 3306 # Database server port
\n database: peatowny # Database name
\n username: root # Database username
\n password: ” # Database password
\n“`<\/p>\n
\nnation-claims:
\n max-claims: 3 # Maximum nation-level claim slots
\n transfer-hours: 24 # Hours to complete a claim transfer
\n“`<\/p>\n
\nrelations:
\n enabled: true # Enable the relations system
\n cost: 0.0 # Economy cost to change a relation
\n nation-auto-ally: true # Auto-ally lands within the same nation
\n“`<\/p>\n
\ncommand-aliases: # Define custom subcommand aliases
\n lands: {} # Example: claim: [“takechunk”, “grabland”]
\n nations: {} # Example: create: [“nationmake”]<\/p>\n
\n text-style: normal # \u2b50 Text style: ‘normal’ or ‘smallcaps’ (Unicode small capitals)<\/p>\n
\n prefix: “&8[&aPeaTowny&8] &7” # Chat message prefix for all plugin messages
\n“`<\/p>\n
\n2. \ud83d\udcc2 Drop the JAR into your server’s `plugins\/` folder
\n3. \ud83d\udd04 Restart your server
\n4. \ud83c\udf92 Players automatically receive a selection tool and claim block on first join
\n5. \u2728 Use `\/lands`, `\/pea`, or `\/town` to open the GUI<\/p>\n
\n2. \ud83d\udd04 Replace `PeaTowny-Free.jar` with the premium JAR
\n3. \ud83d\udd01 Restart \u2014 **all existing data is preserved**
\n4. \ud83c\udf89 Premium features unlock automatically, zero migration needed<\/p>\n
\n>
\n> \ud83c\udf3f **Made with love by Pea Studios**<\/p>\n","protected":false},"excerpt":{"rendered":"