IGNGEconomy 经济市场插件教程

IGNGEconomy 为服务器提供统一的金币账户、官方收购、玩家自由市场、拍卖、邮箱提货和一对一报价功能。本教程面向玩家与日常管理员，命令以当前服务器实际提示为准。

快速开始

使用前请确认：

已通过服务器的 AuthMe 登录，例如 /login 密码。
Minecraft 游戏名已经绑定到 IGNG 账号。
当前服务器已启用经济账户；第一次使用时执行 /eco enable。

本插件的余额、订单、报价和待领取物品按当前服务器记录。切换到其他子服务器时，请以该服务器显示的账户和业务记录为准，不要把不同服务器的余额或订单混在一起。

直接输入 /eco 可以打开经济主菜单；没有记住命令时，也可以先从菜单进入余额、流水和收购功能。

一、经济账户与转账

开启或停用账户

/eco enable
/eco disable

/eco enable：在当前服务器启用自己的经济账户。
/eco disable：停用当前服务器的经济账户。停用前请先处理仍在进行中的市场、报价和待领取业务；系统会按照当前业务状态执行释放或退回。

查询余额与流水

/eco balance
/eco history

余额页面会区分：

可用余额：可以消费、转账或继续发布业务的金额。
冻结余额：暂时为求购、竞价等业务保留的金额。
总额：可用余额与冻结余额的合计。

/eco history 用于查看当前服务器最近的收入、支出、转账和交易流水。

玩家转账

/pay <对方游戏名> <金额>

示例：

/pay Steve 100

转账时填写 Minecraft 游戏名，不填写 IGNG 数字 ID。金额必须为正数；对方需要完成账号绑定并启用当前服务器的经济账户。转账成功后，在线玩家会收到到账提示，离线玩家可在下次上线后查看到账通知。

二、官方收购：赚取启动资金

官方收购适合出售开荒阶段获得的基础材料。操作步骤：

把要出售的物品放在主手。
执行：
```
/eco sell
```
确认游戏内返回的收购数量、单价和实际到账金额。

默认收购参考

以下是插件首次初始化时使用的默认规则。实际服务器可以在数据库中调整规则，最终以游戏内提示为准。

物品	默认单价	默认每日单人上限
圆石、泥土、石头、沙砾、沙子	1 金币 / 个	10,000 个
各类原木	2 金币 / 个	10,000 个
煤炭	3 金币 / 个	10,000 个
粗铜	2 金币 / 个	10,000 个
粗铁	5 金币 / 个	10,000 个

注意：

上表是默认规则，不代表每台服务器当前一定使用相同价格或额度；请以 /eco sell 的返回提示为准。
每日额度按当前服务器的官方收购规则计算，刷新时间和实际剩余额度以服务器提示为准。
带有特殊名称、Lore、附魔或其他自定义数据的物品，可能不符合官方收购规则；无法收购时，可改用玩家市场交易。
不要为了绕过限额反复切换身份或重复提交；遇到额度、物品或账户提示时，保留完整提示并联系管理员。

三、玩家自由市场（GlobalMarketPlus）

IGNGEconomy 使用 GlobalMarketPlus 兼容的商品模型。完整入口是 /gmp，/globalmarket 和 /globalmarketplus 是同一命令树的别名；/market 是市场功能的短入口。

当前启用的是 GMP 商品市场、交易确认和投递流程。旧版 Orderbook 的 /market browse、/market purchase、/market orders、/market cancel、/market claim、/market history 不属于当前可用的新流程，请不要继续使用这些旧命令。

浏览和搜索

/gmp market gui [selling|purchasing|bidding] [页码]
/gmp market search <关键词>

selling：浏览其他玩家出售的商品。
purchasing：浏览其他玩家发布的求购商品。
bidding：浏览拍卖商品。
search：按关键词查找商品。

打开商品详情后，使用交易确认命令完成购买：

/gmp transaction gui <商品UID> [数量] [wholesale|retail]
/gmp transaction confirm <商品UID> [数量] [wholesale|retail]

商品 UID 和价格模式以市场界面显示为准。购买成功后，物品会按照服务器的 GMP 投递设置进入背包、邮箱或待领取记录；背包不足时不要重复购买，先查看邮箱。

发布出售商品（Selling）

手持要出售的物品后执行：

/gmp market sell [wholesale:]<单价> [数量]
/gmp market sell [retail:]<单价> [数量]
/gmp market sellInventory [wholesale:]<单价>
/gmp market sellInventory [retail:]<单价>

sell 使用主手物品。
sellInventory 按界面流程选择背包物品。
wholesale: 和 retail: 用于明确价格模式；省略时使用服务器默认模式。
数量、手续费、有效期和权限组限制由服务器配置决定。

发布前请确认商品、数量、单价和模式。上架成功后，商品会进入托管流程；成交、下架或到期后的物品和金额会按当前服务器设置投递或结算。

发布求购商品（Purchasing）

手持作为样本的物品后执行：

/gmp market buy [wholesale:]<最高单价> [数量]
/gmp market buy [retail:]<最高单价> [数量]
/gmp market buyInventory [wholesale:]<最高单价>
/gmp market buyInventory [retail:]<最高单价>

发布求购时，系统会按数量、价格和服务器规则预留所需金额。有人供货后，物品和未成交部分会按照 GMP 结算流程进入邮箱或释放回账户。若余额不足、物品规则不允许或求购条件不完整，请按照命令帮助修正后再试。

拍卖（Bidding）

/gmp auction start <起拍价> [数量]
/gmp auction gui <商品UID>
/gmp auction bid <商品UID> <竞价>
/gmp auction confirm <商品UID>

卖家手持物品后用 start 创建拍卖。
买家先用 gui 查看，再用 bid 出价并用 confirm 确认。
竞价金额会按当前服务器规则预留；被超过的竞价会按结算规则释放。
是否自动加时、是否允许竞价后撤下、无竞价时如何退回，以服务器配置和界面提示为准。

四、GMP 邮箱与安全领取

邮箱是市场成交、退款、报价物品退回以及背包不足时的统一领取入口：

/gmp mailbox gui
/gmp mailbox list [页码]
/gmp mailbox pickup <邮件编号> [数量]
/gmp mailbox delete <邮件编号>
/gmp mailbox send <玩家名> <数量>

常见情况：

购买后背包没有立即出现物品：先执行 /gmp mailbox gui 或 /gmp mailbox list。
领取时背包空间不足：清理背包后再次执行 pickup，未领取部分会继续保留。
不确定一封邮件是否重要：不要直接 delete，先确认商品、数量和来源。
发送邮箱物品时，填写对方 Minecraft 游戏名和发送数量；对方必须满足服务器的账户与收件条件。

领取编号、邮件编号和商品 UID 是不同的业务编号，请按界面和命令提示分别填写。

五、一对一定向报价（Direct Offer）

如果要把手中的物品以固定总价卖给指定玩家，可以使用 /offer。它与 GMP 市场商品是两套独立流程。

创建报价

将物品放在主手。

执行：

/offer create <买家游戏名> <一口价总价>

示例：

/offer create Alex 500

创建后，物品会进入报价托管，等待买家处理。创建前请确认买家游戏名、物品数量和总价。

查看、接受、拒绝或撤回

/offer list
/offer accept <报价编号>
/offer decline <报价编号>
/offer cancel <报价编号>

买家使用 accept 接受并付款。
买家使用 decline 拒绝报价。
卖家使用 cancel 主动撤回尚未完成的报价。
报价过期、被拒绝或撤回后，物品和金额会按当前服务器的邮箱/待领取设置处理。

不要把报价编号当成玩家名填写，也不要在对方未确认价格和物品时催促其接受。

六、常见问题

提示或现象	原因	处理方式
请先通过 AuthMe 登录	当前会话未完成登录	先执行 `/login 密码`，再重试命令
Minecraft 账号尚未绑定	游戏名未关联 IGNG 账号	先完成账号中心绑定，再进入服务器重试
经济账户尚未启用	当前服务器首次使用或账户已停用	执行 `/eco enable`
可用余额不足	余额不足，或部分金额仍被业务预留	用 `/eco balance` 查看可用/冻结余额，结束不需要的求购或竞价
物品不符合官方收购规则	材料未配置，或包含特殊物品数据	按提示更换物品，或改用玩家市场
找不到商品	UID、关键词、分类或市场分页不正确	重新执行 `/gmp market gui` 或 `/gmp market search`
购买后没有物品	物品已经进入邮箱或待领取记录	执行 `/gmp mailbox gui`，再用 `pickup` 领取
邮箱领取失败	背包不足、邮件编号错误或暂时冷却	清理背包，核对编号，等待命令冷却结束后重试
报价无法接受	报价已过期、被撤回或余额不足	用 `/offer list` 查看当前状态，并联系卖家重新创建

如果涉及重复扣款、物品数量异常或领取失败，请不要连续重复执行确认命令；记录玩家名、商品 UID/报价编号、时间和完整提示，交给管理员核查。

七、管理员参考

本节面向服务器管理员。普通玩家只需要阅读前六节。

全量管理员权限为 igngeconomy.admin（默认授予 OP）。管理员命令中的 <minecraft_username> 填写 Minecraft 游戏名，不填写 IGNG 数字 ID。

状态、账户与查询

/eco admin menu
/eco admin status
/eco admin reload
/eco admin refresh-identity <minecraft_username>
/eco admin servers
/eco admin account <minecraft_username>
/eco admin orders <minecraft_username>
/eco admin offers <minecraft_username>
/eco admin trades <minecraft_username>
/eco admin claims <minecraft_username>
/eco admin ledger <minecraft_username>
/eco admin audit <minecraft_username> [条数]
/eco admin inspect <order|offer|claim> <编号>

这些命令用于确认当前服务器的账户、订单、报价、交易、流水和待领取记录。status 还可以检查数据库、身份服务、AuthMe 和待领取数量等运行状态。

余额、账户与业务处理

/eco admin adjust <minecraft_username> <signed_delta> <原因>
/eco admin freeze <minecraft_username> <原因>
/eco admin unfreeze <minecraft_username> <原因>
/eco admin order <cancel|suspend|release> <订单号> <原因>
/eco admin offer <cancel|suspend|release> <报价编号> <原因>
/eco admin recover-claims <原因>
/eco admin resolve-claim <领取编号> <delivered|retry> <原因>

adjust 调整当前服务器的可用余额，必须填写原因并保留审计记录。
freeze / unfreeze 用于账户风控处理。
order 和 offer 用于暂停、恢复或取消异常业务。
recover-claims 只把超时的投递记录标记为待核实，不会自动把物品再次发出。
管理员核对玩家背包、邮箱和投递记录后，再使用 resolve-claim delivered 或 resolve-claim retry。不确定是否已经发货时，不要直接选择 retry，避免重复发放。

规则与官方收购

/eco admin rule list
/eco admin rule block material <材质> <ALL|MARKET|OFFER|BUYBACK> <原因>
/eco admin rule block hand <ALL|MARKET|OFFER|BUYBACK> <原因>
/eco admin rule unblock <规则编号> <原因>
/eco admin buyback list
/eco admin buyback quota <minecraft_username>
/eco admin buyback history <minecraft_username>
/eco admin buyback <enable|disable> <规则编号> <原因>

调整物品规则前，应先确认影响范围（全部业务、市场、报价或官方收购）。价格、每日额度和启停状态以数据库规则为准；修改后用玩家实际命令和管理员查询进行回读确认。

细分权限

权限节点	能力
`igngeconomy.admin.view.status`	状态、服务器列表、刷新身份
`igngeconomy.admin.view.account`	查看玩家账户
`igngeconomy.admin.view.market`	查看市场订单与详情
`igngeconomy.admin.view.offer`	查看报价与详情
`igngeconomy.admin.view.claim`	查看待领取记录与详情
`igngeconomy.admin.view.ledger`	查看流水、交易和收购历史
`igngeconomy.admin.view.rule`	查看物品规则
`igngeconomy.admin.view.buyback`	查看官方收购规则、额度和历史
`igngeconomy.admin.audit`	查看审计记录
`igngeconomy.admin.adjust`	调整可用余额
`igngeconomy.admin.manage.account`	冻结或解冻账户
`igngeconomy.admin.manage.order`	暂停、恢复或取消订单
`igngeconomy.admin.manage.offer`	暂停、恢复或取消报价
`igngeconomy.admin.manage.claim`	恢复或处理投递记录
`igngeconomy.admin.manage.rule`	新增或停用物品规则
`igngeconomy.admin.manage.buyback`	启用或停用官方收购规则

管理员处理经济、物品或领取异常时，应优先查询再操作，填写清晰原因，并保留操作编号和玩家反馈。完整服务器验收仍需在实际 Paper/Folia、数据库和玩家客户端环境中进行。