16 min read

玩家市场——使用手册

本文面向普通玩家，介绍自由市场、系统商店、费用、账户等级、仓库和命令。文中的数值是插件默认值；服务器管理员可以修改费用、期限、等级和商店报价，请以游戏内当前显示为准。

1. 快速开始

  • 输入 /market 打开玩家市场 GUI。
  • 输入 /market help 查看游戏内命令帮助。
  • 自由市场是玩家之间的匿名订单簿，不显示买卖双方身份。
  • 系统商店由服务器创建，和玩家自由市场是两套入口、两套报价。
  • 账户使用玩家 XUID 记录；改名不会产生新账户。
  • 上架、求购、快速买卖、取消/改价、资产领取、升级和系统商店交易的成功、部分完成、待复核或失败会同时显示聊天栏明细和个人顶部 Toast；Toast 只发送给发起操作的玩家，不会全服广播。

最常用的操作：

  1. 买东西：/market -> 浏览市场 -> 选择物品和具体报价 -> 快速购买。
  2. 卖东西：手中或背包里准备物品 -> /market -> 出售物品 -> 选择物品、数量、单价和期限。
  3. 查看资产：/market warehouse 查看待领取物品，/market pending 查看待领取货币。
  4. 查看订单：/market orders；查看成交：/market history。

2. 自由市场与系统商店的区别

项目 玩家自由市场 系统商店
交易对象 其他玩家的匿名订单 服务器配置的固定报价
价格 玩家下单，按价格和时间撮合 管理员配置固定单价
买方手续费 无，买方只支付成交额 无自由市场手续费，只支付报价金额
卖方手续费 成交手续费始终由卖方承担 无自由市场成交手续费
买到的物品 进入市场仓库，再由玩家领取到背包 直接进入背包；背包放不下时不会扣款
卖出的物品 上架托管或快速卖给收购订单 从玩家背包移除后由系统回收
对手身份 匿名 显示系统商店名称

自由市场不能购买自己的出售订单，也不能把物品卖给自己的收购订单。

3. 费用计算

3.1 上架费

创建出售订单和收购订单都会收取一次上架费：

上架费 = 向上取整(
  当前等级基础费
  + 数量 × 单价 × 上架价值费率 / 10000
  + 向上取整(数量 / 100) × 每 100 件每日托管费 × 期限天数
)

默认参数：

  • 上架价值费率：60 bps，即 0.6%
  • 每 100 件每日托管费：8
  • 等级基础费：Lv.1 至 Lv.5 分别为 100 / 80 / 60 / 50 / 40

示例：Lv.1 上架 65 件物品，单价 100，期限 3 天：

基础费 100
价值费 = 向上取整(65 × 100 × 60 / 10000) = 39
托管费 = 向上取整(65 / 100) × 8 × 3 = 24
上架费 = 100 + 39 + 24 = 163

注意：

  • 上架费在订单创建时收取一次。
  • 托管费按“每 100 件每天”预收，至少计 1 天。
  • 出售订单会先扣上架费，再按精确物品快照托管物品；明确扣物失败时会退回上架费。
  • 收购订单会一次扣除“最大收购金额 + 上架费”，最大收购金额进入订单托管。
  • 提前取消、提前完全成交或改价替换时，退还未使用整天的托管费；固定费和价值费不退。退款进入“待领取货币”。
  • 自然到期不退托管费。部分成交但订单仍活动时暂不退，订单最终提前结束时再统一计算。
  • 改价/续期采用“替换订单”：旧订单变为已替换并结算旧托管费，新订单重新计算并收取一次完整上架费，同时失去原来的排队时间优先级。
  • 旧订单如果没有保存费用拆分数据，为避免错误退款，托管费退款为 0。
  • 快速购买和快速出售不会收上架费，因为它们不创建长期订单。

3.2 自由市场成交手续费

默认成交手续费率为 1300 bps，即 13%，始终由卖方承担：

成交额 = 成交数量 × 成交单价
卖方手续费 = 向上取整(该出售订单累计成交额 × 费率) - 已收手续费
卖方实收 = 本次成交额 - 本次卖方手续费
买方支付 = 本次成交额

按订单累计计算是为了避免一个订单被拆成多笔成交后重复向上取整。例：成交额 1000，默认手续费为 130，买方支付 1000，卖方实收 870。

3.3 仓库赎回费

默认免费仓库容量为 50 条记录、合计 4096 件物品。免费期或容量溢出规则见“仓库”章节。

只有状态为“需付费赎回”的物品收取赎回费：

赎回费 = 赎回基础费 + 每件费 × 该仓库记录数量

默认是 100 + 1 × 数量。例如一条记录有 64 件，赎回费是 74。免费领取和受保护记录不收费；背包容量不足时不会扣费。

3.4 升级费

满足下一等级的全部条件后，执行升级时扣除目标等级配置的升级费。默认升级费为：

升级到 费用
Lv.2 10,000
Lv.3 50,000
Lv.4 200,000
Lv.5 1,000,000

升级使用当前自由市场的结算货币。

4. 账户等级与限制

新账户从 Lv.1 开始。以下为默认限制：

等级 同时收购订单 同时出售订单 出售托管物品上限 收购托管货币上限 单笔最长期限 上架基础费
Lv.1 5 5 2048 100,000 7 天 100
Lv.2 10 10 5,000 200,000 14 天 80
Lv.3 20 20 10,000 500,000 30 天 60
Lv.4 40 40 16,384 1,000,000 60 天 50
Lv.5 80 80 50,000 5,000,000 60 天 40

“出售托管物品上限”是所有未结束出售订单的剩余数量总和；“收购托管货币上限”是所有未结束收购订单的剩余托管金额总和。仓库容量不随等级增加，默认对所有等级相同。

默认升级条件：

目标等级 有效成交笔数 不同交易对手 累计有效成交额 账户天数 升级费
Lv.2 20 10 5,000 7 10,000
Lv.3 100 25 50,000 30 50,000
Lv.4 500 50 500,000 90 200,000
Lv.5 2,000 100 5,000,000 180 1,000,000

这些条件必须全部满足。只有玩家自由市场中已完成的有效成交会增加指标；系统商店交易不计入。使用 /market account 查看当前等级和指标，使用 /market upgrade 尝试升级。

5. 浏览、筛选与分页

GUI 的浏览页支持原版风格的四类筛选：建筑、自然、装备、物品，并支持名称、ID、附魔、耐久、药水、Lore、标签和基岩版 Data Value。

命令浏览每页显示 6 种物品：

/market browse [页码]
/market browse <筛选词> [页码]

示例：

/market browse 2
/market browse 钻石剑
/market browse 装备,锋利
/market browse 久经使用
/market browse dv:5

逗号分隔的多个条件按“同时满足”筛选。DV 是基岩版 Data Value；耐久消耗读取 Damage，两者不是同一个字段。

浏览结果中的物品序号只属于当前玩家，保存 10 分钟。插件在执行购买前还会再次核对该序号对应的 Instrument，防止市场顺序变化后买错物品。序号过期时重新执行 /market browse。

6. 出售物品

GUI

/market -> 出售物品，选择背包中的精确物品组，再填写数量、单价和期限。

命令

命令出售读取玩家当前手持物品：

/market sell <数量> <单价> <期限天>

默认可选期限是 3、7、14、30、60 天，但还必须不超过当前等级的最长期限。上架物品和发布求购时，表单会显示该物品当前的动态或冷启动价格范围；管理员启用强制模式时单价必须在范围内，关闭时范围只作推荐，仍需填写正整数单价。冷启动默认区间为 1 至 200000。

物品上架后会从背包移入订单托管。订单成交时卖方收到“成交额 - 卖方手续费”；若外部经济暂时无法入账，款项进入待领取货币。

7. 快速出售

快速出售会立刻吃掉当前最优的玩家收购订单，不创建长期订单：

/market quicksell <数量> [最低单价]
  • 读取当前手持物品的精确快照。
  • 优先卖给最高价收购订单；同价时先到先得。
  • 可选“最低单价”用于保护价格。
  • 没有符合条件的收购订单时不会扣物。
  • 快速请求一次最多提交 256 个成交分片，未成交数量会安全返回背包；背包明确放不下时转入受保护仓库。
  • 快速出售仍收卖方成交手续费，但不收上架费。

8. 收购订单与快速购买

先使用 /market browse 获取物品序号。

创建长期收购订单：

/market buyorder <物品序号|instrumentId> <数量> <单价> <期限天>

立即购买现有出售订单：

/market quickbuy <物品序号|instrumentId> <数量> [最高单价]
  • 快速购买优先最低价出售订单；同价时先到先得。
  • 可选“最高单价”用于保护价格。
  • 买方只支付实际成交额，不承担玩家市场成交手续费。
  • 玩家自由市场买到的物品进入市场仓库，不直接进入背包。
  • 收购订单按“数量 × 委托单价”托管最大金额；如果实际成交价更低，价差会退回外部余额，失败时进入待领取货币。

9. 订单管理

/market orders [active|history] [页码]
/market cancel <订单序号|orderId>
/market replace <订单序号|orderId> <新单价> <新期限天>
/market history [页码]

订单每页显示 6 条，默认只显示进行中的公开订单；使用 /market orders history 查看已成交、已取消、已过期和已替换订单。订单序号来自当前列表。

  • 取消出售订单：剩余物品优先返回背包；背包明确放不下时转入仓库。
  • 出售订单到期：剩余物品进入仓库。
  • 取消或到期的收购订单：剩余托管货币退回外部余额，无法立即到账时进入待领取货币。
  • 订单改价/续期会创建新订单、重新收上架费并重置价格时间优先级。
  • 已成交、已取消、已过期、已替换或待人工复核的订单不能再次取消或改价。

10. 仓库

自由市场购买、订单到期、部分退回和补偿物品可能进入市场仓库：

/market warehouse
/market claim <仓库序号|warehouseEntryId>

默认状态和时限：

状态 含义 默认处理
免费领取 占用免费记录数和物品数 30 天内免费领取
需付费赎回 免费期已过，或入库时免费容量已满 按记录收赎回费；默认再保留 30 天
受保护 补偿或管理员补发 不收费、不自动过期
已归档 赎回期也已过 玩家不能自行领取，联系管理员复核恢复
待人工复核 外部背包或经济结果不确定 不要反复操作，等待管理员处理

默认免费容量是 50 条记录、合计 4096 件物品。若一次入库只有部分容量，插件会拆成“免费领取”和“需付费赎回”两条记录。

当前仓库限制的是免费区域，不是永久总容量；反复让订单到期可能积累付费或已归档记录。不要把市场仓库当作长期云背包，收到物品后应尽快领取。

领取前会先检查背包是否能放下全部物品。背包不足时不会扣赎回费，也不会改变仓库记录。

11. 待领取货币

/market pending
/market claimmoney <货币序号|货币名称|economyId>

待领取货币用于保存暂时无法写入外部经济的卖款、退款或补偿。余额为 0 的记录不会显示。玩家界面显示管理员配置的货币名称，不要求玩家记忆经济 ID。

unknown 表示外部经济没有明确告诉插件成功或失败。为防止重复发钱，插件会把相关操作冻结为待人工复核，而不是自动重试。

12. 系统商店

/market shop list [页码]
/market shop <商店序号|名称|专用命令|ID> [页码]
/market shop <商店> <buy|recycle> [页码]
/market shop <商店> gui
/market shopbuy <商店> <出售报价序号|offerId> <数量>
/market shopsell <商店> <回收报价序号|offerId> <数量>

管理员也可以为商店注册专用命令，例如 /coinshop。专用命令在服务器启动时注册，商店创建后通常需要重启一次服务器才会出现新命令。

系统商店报价可能有以下限制：商店或报价暂停、库存数量、玩家账户最低等级、每日/每周/每月限额。列表会显示当前可用状态。

系统商店的出售和回收报价可分别设置显示分组。一个方向只有一个分组时直接显示商品；存在多个分组时先选择分组，再浏览组内商品。旧报价自动归入“默认分组”。命令列表会在每条报价上显示分组名。

  • 购买：系统商店先检查背包容量，再扣除“单价 × 数量”，然后把精确物品发到背包。
  • 回收：玩家手持对应的精确物品，系统移除物品后支付“单价 × 数量”；无法立即入账时进入待领取货币。
  • 系统商店不使用玩家自由市场上架费和卖方成交手续费。

13. 物品身份与禁售规则

市场按基岩版物品规则保存原始 ItemSnapshot，并用独立 Instrument 身份撮合。以下差异可能使同名物品成为不同报价：

  • 自定义名称和原版物品类型名
  • Lore
  • 附魔及等级
  • 药水种类和效果
  • 基岩版 Data Value
  • 耐久区间和实际 Damage
  • 其他参与身份的 NBT 或标签

容器类和疑似容器物品会硬拒绝，包括潜影盒、收纳袋以及带未知容器能力/NBT 的物品，以防嵌套资产或复制问题。默认单件物品 NBT 最大 65536 字节；管理员还可以按物品 ID、命名空间、ID 模式、附魔和结构化 NBT 规则禁售。

14. 完整玩家命令速查

命令 作用
/market 或 /market gui 打开玩家 GUI
/market help 显示帮助
/market browse [页码] 浏览自由市场
/market browse <筛选词> [页码] 筛选自由市场
/market account 查看账户等级、指标和限制
`/market orders [active history] [页码]`
/market history [页码] 查看自己的成交历史
/market warehouse 查看仓库
/market pending 查看待领取货币
/market upgrade 尝试升级账户
/market sell <数量> <单价> <期限天> 上架当前手持物品
/market quicksell <数量> [最低单价] 快速卖给收购订单
/market buyorder <物品> <数量> <单价> <期限天> 创建收购订单
/market quickbuy <物品> <数量> [最高单价] 快速购买
/market cancel <订单> 取消活动订单
/market replace <订单> <新单价> <新期限天> 改价或续期，创建替换订单
/market claim <仓库记录> 领取仓库物品
/market claimmoney <货币> 领取待领取货币
/market shop list [页码] 列出系统商店
/market shop <商店> [页码] 列出商店报价
/market shopbuy <商店> <报价> <数量> 从系统商店购买
/market shopsell <商店> <报价> <数量> 向系统商店出售手持物品

尖括号 <...> 表示必填参数，方括号 [...] 表示可选参数。物品、订单、仓库、货币、商店和报价都优先支持相应列表中显示的序号。

15. 出现异常时

  • “没有可成交订单”：当前没有符合物品、价格保护和非本人条件的对手订单。
  • “价格超出范围”：管理员启用强制价格模式时，重新打开表单或浏览市场，按当前已发布区间填写价格；仅推荐模式不会出现此限制。
  • “重复操作/不可变计划变化”：不要继续点击旧表单；关闭后重新打开，避免重复扣款或扣物。
  • “背包容量不足”：清理背包后再购买或领取。
  • “待人工复核”：不要重复提交同一操作，联系管理员并提供发生时间、物品、数量和命令。

Published by: