KnightTowns
A lightweight plugin for managing towns, claiming land, assigning ranks and protecting areas with XP and level integration.
167
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
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.
