官方商店、玩家市场与订单订单系统
本页导读
- 官方商店
- 玩家市场
- 订单系统
- 其它
1. 官方商店
官方商店是由服务器管理员（Admin）创建并管理的B2C交易体系。与玩家市场不同，官方商店通常用于维持服务器经济平衡、出售基础物资或投放特殊限定道具。并支持无限库存、上下架时间、支持命令和药水等商品。
商品类型
| 类型标识 | 中文名称 | 功能描述 |
|---|---|---|
COMMAND | 指令执行 | 购买后由控制台或以玩家身份执行预设指令。 |
GIVE_ITEM | 物品发放 | 系统直接生成物理道具并放入玩家背包。 |
POTION_EFFECT | 药水效果 | 购买后为玩家施加特定的 药水效果。 |
RECYCLE_ITEM | 回收/兑换 | 系统以特定价格回收玩家特定物品。 |
GROUP_BUY_VOUCHER | 团购/兑换码 | 交付特定的序列号或兑换凭证，支持群体核销。 |
2、玩家市场
玩家市场是由玩家自主驱动的 C2C 交易体系。它允许玩家上架物品、发布收购单、上架拍卖物品等进行剩余物资的流通，是服务器内部循环经济的核心载体。
(1)三个维度
玩家市场支持多种交易方式，由以下三个维度组合而成（例如：卖家出货 + 一口价 + 手动库存 = 普通上架）。
提示
注意： 并非所有维度组合都为合法有效的交易模式。请参阅下文说明。
| 维度 | 枚举值 | 功能描述 |
|---|---|---|
| 交易方向 (Side) | SELL / BUY | SELL: 卖家主动出货；BUY: 买家发布需求。 |
| 成交机制 (TradeMode) | DIRECT / AUCTION | DIRECT: 一口价即时交易；AUCTION: 竞价拍卖模式。 |
| 库存来源 (SourceMode) | MANUAL / SUPPLY | MANUAL: 手动上架库存；SUPPLY: 关联供货箱自动补货。 |
(2)支持的上架模式
| 上架模式 | Side (方向) | TradeMode (机制) | SourceMode (库存) | 典型应用场景 |
|---|---|---|---|---|
| 普通上架 | SELL | DIRECT | MANUAL | 玩家上架背包里的特定物品，卖完即止。 |
| 供货箱上架 | SELL | DIRECT | SUPPLY | 玩家设立自动商店，库存由关联的箱子自动补充。 |
| 拍卖 | SELL | AUCTION | MANUAL | 珍稀孤品上架，由全服玩家在限时内竞价。 |
| 收购单 | BUY | DIRECT | MANUAL | 买家发布需求，只要有卖家持有对应物品即可成交。 |
3. 订单系统
订单系统是市场交易的逻辑核心，负责记录并处理从“发起交易”到“物资交付”的全过程。它支持订单状态的实时追踪，并内置了完善的退款与冷却机制，确保在异步交易环境下买卖双方的利益不受损失。
(1) 订单状态
| 状态 | 含义 |
|---|---|
PENDING | 待处理 |
WAIT_CLAIM | 待手动领取 |
DELIVERED | 已发货完成 |
REFUNDED | 已退款 |
RECYCLED | 已回收完成（回收型商品） |
ACTIVE | 可交易 |
PAUSED | 暂停交易 |
SOLD | 已售完 |
UNLISTED | 已下架 |
SUPPLY_EMPTY | 库存不足 |
(2) 交易费用字段
| 字段 | 含义 |
|---|---|
buyerTotal | 买家总支付 |
sellerReceive | 卖家实收 |
feeAmount | 手续费（卖家承担） |
taxAmount | 税额（卖家承担） |
这些值受服主的 market_economy（费率/税率）配置影响。
(3) 退款条件
策略受 **是否启用未发放前可退款 **、订单冷静期 及 **退款截止期限 ** 共同影响。
退款并非无条件
订单状态变为 已发放 (DELIVERED) 后通常无法退款；若超过 退款截止期限，退款亦会失败（报错为 refund_expired / 退款已过期）。
4. 其它
(1)动态价格
动态价格是一种基于 供需算法 实时调整的定价机制。系统根据特定周期内的交易频率、库存余量及成交额，自动计算并更新物品的基准单价。
主条目：
| 模块 | 类型 / 模式 | 支持情况 | 驱动逻辑 |
|---|---|---|---|
| 玩家市场 | 出售物品 | 支持 | 动态价格算法 |
| 收购单 | 暂不支持 | 固定价格 | |
| 拍卖 | 不支持 | 拍卖算法 | |
| 官方商店 | 出售物品 | 支持 | 动态价格算法 |
| 回收物品 | 支持 | 动态价格算法 | |
| 指令 / 药水 / 凭证 | 不支持 | 固定价格 |
(2) 拍卖
主条目：
拍卖是一种基于竞价逻辑的特殊交易形式。它适用于价值难以估量或极其稀缺的物品。卖家设定起拍价与加价阶梯，在限定时间内引导买家进行博弈。系统通过订单系统锁定出价最高者的资金，并在结标时自动完成所有权转移。
(3) 上架上限
系统会综合三层来源（优先级由高到低）：
- 用户专属覆盖：管理端网页设置
- 权限节点：
webshop.market.limit.<n>(即将弃用，请改用网页设置) - 全局默认：
marketMaxActiveListings