全球求购界面
全球求购界面组包含五个配置文件,覆盖求购主列表、发布求购、求购详情、供货审核和求购操作确认。
求购主列表(global_request_item.yml)
global_request_item.yml 控制求购单列表的标题、列表模板和默认按钮;主界面也会优先读取 shop/global_request.yml 中的 title、layout 与 icons。
title: '&8全球求购 {page}/{max-page}'
layout:
- '#########'
- '#ggggggg#'
- '#ggggggg#'
- '#ggggggg#'
- 'P#C#M#S#N'
布局字符
| 字符 | 含义 |
|---|---|
g | 求购单槽位 |
P | 上一页 |
C | 发布求购 |
M | 我的求购筛选 |
S | 搜索与排序 |
N | 下一页 |
E | 空状态占位;当前筛选无结果时显示 |
# | 填充 |
图标动作
| 图标 | 左键 | 右键 | Shift+左键 |
|---|---|---|---|
P | page pre | — | — |
N | page next | — | — |
C | malkuth global_request create | — | — |
M | malkuth global_request my_requests | — | — |
S | malkuth global_request search | malkuth global_request clear_all_filters | malkuth global_request sort |
列表中的 g 槽由系统绑定点击语义:求购者左键进详情、右键看供货申请;其他玩家左键进详情、右键提交供货、Shift+左键按最大可提交数量进入确认。
模板变量
| 变量 | 说明 |
|---|---|
{lore} | 样品物品原始描述 |
{request_id} | 求购单 ID |
{requester_name} | 求购者名称 |
{requester_uuid} | 求购者 UUID |
{item_name} | 样品物品显示名 |
{unit_price} | 求购单价 |
{target_amount} | 目标需求数量 |
{filled_amount} | 已成交数量 |
{pending_amount} | 待审核供货数量 |
{remaining_amount} | 剩余可供货数量 |
{escrow_amount} | 当前托管余额 |
{match_mode} | 当前匹配方式 |
{status} | 求购单状态文本 |
{expire_time} | 到期时间 |
{expire_remaining} | 剩余时间 |
{note} | 求购备注 |
{action_hint} | 动态操作提示 |
发布求购(upload_global_request.yml)
发布界面用于手持样品物品创建求购单,玩家可以在 GUI 中输入单价、数量、备注并切换匹配方式。
title: '&0发布求购'
layout:
- '#########'
- '##g#I#M##'
- '#P#A#N#T#'
- '###Y#C###'
布局字符
| 字符 | 含义 |
|---|---|
g | 样品物品预览 |
I | 求购预览信息 |
M | 匹配方式 |
P | 输入单价 |
A | 输入数量 |
N | 输入备注 |
T | 有效期提示 |
Y | 确认发布 |
C | 取消 / 返回 |
# | 填充 |
图标动作
| 图标 | 左键 |
|---|---|
M | malkuth global_request switch_match_mode |
P | malkuth global_request input_price |
A | malkuth global_request input_amount |
N | malkuth global_request input_note |
Y | malkuth global_request confirm_create |
C | menu back |
可用变量
| 变量 | 说明 |
|---|---|
{unit_price} | 当前输入单价;未输入时显示未设置文本 |
{target_amount} | 当前输入数量;未输入时显示未设置文本 |
{escrow_amount} | 预计托管金额 |
{match_mode} | 当前匹配方式 |
{custom_matcher} | 自定义匹配规则摘要;默认显示空文本 |
{note} | 备注 |
{expire_time} | 预计到期时间 |
{expire_remaining} | 预计剩余有效期 |
求购详情(global_request_detail.yml)
详情页用于查看单个求购单,并提供提交供货、查看供货申请、取消求购和刷新状态入口。
title: '&8求购详情 &7{request_id}'
layout:
- '#########'
- '##I#g#S##'
- '#R#O#A#C#'
- '####B####'
布局字符
| 字符 | 含义 |
|---|---|
I | 求购信息 |
g | 样品物品展示 |
S | 提交供货 |
O | 供货申请列表 |
A | 审核提示 |
C | 取消求购 |
R | 刷新状态 |
B | 返回 |
# | 填充 |
图标动作
| 图标 | 左键 |
|---|---|
S | malkuth global_request submit |
O | malkuth global_request offers |
C | malkuth global_request cancel_confirm |
R | malkuth global_request refresh |
B | menu back |
详情页使用与主列表相同的求购单变量,例如 {request_id}、{requester_name}、{unit_price}、{remaining_amount}、{escrow_amount}、{match_mode}、{expire_time}、{note}。
供货审核(global_request_offers.yml)
供货审核界面展示当前求购单下所有待审核供货申请。
title: '&8供货申请 &7{request_id}'
layout:
- '#########'
- '#ggggggg#'
- '#ggggggg#'
- '#R#####B#'
布局字符
| 字符 | 含义 |
|---|---|
g | 供货申请槽位 |
R | 刷新列表 |
B | 返回详情 |
# | 填充 |
图标动作
| 图标 | 左键 |
|---|---|
R | malkuth global_request refresh_offers |
B | menu back |
供货申请槽位由系统绑定点击语义:左键同意供货,右键拒绝供货,Shift+右键批量拒绝当前页。
模板变量
| 变量 | 说明 |
|---|---|
{lore} | 供货物品原始描述 |
{offer_id} | 供货申请 ID |
{request_id} | 所属求购单 ID |
{supplier_name} | 供货者名称 |
{supplier_uuid} | 供货者 UUID |
{item_name} | 供货物品显示名 |
{amount} | 供货数量 |
{unit_price} | 提交时的单价快照 |
{total_price} | 本次供货总价 |
{status} | 供货申请状态 |
{submit_time} | 提交时间 |
求购确认(confirm_global_request.yml)
求购确认界面用于发布、提交、同意、拒绝和取消求购时的二次确认。
title: '&8确认求购操作'
layout:
- '#########'
- '###g#####'
- '#########'
- '##QYIC###'
- '#########'
布局字符
| 字符 | 含义 |
|---|---|
g | 当前操作预览物品 |
Y | 确认执行 |
Q | 减少数量 |
I | 增加数量 |
C | 取消 / 返回 |
# | 填充 |
图标动作
| 图标 | 左键 | Shift+左键 |
|---|---|---|
Y | malkuth global_request confirm | — |
Q | malkuth global_request quantity_decrease | malkuth global_request quantity_decrease_10 |
I | malkuth global_request quantity_increase | malkuth global_request quantity_increase_10 |
C | menu back | — |
模板变量
| 变量 | 说明 |
|---|---|
{lore} | 预览物品描述 |
{action_type} | 操作类型文本 |
{requester_name} | 求购者名称 |
{supplier_name} | 供货者名称;无供货者时显示 - |
{selected_amount} | 当前确认数量 |
{max_amount} | 可调整的最大数量 |
{unit_price} | 单价 |
{total_price} | 总价 |
{match_mode} | 匹配方式 |
{custom_matcher} | 自定义匹配规则摘要 |
{expire_time} | 到期时间 |
{action_hint} | 当前操作确认提示 |
messages 自定义
messages:
create_hint: '&e▶ 点击绿色羊毛确认发布求购'
submit_hint: '&e▶ 点击绿色羊毛确认提交供货'
approve_hint: '&a▶ 点击绿色羊毛确认同意供货'
reject_hint: '&c▶ 点击绿色羊毛确认拒绝供货'
cancel_hint: '&c▶ 点击绿色羊毛确认取消求购'
| 消息键 | 说明 |
|---|---|
create_hint | 发布求购确认提示 |
submit_hint | 提交供货确认提示 |
approve_hint | 同意供货确认提示 |
reject_hint | 拒绝供货确认提示 |
cancel_hint | 取消求购确认提示 |