商店

打开商店管理商品、检查购买记录、配置玩家命令及编辑消息模板。支付使用经济模块管理的虚拟货币。玩家也可以通过独立的玩家中心购买。

启用商店和命令

1. 打开配置，启用商店，核对三个命令的名称、别名和启用状态。
2. 输入名称时不要包含聊天前缀。名称和别名不能与其他功能冲突；可在聊天与控制台中检查实际命令目录。
3. 保存配置。描述覆盖留空使用服务端语言默认值。界面语言按钮填入明确的草稿；希望它成为全局覆盖时才保存。恢复描述默认值后，下次保存会清除覆盖。

截图来自运行中的前端及已配置的开发后端。命令名称反映截图时的配置。

以下示例使用默认的 / 前缀和命令名称。若服务器已修改配置，请使用实际生效的名称。

玩家命令	用途
/shop [page]	列出可购买商品，每页最多十条。
/shop search Starter pack 2	搜索完整短语 Starter pack 2。
/shop 2 search Starter pack 2	打开该搜索结果的第二页。
/shopinfo <product-key>	查看价格、交付设置、限制和礼包内容。
/buy <product-key> [quantity]	使用虚拟货币购买，数量默认为一。

玩家只能看到已启用且定义可用的商品。停用商品及定义缺失的商品仍向操作员展示，便于修复。搜索翻页时使用返回的下一页命令，以保留搜索内容。

创建商品

1. 在商品目录中选择新增商品，填写稳定的商品键和显示名称。玩家在 /buy 中使用商品键。
2. 设置单价、分类、排序值和启用状态，再按所选类型设置最大购买数量及交付内容。
3. 核对每位玩家的购买冷却和每日限购。冷却填零表示不限制间隔；每日限购留空表示按 UTC 日期不限量。
4. 保存后通过 /shopinfo 检查已启用商品，核对已发布的价格及交付设置。

类型	交付设置
物品	已加载的物品定义、每个购买单位的发放数，以及定义支持的质量、耐久度和物品 Mods。
方块	已加载的方块定义及发放数；不支持质量和物品 Mods。
Buff	每次购买施加一次原生 Buff；购买数量与发放数均固定为一。
礼包	1–50 个有序的物品、方块、Buff 或命令动作；购买数量为一。不允许嵌套礼包或重复 Buff 定义。
控制台命令	已注册的控制台命令和操作员配置的参数模板；购买数量为一。

物品和方块的实际发放总数为每单位发放数 × 购买数量。礼包价格、冷却和每日限购针对整个礼包。修改或删除商品不会改变已有订单的交付快照。

编辑器分为基本信息、商品内容和价格与购买限制。定义及命令选择器支持搜索，可输入内部名称查找准确定义。物品与方块商品可展开高级发放设置，配置所支持的质量、耐久度及 Mods。

编辑礼包

选择礼包并添加内容行。每行包含类型、可搜索的定义或命令选择器、适用的发放数量及可展开的设置。一次只展开一行，折叠或调整顺序不会丢弃草稿。通过上移、下移控制交付顺序。保存时会展开无效行并显示字段错误。最多允许 50 个动作，不允许重复 Buff 定义。

截图是未保存的礼包草稿，没有为截图创建商品。

查看 Buff 效果

选择 Buff 定义后，查看效果描述、原生默认时长和重复施加规则。默认时长为零表示不按时长自动结束，游戏事件仍可能移除效果。原生叠加规则决定重复施加时忽略、延长时长、叠加效果还是替换已有状态。再次购买不一定延长 Buff。

截图为未保存的编辑器，buffcoffee 来自真实服务器目录。截图时没有保存商品或施加 Buff。即使界面标签与描述已本地化，定义显示名称仍可能保留游戏启动时的语言。

配置控制台命令商品

选择已注册的命令，单独填写参数。支持的可选变量为 {PlayerId}、{PlayerEntityId} 和 {PurchaseId}。模板必须为单行，最多 2,000 个字符。玩家只能购买预设动作，不能自行提供控制台参数。

启用前应核对命令的实际作用：命令即使最终报错，也可能已经改变游戏状态。调用完成不代表已验证第三方命令的预期效果。

检查购买与交付

在购买记录中按玩家、商品、状态或日期筛选，再打开记录详情。不常用条件位于高级筛选；展开保留当前查询，重置会清除可见及隐藏条件。状态默认为全部。将记录的扣款引用与经济流水核对，检查不可变的交付动作、各动作结果、尝试历史及计划重试时间。

只有在任何动作成功之前，因玩家不可用而明确未交付的情况，才可能自动重试：包括首次交付最多三次，相邻间隔为 30 秒和 60 秒。超时、中断执行和礼包部分交付需要人工检查，因为效果可能已经生效。

对于**结果不确定（Uncertain）**的订单，先检查记录证据及游戏实际状态，再选择处理方式：

处理方式	结果
确认已交付	由操作员将订单标记为已交付，不再次执行交付。
重新交付	执行原始快照。礼包必须明确选择一个剩余动作；已成功动作不会重复。
退款	整单退款；不会收回已发放的物品或效果。
关闭	关闭记录，不交付也不退款。

单个动作修复成功后，其他动作仍可能让整单保持不确定。人工补发不会安排后续自动重试。礼包没有按比例退款或自动回滚，不要仅因请求超时就重复施加效果。

编辑玩家消息

打开消息模板，选择通用、目录与详情或购买与交付分组，检查各模板支持的变量。占位文本显示服务端语言默认值。界面语言按钮填入草稿，保存将其设为不随玩家语言变化的全局覆盖。恢复默认移除覆盖，使运行时消息重新跟随游戏语言。

目录翻页提示应在 shop.catalog-more 使用 {NextCommand}，让返回命令保留搜索词。未知或格式错误的变量会被拒绝；需要静态文本时可省略支持的变量。切换商店视图会保留本地草稿，离开页面前应检查未保存修改。