🌿 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 ↓

⭐ Premium Edition The complete experience — nations, conquest wars, levels, sub-areas, rent, fly, and much more. Jump to Premium Features ↓

---

🎁 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.<n>, peatowny.lands.<n>, peatowny.members.<n> |

💾 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

---

🏛️ 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 <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

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

🎛️ Feature Toggles

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

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

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)

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)

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

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

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

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

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

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

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

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)

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)

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

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)

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

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

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

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

🤝 Relations (⭐ Premium)

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

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
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
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

🌿 Made with love by Pea Studios