💰 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.