KnightTowns

A lightweight plugin for managing towns, claiming land, assigning ranks and protecting areas with XP and level integration.

167
Download

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 ``` - interval_ticks — Enable or disable random raids - interval_ticks — Time between raid attempts Default: `144000 ticks (~2 hours)`

Commands Overview

Town Commands

- /town setrank <player> <rank> — Create a new town (OP or TownMaster only) - /town setrank <player> <rank> — Delete a town - /town setrank <player> <rank> — View all existing towns - /town setrank <player> <rank> — Claim your current chunk (Mayor only) - /town setrank <player> <rank> — View info of a town - /town setrank <player> <rank> — Show your town’s border - /town setrank <player> <rank> — Add a player to your town - /town setrank <player> <rank> — Remove a member from your town - /town setrank <player> <rank> — Change a member’s rank

Shop Commands

- /town sell — Open the shop GUI - /town sell — Open the sell chest GUI

Admin Economy Commands

- /town givemoney <player> <amount> - /town givemoney <player> <amount>

Use /town help to see the full command usage list.

Ranks & Permissions

- Visitor: Full access to all commands. - Visitor: Can claim chunks, manage assistants/members. - Visitor: Can assist with daily town tasks. - Visitor: Normal player, can view town info. - Visitor: Non-member (no permissions).

Data Storage

KnightTowns uses multiple safe YAML files:

- config.yml — Towns, members, ranks and claimed chunks - config.yml — Player XP, levels and coin balance - config.yml — Shop categories, items buy & sell prices - config.yml — Plugin settings

All files are: - Auto-generated - Reload-safe - Crash-resistant

Example file structures:

config.yml

``` raids: enabled: true interval_ticks: 144000 ```

playerdata.yml

``` <uuid>: xp: 110 level: 2 balance: '1001' ```

towns.yml

``` townname: townmaster: <uuid> datecreated: dd-mm-yyyy hh:mm:ss claimedChunks: - world,10,15 - world,10,16 members: <uuid>: MAYOR <uuid>: MEMBER ```

shop.yml (default)

``` 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: §fFarms material: WHEAT slot: 13 lore: - '' - §7Crops, seeds, and food supplies - §eClick to view!

foods: name: §fFoods material: APPLE slot: 14 lore: - '' - §7Food and Eatables - §eClick to view!

mobdrops: name: §fMob Drops material: ROTTEN_FLESH slot: 15 lore: - '' - §7Loot from various mobs - §eClick to view!

redstone: name: §fRedstone material: REDSTONE slot: 20 lore: - '' - §7Automation and machinery items - §eClick to view!

decorations: name: §fDecorations material: PAINTING slot: 22 lore: - '' - §7Aesthetic items for your builds - §eClick to view!

special: name: §fSpecial Items material: NETHER_STAR slot: 24 lore: - '' - §7Rare & unique magical items - §eClick to view!

items: blocks: - material: OAK_LOG name: Oak Log buy: 4 sell: 1 - material: SPRUCE_LOG name: Spruce Log buy: 4 sell: 1 - material: BIRCH_LOG name: Birch Log buy: 4 sell: 1 - material: JUNGLE_LOG name: Jungle Log buy: 4 sell: 1 - material: ACACIA_LOG name: Acacia Log buy: 4 sell: 1 - material: DARK_OAK_LOG name: Dark Oak Log buy: 4 sell: 1 - material: MANGROVE_LOG name: Mangrove Log buy: 5 sell: 1 - material: CHERRY_LOG name: Cherry Log buy: 5 sell: 1 - material: BAMBOO_BLOCK name: Bamboo Block buy: 5 sell: 1 - material: CRIMSON_STEM name: Crimson Stem buy: 6 sell: 2 - material: WARPED_STEM name: Warped Stem buy: 6 sell: 2 - material: STONE name: Stone buy: 1 sell: 0 - material: COBBLESTONE name: Cobblestone buy: 1 sell: 0 - material: ANDESITE name: Andesite buy: 1 sell: 0 - material: DIORITE name: Diorite buy: 1 sell: 0 - material: GRANITE name: Granite buy: 1 sell: 0 - material: TUFF name: Tuff buy: 2 sell: 1 - material: CALCITE name: Calcite buy: 2 sell: 1 - material: OBSIDIAN name: Obsidian buy: 15 sell: 7 - material: PUMPKIN name: Pumpkin buy: 2 sell: 1 - material: MELON name: Melon buy: 2 sell: 1 - material: CACTUS name: Cactus buy: 2 sell: 1

ores: - material: EMERALD name: Emerald buy: 40 sell: 20 - material: DIAMOND name: Diamond buy: 35 sell: 18 - material: NETHERITE_SCRAP name: Netherite Scrap buy: 70 sell: 35 - material: GOLD_INGOT name: Gold Ingot buy: 18 sell: 9 - material: IRON_INGOT name: Iron Ingot buy: 15 sell: 7 - material: LAPIS_LAZULI name: Lapis Lazuli buy: 12 sell: 6 - material: REDSTONE name: Redstone Dust buy: 10 sell: 5 - material: COPPER_INGOT name: Copper Ingot buy: 8 sell: 4 - material: COAL name: Coal buy: 6 sell: 3

farms: - material: WHEAT name: Wheat buy: 10 sell: 2 - material: SUGAR_CANE name: Sugar Cane buy: 20 sell: 4 - material: BAMBOO name: Bamboo buy: 15 sell: 3 - material: KELP name: Kelp buy: 5 sell: 1 - material: CACTUS name: Cactus buy: 15 sell: 3 - material: PUMPKIN name: Pumpkin buy: 25 sell: 5 - material: MELON name: Melon buy: 25 sell: 5 - material: COCOA_BEANS name: Cocoa Beans buy: 15 sell: 3 - material: NETHER_WART name: Nether Wart buy: 30 sell: 6 - material: RED_MUSHROOM name: Red Mushroom buy: 10 sell: 2 - material: BROWN_MUSHROOM name: Brown Mushroom buy: 10 sell: 2 - material: OAK_SAPLING name: Oak Sapling buy: 50 sell: 5 - material: SPRUCE_SAPLING name: Spruce Sapling buy: 50 sell: 5 - material: BIRCH_SAPLING name: Birch Sapling buy: 50 sell: 5 - material: JUNGLE_SAPLING name: Jungle Sapling buy: 50 sell: 5 - material: ACACIA_SAPLING name: Acacia Sapling buy: 50 sell: 5 - material: DARK_OAK_SAPLING name: Dark Oak Sapling buy: 50 sell: 5 - material: CHERRY_SAPLING name: Cherry Sapling buy: 75 sell: 10 - material: MANGROVE_PROPAGULE name: Mangrove Propagule buy: 75 sell: 10

Mob Farming Essentials

foods: - material: COOKED_PORKCHOP name: Cooked Porkchop buy: 60 sell: 12 - material: COOKED_MUTTON name: Cooked Mutton buy: 60 sell: 12 - material: COOKED_CHICKEN name: Cooked Chicken buy: 60 sell: 12 - material: COOKED_RABBIT name: Cooked Rabbit buy: 60 sell: 12 - material: COOKED_COD name: Cooked Cod buy: 60 sell: 12 - material: COOKED_SALMON name: Cooked Salmon buy: 60 sell: 12 - material: EGG name: Egg buy: 10 sell: 0 - material: PUFFERFISH name: Pufferfish buy: 30 sell: 6 - material: HONEY_BOTTLE name: Honey Bottle buy: 40 sell: 8 - material: MILK_BUCKET name: Milk Bucket buy: 50 sell: 10 - material: POTION name: Bottle of Water buy: 5 sell: 1 - material: RABBIT name: Raw Rabbit buy: 20 sell: 4 - material: COD name: Raw Cod buy: 18 sell: 3 - material: SALMON name: Raw Salmon buy: 20 sell: 4 - material: BREAD name: Bread buy: 15 sell: 3 - material: POTATO name: Potato buy: 8 sell: 1 - material: CARROT name: Carrot buy: 10 sell: 2 - material: BEETROOT name: Beetroot buy: 6 sell: 1 - material: APPLE name: Apple buy: 12 sell: 2 - material: SWEET_BERRIES name: Sweet Berries buy: 10 sell: 2 - material: GLOW_BERRIES name: Glow Berries buy: 16 sell: 3 - material: CHORUS_FRUIT name: Chorus Fruit buy: 40 sell: 8 - material: MELON_SLICE name: Melon Slice buy: 5 sell: 1 - material: PUMPKIN_PIE name: Pie buy: 40 sell: 8 - material: COOKIE name: Cookie buy: 6 sell: 1 - material: CAKE name: Cake buy: 150 sell: 30 - material: GOLDEN_CARROT name: Golden Carrot buy: 80 sell: 16 - material: GOLDEN_APPLE name: Golden Apple buy: 200 sell: 40 - material: DRIED_KELP name: Dried Kelp buy: 4 sell: 1

mobdrops: - material: ROTTEN_FLESH name: Rotten Flesh buy: 2 sell: 1 - material: LEATHER name: Leather buy: 30 sell: 5 - material: BONE name: Bone buy: 10 sell: 2 - material: STRING name: String buy: 12 sell: 3 - material: SPIDER_EYE name: Spider Eye buy: 15 sell: 4 - material: GUNPOWDER name: Gunpowder buy: 25 sell: 8 - material: ENDER_PEARL name: Ender Pearl buy: 120 sell: 25 - material: BLAZE_ROD name: Blaze Rod buy: 150 sell: 35 - material: SLIME_BALL name: Slime Ball buy: 40 sell: 10 - material: MAGMA_CREAM name: Magma Cream buy: 60 sell: 15 - material: PHANTOM_MEMBRANE name: Phantom Membrane buy: 90 sell: 20 - material: RABBIT_FOOT name: Rabbit Foot buy: 120 sell: 30 - material: RABBIT_HIDE name: Rabbit Hide buy: 25 sell: 6 - material: FEATHER name: Feather buy: 10 sell: 2 - material: INK_SAC name: Ink Sac buy: 12 sell: 3 - material: GHAST_TEAR name: Ghast Tear buy: 300 sell: 80

redstone: - material: REDSTONE name: Redstone Dust buy: 6 sell: 3 - material: REDSTONE_TORCH name: Redstone Torch buy: 20 sell: 6 - material: REPEATER name: Redstone Repeater buy: 45 sell: 15 - material: COMPARATOR name: Redstone Comparator buy: 65 sell: 22 - material: PISTON name: Piston buy: 90 sell: 30 - material: STICKY_PISTON name: Sticky Piston buy: 140 sell: 45 - material: OBSERVER name: Observer buy: 120 sell: 40 - material: HOPPER name: Hopper buy: 220 sell: 75 - material: DISPENSER name: Dispenser buy: 110 sell: 35 - material: DROPPER name: Dropper buy: 95 sell: 30 - material: NOTE_BLOCK name: Note Block buy: 80 sell: 25 - material: LEVER name: Lever buy: 10 sell: 3 - material: STONE_BUTTON name: Stone Button buy: 8 sell: 2 - material: DAYLIGHT_DETECTOR name: Daylight Detector buy: 180 sell: 60 - material: TARGET name: Target Block buy: 70 sell: 20

decorations: - material: MANGROVE_ROOTS name: Mangrove Roots buy: 2 sell: 1 - material: CHEST name: Chest buy: 5 sell: 2 - material: BARREL name: Barrel buy: 5 sell: 2 - material: LANTERN name: Lantern buy: 18 sell: 6 - material: SOUL_LANTERN name: Soul Lantern buy: 20 sell: 7 - material: CANDLE name: Candle buy: 6 sell: 2 - material: FLOWER_POT name: Flower Pot buy: 10 sell: 3 - material: BOOKSHELF name: Bookshelf buy: 25 sell: 8 - material: PAINTING name: Painting buy: 15 sell: 5 - material: ITEM_FRAME name: Item Frame buy: 12 sell: 4 - material: GLOW_ITEM_FRAME name: Glow Item Frame buy: 30 sell: 10 - material: ARMOR_STAND name: Armor Stand buy: 20 sell: 7 - material: BELL name: Bell buy: 80 sell: 25 - material: LECTERN name: Lectern buy: 35 sell: 12 - material: COMPOSTER name: Composter buy: 12 sell: 4 - material: JUKEBOX name: Jukebox buy: 120 sell: 40 - material: SMOKER name: Smoker buy: 45 sell: 15 - material: BLAST_FURNACE name: Blast Furnace buy: 60 sell: 20

special: - material: SPAWNER name: Mob Spawner buy: 50 sell: 25 - material: TOTEM_OF_UNDYING name: Totem of Undying buy: 180 sell: 60 - material: ENDER_PEARL name: Ender Pearl buy: 20 sell: 6 - material: SHIELD name: Shield buy: 40 sell: 15 - material: CROSSBOW name: Crossbow buy: 65 sell: 20 - material: TRIDENT name: Trident buy: 450 sell: 150 - material: GOLDEN_APPLE name: Golden Apple buy: 120 sell: 40 - material: ENCHANTED_GOLDEN_APPLE name: Enchanted Golden Apple buy: 1200 sell: 400 - material: SPLASH_POTION name: Splash Potion buy: 90 sell: 30 - material: LINGERING_POTION name: Lingering Potion buy: 140 sell: 45 - material: TNT name: TNT buy: 35 sell: 12 - material: OBSIDIAN name: Obsidian buy: 25 sell: 8 - material: RESPAWN_ANCHOR name: Respawn Anchor buy: 160 sell: 55 - material: CRYING_OBSIDIAN name: Crying Obsidian buy: 35 sell: 12 - material: ENDER_CHEST name: Ender Chest buy: 90 sell: 30 - material: TRIDENT name: GOD's Weapon buy: 10101010101010 sell: 55 ```

Compatibility

- Minecraft: 1.20.1 - 1.21+ - API Version: 1.20 - Server: Spigot / Paper / Bukkit

Lightweight and optimized — zero performance impact.

Developer Info

- Plugin Name: KnightTowns - Version: 1.4.0 - Author: virendaxd (KnightGost) - License: ARR - Source: GitHub Repository

Future Roadmap

- Town alliances and wars - Town chat channels

Support & Feedback

Encounter a bug or have an idea? Join our Discord. Your feedback helps shape the next updates of KnightTowns.

Gallery

ADS