前置模组要求
| 前置 | 是否必须 | 说明 |
|---|---|---|
| Minecraft Forge 47.x | 必须 | 对应 Forge 1.20.1 |
| JEI（Just Enough Items） | 可选（强烈推荐） | 安装后自动识别所有物品分类、可合成物品、NBT变体（附魔书/药水等），购买界面功能更完整；不安装也可运行但物品可获取性判断受限 |
功能介绍
1. 货币与余额系统
- 全服统一货币，货币名称可自定义（默认"原点"）
- 玩家余额持久化存储（NBT格式，存于世界存档目录）
- 登录时自动同步余额到客户端
- 离线玩家数据保留，下次登录自动恢复
2. 商店购买系统（Buy）
- 按创意模式标签页自动分类，支持模组物品
- 支持物品搜索（按名称/ID模糊匹配）
- 每个物品显示当前价格、库存、可购买状态
- 支持快速数量选择（1/8/16/32/64）
- 购买前显示总价和购买后余额预览
- 支持 NBT 变体物品（附魔书、药水、浸泡箭等按具体附魔/药水类型分别显示）
- 管理员可强制显示/隐藏特定物品
3. 商店出售系统（Sell）
- 出售槽（2行×9格）+ 背包实时同步显示
- 支持 Shift+左键快速将背包物品移入出售槽
- 支持鼠标滚轮精细控制持有数量
- 出售前实时显示总收益、手续费、出售后余额
- 悬停 tooltip 显示物品出售单价
- 支持附魔物品、药水等 NBT 物品的溢价出售（附魔等级越高、稀有度越高，出售价越高）
- 出售手续费可配置（默认5%）
- 关闭界面自动将出售槽物品归还背包
4. 拍卖系统（Auction）
- 支持单件拍卖和打包拍卖（最多2行×9格物品打包）
- 打包拍卖可自定义封面物品
- 可自定义拍卖名称、底价、时长（分钟）
- 浏览拍卖：支持按玩家名/物品名搜索，平滑滚动列表
- 出价系统：实时显示当前最高出价、剩余时间；自己的拍卖不能出价
- 我的拍卖：可提前结束（收取额外手续费）或取消（有出价时收取场地费）
- 拍卖到期自动结算：物品给买家，货币给卖家（扣手续费）
- 无人出价时物品自动退还卖家
- 玩家离线时物品/货币存入待领取队列，下次登录自动发放
- 拍卖成交时全服广播
5. 动态价格系统
- 服务器启动后自动基于游戏配方递归计算所有物品基础价格
- 价格算法：
- 无合成表的原材料使用基础价格（可配置）
- 合成品 = 原料总价 × 合成溢价倍率 / 产出数量
- 熔炼/烟熏/高炉工序有独立溢价倍率
- 支持 Bellman-Ford 迭代收敛，防止循环依赖导致价格无限上涨
- 全局价格上限兜底（默认1亿）
- 动态价格：库存越少价格越高（线性插值，库存≥1600时为基础价，库存=0时趋近最大价格上限）
- 热度加成：10分钟内购买量越多，价格额外上浮（最多+50%基础价）
- 管理员可手动覆盖任意物品价格，或锁定价格不被算法修改
6. 限时购买系统（Flash Sale）
- 管理员可设置特定物品的限时特价
- 支持设置特价价格、库存上限、截止时间
- 购买界面有独立"限时购买"入口，仅在有活跃限时商品时显示
- 限时商品 tooltip 显示剩余时间和剩余库存
7. 商店补货系统
- 定时自动补货（间隔可配置，默认60分钟）
- 每个物品可单独配置补货量，未单独配置的使用全局默认值（默认200）
- 库存上限 = 初始配置库存 × 2，防止无限堆积
8. 管理员配置界面（Admin GUI）
- 仅 OP（权限等级2+）可访问，通过购买/出售/拍卖界面右上角齿轮按钮进入
- 四个配置标签页：
- 基础配置：货币名称、各类手续费率、拍卖时长/槽位、补货间隔等
- 物品配置：按分类浏览所有物品，可设置最大价格上限、手动价格覆盖、库存、补货量、价格锁定、购买隐藏/显示；支持多选批量编辑
- 价格算法：调整基础价格、合成/熔炼溢价倍率、递归深度、全局价格上限；支持"保存并重算"或"仅保存"
- 限时购买：为任意物品设置限时特价、库存、截止时间
- 所有配置实时同步到服务端并推送给所有在线玩家
9. 网络同步
- 玩家登录时自动同步余额、拍卖列表、商店数据、配置信息
- 价格计算完成后自动推送最新价格给所有在线玩家
- 管理员保存配置后立即全服同步
10. 快捷键
- 默认按键
B打开交易面板（可在游戏设置中修改）
特色介绍
- 零前置强依赖：JEI 为可选前置，不安装也能运行；无需数据库，数据存于世界存档
- 全物品覆盖：自动识别所有已注册物品（含模组物品），无需手动配置物品列表
- 智能价格算法：基于游戏配方树自动推导合理价格，支持全量/局部/增量重算
- NBT 物品支持：附魔书按附魔类型分别定价，药水按药水类型分别定价，出售时自动计算溢价
- 动态供需模型：库存和购买热度双重影响价格，模拟真实市场波动
- 打包拍卖：支持将多件物品打包成一个拍卖条目，适合套装/材料包交易
- 管理员友好：完整的 GUI 配置界面，无需手动编辑 JSON 文件（也支持直接编辑
config/economymod.json） - 热重载：配置支持
/eco reload热重载，无需重启服务器 - 进度可视化：价格计算期间管理员 ActionBar 显示实时进度条
指令列表
所有指令以 /eco 为根命令。
| 指令 | 权限 | 说明 |
|---|---|---|
/eco balance |
所有玩家 | 查看自己的当前余额 |
/eco give <玩家> <数量> |
OP（权限2+） | 给指定玩家增加货币 |
/eco take <玩家> <数量> |
OP（权限2+） | 扣除指定玩家货币（余额不足则失败） |
/eco set <玩家> <数量> |
OP（权限2+） | 直接设置指定玩家的余额 |
/eco reload |
OP（权限2+） | 热重载配置文件（config/economymod.json） |
/eco recalcprices |
OP（权限2+） | 触发全量重算所有物品价格（异步执行，完成后通知管理员） |
/eco priceinfo |
OP（权限2+） | 查看当前已计算价格的物品数量和 JEI 物品总数 |
/eco dumpprices |
OP（权限2+） | 将所有物品价格按价格从高到低导出到服务端日志文件 |
配置文件
配置文件位于 config/economymod.json，首次启动自动生成，支持 /eco reload 热重载。主要配置项包括货币名称、各类手续费率、拍卖参数、补货参数、价格算法参数、物品价格覆盖/锁定/隐藏列表等。
目前为第一版还有一些不足的地方可以评论告诉我