💰 Kyo Economy
!Minecraft Version !Platform
!API
Kyo Economy is a comprehensive economic and trading system, exclusively designed for TEA Servers. Running entirely on the server (100% server-side), players don't need to install any additional mods on the client to experience the highly intuitive Shop, Black Market, and Item Appraisal system.
✨ Key Features
-
🛡️ Current Data Architecture: Completely eliminates the outdated and error-prone NBT system. Kyo Economy uses Mojang's latest
DataFixerUpper (DFU)technology combined withRecordCodecBuilderfor ultra-fast data reading/writing, ensuring absolute protection against asset loss. -
⚡ 100% Server-Side: Utilizes Polymer and SGUI libraries, providing a smooth, customizable inventory interface without forcing players to download mods.
-
🏦 Dual Currency System: Uses an intelligent reference system of
1 Coin = 1000 Hao, enabling a flexible economy for transactions ranging from micro-deals to multi-million dollar ventures. -
🛒 Admin Shop & Black Market (AH):
-
Trade basic necessities through
/shop. -
Free trading and item auctions between players through
/ah. -
🔍 Smart Valuation Machine: An exclusive mechanism allowing players to Right-Click on enchanted equipment to Appraise its value (detailed report of the amount earned), and Shift + Right-Click to Sell quickly. Enchantment values are divided into 4 Tiers from Basic to Divine!
-
📊 Optimized Scoreboard Display: Automatically compresses massive currency amounts into professional formats (
15.5k,1.2M,4.5B) via PlaceholderAPI, preventing Scoreboard & TabList frame breakage.
📦 Installation Requirements (Dependencies)
For Kyo Economy to function perfectly, your server needs to have the following core mods installed:
-
Fabric API (Compatible version 26.2)
-
Polymer (Core & Resource Pack)
-
SGUI (Server-side GUIs)
-
Placeholder API (eu.pb4.placeholder-api v3+)
💻 Command & Permission List
| Default Command | Function | Permission |
| :--- | :--- | :--- |
| /bal [player] | View your own or another player's account balance. | All players |
| /pay <player> <amount> | Transfer money to another player (Minimum 0.001 Coins). | All players |
| /shop | Open Server Shop. | All Players |
| /ah | Open Black Market - Free Trading Platform. | All Players |
| /eco <give/take/set> <goal> <amount> | Directly interfere with player accounts. | Admin (OP) |
(Note: All the above commands can have their Vietnamese names changed in the config.json file.)
🧰 Configuration
All configuration files are automatically created in the config/kyoeconomy/ directory:
1. config.json
Allows you to rename commands as you like to suit the server's Roleplay context:
{
"command_bal": "tien",
"command_pay": "chuyenkhoan",
"command_shop": "cuahang",
"command_ah": "choden"
}
2. shop.json
Manages items for sale in the Admin Shop. Supports a Variable Price System (Stock Exchange) that automatically adjusts prices randomly after each cycle:
{
"items": [
{
"item_id": "minecraft:diamond",
"name": "Cool Diamond",
"min_price": 45,
"max_price": 55,
"slot": 10
}
]
}