YuVault 配置说明

默认配置文件位于：

plugins/YuVault/config.yml

默认消息文件位于：

plugins/YuVault/messages.yml

数据库配置

storage.type 控制存储后端：

配置	默认值	说明
storage.type	sqlite	sqlite 为单服文件库；mysql 为跨服共享数据库。
storage.pool.enabled	true	是否启用 HikariCP 连接池。
storage.pool.max-pool-size	10	MySQL 最大连接数；SQLite 实际会限制为 1，避免文件库写锁问题。
storage.pool.min-idle	5	MySQL 最小空闲连接数。
storage.pool.connection-timeout	30000	获取连接超时，单位毫秒。
storage.pool.idle-timeout	600000	空闲连接保留时间。
storage.pool.max-lifetime	1800000	连接最大生命周期。

MySQL 参数：

storage:
  type: "mysql"
  mysql:
    host: "localhost"
    port: 3306
    database: "yuvault"
    username: "root"
    password: ""
    jdbc-params: "useSSL=false&allowPublicKeyRetrieval=true&autoReconnect=true"

保险柜基础设定

配置	默认值	说明
default-slots	9	默认槽位数，必须是 9 的倍数，最终限制在 9-54 格。
slot-mode	permission	permission 使用权限动态决定容量；command 使用 /setslots 或创建参数固定容量。
default-vaults	0	玩家默认可拥有的保险柜数量。权限模式通常保持 0，再由权限发放数量。

权限模式示例：

yuvault.vaults.3
yuvault.slots.1.6
yuvault.slots.2.3

含义是玩家最多拥有 3 个保险柜，其中 1 号保险柜 6 行，2 号保险柜 3 行。

世界访问控制

world-control 支持黑名单和白名单：

world-control:
  mode: "blacklist"
  list:
    - "example_nether"
    - "example_the_end"

模式	行为
blacklist	列表中的世界禁止打开保险柜。
whitelist	只有列表中的世界允许打开保险柜。

管理员可用 yuvault.bypass.world 绕过世界限制，也可以用 yuvault.bypass.world.<世界名> 绕过指定世界。

物品存储控制

item-control 用来限制哪些物品可放进保险柜：

item-control:
  mode: "blacklist"
  list:
    - "BEDROCK"
    - "BARRIER"
    - "COMMAND_BLOCK"

支持通配符：

写法	说明
BEDROCK	精确匹配。
ENCHANTED_*	匹配指定前缀。
*_HELMET	匹配指定后缀。
*GOLD*	匹配包含文本。
*	匹配全部物品。

有 yuvault.bypass.item 的玩家可绕过物品限制。

保险柜列表 GUI

list-gui 控制 /yvault gui 的列表界面：

配置	默认值	说明
list-gui.title	&8{player} 的保险柜列表	列表 GUI 标题。
list-gui.rows	6	GUI 行数，范围 1-6。
list-gui.items-per-page	45	每页显示的保险柜图标数量。
list-gui.vault-icon.material	CHEST	有物品保险柜图标。
list-gui.vault-icon.empty-material	CHEST	空保险柜图标。
list-gui.empty-gui.enabled	true	没有保险柜时是否展示创建入口。
list-gui.empty-gui.command	yvault create	点击空状态图标后执行的命令。

底部导航按钮包括 previous-page、next-page、close-button 和可选 back-button。back-button.command 支持 {player} 占位符，适合接回主菜单插件。

回收物品 GUI

reclaimed-gui 控制 /yvault reclaimed 与 /yvault adminreclaimed 的界面：

配置	默认值	说明
reclaimed-gui.title	&8回收物品 - {player}	回收箱 GUI 标题。
reclaimed-gui.rows	6	GUI 行数。
reclaimed-gui.items-per-page	45	每页物品数量。
reclaimed-gui.item-icon.name	&6{name}	回收物品显示名模板。

回收箱保留策略：

配置	默认值	说明
reclaimed-items.expire-days	0	回收物品保留天数，0 表示永久保留。
reclaimed-items.clean-interval-minutes	60	清理过期回收物品的后台检查间隔。

命令别名

commands:
  yvault:
    - "vault"
    - "yv"

修改后执行 /yvault reload，插件会重新注册别名。建议避免和其他插件命令冲突。

自动保存与调试

配置	默认值	说明
auto-save-interval	60	在线玩家保险柜自动保存间隔，单位秒；0 表示禁用。
debug	false	输出详细诊断日志，生产环境建议关闭。
messages-file	messages.yml	自定义消息文件名，相对于插件数据目录。

依赖库校验

library:
  verify-checksum: true

开启后，插件会对 plugins/YuVault/libs/ 下缓存的运行时依赖做哈希校验；缓存损坏或校验失败时会重新下载。正式服建议保持开启。

配置版本

文件	当前版本键	当前值
config.yml	config-version	2
messages.yml	messages-version	2

升级时插件会自动合并缺失项。修改前仍建议备份整个 plugins/YuVault/ 目录和 MySQL 数据库。