L-claim

Version: 2. 0. 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)
• (#developers)
• (#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 `` 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: fla