Appearance
backpack.yml:战术背包档位
背包是单次入场权益。玩家购买的是下一次准入要消费的档位,不是永久容器;扣款结果不确定时系统不会自动退款或重复发货。
固定结构与字段
档位 ID 必须且只能是 small、medium、large、huge,不能增删或改名;根节点也只能有 default-tier、tiers。
| 路径 | 类型 / 默认示例 | 约束与含义 | 生效 |
|---|---|---|---|
default-tier | ID / small | 默认选择,必须引用四个档位之一 | 热重载 |
tiers.<id>.width | 整数 / 4 | 网格宽,1..4 | 热重载;进行中的游戏服下一次准入使用 |
tiers.<id>.height | 整数 / 2..6 | 网格高,1..6 | 同上 |
tiers.<id>.price | 数字 / 500.0 | Vault 扣款金额,必须 >= 0 | 热重载 |
tiers.<id>.priority | 正整数 / 10 | 档位顺序,四档不可重复 | 热重载 |
高 priority 档位的宽和高不得小于低档,面积必须严格更大,价格不得更低。商店 tabs.backpack.entries 必须一一陈列这四个 ID,售价只取本文件,不能在 shop.yml 重复写。
完整默认配置
yaml
default-tier: small
tiers:
small:
width: 4
height: 2
price: 500.0
priority: 10
medium:
width: 4
height: 3
price: 1500.0
priority: 20
large:
width: 4
height: 4
price: 4000.0
priority: 30
huge:
width: 4
height: 6
price: 10000.0
priority: 40常见错误与验证
- 添加
starter、漏掉huge、额外写name都会因严格键校验失败。 priority相同、容量倒退或高档更便宜都会失败。- 修改后执行
/fkescape admin reload;在大厅打开/fkescape shop,核对四档价格;用测试账号购买一次并报名,确认权益只消费一次且背包尺寸正确。