Logo
MINECRAFTBIBLE
Items
Items

All game items

Blocks
Blocks

Building blocks

Mobs
Mobs

Creatures & monsters

Biomes
Biomes

World biomes

Structures
Structures

Generated structures

Recipes
Recipes

Crafting guides

Advancements
Advancements

Achievements

Loot Tables
Loot Tables

Drop rates

Tags
Tags

Item groupings

All Versions
View all data →
Capes
Cape ArchiveNEW

Browse rare Minecon capes, OptiFine capes, and custom capes from players worldwide

Browse

Player Database
Player DatabasePopular

Search any player

Skin Browser
Skin Browser

Browse & download skins

Cape Gallery
Cape GalleryNEW

Minecon & OptiFine capes

Seed Vault
Seed Vault

Curated seeds

Learn

Guides
GuidesNew

Tutorials & tips

Blog
Blog

News & updates

Community

Community Hub
Community HubHub

Posts, discussions & more

All Versions
View community →
Seed Analyzer
Seed Analyzer

World seed analysis

Loot Explorer
Loot Explorer

Drop rates

Crafting Calculator
Crafting Calculator

Material planning

Enchant Calculator
Enchant Calculator

Probability math

Redstone Lab
Redstone Lab

Signal timing

Trading Profit
Trading Profit

Villager ROI

All Versions
View all tools →
Mods
Mods

Browse all mods

Plugins
Plugins

Server plugins

Resource Packs
Resource Packs

Textures & sounds

Shaders
Shaders

Visual enhancements

Datapacks
Datapacks

World logic

Scanner
Mod Intelligence

Scan & analyze any mod

All Versions
View all mods →
Loading...
IntroductionIntroductionVersion HistoryVersion HistoryGuidesGuidesBlog & NewsBlog & News
ItemsItemsBlocksBlocksMobsMobsRecipesRecipesBiomesBiomesStructuresStructuresAdvancementsAdvancementsLoot TablesLoot TablesTagsTags
ModsModsPluginsPluginsResource PacksResource PacksShadersShadersDatapacksDatapacks

MinecraftBible

The Ultimate Wiki

Logo
MINECRAFTBIBLE

The ultimate Minecraft reference. Every item, block, mob, and recipe documented with precision.

Community

  • Skin Browser
  • Cape Gallery
  • Seed Vault
  • Blog
  • Guides

Database

  • Items
  • Blocks
  • Mobs
  • Recipes
  • Biomes
  • Structures

Tools

  • Seed Analyzer
  • Mod Intelligence
  • Crafting Calculator
  • Enchant Calculator

Mods & Packs

  • Mods
  • Plugins
  • Resource Packs
  • Shaders
  • Datapacks

Site & Legal

  • About
  • Authors
  • Editorial Policy
  • Corrections
  • Contact
  • Privacy Policy
  • Terms of Service
  • DMCA
  • Sitemap

© 2026 MinecraftBible. Not affiliated with Mojang or Microsoft.

PrivacyTermsContact
PeaTowny
PluginLicenseRef-All-Rights-Reserved

PeaTowny

Minecrafts greatest Kingdoms and Towns plugin!

48
Downloads
1
Followers
3 months ago
Updated
📦
2
Versions
adventureeconomysocialbukkitpaperpurpurspigot
Download Latestv1.0.1View on Modrinth

📖About PeaTowny

Paper Java 21 Vault

🌿 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

  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

👥 Team & Contributors

No authors recorded.

⚙️ Compatibility

Environment
🖥️ Server-side
Loaders
bukkitpaperpurpurspigot
Minecraft Versions
1.211.21.11.21.21.21.31.21.41.21.51.21.61.21.7+4 more

🔗 Links

Modrinth Page