YuVault 常见问题
玩家提示没有权限怎么办
普通玩家默认没有 yuvault.use。至少发放：
/lp group default permission set yuvault.use true
/lp group default permission set yuvault.reclaimed true
/lp group default permission set yuvault.vaults.1 true
/lp group default permission set yuvault.slots.1.3 true如果 default-vaults 保持 0，但没有 yuvault.vaults.<数量>，玩家会没有可创建的保险柜。
为什么 VIP 槽位权限没有生效
先确认 slot-mode：
| 模式 | 行为 |
|---|---|
permission | 读取 yuvault.slots.<编号>.<行数>。 |
command | 忽略槽位权限，使用 /yvault setslots 或创建时写入的行数。 |
还要注意编号从玩家视角的 1 开始。例如 1 号保险柜 6 行是 yuvault.slots.1.6，不是 yuvault.slots.0.6。
为什么 /yvault setslots 被拒绝
/yvault setslots 只在 slot-mode: command 时可用。默认 permission 模式下，槽位由玩家权限决定，插件会拒绝管理员用命令修改容量。
缩小槽位会不会吞物品
插件在缩小槽位或删除保险柜时，会把超出部分转入回收箱。玩家可用：
/yvault reclaimed管理员可用：
/yvault adminreclaimed <玩家>如果数据库事务失败，插件会拒绝本次缩容或打开操作，避免把已有内容覆盖成空。
MySQL 连接失败怎么排查
按顺序检查：
storage.type是否为mysql。host、port、database、username、password是否正确。- 数据库账号是否有建表、查询、插入、更新、删除权限。
- 服务端机器是否能访问 MySQL 端口。
- 首次启动时
mysql-connector-j是否成功下载到plugins/YuVault/libs/。
如果使用远程数据库，建议先用同机器的数据库客户端测试连接。
首次启动卡在依赖下载怎么办
YuVault 需要下载 HikariCP、SQLite JDBC、MySQL JDBC 和 SLF4J 依赖。若机器无法访问 Maven Central：
- 查看控制台缺少哪个 jar。
- 手动下载对应版本 jar。
- 放入
plugins/YuVault/libs/。 - 保持
library.verify-checksum: true并重启；如果校验文件也无法访问，可临时关闭校验完成启动测试。
正式服不建议长期关闭依赖校验。
可以在 Mohist、Arclight、Youer 上用吗
目标适配范围与 YuRandomTeleport 一致：Minecraft 1.8.x-1.26.x，Spigot、Paper、Paper 衍生端，以及 Mohist、Arclight、Youer 等 Bukkit API 混合端。混合端的物品 NBT 和序列化差异更复杂，上线前建议重点测试模组物品、容器物品和跨服 MySQL 场景。
物品无法放进保险柜怎么办
检查 item-control：
item-control:
mode: "blacklist"
list:
- "BEDROCK"
- "BARRIER"
- "COMMAND_BLOCK"如果是黑名单模式，列表中的物品会被阻止。如果是白名单模式，只有列表中的物品能存入。管理员可用 yuvault.bypass.item 绕过。
某个世界打不开保险柜怎么办
检查 world-control：
world-control:
mode: "blacklist"
list:
- "example_nether"黑名单模式下，列表世界禁止打开。白名单模式下，只有列表世界允许打开。可给管理员发放 yuvault.bypass.world 或 yuvault.bypass.world.<世界名>。
管理员打开离线玩家保险柜会裁剪容量吗
默认权限模式下，如果保险柜所有者离线，插件不会因为读不到在线权限而裁剪已有内容。它会至少保留默认容量和已有内容长度对应的安全容量，避免误缩容。
数据库表有哪些
YuVault 使用：
vaults：保存玩家保险柜。reclaimed_items：保存被回收的物品。
SQLite 模式下数据库文件是 plugins/YuVault/vaults.db。MySQL 模式下建议定期备份这两张表。