跳到主要内容

拍卖行界面

拍卖行界面组包含三个列表与管理配置文件,覆盖拍卖物品展示模板、我的出价和我的拍品管理。点击上架后会进入已接入的 auction_create.yml 创建编辑器,完整流程见 上架创建编辑器。

拍卖物品展示模板(auction_item.yml)​

纯模板文件,无 layout 和 icons 定义。用于控制拍卖行列表中每个物品的展示样式。

模板变量​

template:
lore:
- '{lore}'
- ''
- '&e起拍价: &f{start_price}'
- '&e当前价: &a{current_price}'
- '&e下次出价: &a{next_bid_price} &7({bid_rule})'
- '&e一口价: &6{buyout_price}'
- '&e一口价差额: &6{buyout_difference}'
- '&e预计税率: &6{tax_rate}%'
- '&e预计实收: &a{seller_income}'
- '&e预计税费: &c{tax_amount}'
- '&e最高出价者: &f{bidder}'
- '&e剩余时间: &f{remaining}'
- ''
- '&a左键竞拍 &7| &6右键一口价购买'
变量说明
{lore}物品描述
{start_price}起拍价
{current_price}当前出价
{next_bid_price}下一次左键出价金额
{bid_increment}本次最低加价金额
{bid_rule}加价规则文本
{buyout_price}一口价文本;未设置时显示默认无一口价文本
{has_buyout} / {buyout_available}当前拍品是否设置一口价
{buyout_difference}当前价距离一口价的差额文本
{bidder}最高出价者
{seller}卖家名称
{remaining}剩余时间
{bid_percent}加价百分比
{tax_rate}当前成交价下的预计税率百分比
{tax_amount}当前成交价下的预计税费
{seller_income}当前成交价下的预计卖家实收
{currency_mode}当前拍卖行货币模式,通常为 single 或 multiple
{currency_options}当前拍品可用的货币选项摘要
{currency_selected}当前已选择的货币;未选择时显示默认状态
备注

当前默认 auction_item.yml 只提供 template.lore,不再通过 messages.bid_percent 控制加价显示;{bid_percent}、{bid_rule}、{next_bid_price} 等值来自 shop/auction.yml -> bid.*。

拍品槽位的点击语义​

拍卖列表里每个拍品槽位由系统绑定点击语义,不需要配置:

操作行为
左键竞拍出价
右键一口价买断
Shift + 左键拍品是潜影盒或收纳袋时,打开内容预览

预览界面是只读的,所有点击都会被取消,关掉后自动回到原来那一页拍卖列表。容器里没有任何物品时只发一条提示,不会打开空界面。想在展示模板里提示玩家这个操作,可以在 template.lore 里加一行说明。

拍卖列表还会把当前支付配置作为上下文提供给模板:{currency_mode}、{currency_options}、{currency_selected}。single 模式在出价或一口价前使用选中的货币,multiple 模式按顺序同时处理全部货币。

商店没有开启一口价(shop/auction.yml -> buyout.enabled: false)时,右键不会买断,创建编辑器里也会直接拒绝输入一口价并提示当前拍卖行未启用该功能。

拍卖行我的出价(auction_my_bids.yml)​

查看自己已出价的拍卖物品列表。

title: '&6我的出价'

layout:
- '#########'
- ' ggggggg '
- ' ggggggg '
- ' ggggggg '
- ' ggggggg '
- 'B########'

布局字符​

字符含义
g拍卖物品槽位(共 28 个,4 行)
B返回
图标左键
Bmenu back

模板变量​

变量说明
{lore}物品描述
{current_price}当前出价
{my_bid}我的出价
{remaining}剩余时间

拍卖行我的拍品(auction_upload.yml)​

管理自己上架的拍卖物品,支持上架新拍品。

title: '&6我的拍品'

layout:
- '#########'
- ' ggggggg '
- ' ggggggg '
- ' ggggggg '
- ' ggggggg '
- 'B###U####'

布局字符​

字符含义
g拍品槽位(共 28 个,4 行)
B返回
U上架拍卖物品
图标左键
Bmenu back
Umalkuth auction upload

模板变量​

变量说明
{lore}物品描述
{start_price}起拍价
{current_price}当前出价
{remaining}剩余时间

拍卖创建编辑器(auction_create.yml)​

auction_upload.yml 的 U 按钮会打开独立创建编辑器,不再通过连续聊天输入直接提交。

layout:
- '#########'
- '##g#P#O##'
- '##A#R#D##'
- '####I####'
- '##Y#B#C##'

编辑器支持起拍价、一口价、数量和拍卖时长草稿。P、O、D、I 分别调用 malkuth upload input price、input buyout、input duration、input amount;A / R 按点击档位增减数量;Y 只进入 upload_create_confirm.yml,不会直接创建拍卖。

可用变量为 {amount}、{max_amount}、{start_price}、{buyout_price}、{duration}、{shop}、{currency_mode}、{currency_options}、{currency_selected}。K 图标(默认由源码补入)执行 malkuth auction currency 打开货币选择;single 模式在多选项时提交前必须明确选择,multiple 模式显示全部支付项。默认布局、完整动作表、输入限制和草稿边界见 上架创建编辑器。