L-claim

Minecraft 版本： 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2 26.2

平台： bukkit paper spigot

标签： adventure economy game-mechanics

L-Claim

Version: 1.3.1 | Minecraft: 1.20+ | Java: 17+

A feature-rich chunk-based town claim plugin with full diplomacy (war, alliances, pacts, embargoes), economy integration, auto-farming, bounties, granular permission management, chest locking, and a complete GUI system. Fully multilingual (English, Turkish, Spanish) with Dynmap and BlueMap support.

Table of Contents

• Features
• Commands
• Admin Commands
• Permissions
• Configuration
• Town Levels
• Farmer Levels
• War Schedule
• PlaceholderAPI
• Data Storage
• GUI Menus
• Dependencies
• Installation

Features

Town System

• Create, delete, rename, and manage towns with unique names
• 12 progression levels based on member count, each granting bonus chunk capacity
• Configurable name length, character restrictions, and max members
• Upkeep costs per chunk with automatic town deletion or chunk release on non-payment
• Town chat for private member communication
• Member and visitor spawn points
• MOTD and town policy (peaceful / neutral) settings
• Town For Sale: mayors can list their town on the town marketplace with a purchase price; buyers can purchase the town and take over as mayor

Land Claiming

• Chunk-based claiming system with adjacency requirements (configurable)
• Minimum distance enforcement between different towns
• Claim cost per chunk deducted from the town bank
• Blocked-world support (disable claiming in specific worlds)
• Configurable particle effects and sounds on claim
• Per-chunk unclaiming or mass unclaim-all

Protection

• Granular per-member permissions (33 permission types): build, break, interact, containers, doors, redstone, animals, monsters, vehicles, and more
• Per-town settings: PvP, mob spawning, fire spread, explosions, visitor permissions
• Per-chunk plot permissions — assign individual permission overrides per plot
• Visitors can be given separate build/break/interact/container permissions
• Trust system: give full access to non-members
• Keep inventory and XP on death inside own town claims
• Admin bypass mode for staff
• Alliance and pact members are treated as trusted in each other's towns

Diplomacy

• War: Declare war on other towns, scheduled war sessions with configurable days/times, points per kill, multi-session wars, daily tribute payments from losers to winners, losing town deletion on non-payment
• Conquered Towns: War winners conquer defeated towns; conquered towns pay daily chunk-based tribute and cannot declare war, make peace, or create pacts with their conqueror
• Peace: Send and accept/reject peace offers (2-minute expiry)
• Alliances: Invite, accept, and manage alliances; allied towns share building/interaction rights; auto-accept when both sides invite each other
• Non-Aggression Pacts: Paid agreements with configurable duration and cost; prevents war declarations; auto-expiry with refund protection
• Embargoes: declare economic embargoes on enemy towns, with daily or one-time chunk-based cost
• Money Transfers: send town bank funds to other towns via GUI with custom amount entry
• Diplomacy History: full audit log of war, peace, alliance, pact, and tribute events

Economy

• Vault-based economy integration
• Town creation cost, claim cost, and chunk upkeep deducted from player/town balances
• Town bank with deposit (any member) and withdraw (mayor only)
• Tax System: mayor sets a tax amount collected from members on a configurable interval
• Bank GUI shows estimated daily upkeep and war tribute income/expenses
• Admin commands for bank manipulation

Farmer System

• Purchasable auto-harvesting farmer for your town
• 10 upgrade levels with increasing capacity, range, and speed
• Harvests 14 crop types: wheat, carrot, potato, beetroot, nether wart, cocoa, melon, pumpkin, sweet berries, glow berries, cactus, sugar cane, bamboo, kelp
• Auto-collect drops within range
• Sell harvested items to town bank at configured prices
• Per-item collection toggle
• Stats tracking (daily, weekly, monthly, total production and earnings)
• Particle effects on harvest

Bounty System

• Place bounties on players from your personal balance
• Multiple bounties can stack on the same target
• Killer receives total bounty on the target's death
• GUI with sorting and filtering

Chest Lock

• Lock chests, trapped chests, and barrels using [lock] signs
• Only the owner and mayor can access locked containers
• Auto-cleared when chunks are unclaimed (even if the world is not loaded)

Fly & Map

• Toggle flight within your town's claimed area; auto-disabled when leaving
• GUI-based chunk map (9x9 grid) with color-coded territory and hover details

Web Maps

• Dynmap integration: flat shape markers for each town claim + POI spawn markers
• BlueMap integration: flat or 3D extruded claim shape markers + POI spawn markers
• Configurable layer name, priority, colors, opacity, labels, spawn markers, and shape-mode

Multi-Language

• Built-in English, Turkish, and Spanish translations
• All messages, GUI text, and placeholders are language-aware
• Easy to extend with additional language files

Other

• Offline notifications for events that happened while players were away
• Plugin statistics and bStats metrics
• Automatic version checker with in-game OP notifications
• Timestamped data backups

Commands

Player Commands (/town, alias /t or /kasaba)

Admin Commands

Admin Commands (/lclaim or /lc)

Permissions

Player Permissions

Admin Permissions

Setting / town policy / embargo / diplomacy management permissions (e.g. lclaim.admin.setlevel, lclaim.admin.backup, lclaim.admin.war, lclaim.admin.peace, lclaim.admin.pact, lclaim.admin.warsession, lclaim.admin.diplomacy) are checked through lclaim.admin and the corresponding admin command handler.

Configuration

config.yml

# Language: "tr", "en", or "es"
language: "en"

town:
  base-chunks: 4                  # Base chunk limit for all towns
  max-members: 20                 # Maximum members per town
  min-name-length: 3              # Minimum town name length
  max-name-length: 16             # Maximum town name length
  name-regex: "[a-zA-Z0-9_\\-]+"
  creation-cost: 500.0            # Town creation cost (from player balance)
  claim-cost: 100.0               # Per-chunk claim cost (from town bank)
  delete-on-insufficient-funds: true
  upkeep-per-chunk: 10.0          # Daily upkeep per chunk (0 = disable)
  upkeep-interval: 1440           # Upkeep check interval in minutes (0 = disable)
  tax-max-amount: 500             # Max tax a mayor can set (0 = disable tax system)
  tax-interval: 1440              # Tax collection interval in minutes
  max-motd-length: 255            # Maximum MOTD length
  require-adjacent-claims: true   # New claims must be adjacent
  min-distance-between-towns: 3   # Minimum chunk distance between towns
  blocked-worlds: []              # Worlds where claiming is disabled
  levels:
    1: { members-required: 1, bonus-chunks: 0 }
    2: { members-required: 3, bonus-chunks: 4 }
    3: { members-required: 4, bonus-chunks: 8 }
    4: { members-required: 5, bonus-chunks: 12 }
    5: { members-required: 6, bonus-chunks: 16 }
    6: { members-required: 8, bonus-chunks: 20 }
    7: { members-required: 10, bonus-chunks: 24 }
    8: { members-required: 12, bonus-chunks: 28 }
    9: { members-required: 14, bonus-chunks: 32 }
    10: { members-required: 16, bonus-chunks: 36 }
    11: { members-required: 18, bonus-chunks: 40 }
    12: { members-required: 20, bonus-chunks: 48 }

claim-effects:
  particles: true
  particle-type: "END_ROD"
  particle-duration: 6           # seconds
  sound: true
  sound-name: "ENTITY_EXPERIENCE_ORB_PICKUP"

protection:
  enabled: true                  # Master toggle
  mob-spawning: true             # Allow mob spawning in claims
  explosions: false              # Allow explosions in claims
  fire-spread: false             # Allow fire spread in claims
  prevent-pvp: false             # Prevent PvP in claims
  members-can-build: true        # Members can build/break
  keep-on-death: true            # Keep inventory/XP on death in own town

map:
  width: 9                       # Map width (odd recommended)
  height: 9                      # Map height (odd recommended)
  unclaimed-char: "□"
  your-town-char: "■"
  other-town-char: "▪"
  current-chunk-char: "✦"

database:
  type: "sqlite"                 # "sqlite", "mysql", or "mariadb"
  sqlite-file: "lclaim.db"
  mysql:
    host: "localhost"
    port: 3306
    database: "lclaim"
    username: "root"
    password: ""
    use-ssl: false
    verify-server-certificate: false
    allow-public-key-retrieval: false

history:
  enabled: true
  retention-days: 30

economy:
  enabled: true                  # Requires Vault

chest-lock:
  enabled: true

farmer:
  enabled: true
  buy-cost: 10000                # Farmer purchase cost (from town bank)
  particle-effects: true
  auto-collect-items: true
  prices:
    wheat: 5.0
    carrot: 8.0
    potato: 7.0
    beetroot: 10.0
    nether-wart: 15.0
    melon: 6.0
    pumpkin: 12.0
    cocoa: 20.0
    sugar-cane: 4.0
    cactus: 3.0
    sweet-berry: 12.0
    bamboo: 3.0
    kelp: 2.0

war:
  enabled: true
  broadcast-session-messages: true
  boss-bar: true
  sessions-per-war: 3
  points-per-kill: 5
  daily-fee-per-chunk: 10.0
  timezone: ""                   # e.g. "UTC", "Europe/Istanbul"; empty = system default
  schedule:
    days: [MONDAY, TUESDAY, WEDNESDAY]
    start-hour: 21
    start-minute: 0
    end-hour: 22
    end-minute: 0

embargo:
  enabled: true
  cost-per-chunk: 5.0
  payment-mode: "daily"          # "daily" or "one-time"

policy:
  enabled: true
  peaceful-cost: 5000.0
  peaceful-upkeep-multiplier: 2.0
  cooldown-days: 5

notifications:
  offline-notifications: true

version-check:
  enabled: true
  notify-on-join: true

misc:
  debug: false
  auto-save: 5                   # Auto-save interval in minutes

dynmap:
  enabled: true
  layer-name: "L-Claim Kasabalari"
  layer-priority: 10
  fill-color: "00FF00"
  line-color: "004400"
  fill-opacity: 0.6
  line-opacity: 1.0
  line-weight: 3
  show-labels: true
  show-spawn-markers: true
  update-interval: 300

bluemap:
  enabled: true
  layer-name: "L-Claim Kasabalari"
  layer-priority: 10
  fill-color: "00FF00"
  line-color: "004400"
  fill-opacity: 0.6
  line-opacity: 1.0
  line-weight: 3
  show-labels: true
  show-spawn-markers: true
  update-interval: 300
  shape-mode: "extruded"          # "extruded" or "flat"
  shape-y: 64.0
  extrude-min-y: 64.0
  extrude-max-y: 256.0
  depth-test: false

bstats:
  enabled: true

Town Levels

Max Chunks Formula: base-chunks + level-bonus

Farmer Levels

Harvestable Crops

Wheat, Carrots, Potatoes, Beetroots, Nether Wart, Cocoa, Melon, Pumpkin, Sweet Berries, Glow Berries, Cactus, Sugar Cane, Bamboo, Kelp.

War Schedule

War sessions follow a configurable weekly schedule:

war:
  timezone: ""                   # Empty = server system timezone
  schedule:
    days: [MONDAY, TUESDAY, WEDNESDAY]
    start-hour: 21
    start-minute: 0
    end-hour: 22
    end-minute: 0

• Sessions run simultaneously for all at-war pairs during the configured time window
• Multiple sessions per war (sessions-per-war: 3)
• Points are earned from kills during active sessions (points-per-kill: 5)
• After all sessions, the winner is determined by total points
• The loser pays daily-fee-per-chunk each day until the tribute is fully paid
• If the loser cannot pay, their town is automatically deleted
• War winners conquer the defeated town; conquered towns appear in a dedicated diplomacy menu showing conquered date, daily tribute, points, kills, and deaths
• Conquered towns cannot declare war, request peace, or create pacts with their conqueror
• The loser's chunk count is used to calculate the daily tribute fee
• A boss bar displays war info during active sessions
• Embargoes can additionally be declared on enemy towns (daily or one-time chunk-based cost)

PlaceholderAPI

All placeholders use the %lclaim_ prefix.

Data Storage

L-Claim supports SQLite (default) and MySQL/MariaDB backends. Older YAML storage has been replaced by relational SQL storage.

SQLite (Recommended)

• File-based (plugins/L-Claim/lclaim.db)

MySQL / MariaDB

• Recommended for shared/large servers
• Configure connection in config.yml

Configure the backend in config.yml:

database:
  type: "sqlite"   # or "mysql" / "mariadb"
  sqlite-file: "lclaim.db"
  mysql:
    host: "localhost"
    port: 3306
    database: "lclaim"
    username: "root"
    password: ""

Backup

• Use /lclaim backup to create timestamped backups in plugins/L-Claim/backups/
• Automatic periodic saving (misc.auto-save)

GUI Menus

The plugin features a complete inventory GUI (accessible via /town):

All GUI menus automatically support English, Turkish, and Spanish text based on the configured language.

Dependencies

Installation

1. Download the latest L-Claim.jar from the releases page.
2. Place the JAR in your server's plugins/ folder.
3. Restart your server (or use /reload confirm).
4. Edit plugins/L-Claim/config.yml to your preferences.
5. Use /lc reload to apply configuration changes.

Support

discord: squezsaz