Spoiler

Still Working on it To Improve and add more features.. if you got any idea please let me know.

KINGDOM-ECONOMY

A powerful medieval economy extension for KingdomsX that transforms kingdoms into fully functional economic societies with treasuries, banking, profession villagers, protected land markets, and kingdom-controlled civilization mechanics.

---

Overview

KINGDOMECONOMY is a large-scale KingdomsX extension plugin designed for PaperMC 1.21+ servers that want deep economy, territory, and medieval society gameplay.

Instead of using kingdoms only for claims and PvP, this plugin evolves them into living economic civilizations where kingdoms manage:

• treasuries
• banking systems
• profession villagers
• land ownership
• taxes
• controlled permissions
• protected societies
• economic progression

Designed for:

• Kingdom SMPs
• Civilization Servers
• Medieval Roleplay
• Geopolitical SMPs
• Economy Servers
• Survival Communities

---

Core Features

Kingdom Treasury Economy

Every kingdom functions as an economic state with its own treasury system.

Players can:

• deposit money into kingdom banking systems
• store currency safely
• manage wealth through kingdom-controlled economies
• participate in society-based progression

The economy is built around Serkcoin, an integer-based virtual currency system.

---

Serkcoin Currency System

KINGDOMECONOMY introduces:

• wallet balances
• secure bank storage
• treasury balances
• total wealth tracking
• configurable economic behavior

Supports:

• death wallet loss systems
• economy balancing
• server-wide medieval markets

PlaceholderAPI placeholders included:

%kingdomeconomy_serk%
%kingdomeconomy_bank%
%kingdomeconomy_total%
%kingdomeconomy_kingdom%
%kingdomeconomy_treasury%

---

Villager Profession System

Chief-Based Recruitment

Kings can create Chiefs using:

/ke villager chief

Chiefs act as recruitment hubs for kingdom workers and profession villagers.

---

Profession Villagers

Villagers are:

• kingdom restricted
• configurable
• profession limited
• economy integrated

Features:

• profession ownership
• stock limits
• shortages
• supply mechanics
• configurable item prices

Villagers only interact with members of the same kingdom to maintain kingdom exclusivity and balance.

---

Iron Golem Protection

Attacking Chiefs or protected kingdom villagers triggers defensive Iron Golems.

This creates:

• realistic kingdom defense
• anti-grief mechanics
• protected economic infrastructure

---

Land Market System

KINGDOMECONOMY includes a chunk-based land economy integrated directly with KingdomsX claims.

Selling Land

Kings can:

1. Select chunks using a Golden Hoe
2. Put land for sale using:

/ke land sell <price>

---

Buying Land

Players can purchase land using:

/ke land buy

Payments automatically transfer into the kingdom treasury.

---

Safe Chunk Ownership

The system is:

• claim-aware
• kingdom protected
• economy integrated
• chunk aligned

Perfect for:

• town expansion
• property markets
• civilization roleplay
• player-driven economies

---

Kingdom Permission System

KINGDOMECONOMY extends KingdomsX permission handling with temporary access systems.

Commands:

/ke allow build <player>
/ke allow break <player>
/ke allow use <player>

This allows kingdoms to:

• create diplomatic access
• allow temporary workers
• grant construction permissions
• manage visitors safely

---

Banking System

Players can securely manage money using:

/ke bank deposit <amount>
/ke bank withdraw <amount>

The banking system supports:

• secure balance storage
• medieval roleplay economies
• treasury integration
• configurable economic balancing

---

Supply System

Economies can be expanded using:

/ke job supply <material> <amount>

This enables:

• profession supply chains
• market restocking
• controlled resource economies
• realistic production systems

---

Configuration

Most gameplay systems are configurable.

Supported configuration includes:

• taxes
• GUI labels
• item prices
• interest systems
• shortages
• profession ownership
• land prices
• economy balancing
• stock limits
• messages

---

Database Support

Supported storage systems:

• SQLite
• MySQL

SQLite works by default. MySQL can be enabled through config.yml.

---

Compatibility

Supported Platforms

• PaperMC 1.21.8+
• Java 21

---

Dependencies

Required:

• KingdomsX

Optional:

• PlaceholderAPI

---

Commands

/ke
/ke reload
/ke villager chief

/ke allow build <player>
/ke allow break <player>
/ke allow use <player>

/ke land sell [price]
/ke land buy

/ke bank deposit <amount>
/ke bank withdraw <amount>

/ke job supply <material> <amount>

/serk

---

Installation

1. Install KingdomsX
2. Download KINGDOMECONOMY
3. Place the plugin inside your /plugins folder
4. Start the server
5. Configure files as needed
6. Restart the server

---

Why KINGDOMECONOMY?

Most economy plugins focus only on money.

KINGDOMECONOMY focuses on:

• societies
• civilizations
• kingdom progression
• protected economies
• realistic medieval systems
• territory ownership
• multiplayer interaction

This creates a deeper survival experience where kingdoms feel alive instead of being simple claim systems.

---

Notes

The KingdomsX integration uses a reflection-backed hook system for improved compatibility across multiple KingdomsX builds and API changes.

---

Future Expansion Potential

KINGDOMECONOMY is designed to support future systems such as:

• kingdom taxes
• advanced trading
• war economies
• kingdom salaries
• NPC guards
• dynamic inflation
• bounty systems
• advanced markets
• civilization events

---

Support

If you encounter bugs, balancing issues, or compatibility problems, please report them through the project support page.

• Discord Feedback and suggestions are always welcome.