🌿 PeaTowny
The modern land-claiming & town management plugin.
Drop-in replacement for Towny & Lands — familiar /lands commands, zero learning curve.
💬 Discord ·
🎁 Free Edition ·
⭐ Premium Edition ·
⚙️ Config
---
## 🗂️ 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 ↓](#-free-edition)**
|
### ⭐ Premium Edition
The complete experience — nations, conquest wars,
levels, sub-areas, rent, fly, and much more.
**[Jump to Premium Features ↓](#-premium-edition)**
|
---
# 🎁 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/Leave** | Action bar notifications when crossing land borders |
| 🔔 **Beacons** | Each land gets a beacon at its home chunk |
| 🌈 **Beacon Color** | Customize your beacon's color through the GUI |
### 🔧 Admin Tools
| Feature | Details |
|:---|:---|
| 🛡️ **`/landadmin`** | Full admin management suite |
| 👁️ **Bypass Mode** | Admins bypass all land protections |
| 🏰 **Admin Lands** | Create server-protected areas (spawn, arenas) |
| ⚔️ **Force War** | `/landadmin forcewar` — declare war between any two lands |
| 🛑 **End War** | `/landadmin endwar` — force-end any active war |
| ⚙️ **Limits** | Chunk, land, and member limits via permissions |
| 🔑 **Permissions** | `peatowny.chunks.`, `peatowny.lands.`, `peatowny.members.` |
### 💾 Data & Storage
| Feature | Details |
|:---|:---|
| 📄 **YAML** | Simple file-based data, no setup required |
| 🗄️ **SQLite** | Lightweight database for better performance |
| 💾 **Auto-Save** | Data saved every 5 minutes automatically |
### 🔌 Integration
| Feature | Details |
|:---|:---|
| 💵 **Vault** | Full economy support |
| 🗺️ **Dynmap & BlueMap** | Land claims rendered on your web map |
| 💬 **Land Chat** | Private chat channel for land members |
---
# ⭐ Premium Edition
> **One-time purchase. Every feature unlocked.** Just swap the JAR — all your data carries over instantly. Premium includes **everything in Free** plus the features below.
> 🛒 **Get Premium →** [discord.gg/Y8QhgYaq6K](https://discord.gg/Y8QhgYaq6K)
---
### 🏛️ Nations
Group multiple lands into a powerful nation with shared governance, taxes, and diplomacy.
| Feature | Details |
|:---|:---|
| 👑 **Create Nations** | Form a nation from your level-5 capital land |
| 🏘️ **Member Lands** | Invite other lands to join your nation |
| 💸 **Nation Taxes** | Collect taxes from member lands |
| 🏚️ **Nation Upkeep** | Per-chunk upkeep for national territory |
| 🌐 **Nation Chat** | 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 |
|:---|:---|
| 🚩 **Chunk Capturing** | Place a capture fence in enemy territory and hold the chunk |
| 📊 **Boss Bar Progress** | Real-time capture progress visible to both sides |
| 🛡️ **Contestation** | Defenders entering a captured chunk pause the timer |
| 💥 **Beacon Win** | Capture the enemy's home beacon to win instantly |
| 🏳️ **Surrender & Tribute** | Losing side can surrender and pay up to 75% tribute |
| 🛡️ **War Shields** | Protection periods after creation, surrender, and war end |
| 💸 **Robbery** | 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 |
|:---|:---|
| 🟢 **Ally** | Shared protections between allied lands |
| ⚪ **Neutral** | Default relation |
| 🔴 **Enemy** | 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 |
|:---|:---|
| 🏚️ **Upkeep** | 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 **Lands** 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 ` | 🏗️ 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 ` | 💌 Invite a player |
| `/lands trust ` | ✅ Trust a player |
| `/lands untrust ` | ❌ Remove a player |
| `/lands setrole ` | 🎖️ 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 ` | 💰 Deposit to land bank |
| `/lands withdraw ` | 💰 Withdraw from land bank |
| `/lands balance` | 💰 Check land balance |
| `/lands rename ` | ✏️ 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 ` | 🏴 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 ` | 🔄 Transfer captured land |
### Nation Subcommands *(Premium)*
| Command | Description |
|:---|:---|
| `/nations create ` | 👑 Create a nation |
| `/nations invite ` | 💌 Invite a land to your nation |
| `/nations kick ` | ❌ 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 ` | 🗑️ Force delete a land |
| `/landadmin give ` | 🎁 Give claim chunks to a player |
| `/landadmin setowner ` | 👤 Change land owner |
| `/landadmin setresource ` | 💎 Set land resource type |
| `/landadmin forcewar ` | ⚔️ Force declare a war |
| `/landadmin endwar [winner]` | 🛑 Force end an active war |
| `/landadmin migrate ` | 📥 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.`, `peatowny.lands.`, `peatowny.members.`
### ✨ 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 [Discord](https://discord.gg/Y8QhgYaq6K)
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 [Discord](https://discord.gg/Y8QhgYaq6K)
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?
> 💬 **Discord:** [discord.gg/Y8QhgYaq6K](https://discord.gg/Y8QhgYaq6K)
>
> 🌿 **Made with love by Pea Studios**
11
