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 — Create a new town (OP or TownMaster only)
/town delete — Delete a town
/town list — View all existing towns
/town claim — Claim your current chunk (Mayor only)
/town info — View info of a town
/town showborder — Show your town’s border
/town addmember — Add a player to your town
/town removemember — Remove a member from your town
/town setrank — 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
/town givemoney

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:

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.

KnightTowns