KnightTowns

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

Загрузки: 225
Подписчики: 4
Обновлён: 6 апреля 2026 г.
Лицензия: All-Rights-Reserved

Опубликован 25 октября 2025 г.

Исходный код

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.

Ченджлог

2.1.0Релиз26.1, 26.1.1, 26.1.2 · 6 апреля 2026 г.

Support for 26.1 - 26.1.2

2.0.0Релиз1.21.9, 1.21.10, 1.21.11 · 5 марта 2026 г.

KnightTowns – Raid System Update

Major Feature: Town Raids

Towns can now be attacked by random raid events, forcing players to defend their land against waves of hostile mobs.

Added

Random Town Raids

Raids can automatically start against a random town.
Only towns with claimed chunks and online members can be targeted.

Multiple Raid Waves

Raids occur in 3 waves of enemies.
Each wave increases mob count and difficulty.

Raid Difficulty System

EASY
NORMAL
HARD
Difficulty affects:
- mob strength
- mob count
- XP rewards

Custom Raid Mobs

Zombies, Skeletons, Pillagers, Spiders
Hard raids may spawn Vindicators and Witches
Custom mob names like:
- Undead Zombie
- Vengeful Skeleton
- Elite Pillager

Raid BossBar

Displays current wave and remaining mobs
Updates live during the raid

Town Defender Rewards

Players who participate receive XP rewards
Non-town players helping defend can also earn rewards

Contributor Tracking

Players who damage raid mobs are tracked as contributors.

Configuration

Config options:

raids:
  enabled: true
  interval_ticks: 144000

enabled – enable or disable random raids
interval_ticks – time between raid attempts (Default: 144000 ticks = ~2 hours)

Admin Controls

Admins can force start/stop raids if needed.
All active raid mobs will be removed when a raid is stopped.

1.3.0Релиз1.21.9, 1.21.10, 1.21.11 · 4 марта 2026 г.

Added

Automatic update checker
Update notification in console
OP notification on join

1.2.2Релиз1.21.9, 1.21.10, 1.21.11 · 3 марта 2026 г.

Minor changes

Changed border
Fix warns

1.2.1Релиз1.21.9, 1.21.10, 1.21.11 · 2 января 2026 г.

v1.2.1

New

Shop Menu

Category-based shop GUI
Fully configurable via shop.yml
Buy items using in-game currency

Sell Menu

Chest-style sell GUI
Place items and close inventory to sell
Sell prices are read from shop.yml
Unsellable items are returned automatically

Player Info Menu

View player currency
View XP and town data
Clean, easy-to-use interface

Shop Configuration (shop.yml)

Fully editable key-values

Category names
Category icons (materials)
GUI slots
Item buy prices
Item sell prices
Item display names & lore

Supports easy expansion without code changes

One config controls both buy & sell systems

Economy System

Added /setmoney (admin command)
Added /givemoney
Unified currency usage across:
1. Shop menu
2. Sell menu
3. Commands
Improved money sync and validation

Note

Supports 1.20.1 to 1.21.11

1.1.1Релиз1.21.8, 1.21.9, 1.21.10 · 8 ноября 2025 г.

v1.1.1

Fixes

Added Info command and use in Help command.

1.1.0Релиз1.21.8, 1.21.9, 1.21.10 · 8 ноября 2025 г.

v1.1.0 — Town Info + Anti-XP Exploit Update

🆕 New

Added /town info command — shows mayor, creation date, and chunk count.

🛠 Fixes & Improvements

Fixed infinite XP exploit: Players can no longer gain unlimited XP by placing and breaking the same blocks repeatedly.
New system: Tracks placed blocks to ensure XP is only earned from naturally generated materials.
Improved XP logic: Refined XP rewards for ores, logs, farming items, and rare blocks.
Cleaner code structure: Optimized event handling for both placement and breaking detection.

1.0.0Релиз1.21.8, 1.21.9, 1.21.10 · 25 октября 2025 г.

KnightTowns v1.0.0 – First Release

🏙 Town System

Players can create and delete towns (/town create / /town delete ).
Towns can claim chunks (/town claim) and display borders for 30 seconds.
Town members have ranks: TownMaster, Mayor, Member, and Visitor.
Only TownMaster or Mayor can manage members depending on rank.
Players cannot break, place, or interact with blocks/items in towns they don’t belong to.
Optional bypass permission knighttowns.bypass for OPs or admins.

⚡ XP & Level System

Players gain XP from blocks and kills.
Level-up detection triggers correctly and only for the leveling player.
Multiple level-ups handled correctly.
XP and level persist across joins and server restarts.

💬 Commands

/town create – Create a new town (TownMaster only)
/town list – List all towns with Mayor info
/town delete – Delete a town (TownMaster only)
/town showborder – Show the border of your town for a few seconds
/town claim – Claim the chunk you are standing on for your town
/town addmember – Add a player to your town (Mayor/TownMaster only)
/town removemember – Remove a player from your town (Mayor/TownMaster only)

🛡 Grief Protection

Players cannot build, break, or interact in other towns unless allowed.
Visitors (no rank) cannot modify blocks in any town.
Town borders prevent accidental griefing.

📝 Persistence & Safety

Town data saved in towns.yml.
Player data and XP saved reliably on quit.
All operations synced between memory and file.

🎨 UX & Feedback

XP gain messages appear on the action bar.
Level-up messages are shown only to the leveling player.
Town commands provide clear success/failure feedback.
Borders use Glowstone (corner) and Gold Blocks (marking between corners) for visual feedback.

KnightTowns — Build, Expand and Rule Your Own Towns

Features

Town System

Raid System

Update Checker

Player System

Economy System

Shop System

Sell Chest System

Town Information GUI

Config Driven

Raid Configuration

Commands Overview

Town Commands

Shop Commands

Admin Economy Commands

Ranks & Permissions

Data Storage

Example file structures:

Compatibility

Developer Info

Future Roadmap

Support & Feedback

Ченджлог

KnightTowns – Raid System Update

Major Feature: Town Raids

Added

Random Town Raids

Multiple Raid Waves

Raid Difficulty System

Custom Raid Mobs

Raid BossBar

Town Defender Rewards

Contributor Tracking

Configuration

Config options:

Admin Controls

Minor changes

v1.2.1

New

Shop Menu

Sell Menu

Player Info Menu

Shop Configuration (shop.yml)

Fully editable key-values

Supports easy expansion without code changes

One config controls both buy & sell systems

Economy System

Note

v1.1.1

Fixes

v1.1.0 — Town Info + Anti-XP Exploit Update

🆕 New

🛠 Fixes & Improvements

KnightTowns v1.0.0 – First Release

🏙 Town System

⚡ XP & Level System

💬 Commands

🛡 Grief Protection

📝 Persistence & Safety

🎨 UX & Feedback

Комментарии