KnightTowns

# KnightTowns — Build, Expand and Rule Your Own Towns A lightweight yet powerful Minecraft town & economy plugin that lets players create and manage towns, claim land, trade items through GUIs and manage player and currency — all while keeping gameplay simple, fair and fun. ## Features ### Town System - Create, delete and manage towns - Rank-based permissions (TownMaster, Mayor, Assistant, Member, Visitor) - Persistent town data (reload & restart safe) - Chunk claiming system with protection - Visual chunk borders ### Raid System - Random town raid events - Raids can target towns with claimed chunks and online members - Multi-wave raids (3 waves of enemies) - Raid difficulty levels: EASY, NORMAL, HARD - Difficulty affects mob strength, mob count and XP rewards - Custom raid mobs (Zombies, Skeletons, Pillagers, Spiders) - Hard raids may spawn Vindicators and Witches - Unique mob names such as: - _Undead Zombie_ - _Vengeful Skeleton_ - _Elite Pillager_ - BossBar showing current raid wave and remaining mobs - Live raid progress updates - XP rewards for defenders and contributors ### Update Checker - Automatic update checker - Console notification when a new version is available - OP players receive update alerts when joining the server ### Player System - Player Info GUI (levels, XP, coins, rank) - Persistent player data (playerdata.yml) - XP & level tracking ### Economy System - Integrated coin-based economy - Persistent balances using BigDecimal (safe & accurate) - Admin money commands (set, give) - Unified balance system across shop, sell, and GUI ### Shop System - Fully GUI-based shop - Category-based navigation - Config-driven items & prices (shop.yml) - Buy items in single or bulk amounts - Supports multiple categories (Blocks, Ores, Farms, etc.) ### Sell Chest System - Open with **/sell** - Place items into a GUI chest - Items are auto-sold on close - Prices read directly from shop.yml - Instant coin payout ### Town Information GUI - View town stats, members, power and claims - Visual and interactive menus - Placeholder-based dynamic data ### Config Driven - Editable shop.yml - Safe reload handling - Missing keys auto-handled ### Raid Configuration Raids can be configured inside `config.yml`: ``` raids: enabled: true interval_ticks: 144000 ``` - **enabled** — Enable or disable random raids - **interval_ticks** — Time between raid attempts Default: `144000 ticks (~2 hours)` ## Commands Overview ### Town Commands - **/town create <name>** — Create a new town (OP or TownMaster only) - **/town delete <name>** — Delete a town - **/town list** — View all existing towns - **/town claim** — Claim your current chunk (Mayor only) - **/town info <name>** — View info of a town - **/town showborder** — Show your town’s border - **/town addmember <player>** — Add a player to your town - **/town removemember <player>** — Remove a member from your town - **/town setrank <player> <rank>** — Change a member’s rank ### Shop Commands - **/town shop** — Open the shop GUI - **/town sell** — Open the sell chest GUI ### Admin Economy Commands - **/town setmoney <player> <amount>** - **/town givemoney <player> <amount>** Use **/town help** to see the full command usage list. ## Ranks & Permissions - **TownMaster:** Full access to all commands. - **Mayor:** Can claim chunks, manage assistants/members. - **Assistant:** Can assist with daily town tasks. - **Member:** Normal player, can view town info. - **Visitor:** Non-member (no permissions). ## Data Storage KnightTowns uses multiple safe YAML files: - **towns.yml** — Towns, members, ranks and claimed chunks - **playerdata.yml** — Player XP, levels and coin balance - **shop.yml** — Shop categories, items buy & sell prices - **config.yml** — Plugin settings All files are: - Auto-generated - Reload-safe - Crash-resistant ## Example file structures: <details> <summary>config.yml</summary> ``` raids: enabled: true interval_ticks: 144000 ``` </details> <details> <summary>playerdata.yml</summary> ``` <uuid>: xp: 110 level: 2 balance: '1001' ``` </details> <details> <summary>towns.yml</summary> ``` townname: townmaster: <uuid> datecreated: dd-mm-yyyy hh:mm:ss claimedChunks: - world,10,15 - world,10,16 members: <uuid>: MAYOR <uuid>: MEMBER ``` </details> <details> <summary>shop.yml (default)</summary> ``` shop: title: §6§lKnightTowns Shop size: 36 categories: blocks: name: §fBlocks material: GRASS_BLOCK slot: 11 lore: - '' - §7Buy common and rare blocks - §eClick to view! ores: name: §fOres material: DIAMOND_ORE slot: 12 lore: - '' - §7Precious ores and rare materials - §eClick to view! farms: name: §f