YuVault 命令手册
YuVault 的主命令是 /yvault,默认别名为 /yv 与 /vault。配置中的 commands.yvault 还可以追加动态别名,执行 /yvault reload 后重新注册。
主命令与别名
| 入口 | 用途 |
|---|---|
/yvault | 打开自己的第一个保险柜,或在没有保险柜且可创建时打开创建入口。 |
/yv | /yvault 的短别名。 |
/vault | 更适合写进菜单、NPC 或公告的通用别名。 |
玩家命令
| 命令 | 权限 | 说明 | 示例 |
|---|---|---|---|
/yvault | yuvault.use | 打开自己的第一个保险柜。 | /vault |
/yvault open [编号] | yuvault.use | 打开自己的指定保险柜,编号从 1 开始。 | /yv open 2 |
/yvault list | yuvault.use | 以文字列表查看自己的保险柜,并可点击打开。 | /yvault list |
/yvault gui | yuvault.use | 打开保险柜列表 GUI。 | /vault gui |
/yvault create [编号] [行数] | yuvault.use | 创建自己的保险柜。权限模式下行数由权限决定,命令模式下可指定行数。 | /yvault create 1 |
/yvault reclaimed | yuvault.reclaimed | 打开自己的回收物品界面。 | /yv reclaimed |
/yvault help | 无硬性权限 | 查看帮助菜单;会按权限展示可用管理命令。 | /yv help |
管理命令
| 命令 | 权限 | 说明 |
|---|---|---|
/yvault open <玩家> [编号] | yuvault.admin | 打开指定玩家的保险柜。 |
/yvault list <玩家> | yuvault.admin | 查看指定玩家的保险柜列表。 |
/yvault gui <玩家> | yuvault.admin | 以 GUI 查看指定玩家的保险柜列表。 |
/yvault create <玩家> [编号] [行数] | yuvault.admin | 为指定玩家创建保险柜。 |
/yvault setslots <玩家> <编号> <行数> | yuvault.admin | 在 slot-mode: command 时设置指定保险柜行数。 |
/yvault delete <玩家> <编号> | yuvault.admin | 删除指定保险柜,保险柜内物品会转入回收箱。 |
/yvault adminreclaimed <玩家> | yuvault.adminreclaimed 或 yuvault.admin | 查看并提取指定玩家的回收物品。 |
/yvault reload | yuvault.reload | 重载配置、消息和动态命令别名。 |
编号与行数规则
| 项目 | 规则 |
|---|---|
| 保险柜编号 | 玩家看到的编号从 1 开始,内部保存时转换为从 0 开始。 |
| 行数 | 有效范围是 1-6 行,对应 9-54 格。 |
| 权限模式 | slot-mode: permission 时,行数由 yuvault.slots.<编号>.<行数> 决定,/setslots 会被拒绝。 |
| 命令模式 | slot-mode: command 时,行数由创建参数或 /setslots 写入;未设置时回退到 default-slots。 |
常用示例
bash
/lp group default permission set yuvault.use true
/lp group default permission set yuvault.reclaimed true
/lp group default permission set yuvault.vaults.2 true
/lp group vip permission set yuvault.vaults.5 true
/lp group vip permission set yuvault.slots.1.6 true
/vault gui
/yvault open Steve 1
/yvault delete Steve 2
/yvault adminreclaimed SteveTab 补全
插件会根据权限提供子命令补全:
- 普通玩家可见
open、list、gui、create、reclaimed、help。 - 有
yuvault.reload时追加reload。 - 有
yuvault.admin时追加setslots、delete,并为玩家名和保险柜编号提供补全。 - 有
yuvault.adminreclaimed或yuvault.admin时追加adminreclaimed。