🌿 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

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 ↓

⭐ 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

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

🔓 Upgrading to Premium

🛒 Purchase from our Discord
🔄 Replace PeaTowny-Free.jar with the premium JAR
🔁 Restart — all existing data is preserved
🎉 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

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

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

Совместимость

Minecraft: Java Edition

Платформы

Поддерживаемые окружения

Ссылки

Детали