🌿 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

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

🌐 Public Warp System

👥 Members & Roles

🛡️ Protection

💰 Economy (Vault)

⚔️ War System (Kill Point Mode)

🎨 Visual & UI

🔧 Admin Tools

💾 Data & Storage

🔌 Integration

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

⚔️ Full Conquest War (Capture Mode)

Transform combat into full-scale territorial warfare:

📈 Land Levels

Lands progress through 5 tiers as they grow:

🤝 Relations

💎 Resource Nodes

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

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

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

📜 Commands

Main Commands (Multiple Aliases)

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

Land Subcommands

War Subcommands

Nation Subcommands (Premium)

Admin Subcommands

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