💰 Kyo Economy

Kyo Economy is a comprehensive economy and trading system custom-built for TEA Server. Running 100% server-side, players do not need to install any client-side mods while still enjoying a multi-layered paginated shop GUI, a player marketplace (black market), and an item appraisal system with sleek, intuitive UI/UX.

✨ Features

• 🛡️ Modern Data Architecture & Item Safety:
  • Fully replaces error-prone legacy NBT structures with Mojang's latest DataFixerUpper (DFU) and RecordCodecBuilder for lightning-fast read/write operations and complete asset protection.
  • All item drop and return routines now spawn ItemEntity instances directly rather than calling the Player drop API, preventing item loss caused by full inventories or network issues.
• 🌍 Multi-Alias Command System: Eliminates language barriers by allowing unlimited aliases per command (e.g., /bal, /money, /sodu; /shop, /store, /cuahang). Highly versatile for multilingual servers.
• 🛍️ Paginated Nested Menus: The server shop features 6 distinct categories with user-friendly category names and built-in pagination, allowing players to browse extensive catalogs seamlessly without overflow.
• ⚙️ Versatile Selling Workflow:
  • Cursor Sale: Pick up an item on the cursor and click the shop interface to sell immediately at the listed price (including enchantment bonuses).
  • Quick Sale & Sell All: Clean out inventory slots instantly or dump entire stacks safely.
  • Enjoy unrestricted inventory management without accidental sales.
• 🔍 Precise Enchantment Appraisal: Upgraded calculation logic for enchantment bonuses accurately scales valuations based on enchantment tiers, complemented by clear chat breakdowns and audio feedback.
• 📊 Optimized Scoreboard Display: Automatically compacts large currency values into clean notation (15.5k, 1.2M, 4.5B) via PlaceholderAPI, preventing scoreboard and tablist layout clipping.

📦 Dependencies

To run Kyo Economy, the server requires the following core dependencies:

• Fabric Loader (>= 0.19.5)
• Fabric API (Compatible with Minecraft 26.3)
• Polymer (Core & Resource Pack, latest build)
• SGUI (Server-side GUIs)
• Placeholder API (eu.pb4.placeholder-api v3+)

💻 Commands & Permissions

(💡 Note: These represent default aliases. Additional localized aliases can be configured via commands.json.)

🧰 Configuration

Configuration files are located in config/kyoeconomy/:

1. commands.json (Multi-Alias Registry)

Use JSON string arrays to register multiple aliases for each command:

{
  "cmd_bal": ["bal", "money", "sodu", "tien"],
  "cmd_pay": ["pay", "transfer", "chuyentien", "ck"],
  "cmd_shop": ["shop", "store", "cuahang", "chinhhang"],
  "cmd_ah": ["ah", "market", "choden", "chotroi"],
  "cmd_eco": ["eco", "economy", "quantritien"]
}

2. shop.json (Catalog & Category Management)

Supports dynamic price fluctuations across preset cycles and maps items to category tabs:

{
  "items": [
    {
      "item_id": "minecraft:cobblestone",
      "name": "Cobblestone",
      "min_price": 5.0,
      "max_price": 10.0,
      "category": "blocks"
    },
    {
      "item_id": "minecraft:diamond_sword",
      "name": "Diamond Sword",
      "price": 500.0,
      "category": "equipment"
    }
  ]
}

💡 Supported Category Tags:

• blocks: Building blocks
• food: Food and farming yields
• materials: Raw materials and minerals
• equipment: Weapons, tools, and armor
• mob_drops: Mob drops and monster loot
• special: Special and rare items

🎮 Shop Interaction Guide (KyoShopGui)

The shop provides an interactive flow directly from the player inventory:

• Free Left-Click: Move, split, or organize items inside your inventory without triggering inadvertent sales.
• Cursor Sale: Grab an item with your cursor and click inside the shop viewport to sell it at market value (enchantment bonuses included).
• Price Appraisal: Right-click an item in your inventory to print an appraisal breakdown in chat alongside an audio cue.
• Safe Quick Sale: Shift + Right-Click an item to immediately liquidate the entire stack to the server.
• Pagination: Navigate across catalog pages using the pagination buttons at the bottom row of the GUI.

🔗 PlaceholderAPI Support

Expose player economy statistics to Kyo Scoreboard, TabList, or chat formatting:

• %kyoeconomy:balance%: Formats balance into clean notation (15.5k Xu, 2M Xu, 1B Xu). Preserves fractional decimals (Hao) when holdings fall below 1,000 Xu.

Developed by Kyo — Exclusively tailored for TEA Server.

💰 Kyo Economy

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 with RecordCodecBuilder for 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

}

]
}