玩家商店界面
玩家商店界面组包含五个配置文件，覆盖玩家商店的物品展示模板、浏览列表、商品编辑、上架管理和摆摊模型选择。
玩家商店物品模板（player_shop_item.yml）
纯模板文件，无 layout 和 icons 定义。用于控制玩家商店中每个物品的展示样式。
模板变量
template:
lore:
- '{lore}'
- ''
- '&7卖家: &f{seller}'
- '&7价格: &e{price}'
- '&7税率: &6{tax_rate}%'
- '&7卖家实收: &a{seller_income}'
- '&7税费: &c{tax_amount}'
- '&7库存: &a{stock}'
- '{action_hint}'
| 变量 | 说明 |
|---|---|
{lore} | 物品描述 |
{seller} | 卖家名称 |
{price} | 价格 |
{tax_rate} | 当前成交税率百分比 |
{tax_amount} | 税费金额 |
{seller_income} | 卖家实收金额 |
{stock} | 库存数量 |
{action_hint} | 动态操作提示（购买/自有物品操作等） |
玩家商店浏览列表（browse_player_shops.yml）
浏览某个玩家商店类型下的所有玩家商店。
title: '&0浏览玩家商店'
layout:
- '#########'
- ' g g g g '
- ' g g g g '
- '#########'
- 'P###S###N'
布局字符
| 字符 | 含义 |
|---|---|
g | 商店槽位（共 8 个，分两行） |
P | 上一页 |
S | 搜索店主 |
N | 下一页 |
| 图标 | 左键 |
|---|---|
P | page pre |
S | malkuth player_shop_browse search |
N | page next |
备注
此界面无 template 定义，商店槽位内容由系统代码直接控制。S 搜索按钮会关闭界面并等待玩家在聊天栏输入店主名称或 UUID，输入 clear 可清空搜索，输入 cancel 可返回当前搜索结果。
商品编辑界面（edit_goods.yml）
玩家商店中编辑已上架商品，支持修改价格、描述、名称、Custom Model Data 和材质。
title: '&0编辑商品 {page}/{max-page}'
layout:
- '#########'
- '####g####'
- '#l#n#c#m#'
- '####p####'
- '#########'
- '#P#B#C#N#'
布局字符
| 字符 | 含义 |
|---|---|
g | 当前编辑的商品展示 |
l | 修改商品描述（lore） |
n | 修改商品显示名（name） |
c | 修改 Custom Model Data |
m | 修改商品材质（material） |
p | 修改商品价格（price） |
P | 上一个商品 |
B | 返回上一操作 |
C | 关闭界面 |
N | 下一个商品 |
图标动作
| 图标 | 左键 |
|---|---|
p | malkuth modify price |
l | malkuth modify lore |
n | malkuth modify name |
c | malkuth modify model_data |
m | malkuth modify material |
P | page pre |
B | menu back |
C | menu close |
N | page next |
提示
修改操作（修改价格/描述/名称/CMD/材质）点击后会关闭 GUI，在聊天栏等待输入新值。其中价格、CMD 和材质由系统预校验格式。
模板变量
| 变量 | 说明 |
|---|---|
{lore} | 商品描述 |
{price} | 当前价格 |
{amount} | 数量 |
商品上架界面（upload_shop.yml）
管理玩家商店中已上架的商品，支持上架新商品。
title: '&0上架商品 {page}/{max-page}'
layout:
- '#########'
- ' ggggggg ' # x4 行
- 'P###U###N'
布局字符
| 字符 | 含义 |
|---|---|
g | 已上架商品槽位（共 28 个，4 行） |
P | 上一页 |
U | 上架新商品 |
N | 下一页 |
| 图标 | 左键 |
|---|---|
P | page pre |
U | malkuth player_shop upload |
N | page next |
模板变量
| 变量 | 说明 |
|---|---|
{lore} | 物品描述 |
{price} | 价格 |
{amount} | 数量 |
摆摊模型选择（stall_model_select.yml）
开启 config.yml -> player-shop-block.stall-entity.enabled 后，玩家可通过 /malkuth place model 打开摆摊模型选择界面。
title: '&0选择摆摊形象'
layout:
- '#########'
- ' m m m m '
- ' m m m m '
- '#########'
- '####B####'
布局字符
| 字符 | 含义 |
|---|---|
m | 可用模型槽位 |
B | 关闭界面 |
# | 填充 |
图标动作
模型槽位由系统代码绑定点击逻辑，不需要在 icons.m.actions 中配置动作。
| 图标 | 左键 |
|---|---|
m | 切换为该摆摊模型 |
B | menu close |
模板变量
| 变量 | 说明 |
|---|---|
{model_id} | 模型 ID |
{model_display} | 模型显示名 |
{permission} | 使用该模型所需权限；为空时显示语言文件中的“无” |
{selected} | 当前正在使用该模型时显示选中标记 |
提示
可选模型来自 config.yml -> player-shop-block.stall-entity.default-model 与 models。如果模型配置了 permission，只有拥有该权限的玩家才会在界面中看到并选择它。