京都经济

💰 Kyo Economy


Kyo Economy 是一套专为 TEA Server 定制的综合经济与交易系统。它 100% 运行于服务端，玩家无需安装任何客户端模组，即可享受多层分页商店 GUI、玩家市场（黑市）以及物品估价系统，并配备简洁直观的 UI/UX。

---

✨ 特性

• 🛡️ 现代数据架构与物品安全：

  • 全面采用 Mojang 最新的 DataFixerUpper (DFU) 和 RecordCodecBuilder 取代易出错的旧版 NBT 结构，实现极速读写操作与完整的资产保护。
  • 所有物品掉落与返还流程现在直接生成 ItemEntity 实例，而非调用 Player drop API，从而防止因背包已满或网络问题导致的物品丢失。

• 🌍 多别名指令系统：通过允许每条指令拥有无限个别名来消除语言障碍（例如 /bal、/money、/sodu；/shop、/store、/cuahang）。非常适合多语言服务器使用。

• 🛍️ 分页嵌套菜单：服务器商店设有 6 个不同分类，拥有用户友好的分类名称和内置分页功能，让玩家可以无缝浏览庞大的商品目录而不会溢出。

• ⚙️ 多样化的出售流程：

  • 光标出售： 用光标拾取物品并点击商店界面，即可按标价（包括附魔加成）立即出售。
  • 快速出售与全部出售： 即时清空背包槽位，或安全地批量出售整组物品。
  • 享受不受限制的背包管理，无需担心误售。

• 🔍 精准附魔估价：升级后的附魔加成计算逻辑，可根据附魔等级准确缩放估值，并配有清晰的聊天明细与音效反馈。

• 📊 优化的计分板显示：通过 PlaceholderAPI 自动将大额货币值压缩为简洁记法（15.5k、1.2M、4.5B），防止计分板和 TabList 布局被裁剪。

---

📦 依赖项

要运行 Kyo Economy，服务器需要以下核心依赖：

• Fabric Loader (>= 0.19.5)
• Fabric API（兼容 Minecraft 26.3）
• Polymer（Core 与 Resource Pack，最新构建版）
• SGUI（服务端 GUI）
• Placeholder API（eu.pb4.placeholder-api v3+）

---

💻 指令与权限

默认指令	描述	权限
/bal [player]	查看自己或目标玩家的余额。	所有人
/pay <player> <amount>	向其他玩家转账货币（最低：0.001 Xu）。	所有人
/shop	打开主服务器商店界面。	所有人
/ah	打开玩家市场 / 拍卖行。	所有人
/eco <give/take/set> <target> <amount>	直接管理玩家账户余额。	管理员 (OP)

（💡 注：以上为默认别名。可通过 commands.json 配置额外的本地化别名。）

---

🧰 配置

配置文件位于 config/kyoeconomy/：

1. commands.json（多别名注册表）

使用 JSON 字符串数组为每条指令注册多个别名：

{
  "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（商品目录与分类管理）

支持在预设周期内动态波动价格，并将物品映射到分类标签页：

{
  "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"
    }
  ]
}

---

💡 支持的分类标签：

• blocks：建筑方块
• food：食物与农业产出
• materials：原材料与矿物
• equipment：武器、工具和盔甲
• mob_drops：生物掉落物与怪物战利品
• special：特殊与稀有物品

---

🎮 商店交互指南（KyoShopGui）

商店提供直接从玩家背包开始的交互流程：

• 自由左键点击：在背包内移动、拆分或整理物品，而不会触发误售。
• 光标出售：用光标拿取物品并点击商店视口内部，即可按市场价出售（包含附魔加成）。
• 价格估价：右键点击背包中的物品，即可在聊天中打印估价明细并伴有音效提示。
• 安全快速出售：Shift + 右键点击物品，即可立即将整组物品出售给服务器。
• 分页：使用 GUI 底部的分页按钮浏览商品目录的各个页面。

---

🔗 PlaceholderAPI 支持

将玩家经济统计数据暴露给 Kyo Scoreboard、TabList 或聊天格式：

• %kyoeconomy:balance%：将余额格式化为简洁记法（15.5k Xu、2M Xu、1B Xu）。当持有量低于 1,000 Xu 时保留小数位（Hao）。

---

Developed by Kyo — Exclusively tailored for TEA Server.