# L-Claim<\/p>\n
**Version:** 1.2.2 | **Minecraft:** 1.20+ | **Java:** 17+<\/p>\n
A feature-rich chunk-based town claim plugin with full diplomacy (war, alliances, pacts), economy integration, auto-farming, bounties, granular permission management, chest locking, and a complete GUI system.<\/p>\n
—<\/p>\n
## Features<\/p>\n
### Town System
\n– Create, delete, rename, and manage towns with unique names
\n– 12 progression levels based on member count, each granting bonus chunk capacity
\n– Configurable name length, character restrictions, and max members
\n– Upkeep costs per chunk with automatic town deletion or chunk release on non-payment
\n– Town chat for private member communication
\n– Member and visitor spawn points<\/p>\n
### Land Claiming
\n– Chunk-based claiming system with adjacency requirements (configurable)
\n– Minimum distance enforcement between different towns
\n– Claim cost per chunk deducted from the town bank
\n– Blocked-world support (disable claiming in specific worlds)
\n– Configurable particle effects and sounds on claim
\n– Per-chunk unclaiming or mass unclaim-all<\/p>\n
### Protection
\n– Granular per-member permissions (33 permission types): build, break, interact, containers, doors, redstone, PvP, vehicles, and more
\n– Per-town settings: PvP, mob spawning, fire spread, explosions, visitor permissions
\n– Visitors can be given separate build\/break\/interact\/container permissions
\n– Trust system: give full access to non-members
\n– Keep inventory on death inside own town claims
\n– Admin bypass mode for staff
\n– Alliance and pact members are treated as trusted in each other’s towns<\/p>\n
### Diplomacy
\n– **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
\n– **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
\n– **Peace:** Send and accept\/reject peace offers (2-minute expiry)
\n– **Alliances:** Invite, accept, and manage alliances; allied towns share building\/interaction rights; auto-accept when both sides invite each other
\n– **Non-Aggression Pacts:** Paid agreements with configurable duration and cost; prevents war declarations; auto-expiry with refund protection
\n– **Money Transfers:** Send town bank funds to other towns via GUI with custom amount entry<\/p>\n
### Economy
\n– Vault-based economy integration
\n– Town creation cost, claim cost, and chunk upkeep deducted from player\/town balances
\n– Town bank with deposit (any member) and withdraw (mayor only)
\n– Bank info GUI shows estimated daily upkeep and war tribute income\/expenses
\n– Admin commands for bank manipulation<\/p>\n
### Farmer System
\n– Purchaseable auto-harvesting farmer for your town
\n– 10 upgrade levels with increasing capacity, range, and speed
\n– Harvests 14 crop types: wheat, carrot, potato, beetroot, nether wart, cocoa, melon, pumpkin, sweet berries, glow berries, cactus, sugar cane, bamboo, kelp
\n– Auto-collect drops within range
\n– Sell harvested items to town bank at configured prices
\n– Per-item collection toggle
\n– Stats tracking (daily, weekly, monthly, total production and earnings)
\n– Particle effects on harvest<\/p>\n
### Bounty System
\n– Place bounties on players from your personal balance
\n– Multiple bounties can stack on the same target
\n– Killer receives total bounty on target’s death
\n– GUI with sorting and filtering<\/p>\n
### Chest Lock
\n– Lock chests, trapped chests, and barrels using `[lock]` signs
\n– Only the owner and mayor can access locked containers
\n– Auto-cleared when chunks are unclaimed<\/p>\n
### Fly System
\n– Toggle flight within your town’s claimed area
\n– Auto-disabled when leaving town territory<\/p>\n
### Chunk Map
\n– GUI-based visual map (9×5 grid) of surrounding chunks
\n– Color-coded: your town, other towns, unclaimed, current position
\n– Hover for town details<\/p>\n
### Multi-Language
\n– Built-in English and Turkish translations
\n– All messages, GUI text, and placeholders are language-aware
\n– Easy to extend with additional language files<\/p>\n
### Admin Tools
\n– Force claim\/unclaim any chunk
\n– Force delete any town
\n– Purge all towns belonging to a player
\n– Override town levels
\n– Protection bypass mode
\n– Data backup with timestamps
\n– Plugin statistics
\n– Town level override
\n– GUI-based admin town list with search and detail view
\n– Force war declaration between towns
\n– Force peace between towns
\n– Create and cancel non-aggression pacts between towns
\n– Start\/stop war sessions
\n– View diplomatic relations of any town<\/p>\n
—<\/p>\n
## Commands<\/p>\n
### Player Commands (`\/town`)<\/p>\n
| Alias | Command | Description | Permission | ### Admin Commands (`\/lclaim` or `\/lc`)<\/p>\n | Command | Description | Permission | —<\/p>\n ## Permissions<\/p>\n | Permission | Default | Description | —<\/p>\n ## Installation<\/p>\n 1. Download the latest `L-Claim.jar` from the releases page. —<\/p>\n ## Configuration<\/p>\n ### `config.yml`<\/p>\n “`yaml # Language setting: “tr” for Turkish, “en” for English # Town Settings # Town Level System # Require new claims to be adjacent to existing claimed chunks # Minimum chunk distance between different towns (0 = disabled) # Worlds where chunk claiming is disabled (empty list = all worlds allowed) # Claim particles & sound effect # Protection Settings # Map Settings # Database Settings # Economy Settings (requires Vault) # Chest Lock System # Farmer System # War Settings # Miscellaneous “`<\/p>\n —<\/p>\n ## Town Levels<\/p>\n | Level | Members Required | Bonus Chunks | **Max Chunks Formula:** `base-chunks + level-bonus`<\/p>\n —<\/p>\n ## Farmer Levels<\/p>\n | Level | Upgrade Cost | Capacity | Range | Harvest Interval | ### Harvestable Crops —<\/p>\n ## War Schedule<\/p>\n War sessions follow a configurable weekly schedule:<\/p>\n “`yaml – Sessions run **simultaneously** for all at-war pairs during the configured time window —<\/p>\n ## PlaceholderAPI<\/p>\n All placeholders use the `%lclaim_` prefix.<\/p>\n | Placeholder | Description | —<\/p>\n ## Data Storage<\/p>\n L-Claim supports two storage backends:<\/p>\n ### SQLite (Recommended) ### YAML Switch between backends in `config.yml`: ### Backup —<\/p>\n ## GUI Menus<\/p>\n The plugin features a full inventory GUI system accessible via `\/town`:<\/p>\n | Menu | Description | All GUI menus support both English and Turkish text based on the configured language.<\/p>\n —<\/p>\n ## Support<\/p>\n discord: squezsaz<\/p>\n","protected":false},"excerpt":{"rendered":" L-Claim is a chunk-based town claim system developed for Minecraft servers. Players can establish their own towns, protect their land, manage members, and customize their communities with an advanced permission system.<\/p>\n","protected":false},"featured_media":91380,"template":"","meta":{"_minecraft_slug":"l-claim","_minecraft_project_id":"cSxkjuMD","_minecraft_author":"squezsaz","_minecraft_license":"MIT","_minecraft_downloads":29,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"l-claim.zip","_minecraft_size_bytes":1327275,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-15T22:15:28.613080Z","_minecraft_date_created":"2026-04-12T00:10:50.157915Z","_minecraft_date_modified":"2026-05-13T17:30:59.760089Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/l-claim","_minecraft_icon_attachment_id":91380,"_minecraft_imported_at":"2026-06-05T05:18:54+00:00","_minecraft_import_hash":"c61455fca9a289fe4e575b52d497e448","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,844,88,89,126,127,129],"mod_loader":[130,132,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-91379","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-economy","mod_category-equipment","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|—|—|—|—|
\n| `\/town create
\n| `\/town delete` | `\/town sil` | Delete your town (requires confirmation) | `lclaim.town.delete` |
\n| `\/town claim` | `\/town talep` | Claim current chunk | `lclaim.town.claim` |
\n| `\/town unclaim` | `\/town birak` | Unclaim current chunk | `lclaim.town.unclaim` |
\n| `\/town unclaim all` | `\/town birak hepsi` | Unclaim all chunks | `lclaim.town.unclaim` |
\n| `\/town info [town]` | `\/town bilgi` | View town information | `lclaim.town.info` |
\n| `\/town list [page]` | `\/town liste` | List all towns | `lclaim.town.list` |
\n| `\/town invite
\n| `\/town accept` | `\/town kabul` | Accept an invitation | \u2014 |
\n| `\/town decline` | `\/town red` | Decline an invitation | \u2014 |
\n| `\/town kick
\n| `\/town leave` | `\/town ayril` | Leave your town | \u2014 |
\n| `\/town transfer
\n| `\/town deposit
\n| `\/town withdraw
\n| `\/town set name
\n| `\/town set spawn` | \u2014 | Set member spawn | \u2014 |
\n| `\/town set visitor-spawn` | `\/town set ziyaretci-spawn` | Set visitor spawn | \u2014 |
\n| `\/town spawn [town]` | \u2014 | Teleport to spawn | \u2014 |
\n| `\/town map` | `\/town harita` | Open chunk map | `lclaim.town.map` |
\n| `\/town fly` | `\/town uc` | Toggle flight | `lclaim.town.fly` |
\n| `\/town chat` | `\/town sohbet` | Toggle town chat mode | \u2014 |
\n| `\/town trust add
\n| `\/town trust remove
\n| `\/town alliance-accept
\n| `\/town alliance-reject
\n| `\/town pact-accept
\n| `\/town pact-reject
\n| `\/town war info` | `\/town savas info` | View war information | \u2014 |
\n| `\/town war next-session` | \u2014 | View next war session info | \u2014 |
\n| `\/town help` | `\/town yardim` | Show command help | \u2014 |<\/p>\n
\n|—|—|—|
\n| `\/lc reload` | Reload configuration | `lclaim.admin.reload` |
\n| `\/lc info
\n| `\/lc list` | List all towns | `lclaim.admin.list` |
\n| `\/lc stats` | View plugin statistics | `lclaim.admin.stats` |
\n| `\/lc forceclaim
\n| `\/lc forceunclaim` | Force unclaim current chunk | `lclaim.admin.forceunclaim` |
\n| `\/lc forcedelete
\n| `\/lc bypass` | Toggle protection bypass | `lclaim.admin.bypass` |
\n| `\/lc setbalance
\n| `\/lc addbalance
\n| `\/lc removebalance
\n| `\/lc teleport
\n| `\/lc purge
\n| `\/lc clearinvites` | Clear pending invites | `lclaim.admin.clearinvites` |
\n| `\/lc setlevel
\n| `\/lc backup` | Backup data to `\/backups\/` | `lclaim.admin.backup` |
\n| `\/lc town` | Open GUI-based admin town list | `lclaim.admin.town` |
\n| `\/lc war
\n| `\/lc peace
\n| `\/lc pact
\n| `\/lc pact cancel
\n| `\/lc warsession
\n| `\/lc warsession startall` | Start all pending war sessions | `lclaim.admin.warsession` |
\n| `\/lc warsession stopall` | Stop all active war sessions | `lclaim.admin.warsession` |
\n| `\/lc diplomacy
\n| ` [NEW] \/lc saveall` | Manually saves new data to the database |<\/p>\n
\n|—|—|—|
\n| `lclaim.town.create` | `true` | Create a town |
\n| `lclaim.town.delete` | `true` | Delete your town |
\n| `lclaim.town.claim` | `true` | Claim chunks |
\n| `lclaim.town.unclaim` | `true` | Unclaim chunks |
\n| `lclaim.town.invite` | `true` | Invite players |
\n| `lclaim.town.kick` | `true` | Kick players |
\n| `lclaim.town.info` | `true` | View town info |
\n| `lclaim.town.list` | `true` | List towns |
\n| `lclaim.town.map` | `true` | View chunk map |
\n| `lclaim.town.fly` | `op` | Toggle flight in your town |
\n| `lclaim.town.deposit` | `true` | Deposit to town bank |
\n| `lclaim.town.withdraw` | `op` | Withdraw from town bank |
\n| `lclaim.admin` | `op` | Admin command access |
\n| `lclaim.admin.*` | `op` | All admin sub-permissions |
\n| `lclaim.admin.town` | `op` | Open admin town list GUI |
\n| `lclaim.admin.reload` | `op` | Reload configuration |
\n| `lclaim.admin.info` | `op` | View town info |
\n| `lclaim.admin.list` | `op` | List towns |
\n| `lclaim.admin.stats` | `op` | View statistics |
\n| `lclaim.admin.forceclaim` | `op` | Force claim chunks |
\n| `lclaim.admin.forceunclaim` | `op` | Force unclaim chunks |
\n| `lclaim.admin.forcedelete` | `op` | Force delete towns |
\n| `lclaim.admin.bypass` | `op` | Protection bypass |
\n| `lclaim.admin.setbalance` | `op` | Set town bank balance |
\n| `lclaim.admin.addbalance` | `op` | Add money to town bank |
\n| `lclaim.admin.removebalance` | `op` | Remove money from town bank |
\n| `lclaim.admin.teleport` | `op` | Teleport to town spawn |
\n| `lclaim.admin.purge` | `op` | Purge player towns |
\n| `lclaim.admin.clearinvites` | `op` | Clear invites |
\n| `lclaim.admin.setlevel` | \u2014 | Set town level (not in plugin.yml) |
\n| `lclaim.admin.backup` | \u2014 | Create backup (not in plugin.yml) |
\n| `lclaim.admin.warsession` | \u2014 | Manage war sessions (not in plugin.yml) |
\n| `lclaim.admin.war` | \u2014 | Force declare war (not in plugin.yml) |
\n| `lclaim.admin.peace` | \u2014 | Force peace (not in plugin.yml) |
\n| `lclaim.admin.pact` | \u2014 | Manage pacts (not in plugin.yml) |
\n| `lclaim.admin.diplomacy` | \u2014 | View diplomacy (not in plugin.yml) |<\/p>\n
\n2. Place the JAR file in your server’s `plugins\/` folder.
\n3. Restart your server (or use `\/reload confirm`).
\n4. Edit `plugins\/L-Claim\/config.yml` to your preferences.
\n5. Use `\/lc reload` to apply configuration changes.<\/p>\n
\n# L-Claim Configuration File
\n# ================================<\/p>\n
\nlanguage: “en”<\/p>\n
\ntown:
\n # Base chunk limit for all towns
\n base-chunks: 4
\n # Maximum members in a town
\n max-members: 20
\n # Minimum town name length
\n min-name-length: 3
\n # Maximum town name length
\n max-name-length: 16
\n # Allowed characters in town name (regex)
\n name-regex: “[a-zA-Z0-9_\\-]+”
\n # Cost to create a town (requires Vault)
\n creation-cost: 500.0
\n # Cost per chunk claim \u2014 pulled from town bank (0 = free)
\n # Claim cost is NOT a reason to delete the town. Town is only deleted on upkeep failure.
\n claim-cost: 100.0
\n # Delete on insufficient upkeep funds (NOT on claim cost failure)
\n delete-on-insufficient-funds: true
\n # Daily upkeep cost per chunk (0 to disable)
\n upkeep-per-chunk: 10.0
\n # Upkeep check interval in minutes (0 to disable)
\n upkeep-interval: 1440<\/p>\n
\n # Each level requires a certain number of members and gives bonus chunks
\n levels:
\n 1:
\n members-required: 1
\n bonus-chunks: 0
\n 2:
\n members-required: 3
\n bonus-chunks: 4
\n 3:
\n members-required: 4
\n bonus-chunks: 8
\n 4:
\n members-required: 5
\n bonus-chunks: 12
\n 5:
\n members-required: 6
\n bonus-chunks: 16
\n 6:
\n members-required: 8
\n bonus-chunks: 20
\n 7:
\n members-required: 10
\n bonus-chunks: 24
\n 8:
\n members-required: 12
\n bonus-chunks: 28
\n 9:
\n members-required: 14
\n bonus-chunks: 32
\n 10:
\n members-required: 16
\n bonus-chunks: 36
\n 11:
\n members-required: 18
\n bonus-chunks: 40
\n 12:
\n members-required: 20
\n bonus-chunks: 48<\/p>\n
\n # First claim is always free (the town founding chunk)
\n require-adjacent-claims: true<\/p>\n
\n # Example: 3 means towns must be at least 3 chunks apart
\n min-distance-between-towns: 3<\/p>\n
\n # Example: [“world_nether”, “world_the_end”]
\n blocked-worlds: []<\/p>\n
\nclaim-effects:
\n # Play particle effect when claiming a chunk
\n particles: true
\n # Particle type (FLAME, HAPPY_VILLAGER, END_ROD, VILLAGER_HAPPY, etc.)
\n particle-type: “END_ROD”
\n # How long particles stay visible (in seconds)
\n particle-duration: 6
\n # Play sound when claiming
\n sound: true
\n # Sound name (ENTITY_EXPERIENCE_ORB_PICKUP, BLOCK_NOTE_BLOCK_CHIME, etc.)
\n sound-name: “ENTITY_EXPERIENCE_ORB_PICKUP”<\/p>\n
\nprotection:
\n # Protect claimed chunks from non-members
\n enabled: true
\n # Allow mob spawning in claimed chunks (global fallback, per-town overrides this)
\n mob-spawning: true
\n # Allow explosions in claimed chunks
\n explosions: false
\n # Allow fire spread in claimed chunks
\n fire-spread: false
\n # Prevent PvP in claimed chunks
\n prevent-pvp: false
\n # Allow members to build\/break
\n members-can-build: true
\n # Keep inventory and XP on death inside claimed chunks
\n keep-on-death: true<\/p>\n
\nmap:
\n # Map width (odd number recommended)
\n width: 9
\n # Map height (odd number recommended)
\n height: 9
\n # Character for unclaimed chunks
\n unclaimed-char: “\u25a1”
\n # Character for your town chunks
\n your-town-char: “\u25a0”
\n # Character for other town chunks
\n other-town-char: “\u25aa”
\n # Character for current chunk
\n current-chunk-char: “\u2726”<\/p>\n
\ndatabase:
\n # Storage type: “yaml” or “sqlite”
\n type: “sqlite”
\n # SQLite file name
\n sqlite-file: “lclaim.db”<\/p>\n
\neconomy:
\n enabled: true<\/p>\n
\nchest-lock:
\n # Enable\/disable chest lock system
\n enabled: true<\/p>\n
\nfarmer:
\n # Enable\/disable farmer system
\n enabled: true
\n # Cost to buy a farmer
\n buy-cost: 10000
\n # Enable particle effects when harvesting
\n particle-effects: true
\n # Auto collect dropped items within range (if item collecting is enabled)
\n auto-collect-items: true
\n # Item prices for selling
\n prices:
\n wheat: 5.0
\n carrot: 8.0
\n potato: 7.0
\n beetroot: 10.0
\n nether-wart: 15.0
\n melon: 6.0
\n pumpkin: 12.0
\n cocoa: 20.0
\n sugar-cane: 4.0
\n cactus: 3.0
\n sweet-berry: 12.0
\n bamboo: 3.0
\n kelp: 2.0<\/p>\n
\nwar:
\n # Broadcast war session start\/end messages to all players
\n broadcast-session-messages: true
\n # Show boss bar with war info during active sessions
\n boss-bar: true
\n # Number of sessions per war
\n sessions-per-war: 3
\n # Points awarded per kill
\n points-per-kill: 5
\n # Daily fee per chunk that the loser pays to the winner
\n daily-fee-per-chunk: 10.0
\n # Timezone for war schedule (empty = system default, e.g. “UTC”, “Europe\/Istanbul”, “America\/New_York”)
\n timezone: “”
\n # War schedule \u2014 sessions happen on configured days at specified time range
\n schedule:
\n # Days of the week (MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY)
\n days: [MONDAY, TUESDAY, WEDNESDAY]
\n # Session start time (24-hour format)
\n start-hour: 21
\n start-minute: 0
\n # Session end time (24-hour format)
\n end-hour: 22
\n end-minute: 0<\/p>\n
\nmisc:
\n # Enable debug logging
\n debug: false
\n # Auto-save interval in minutes
\n auto-save: 5<\/p>\n
\n|——-|—————–|————–|
\n| 1 | 1 | 0 |
\n| 2 | 3 | 4 |
\n| 3 | 4 | 8 |
\n| 4 | 5 | 12 |
\n| 5 | 6 | 16 |
\n| 6 | 8 | 20 |
\n| 7 | 10 | 24 |
\n| 8 | 12 | 28 |
\n| 9 | 14 | 32 |
\n| 10 | 16 | 36 |
\n| 11 | 18 | 40 |
\n| 12 | 20 | 48 |<\/p>\n
\n|——-|————-|———-|——-|—————–|
\n| 1 | Free | 500 | 10 blocks | 5.0s |
\n| 2 | 2,000 | 750 | 12 | 4.5s |
\n| 3 | 5,000 | 1,000 | 15 | 4.0s |
\n| 4 | 10,000 | 1,500 | 18 | 3.5s |
\n| 5 | 20,000 | 2,000 | 22 | 3.0s |
\n| 6 | 40,000 | 3,000 | 26 | 2.5s |
\n| 7 | 75,000 | 4,000 | 32 | 2.0s |
\n| 8 | 125,000 | 5,000 | 40 | 1.5s |
\n| 9 | 200,000 | 7,000 | 50 | 1.2s |
\n| 10 | 300,000 | 10,000 | 60 | 1.0s |<\/p>\n
\nWheat, Carrots, Potatoes, Beetroots, Nether Wart, Cocoa, Melon, Pumpkin, Sweet Berries, Glow Berries, Cactus, Sugar Cane, Bamboo, Kelp.<\/p>\n
\nwar:
\n timezone: “” # Empty = server system timezone
\n schedule:
\n days: [MONDAY, TUESDAY, WEDNESDAY]
\n start-hour: 21
\n start-minute: 0
\n end-hour: 22
\n end-minute: 0
\n“`<\/p>\n
\n– Multiple sessions per war (`sessions-per-war: 3`)
\n– Points are earned from kills during active sessions (`points-per-kill: 5`)
\n– After all sessions, the winner is determined by total points
\n– The loser pays `daily-fee-per-chunk` each day until the tribute is fully paid
\n– If the loser cannot pay, their town is automatically deleted
\n– War winners **conquer** the defeated town; conquered towns appear in a dedicated diplomacy menu showing conquered date, daily tribute, points, kills, and deaths
\n– Conquered towns cannot declare war, request peace, or create pacts with their conqueror
\n– The loser’s chunk count is used to calculate the daily tribute fee<\/p>\n
\n|—|—|
\n| `%lclaim_town_name%` | Player’s town name (or “None”) |
\n| `%lclaim_town_mayor%` | Town mayor name |
\n| `%lclaim_town_members%` | Member count |
\n| `%lclaim_town_max_members%` | Max member count |
\n| `%lclaim_town_chunks%` | Claimed chunk count |
\n| `%lclaim_town_max_chunks%` | Max chunk count |
\n| `%lclaim_town_bank%` | Town bank balance |
\n| `%lclaim_town_balance_formatted%` | Formatted bank balance |
\n| `%lclaim_town_pvp%` | PvP status (Enabled\/Disabled) |
\n| `%lclaim_town_pvp_status%` | PvP status (true\/false) |
\n| `%lclaim_town_visitors%` | Visitor status (Enabled\/Disabled) |
\n| `%lclaim_town_visitor_status%` | Visitor status (true\/false) |
\n| `%lclaim_town_fire%` | Fire spread status |
\n| `%lclaim_town_explosions%` | Explosions status |
\n| `%lclaim_town_mob_spawning%` | Mob spawning status |
\n| `%lclaim_town_world%` | Town’s world |
\n| `%lclaim_town_founded%` | Founded date |
\n| `%lclaim_town_is_mayor%` | Is player mayor? (true\/false) |
\n| `%lclaim_town_is_member%` | Is player member? (true\/false) |
\n| `%lclaim_town_is_trusted%` | Is player trusted? (true\/false) |
\n| `%lclaim_town_trusted_count%` | Trusted player count |
\n| `%lclaim_town_level%` | Town level |
\n| `%lclaim_in_claimed_chunk%` | Is player in a claimed chunk? |
\n| `%lclaim_in_own_town%` | Is player in their own town? |
\n| `%lclaim_chunk_town_name%` | Town name of current chunk |
\n| `%lclaim_chunk_town_pvp%` | PvP status of current chunk’s town |
\n| `%lclaim_total_towns%` | Total towns on the server |
\n–NEW– \u2193\u2193\u2193
\n| `%lclaim_town_war_count%` | Active war count | `2` |
\n| `%lclaim_town_alliance_count%` | Alliance count | `1` |
\n| `%lclaim_town_pact_count%` | Non-aggression pact count | `3` |
\n| `%lclaim_town_is_at_war%` | Is at war? | `Yes` \/ `No` |
\n| `%lclaim_town_war_list%` | List of towns at war (comma separated) | `Rome, Sparta` |
\n| `%lclaim_town_alliance_list%` | Allied towns | `Athens` |
\n| `%lclaim_town_pact_list%` | Towns with pacts | `Carthage, Egypt` |
\n| `%lclaim_town_conquered_count%` | Conquered town count | `1` |
\n| `%lclaim_town_conquered_list%` | Conquered towns | `Troy` |
\n| `%lclaim_town_has_active_war_session%` | Has active war session? | `Yes` \/ `No` |
\n| `%lclaim_town_daily_upkeep%` | Daily upkeep cost | `150.00` |<\/p>\n
\n– File-based (`plugins\/L-Claim\/lclaim.db`)
\n– All data in relational tables with proper indexing
\n– Tables: `towns`, `town_members`, `town_trusted`, `claimed_chunks`, `town_permissions`, `town_settings`, `chest_locks`, `farmers`, `farmer_items`, `town_diplomacy`<\/p>\n
\n– File-based (`plugins\/L-Claim\/towns.yml`)
\n– Simpler but slower for large servers
\n– Single file stores all town data<\/p>\n
\n“`yaml
\ndatabase:
\n type: “sqlite” # or “yaml”
\n sqlite-file: “lclaim.db”
\n“`<\/p>\n
\nUse `\/lc backup` to create timestamped backups in `plugins\/L-Claim\/backups\/`.<\/p>\n
\n|—|—|
\n| **Town Main** | Town management hub \u2014 claim, unclaim, map, members, bank, settings, trust, farmer, bounty, diplomacy, level info, teleport, delete\/leave |
\n| **Members** | Member list with permission editor, kick, and transfer actions |
\n| **Invite** | Paginated list of online players to invite |
\n| **Bank** | Deposit\/withdraw with quick amounts and custom entry |
\n| **Town List** | Paginated list of all towns |
\n| **Map** | 9×5 chunk map with color-coded territory |
\n| **Permissions** | Granular permission editor with 33 permission types |
\n| **Settings** | Toggle PvP, mob spawning, fire, explosions, visitors |
\n| **Trust** | Trusted player management |
\n| **Bounty** | View, add, filter, and sort bounties |
\n| **Farmer** | Buy, upgrade, toggle items, sell, and view stats |
\n| **Diplomacy** | War, peace, alliance, pact, conquered towns, and money transfer menus |
\n| **Conquered Towns** | View conquered town details, daily tribute, and war statistics |
\n| **Admin Town List** | Browse all towns with pagination, search by name, and view member details |<\/p>\n