上架创建编辑器
上架创建编辑器把全球市场、拍卖行和全球求购的创建流程统一为“选择商店 → 编辑草稿 → 复核 → 真实提交”。本页说明 upload_shop_select.yml、global_market_create.yml、auction_create.yml 和 upload_create_confirm.yml。
全球求购使用同一套草稿、输入和确认机制，但编辑页布局仍由 upload_global_request.yml 控制。
草稿、输入与确认边界
- 玩家从背包选择物品后，系统记录来源槽位与选择时的物品快照；全球市场和拍卖行的数量不能超过该槽位当时的数量。
config.yml -> upload_editor.input_mode控制数值输入方式：auto优先使用牌子，不支持或打开失败时回退聊天；sign只使用牌子；chat只使用聊天栏。备注和自定义匹配规则固定使用聊天输入。menu back返回来源界面时保留草稿；malkuth upload cancel会清理草稿并返回来源界面。草稿默认保留 300 秒，实际时间由draft_timeout_seconds控制。malkuth upload review只校验草稿并进入共享确认页，不会直接扣物、扣款或写入挂单。若confirm_before_submit: false，校验通过后会跳过确认页直接提交。- 启用确认页时，只有
malkuth upload confirm_submit会进入真实提交阶段；关闭confirm_before_submit时则由review校验后直接提交。提交前都会再次核对权限、草稿状态、来源槽位与所需数量；重复点击会被提交中状态拦截。 - 全球求购是否要求样品仍在来源槽位，取决于商店的
request.consume_sample_item；其余创建模式在提交前都要求来源槽位保持一致。
上架商店选择（upload_shop_select.yml）
当同一种模式存在多个可用商店时，这个界面让玩家先选择目标商店。
title: '&0选择上架商店'
layout:
- '#########'
- '#ggggggg#'
- '#ggggggg#'
- 'B########'
icons:
'#':
material: GRAY_STAINED_GLASS_PANE
name: '&7 '
B:
material: ARROW
name: '&c返回'
actions:
left:
- 'menu back'
布局字符
| 字符 | 含义 |
|---|---|
g | 候选商店分页槽；候选图标由系统生成 |
B | 返回来源入口；没有来源回调时关闭界面 |
# | 填充 |
候选商店图标固定显示商店展示名、商店 Key 和当前创建模式，不读取 template。点击候选项后才会创建或打开对应商店的编辑草稿。
全球市场创建（global_market_create.yml）
全球市场创建页用于选择物品、设置上架数量与价格，再进入共享确认页。
layout:
- '#########'
- '##g#P#A##'
- '###D#I###'
- '##Y#B#C##'
布局字符
| 字符 | 含义 |
|---|---|
g | 当前选择物品的不可拿取预览 |
P | 输入价格；根据商店购买模式显示“单价”或“整批总价” |
A | 增加上架数量 |
D | 减少上架数量 |
I | 输入精确数量 |
Y | 校验草稿并进入确认页 |
B | 返回上架管理列表并保留草稿 |
C | 取消并清理草稿 |
# | 填充 |
图标动作
| 图标 | 左键 | 右键 | Shift+左键 | Shift+右键 |
|---|---|---|---|---|
P | malkuth upload input price | — | — | — |
A | malkuth upload amount increase left | malkuth upload amount increase right | malkuth upload amount increase shift_left | malkuth upload amount increase shift_right |
D | malkuth upload amount decrease left | malkuth upload amount decrease right | malkuth upload amount decrease shift_left | malkuth upload amount decrease shift_right |
I | malkuth upload input amount | — | — | — |
Y | malkuth upload review | — | — | — |
B | menu back | — | — | — |
C | malkuth upload cancel | — | — | — |
数量按钮按左键 1、右键 8、Shift+左键 32 调整；Shift+右键增加时直接取来源槽位最大数量，减少时回到 1。精确数量必须大于 0 且不能超过来源槽位数量，价格必须是大于 0 的有限数字。
可用变量
| 变量 | 说明 |
|---|---|
{amount} | 当前上架数量 |
{max_amount} | 选择物品时来源槽位中的最大数量 |
{price} | 当前价格 |
{price_label} | 单价 或 整批总价 |
{shop} | 当前商店 ID |
拍卖创建（auction_create.yml）
拍卖创建页在统一数量和价格编辑基础上，增加一口价与拍卖时长。
layout:
- '#########'
- '##g#P#O##'
- '##A#R#D##'
- '####I####'
- '##Y#B#C##'
布局字符
| 字符 | 含义 |
|---|---|
g | 当前拍品的不可拿取预览 |
P | 输入起拍价 |
O | 输入或清除一口价 |
A | 增加拍品数量 |
R | 减少拍品数量 |
D | 输入拍卖时长 |
I | 输入精确数量 |
Y | 校验草稿并进入确认页 |
B | 返回拍品管理列表并保留草稿 |
C | 取消并清理草稿 |
# | 填充 |
图标动作
| 图标 | 左键 | 右键 | Shift+左键 | Shift+右键 |
|---|---|---|---|---|
P | malkuth upload input price | — | — | — |
O | malkuth upload input buyout | — | — | — |
A | malkuth upload amount increase left | malkuth upload amount increase right | malkuth upload amount increase shift_left | malkuth upload amount increase shift_right |
R | malkuth upload amount decrease left | malkuth upload amount decrease right | malkuth upload amount decrease shift_left | malkuth upload amount decrease shift_right |
D | malkuth upload input duration | — | — | — |
I | malkuth upload input amount | — | — | — |
Y | malkuth upload review | — | — | — |
B | menu back | — | — | — |
C | malkuth upload cancel | — | — | — |
起拍价必须大于 0。一口价输入 0 或 skip 可以清除，但最终仍会受商店一口价开关、必填规则和最低倍数限制；一口价不能低于起拍价。拍卖时长必须处于 shop/auction.yml -> upload.min_duration_hours 与 max_duration_hours 之间。
可用变量
| 变量 | 说明 |
|---|---|
{amount} | 当前拍品数量 |
{max_amount} | 选择物品时来源槽位中的最大数量 |
{start_price} | 当前起拍价 |
{buyout_price} | 当前一口价；未设置时显示空值文本 |
{duration} | 当前拍卖时长，单位小时 |
{shop} | 当前商店 ID |
共享创建确认（upload_create_confirm.yml）
全球市场、拍卖行和全球求购共用这个高风险确认页。
title: '&4确认高风险创建'
layout:
- '#########'
- '####g####'
- '#########'
- '##Y#B#C##'
布局字符
| 字符 | 含义 |
|---|---|
g | 不可拿取的物品或样品预览 |
Y | 确认创建并进入真实提交阶段 |
B | 返回编辑页并保留草稿 |
C | 取消并清理草稿 |
# | 红色风险提示填充 |
| 图标 | 左键 |
|---|---|
Y | malkuth upload confirm_submit |
B | menu back |
C | malkuth upload cancel |
可用变量
| 变量 | 说明 |
|---|---|
{mode} | 当前创建模式 |
{shop} | 当前商店 ID |
{amount} | 当前数量 |
{price} | 当前价格或起拍价 |
{buyout_price} | 当前一口价 |
{duration} | 拍卖时长，或全球求购有效期小时数 |
{expire_time} | 全球求购预计到期时间；其他模式为 - |
{total_amount} | 本次创建对应的金额；拍卖按起拍价显示，其他模式按价格乘数量计算 |
确认页打开前会先验证物品、数量、价格、拍卖时长、一口价关系和自定义匹配规则。验证失败时会返回编辑页，不会进入提交阶段。