Skip to content

safebox.yml:保险箱权限档位

保险箱跨局保存。系统按玩家拥有的最高优先级权限决定可写容量;权限降级时保留已有数据并只读,避免裁切或重复迁移物品。

字段参考

档位 ID 必须且只能为 basichightop

路径类型 / 默认示例约束与含义生效
tiers.<id>.permission权限节点三档必须非空且互不重复热重载
tiers.<id>.width整数1..4热重载
tiers.<id>.height整数1..6热重载
tiers.<id>.priority正整数不可重复;越高越优先热重载

高优先级尺寸必须包含低优先级尺寸且面积严格增加。若玩家存档档位高于当前权限档位,SafeBoxManager 以只读方式打开;恢复原权限后可再次写入。

完整默认配置

yaml
tiers:
  basic:
    permission: fkescape.safebox.basic
    width: 2
    height: 1
    priority: 10
  high:
    permission: fkescape.safebox.high
    width: 2
    height: 2
    priority: 20
  top:
    permission: fkescape.safebox.top
    width: 3
    height: 2
    priority: 30

常见错误与验证

  • 不要用同一权限节点表示多个档位。降权只读是固定安全规则,不提供可关闭的配置开关。
  • 不要通过缩小高档尺寸“回收空间”,加载器会拒绝容量倒退。
  • /fkescape admin reload 后分别给测试号三个权限,通过快捷栏最后一格或 Shift + F 万用菜单打开保险库;存入物品,移除高档权限,确认只能查看且物品不被重新发放或裁切。