quickbar.yml

quickbar.yml 只在游戏服管理对局成员的快捷道具与战术万用菜单。大厅服不会发放或识别这些入口。

快捷栏槽位

items.equipment、items.backpack、items.safebox 分别配置选装、战术背包和保险库。slot 使用玩家快捷栏的零基索引，默认值为 6、7、8，三者必须互不重复。

每个图标支持：

• material：有效的 Bukkit 物品材质。
• name：显示名称模板。
• lore：Lore 模板列表。
• custom-model-data：可选非负整数；省略时使用原版模型。

服务端使用隐藏 PDC 标识判断功能道具，材质、名称、Lore 和 CustomModelData 只负责展示，不能用于伪造功能入口。

模板变量

名称和 Lore 都支持 PlaceholderAPI，以及以下内置变量：

范围	变量
通用	{player}、{phase}、{seconds}、{players}
战术背包	{tier}、{width}、{height}、{used}、{total}、{available}
保险库	{tier}、{width}、{height}、{used}、{total}、{access}
装备选择	{equipped}
万用菜单按钮	{availability}
离场确认	{leave_warning}、{leave_backpack}、{leave_kits}

used 按网格物品实际覆盖的格数计算，不是物品种类或堆叠数量。异步存档尚未加载时会显示加载状态，不会猜测数值。

万用菜单

menu.icons 配置状态、选装、背包、保险库、离场、确认和返回按钮，同样支持 custom-model-data、名称/Lore 模板和 PlaceholderAPI。修改后执行 /fkescape admin reload；整份配置会先完整校验，失败时继续使用旧配置。