IGNGEconomy 经济市场插件教程

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

---

快速开始

使用前请确认：

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

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

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

---

一、经济账户与转账

开启或停用账户

/eco enable
/eco disable

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

查询余额与流水

/eco balance
/eco history

余额页面会区分：

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

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

玩家转账

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

示例：

/pay Steve 100

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

---

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

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

1. 把要出售的物品放在主手。

2. 执行：

   /eco sell
   

3. 确认游戏内返回的收购数量、单价和实际到账金额。

默认收购参考

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

物品	默认单价	默认每日单人上限
圆石、泥土、石头、沙砾、沙子	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 市场商品是两套独立流程。

创建报价

1. 将物品放在主手。

2. 执行：

   /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、数据库和玩家客户端环境中进行。