PeaTowny

Minecrafts greatest Kingdoms and Towns plugin!

PeaTowny

<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> · <a href="#-free-edition">🎁 Free Edition</a> · <a href="#-premium-edition">⭐ Premium Edition</a> · <a href="#-configuration-reference">⚙️ Config</a> </p>

PeaTowny

---

🗂️ Choose Your Edition

🎁 Free Edition

Everything you need to run a land-claiming server. Full protection, wars, GUI, economy, and admin tools.

Jump to Free Features ↓

</td> <td width="50%" align="center">

⭐ Premium Edition

The complete experience — nations, conquest wars, levels, sub-areas, rent, fly, and much more.

Jump to Premium Features ↓

</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 | |:---|:---| | 🏗️ Expand | Players can own up to 3 lands (configurable) | | 📦 Expand | Claim with `/lands claim` — creation auto-claims a 3x3 area | | 🚶 Expand | Walk to claim chunks automatically with `/lands autoclaim` | | 🧱 Expand | Place a physical block to instantly create a land (3x3 area) | | 🪄 Expand | Visual tool given on first join for selecting areas | | 📍 Expand | Set and teleport to a spawn point within your land | | ✏️ Expand | Change your land's name anytime through GUI or command | | 🔎 Expand | Browse all server lands via the GUI | | 📐 Expand | Expand your land's borders in a direction |

🌐 Public Warp System

| Feature | Details | |:---|:---| | 🔔 Custom Icons | Step on any land beacon to open the public warp browser | | 🗺️ Custom Icons | Paginated GUI showing all public lands — click to teleport | | 🔍 Custom Icons | Click the sign icon to search for a specific land by name | | 🔒 Custom Icons | 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 | |:---|:---| | 💌 Trust / Untrust | Invite players to join your land | | 🎖️ Trust / Untrust | Owner, Officer, Member, Visitor (built-in & undeletable) | | 🛠️ Trust / Untrust | Create additional roles with custom names & colors | | 🔐 Trust / Untrust | Fine-grained control: build, break, interact, containers, doors, PvP, etc. | | ✅ Trust / Untrust | Quickly add or remove members from your land |

🛡️ Protection

| Feature | Details | |:---|:---| | 🧩 Combat Tag | Claimed chunks are fully protected from outsiders | | 🌿 Combat Tag | Toggle explosions, fire spread, mob spawning, PvP, pistons, liquid flow, etc. | | 🌍 Combat Tag | Configurable protection rules for unclaimed land | | ⚔️ Combat Tag | Configurable duration, boss bar countdown, remove-on-death option |

💰 Economy (Vault)

| Feature | Details | |:---|:---| | 🏦 Teleport Costs | Deposit and withdraw funds from your land's treasury | | 💎 Teleport Costs | Configurable price per chunk with scaling options | | 🚀 Teleport Costs | Optional economy cost for spawn teleportation |

⚔️ War System (Kill Point Mode)

| Feature | Details | |:---|:---| | 🏴 War GUI | Challenge another land to a kill-count war | | 💀 War GUI | Per-player kill counts tracked and displayed | | 📊 War GUI | `/wars status` shows detailed scoreboard with sides, kills, progress bars | | 🎯 War GUI | Live kill-point updates on your action bar during war | | 🏆 War GUI | First side to reach the kill threshold wins | | 🏳️ War GUI | Winner receives the loser's land — transfer within 24hrs or it reverts | | ⏱️ War GUI | Wars auto-end after a configurable duration | | 🚩 War GUI | 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 | |:---|:---| | 🖱️ Beacon Color | Manage everything through clean inventory menus | | ✨ Beacon Color | See land borders with particles or glowing block entities | | 📢 Beacon Color | Action bar notifications when crossing land borders | | 🔔 Beacon Color | Each land gets a beacon at its home chunk | | 🌈 Beacon Color | Customize your beacon's color through the GUI |

🔧 Admin Tools

| Feature | Details | |:---|:---| | 🛡️ Permissions | Full admin management suite | | 👁️ Permissions | Admins bypass all land protections | | 🏰 Permissions | Create server-protected areas (spawn, arenas) | | ⚔️ Permissions | `/landadmin forcewar` — declare war between any two lands | | 🛑 Permissions | `/landadmin endwar` — force-end any active war | | ⚙️ Permissions | Chunk, land, and member limits via permissions | | 🔑 Permissions | `peatowny.chunks.<n>`, `peatowny.lands.<n>`, `peatowny.members.<n>` |

💾 Data & Storage

| Feature | Details | |:---|:---| | 📄 Auto-Save | Simple file-based data, no setup required | | 🗄️ Auto-Save | Lightweight database for better performance | | 💾 Auto-Save | Data saved every 5 minutes automatically |

🔌 Integration

| Feature | Details | |:---|:---| | 💵 Land Chat | Full economy support | | 🗺️ Land Chat | Land claims rendered on your web map | | 💬 Land Chat | Private chat channel for land members |

---

⭐ Premium Edition

> everything in Free Just swap the JAR — all your data carries over instantly. Premium includes everything in Free plus the features below.

> 🛒 Get Premium → Get Premium →

---

🏛️ Nations

Group multiple lands into a powerful nation with shared governance, taxes, and diplomacy.

| Feature | Details | |:---|:---| | 👑 Diplomacy | Form a nation from your level-5 capital land | | 🏘️ Diplomacy | Invite other lands to join your nation | | 💸 Diplomacy | Collect taxes from member lands | | 🏚️ Diplomacy | Per-chunk upkeep for national territory | | 🌐 Diplomacy | Dedicated chat channel shared across all nation lands | | 🤝 Diplomacy | Nation-level relations and war declarations |

⚔️ Full Conquest War (Capture Mode)

Transform combat into full-scale territorial warfare:

| Feature | Details | |:---|:---| | 🚩 Territory Transfer | Place a capture fence in enemy territory and hold the chunk | | 📊 Territory Transfer | Real-time capture progress visible to both sides | | 🛡️ Territory Transfer | Defenders entering a captured chunk pause the timer | | 💥 Territory Transfer | Capture the enemy's home beacon to win instantly | | 🏳️ Territory Transfer | Losing side can surrender and pay up to 75% tribute | | 🛡️ Territory Transfer | Protection periods after creation, surrender, and war end | | 💸 Territory Transfer | Winners claim a percentage of the loser's bank | | 🔄 Territory Transfer | Captured land transferred to the winner with 24hr deadline |

📈 Land Levels

Lands progress through 5 tiers as they grow:

| Level | Title | Members Required | Balance Required | Bonus Chunks | |:---:|:---|:---:|:---:|:---:| | ⭐ 1 | Settlement | — | — | — | | ⭐ 2 | Village | 4 | $7,500 | +1 | | ⭐ 3 | Town | 8 | $17,000 | +2 | | ⭐ 4 | Province | 14 | $30,000 | +4 | | ⭐ 5 | Land | 24 | $55,000 | +8 |

🤝 Relations

| Feature | Details | |:---|:---| | 🟢 Nation Auto-Ally | Shared protections between allied lands | | ⚪ Nation Auto-Ally | Default relation | | 🔴 Nation Auto-Ally | Hostile relation with PvP enabled | | 🏛️ Nation Auto-Ally | Lands in the same nation are automatically allied |

💎 Resource Nodes

Each land is assigned a random resource type with bonus drops:

| Resource | Bonus | |:---|:---| | ⛏️ Diamond | Bonus diamond drops while mining stone/deepslate | | 🪨 Iron | Bonus raw iron drops while mining | | 🥇 Gold | Bonus raw gold drops while mining | | 🌾 Wheat | Bonus crop yields on harvest | | 🐟 Fish | Bonus catches while fishing | | 🐄 Mob | Bonus spawns from breeding | | ⛽ Fuel | Collectible fuel sent to your fuel chest |

🗂️ Sub-Areas

Divide your land into sub-areas with independent permission sets. Perfect for public markets, member housing, restricted zones, or visitor areas within a single land.

🏪 Rent & Sell

List lands for rent or sale on the marketplace. Players browse available listings, rent on a recurring cycle, or purchase outright.

📦 Land Storage

Per-land shared storage accessible through the GUI — a communal chest for your land members.

🕊️ Fly

Members can fly freely within their own land. Automatically disabled when leaving territory or entering combat.

💸 Upkeep & Taxes

| Feature | Details | |:---|:---| | 🏚️ Taxes | Lands pay per-chunk upkeep on a configurable cycle | | 📋 Taxes | Land owners set a member tax rate — auto-untrust on failure to pay |

🗄️ MySQL Storage

Connect to a MySQL database for large networks and multi-server setups.

✍️ Custom Messages

Edit every single message in `messages.yml` — change wording, colors, and placeholders to match your server brand.

🎨 GUI Text Style

Toggle between normal text and Unicode small-caps for a sleek, premium GUI look.

📥 Migration

Import data from Towny and Towny with a single command. Switch without losing anything.

🗺️ Minimap

In-game chunk minimap showing nearby claims, wilderness, and resource types right on your screen.

---

📊 Free vs Premium at a Glance

| Feature | 🎁 Free | ⭐ Premium | |:---|:---:|:---:| | 🏠 Land claiming & protection | ✅ | ✅ | | 🎖️ Roles & permissions | ✅ | ✅ | | 💰 Economy & land bank | ✅ | ✅ | | 🖱️ GUI menus | ✅ | ✅ | | ✨ Border visualization | ✅ | ✅ | | 🔔 Beacon markers & color | ✅ | ✅ | | 🌐 Public warp system | ✅ | ✅ | | 💬 Land chat | ✅ | ✅ | | 🗺️ Dynmap / BlueMap | ✅ | ✅ | | 💾 YAML & SQLite storage | ✅ | ✅ | | 🔧 Admin tools & bypass | ✅ | ✅ | | ⚔️ War (kill-point mode) | ✅ | ✅ | | 🏆 War land transfer | ✅ | ✅ | | 📊 War scoreboard & action bar | ✅ | ✅ | | 🚩 War flags (block break/place) | ✅ | ✅ | | ⚔️ Combat tag with boss bar | ✅ | ✅ | | | | | | 🚩 War (chunk capture & conquest) | ❌ | ✅ | | 🏛️ Nations & nation chat | ❌ | ✅ | | 📈 Land levels (5 tiers) | ❌ | ✅ | | 🤝 Relations (ally/enemy) | ❌ | ✅ | | 💎 Resource nodes | ❌ | ✅ | | 🗂️ Sub-areas | ❌ | ✅ | | 🏪 Rent & sell | ❌ | ✅ | | 📦 Land storage | ❌ | ✅ | | 🕊️ Fly in land | ❌ | ✅ | | 💸 Upkeep & taxes | ❌ | ✅ | | 🗄️ MySQL support | ❌ | ✅ | | ✍️ Custom messages | ❌ | ✅ | | 🎨 GUI small-caps style | ❌ | ✅ | | 📥 Plugin migration | ❌ | ✅ | | 🗺️ Minimap | ❌ | ✅ |

---

📜 Commands

Main Commands (Multiple Aliases)

> All main commands open the same land GUI. Use whichever feels natural.

| Command | Aliases | Description | |:---|:---|:---| | `/lands` | `/land`, `/l` | Main land command & GUI | | `/pea` | `/p`, `/peatowny`, `/pt` | Same as `/lands` | | `/town` | `/t` | Same as `/lands` | | `/nations` | `/nation`, `/n` | Nation management *(Premium)* | | `/wars` | `/war`, `/defeated` | War commands | | `/landadmin` | `/la`, `/ladmin` | Admin commands |

Land Subcommands

| Command | Description | |:---|:---| | `/lands create <name>` | 🏗️ Create a new land (claims 3x3 area) | | `/lands claim` | 📦 Claim the chunk you're in | | `/lands unclaim` | ↩️ Unclaim the current chunk | | `/lands autoclaim` | 🚶 Toggle auto-claim mode | | `/lands expand` | 📐 Expand your land borders | | `/lands invite <player>` | 💌 Invite a player | | `/lands trust <player>` | ✅ Trust a player | | `/lands untrust <player>` | ❌ Remove a player | | `/lands setrole <player> <role>` | 🎖️ Assign a role to a member | | `/lands spawn [name]` | 📍 Teleport to land spawn | | `/lands setspawn` | 📍 Set your land's spawn point | | `/lands movebeacon` | 🔔 Move your land's beacon | | `/lands fly` | 🕊️ Toggle flight *(Premium)* | | `/lands chat` | 💬 Toggle land chat | | `/lands map` | 🗺️ Toggle minimap *(Premium)* | | `/lands menu` | 🖱️ Open land management GUI | | `/lands info [name]` | ℹ️ View land info | | `/lands list` | 📋 List all lands | | `/lands top` | 🏆 View top lands | | `/lands deposit <amount>` | 💰 Deposit to land bank | | `/lands withdraw <amount>` | 💰 Withdraw from land bank | | `/lands balance` | 💰 Check land balance | | `/lands rename <name>` | ✏️ Rename your land | | `/lands delete` | 🗑️ Delete your land | | `/lands view` | 👁️ Toggle border visualization | | `/lands buy` | 🛒 Buy a land listing *(Premium)* | | `/lands storage` | 📦 Access land storage *(Premium)* |

War Subcommands

| Command | Description | |:---|:---| | `/wars declare <land>` | 🏴 Declare war on a land | | `/wars surrender` | 🏳️ Surrender the current war | | `/wars status` | 📊 View detailed war scoreboard | | `/wars info` | ℹ️ View war info | | `/wars list` | 📋 List active wars | | `/wars transfer <land>` | 🔄 Transfer captured land |

Nation Subcommands (Premium)

| Command | Description | |:---|:---| | `/nations create <name>` | 👑 Create a nation | | `/nations invite <land>` | 💌 Invite a land to your nation | | `/nations kick <land>` | ❌ Remove a land from your nation | | `/nations leave` | 🚪 Leave your nation | | `/nations info [name]` | ℹ️ View nation info | | `/nations list` | 📋 List all nations |

Admin Subcommands

| Command | Description | |:---|:---| | `/landadmin bypass` | 👁️ Toggle admin bypass mode | | `/landadmin unclaim` | ↩️ Force unclaim a chunk | | `/landadmin delete <land>` | 🗑️ Force delete a land | | `/landadmin give <player> <amount>` | 🎁 Give claim chunks to a player | | `/landadmin setowner <land> <player>` | 👤 Change land owner | | `/landadmin setresource <land> <type>` | 💎 Set land resource type | | `/landadmin forcewar <land1> <land2>` | ⚔️ Force declare a war | | `/landadmin endwar <land> [winner]` | 🛑 Force end an active war | | `/landadmin migrate <plugin>` | 📥 Import from Lands/Towny *(Premium)* | | `/landadmin reload` | 🔄 Reload plugin config |

---

⚙️ Configuration Reference

> Full breakdown of every option in `config.yml`. Lines marked with ⭐ are Premium Only.

---

🔧 Core Settings

```yaml basic-mode: false # Simplified mode — disables advanced features for a simpler experience ```

🎛️ Feature Toggles

```yaml features: upkeep: true # ⭐ Enable per-chunk upkeep costs (lands pay to maintain chunks) taxes: true # ⭐ Enable land owner taxation of members relations: true # ⭐ Enable ally/enemy relations between lands wars: true # Enable the war system (kill-point and capture modes) nations: true # ⭐ Enable the nations system (group lands together) levels: true # ⭐ Enable land leveling progression (Settlement → Land) ```

🌍 General Settings

```yaml general: claim-worlds: # Which worlds allow claiming (* = all worlds) - '*' language: 'en-US' # Language locale for messages edit-by-loc: false # Allow editing land settings based on location first-join-items: # Items given to players on their first join selection: enabled: true # Give the selection wand tool slot: 1 # Inventory slot for the selection tool info: enabled: true # Give the info tool (right-click to inspect chunks) slot: 2 # Inventory slot for the info tool camp: enabled: false # Give the camp item (portable base) claim-block: enabled: true # Give a claim block (place to create a land instantly) slot: 3 # Inventory slot for the claim block date-format: 'MM/dd/yyyy hh:mm a' # Date display format throughout the plugin eco-format: '$#,##0.00' # Economy number format (currency display) ```

💰 Economy Cycle

```yaml economic: interval: days: 7 # Days between each economy cycle (upkeep/tax collection) time: '23:00:00' # Time of day when the cycle runs (HH:mm:ss) ```

🏚️ Upkeep (⭐ Premium)

```yaml upkeep: per-chunk: 3.0 # Cost per chunk each economy cycle unclaim-on-fail: false # Auto-unclaim chunks when a land can't pay upkeep no-pay-period: 2d # Grace period after land creation before upkeep starts ```

📋 Taxes (⭐ Premium)

```yaml taxes: min: 0 # Minimum tax rate a land owner can set max: 10.0 # Maximum tax rate a land owner can set untrust-on-fail: true # Auto-remove members who fail to pay taxes ```

🚀 Teleportation

```yaml teleport: cost: 0 # Economy cost to teleport to a land spawn delay: 3 # Seconds to wait before teleporting (warmup) cancel-on-move: true # Cancel teleport if the player moves during warmup cooldown: 30 # Seconds between teleport uses ```

⚔️ Combat Tag

```yaml combat: enabled: true # Enable the combat tag system duration: 15 # Combat tag duration in seconds after last hit boss-bar: true # Show a boss bar countdown during combat tag remove-on-death: true # Clear combat tag when the tagged player dies ```

🏠 Land Settings

```yaml land: creation: force: false # Force players to create a land before claiming cost: 0.0 # Economy cost to create a new land claim-radius: 1 # Initial claim radius on creation (1 = 3x3 area) name: spaces: false # Allow spaces in land names max-length: 24 # Maximum characters in a land name color: true # Allow color codes (&a, &b, etc.) in names numbers: true # Allow numbers in land names chunk-distance: mode: EUCLIDEAN # Distance calculation mode (EUCLIDEAN or MANHATTAN) land: 1 # Minimum chunk distance between different lands nation: 3 # Minimum chunk distance between different nations force-near: enabled: true # New claims must be adjacent to existing claims treat-as-new: true # Treat first claim as a "new land" (no adjacency needed) spawn: auto-set: true # Automatically set spawn when a land is created cost: set: 0.0 # Cost to set a land spawn change: 0.0 # Cost to change an existing spawn teleport: cost: 0.0 # Cost to teleport to spawn (overrides global teleport.cost) cooldown: 0 # Spawn-specific teleport cooldown in seconds re-spawn: true # Respawn at land spawn on death invite: enabled: true # Enable the invite system invite-owner: true # Allow inviting players who already own a land broadcast: create: true # Broadcast a message when a land is created delete: true # Broadcast a message when a land is deleted chat: forward-to-console: false # Forward land chat messages to the server console mute-global: false # Mute global chat when land chat is active fly: # ⭐ Premium Only enabled: true # Enable /lands fly command disable-delay: 3 # Seconds of hover time before fly disables on leaving land setowner: enabled: true # Allow transferring land ownership cost: 5000.0 # Cost to transfer ownership rent: # ⭐ Premium Only rent: true # Enable renting lands sell: true # Enable selling lands expiration: owner-offline: 60d # Delete land after owner is offline for this duration delete-land: true # Actually delete the land on expiration (vs just flagging) storage: true # ⭐ Enable per-land shared storage chests ```

📦 Chunk Settings

```yaml chunk: cost: buy: 0.0 # Cost per chunk claimed refund: 0 # Refund percentage when unclaiming (0-100) increase: 0.0 # Additive price increase for each additional chunk max-claims: 0 # Hard max chunks per land (0 = use permission-based limits) initial-claims: 10 # Default max chunks for new lands (no permission set) scaling: enabled: true # Scale max chunks based on member count base-chunks: 10 # Starting chunk limit per-member: 5 # Additional chunks per member joined ```

📐 Limits

```yaml limits: default-chunks: 10 # Default max chunks if no permission node set default-lands: 3 # Default max lands per player default-members: 10 # Default max members per land permission-stacking: false # Stack multiple permission nodes (add) vs take highest ```

> Permission nodes: `peatowny.chunks.<n>`, `peatowny.lands.<n>`, `peatowny.members.<n>`

✨ Visualization

```yaml visualization: type: ENTITY # Border display type: ENTITY (glowing blocks) or PARTICLE duration: 15 # How long borders stay visible (seconds) show-on-enter: true # Auto-show borders when entering a land particle: FLAME # Particle type for PARTICLE mode border-block: GLOWSTONE # Block type for ENTITY mode border display ```

⚔️ War Settings

```yaml war: enabled: true # Enable the war system mode: killpoint # War mode: 'killpoint' (free+premium) or 'capture' (⭐ premium only)

killpoint = kills determine the winner

capture = chunk capturing determines the winner

only-nations: false # Only allow war between nations (not individual lands) declaration: min-players: attacker: 0 # Minimum online members required for the attacking side defender: 0 # Minimum online members required for the defending side preparation-time: 1d # Time between declaration and war start mutual: false # Require both sides to agree before war starts min-balance: attacker: 5000 # Minimum land bank balance to declare war defender: 0 # Minimum defender balance required points: kill: 1 # Points awarded per player kill capture: 5 # Points awarded per chunk captured (⭐ capture mode) to-win-per-player: 5 # Points-to-win calculated per online player on each side min-to-win: 100 # Minimum total points needed to win regardless of player count timeout: 36h # Auto-end war after this duration (supports d, h, m) surrender: tribute-max: 75% # Maximum bank percentage the winner can demand on surrender shield: creation: 1d # War shield after land creation (can't be attacked) surrender: 4d # War shield after surrendering end: 7d # War shield after a war ends end: robbery: 75% # Percentage of loser's bank the winner takes transfer: timeout: 24 # Hours the winner has to transfer captured land before it reverts keep-inventory: false # Keep inventory on death during war capture: # ⭐ Premium Only — chunk capture settings enabled: true # Enable chunk capturing mechanic hold-time: 600 # Seconds a capture fence must be held to capture a chunk max-active: 3 # Maximum simultaneous capture attempts per war fence-block: OAK_FENCE # Block type used as the capture fence boss-bar-color: GREEN # Boss bar color during active capture pause-bar-color: RED # Boss bar color when capture is contested/paused flags: # War flags — permissions bypassed between warring lands enabled: [] # Flags to enable: BLOCK_BREAK, BLOCK_PLACE, INTERACT,

CONTAINER_ACCESS, DOOR_USE, EXPLOSIONS

block-whitelist: # Per-flag block whitelists (empty = all blocks allowed) BLOCK_BREAK: [] # Only these blocks can be broken during war BLOCK_PLACE: [] # Only these blocks can be placed during war ```

🏛️ Nation Settings (⭐ Premium)

```yaml nation: enabled: true # Enable nations creation: cost: 20000.0 # Economy cost to create a nation capital-level: 5 # Minimum land level required for the capital name: max-length: 24 # Maximum nation name length spaces: false # Allow spaces in nation names color: true # Allow color codes in nation names taxes: min: 0 # Minimum nation tax rate max: 5.0 # Maximum nation tax rate remove-on-fail: true # Remove lands that fail to pay nation taxes upkeep: enabled: true # Enable nation-level upkeep per-chunk: 3.0 # Per-chunk upkeep cost for nation territory delete-on-fail: true # Delete nation if it can't pay upkeep ```

📈 Land Levels (⭐ Premium)

```yaml levels: enabled: true # Enable the level progression system keep-level: false # Keep level when members leave (false = auto-downgrade) land: 1: title: 'Settlement' # Display title for level 1 attributes: bonus-chunks: 0 # Extra chunk slots at this level 2: title: 'Village' requirements: members: 4 # Members needed to reach level 2 balance: 7500 # Land bank balance needed for level 2 attributes: bonus-chunks: 1 3: title: 'Town' requirements: members: 8 balance: 17000 attributes: bonus-chunks: 2 4: title: 'Province' requirements: members: 14 balance: 30000 attributes: bonus-chunks: 4 5: title: 'Land' requirements: members: 24 balance: 55000 attributes: bonus-chunks: 8 ```

🌿 Natural Flags

```yaml natural-flags: # Default values for land-wide flags (toggled per-land in GUI) EXPLOSIONS: false # Allow explosions within the land FIRE_SPREAD: false # Allow fire to spread MOB_SPAWNING: true # Allow passive mob spawning HOSTILE_SPAWNING: true # Allow hostile mob spawning LEAF_DECAY: true # Allow leaf block decay PISTON: true # Allow pistons to push/pull blocks LIQUID_FLOW: false # Allow water/lava flow SNOW_MELT: true # Allow snow to melt PVP: false # Allow PvP between members ENTRY: true # Allow non-members to enter the land ENTER_NOTIFY: true # Show action bar notification when entering ```

💎 Resources (⭐ Premium)

```yaml resources: enabled: true # Enable the resource node system types: DIAMOND: chance: 0.005 # 0.5% chance per qualifying block mined blocks: [STONE, DEEPSLATE, COBBLED_DEEPSLATE] # Blocks that trigger the bonus drop: DIAMOND # Item dropped as bonus IRON: chance: 0.02 # 2% chance blocks: [STONE, DEEPSLATE, COBBLED_DEEPSLATE] drop: RAW_IRON GOLD: chance: 0.01 # 1% chance blocks: [STONE, DEEPSLATE, COBBLED_DEEPSLATE] drop: RAW_GOLD WHEAT: chance: 0.15 # 15% chance on crop harvest bonus-amount: 2 # Extra wheat dropped FISH: chance: 0.25 # 25% chance for bonus catch MOB: chance: 0.20 # 20% chance for extra mob from breeding FUEL: chance: 0.03 # 3% chance per qualifying block blocks: [STONE, DEEPSLATE, COBBLED_DEEPSLATE, NETHERRACK] ```

🌍 Wilderness Flags

```yaml wilderness: # Global rules for unclaimed (wilderness) land block-break: true # Allow block breaking in wilderness block-place: true # Allow block placing in wilderness pvp: true # Allow PvP in wilderness mob-spawning: true # Allow mob spawning in wilderness hostile-spawning: true # Allow hostile mob spawning in wilderness explosions: true # Allow explosions in wilderness fire-spread: true # Allow fire spread in wilderness ender-pearl: true # Allow ender pearl teleportation in wilderness chorus-fruit: true # Allow chorus fruit teleportation in wilderness ```

💾 Storage Backend

```yaml storage: type: sqlite # Storage type: yaml, sqlite, or mysql (⭐ mysql = premium) mysql: # ⭐ Premium Only — MySQL connection settings host: localhost # Database server hostname port: 3306 # Database server port database: peatowny # Database name username: root # Database username password: '' # Database password ```

🏛️ Nation Claims

```yaml nation-claims: max-claims: 3 # Maximum nation-level claim slots transfer-hours: 24 # Hours to complete a claim transfer ```

🤝 Relations (⭐ Premium)

```yaml relations: enabled: true # Enable the relations system cost: 0.0 # Economy cost to change a relation nation-auto-ally: true # Auto-ally lands within the same nation ```

🎨 GUI & Messages

```yaml command-aliases: # Define custom subcommand aliases lands: {} # Example: claim: ["takechunk", "grabland"] nations: {} # Example: create: ["nationmake"]

gui: text-style: normal # ⭐ Text style: 'normal' or 'smallcaps' (Unicode small capitals)

messages: prefix: "&8[&aPeaTowny&8] &7" # Chat message prefix for all plugin messages ```

---

🚀 Getting Started

1. 📥 Download PeaTowny from our PeaTowny 2. 📂 Drop the JAR into your server's `plugins/` folder 3. 🔄 Restart your server 4. 🎒 Players automatically receive a selection tool and claim block on first join 5. ✨ Use `/lands`, `/pea`, or `/town` to open the GUI

🔓 Upgrading to Premium

1. 🛒 Purchase from our all existing data is preserved 2. 🔄 Replace `PeaTowny-Free.jar` with the premium JAR 3. 🔁 Restart — all existing data is preserved 4. 🎉 Premium features unlock automatically, zero migration needed

---

💚 Support & Community

Need help? Have a suggestion? Want to grab Premium?

> 💬 Made with love by Pea Studios Made with love by Pea Studios > > 🌿 Made with love by Pea Studios

PeaTowny

PeaTowny

🗂️ Choose Your Edition

🎁 Free Edition

⭐ Premium Edition

🎁 Free Edition

🏠 Land Management

🌐 Public Warp System

👥 Members & Roles

🛡️ Protection

💰 Economy (Vault)

⚔️ War System (Kill Point Mode)

🎨 Visual & UI

🔧 Admin Tools

💾 Data & Storage

🔌 Integration

⭐ Premium Edition

🏛️ Nations

⚔️ Full Conquest War (Capture Mode)

📈 Land Levels

🤝 Relations

💎 Resource Nodes

🗂️ Sub-Areas

🏪 Rent & Sell

📦 Land Storage

🕊️ Fly

💸 Upkeep & Taxes

🗄️ MySQL Storage

✍️ Custom Messages

🎨 GUI Text Style

📥 Migration

🗺️ Minimap

📊 Free vs Premium at a Glance

📜 Commands

Main Commands (Multiple Aliases)

Land Subcommands

War Subcommands

Nation Subcommands *(Premium)*

Admin Subcommands

⚙️ Configuration Reference

🔧 Core Settings

🎛️ Feature Toggles

🌍 General Settings

💰 Economy Cycle

🏚️ Upkeep *(⭐ Premium)*

📋 Taxes *(⭐ Premium)*

🚀 Teleportation

⚔️ Combat Tag

🏠 Land Settings

📦 Chunk Settings

📐 Limits

✨ Visualization

⚔️ War Settings

killpoint = kills determine the winner

capture = chunk capturing determines the winner

CONTAINER_ACCESS, DOOR_USE, EXPLOSIONS

🏛️ Nation Settings *(⭐ Premium)*

📈 Land Levels *(⭐ Premium)*

🌿 Natural Flags

💎 Resources *(⭐ Premium)*

🌍 Wilderness Flags

💾 Storage Backend

🏛️ Nation Claims

🤝 Relations *(⭐ Premium)*

🎨 GUI & Messages

🚀 Getting Started

🔓 Upgrading to Premium

💚 Support & Community

Gallery

Versions

Nation Subcommands (Premium)

🏚️ Upkeep (⭐ Premium)

📋 Taxes (⭐ Premium)

🏛️ Nation Settings (⭐ Premium)

📈 Land Levels (⭐ Premium)

💎 Resources (⭐ Premium)

🤝 Relations (⭐ Premium)