<p align="center"> <img src="https://img.shields.io/badge/Paper-1.21.11-44cc11?style=for-the-badge&logo=data:image/png;base64," alt="Paper"> <img src="https://img.shields.io/badge/Java-21-orange?style=for-the-badge&logo=oracle" alt="Java 21"> <img src="https://img.shields.io/badge/Vault-Optional-blue?style=for-the-badge" alt="Vault"> </p> <h1 align="center">🌿 PeaTowny</h1> <p align="center"><b>The modern land-claiming & town management plugin.</b></p> <p align="center">Drop-in replacement for Towny & Lands — familiar <code>/lands</code> commands, zero learning curve.</p> <p align="center"> <a href="https://discord.gg/Y8QhgYaq6K">💬 Discord</a> &nbsp;·&nbsp; <a href="#-free-edition">🎁 Free Edition</a> &nbsp;·&nbsp; <a href="#-premium-edition">⭐ Premium Edition</a> &nbsp;·&nbsp; <a href="#-configuration-reference">⚙️ Config</a> </p> !(https://cdn.modrinth.com/data/cached_images/edc959e61690f364d284b7b51ae9ce664f8ece86_0.webp) --- ## 🗂️ Choose Your Edition <table> <tr> <td width="50%" align="center"> ### 🎁 Free Edition Everything you need to run a land-claiming server. Full protection, wars, GUI, economy, and admin tools. **(#-free-edition)** </td> <td width="50%" align="center"> ### ⭐ Premium Edition The complete experience — nations, conquest wars, levels, sub-areas, rent, fly, and much more. **(#-premium-edition)** </td> </tr> </table> --- # 🎁 Free Edition > **Zero cost. Fully functional.** Create lands, invite members, manage permissions, wage wars, and protect your builds — everything you need out of the box. --- ### 🏠 Land Management | Feature | Details | |:---|:---| | 🏗️ **Create & Delete** | Players can own up to 3 lands (configurable) | | 📦 **Chunk Claiming** | Claim with `/lands claim` — creation auto-claims a 3x3 area | | 🚶 **Auto-Claim** | Walk to claim chunks automatically with `/lands autoclaim` | | 🧱 **Claim Block** | Place a physical block to instantly create a land (3x3 area) | | 🪄 **Selection Tool** | Visual tool given on first join for selecting areas | | 📍 **Land Spawn** | Set and teleport to a spawn point within your land | | ✏️ **Rename** | Change your land's name anytime through GUI or command | | 🔎 **Land Browser** | Browse all server lands via the GUI | | 📐 **Expand** | Expand your land's borders in a direction | ### 🌐 Public Warp System | Feature | Details | |:---|:---| | 🔔 **Beacon Warps** | Step on any land beacon to open the public warp browser | | 🗺️ **Warp Browser** | Paginated GUI showing all public lands — click to teleport | | 🔍 **Search** | Click the sign icon to search for a specific land by name | | 🔒 **Warp Manager** | Land owners can toggle public/private and set a custom icon | | 🎨 **Custom Icons** | Choose from 56+ block/item icons to represent your land | ### 👥 Members & Roles | Feature | Details | |:---|:---| | 💌 **Invite System** | Invite players to join your land | | 🎖️ **4 Default Roles** | Owner, Officer, Member, Visitor (built-in & undeletable) | | 🛠️ **Custom Roles** | Create additional roles with custom names & colors | | 🔐 **Role Flags** | Fine-grained control: build, break, interact, containers, doors, PvP, etc. | | ✅ **Trust / Untrust** | Quickly add or remove members from your land | ### 🛡️ Protection | Feature | Details | |:---|:---| | 🧩 **Chunk-Based** | Claimed chunks are fully protected from outsiders | | 🌿 **Natural Flags** | Toggle explosions, fire spread, mob spawning, PvP, pistons, liquid flow, etc. | | 🌍 **Wilderness Rules** | Configurable protection rules for unclaimed land | | ⚔️ **Combat Tag** | Configurable duration, boss bar countdown, remove-on-death option | ### 💰 Economy (Vault) | Feature | Details | |:---|:---| | 🏦 **Land Bank** | Deposit and withdraw funds from your land's treasury | | 💎 **Chunk Costs** | Configurable price per chunk with scaling options | | 🚀 **Teleport Costs** | Optional economy cost for spawn teleportation | ### ⚔️ War System (Kill Point Mode) | Feature | Details | |:---|:---| | 🏴 **Declare War** | Challenge another land to a kill-count war | | 💀 **Kill Tracking** | Per-player kill counts tracked and displayed | | 📊 **War Scoreboard** | `/wars status` shows detailed scoreboard with sides, kills, progress bars | | 🎯 **Action Bar** | Live kill-point updates on your action bar during war | | 🏆 **Victory** | First side to reach the kill threshold wins | | 🏳️ **Transfer** | Winner receives the loser's land — transfer within 24hrs or it reverts | | ⏱️ **Timeout** | Wars auto-end after a configurable duration | | 🚩 **War Flags** | Configurable block break/place permissions during war with block whitelists | | 📋 **War GUI** | View active wars and status from the land menu | ### 🎨 Visual & UI | Feature | Details | |:---|:---| | 🖱️ **Full GUI** | Manage everything through clean inventory menus | | ✨ **Border Viz** | See land borders with particles or glowing block entities | | 📢 **Enter/