CocoVaults Lite
每位玩家的专属物品存放处。
免费个人保险箱 · 本地存储 · 备份与恢复
为玩家提供专属的物品存放空间。CocoVaults Lite 将可定制的保险箱、本地存储和实用的恢复工具整合到一个免费的插件中。
Minecraft 26.3+ · CocoVaults Lite 5
Minecraft 1.8.8–26.2 · CocoVaults Lite Legacy
Spigot & Paper · 选择适合你版本的 jar 文件。不支持 Folia。
01 · 让每个保险箱都充满个性。
直接打开编号保险箱或浏览选择器。空间属于玩家,体验由你配置。
打造个性化体验
自定义保险箱名称、材质或手持物品图标,以及一键物品整理功能。
为权限等级预留空间
基于权限的保险箱数量、大小和单独解锁设置。
融入服务器风格
可配置的选择器,包含导航、锁定保险箱预览和空间详情。
制定你的规则
物品黑名单或白名单、世界和游戏模式限制、冷却时间以及可选的末影箱访问权限。
消息、声音 & PlaceholderAPI
使用 MiniMessage、颜色代码和十六进制颜色自定义消息。设置打开、关闭、拒绝访问和分页的声音。可选的 PlaceholderAPI 支持可将保险箱信息集成到你的消息中。
一窥保险箱内部
观看保险箱选择器演示
录制于早期版本;v5 界面可能有所不同。
02 · 你的服务器,你的本地存储。
JSON & YAML
存储在服务器上的可读文件。
嵌入式 H2
插件自带的本地数据库。无需维护单独的数据库服务。
Lite 专为单服务器设计。在 JSON、YAML 和 H2 之间迁移时,需提供确认步骤和目标备份。
03 · 守护玩家珍视的物品。
所有者和授权员工共享同一个实时保险箱库存。备份和清晰的管理员权限使恢复和维护触手可及。
谨慎保存
有序保存、报告并重试失败操作,且不可读的保险箱保持关闭状态。保留物品元数据。
保留回退途径
自动和手动备份、恢复工具,以及在破坏性管理员操作前进行备份。
赋予员工合适的工具
检查、编辑(需权限)、清空、删除或清除保险箱。审计员工操作,并可选择性地记录玩家物品移动。
导入器 & 存储迁移
引入现有保险箱。 支持从 PlayerVaultsX、AxVaults、EnderVaults 或 FairyVaults 导入数据。CocoVaults 3 的 Lite 版本支持 JSON 和 YAML 数据导入。
04 · 比较各个版本。
两个版本均包含个人保险箱、权限管理、自定义功能、H2 数据库、备份、恢复和管理员工具。Premium 版额外增加了 SQLite、共享 MySQL/MariaDB/Redis 存储以及跨服务器保险箱功能。
准备好为玩家提供更多空间了吗?
阅读指南,设置你的保险箱,并加入 FruitForge 社区。
安装、命令 & 权限
- 备份
plugins/CocoVaults-Lite。 - 停止服务器,安装适用于你 Minecraft 版本的 jar 文件,移除之前的 CocoVaults jar 文件,然后启动服务器。
- 查看
Settings.yml并选择存储方式。迁移现有数据时请遵循文档说明。 - 授予
cocovaults.quantity.<n>或修改Default-Vaults。默认保险箱数量为 零。如果你希望玩家自定义名称和图标,请授予重命名和图标权限。
常用命令
/cv gui 浏览保险箱选择器
/cv 1 打开 1 号保险箱
/cv rename 1 Supplies 将 1 号保险箱命名为 Supplies
/cv icon 1 HAND 使用当前手持物品作为图标
/cv sort 1 合并堆叠并整理保险箱
/cv admin backup 创建备份(需要员工权限)
入门权限 · 三个 54 格的保险箱
cocovaults.open
cocovaults.quantity.3
cocovaults.size.54
cocovaults.rename
cocovaults.icon
替换 jar 文件时需要完全重启服务器。不支持服务器 /reload 命令;/cv admin reload 用于重新加载插件配置。
从早期版本更新
v5 版本可读取 CocoVaults Lite 4 的 JSON 和 YAML 数据。现有的名称、图标和设置将被保留。更新前请备份插件文件夹。
来自 CocoVaults 3?在备份后,使用 /cv admin import CocoVaults3 导入 JSON/YAML 数据。配置更新会保留你的数值,并将旧配置文件保存在 old-configs/ 中。
命令 & 权限
正常版和 Legacy 版使用相同的命令和权限名称。尖括号标记必需参数;方括号标记可选参数。
主命令: /cv
别名: /cocovaults, /vault, /vaults, /cocov, /cocovault, /pv, /pvault, /pvaults
所有玩家命令
/cv
显示帮助。权限: 无
/cv help
显示帮助。权限: 无
/cv <vault>
打开你的编号保险箱。权限: cocovaults.open
/cv gui
打开保险箱选择器。权限: cocovaults.open
/cv rename <vault> <name>
重命名一个可访问的保险箱。权限: cocovaults.rename
/cv icon <vault> <material|HAND>
设置材质图标或使用手持物品。权限: cocovaults.icon
/cv sort <vault>
合并堆叠并整理一个可访问的保险箱。权限: cocovaults.sort
玩家还需要通过配额或单独解锁来访问所选的保险箱。
所有管理员命令
/cv admin
显示管理帮助。权限: cocovaults.admin
/cv admin reload
重新加载配置;更改存储后端不会迁移数据。权限: cocovaults.admin.reload
/cv admin view <player> <vault>
查看其他玩家的保险箱;编辑还需要 admin.edit 权限。权限: cocovaults.admin.view
/cv <player> <vault>
管理员查看的快捷方式。权限: cocovaults.admin.view
/cv admin inspect <player> <vault>
只读检查一个保险箱,即使你拥有编辑权限。权限: cocovaults.admin.view
/cv admin forceopen <vault> <player>
为在线玩家打开一个保险箱。权限: cocovaults.admin.forceopen
/cv admin list <player>
列出已保存的保险箱及其详情。权限: cocovaults.admin.list
/cv admin clear <player> <vault>
在确认和备份后清空一个保险箱。权限: cocovaults.admin.clear
/cv admin delete <player> <vault>
在确认和备份后删除一个保险箱。权限: cocovaults.admin.delete
/cv admin backup
立即备份所有保险箱。权限: cocovaults.admin.backup
/cv admin restore <file> [player]
恢复备份,可选地为单个玩家恢复。权限: cocovaults.admin.restore
/cv admin purge <empty|inactive> [days]
移除空或长时间未使用的保险箱;“未使用”默认指 90 天。权限: cocovaults.admin.purge
/cv admin migrate <source> <destination>
在受支持的存储后端之间进行迁移,需确认并提供目标备份。权限: cocovaults.admin.migrate
/cv admin import <plugin> [option]
导入支持的数据;如果不提供插件名称,则列出导入器。权限: cocovaults.admin.import
/cv admin info
显示存储、序列化、已加载保险箱及备份状态。权限: cocovaults.admin.info
迁移后端:JSON, YAML 和 H2。导入器:PlayerVaultsX, AxVaults, EnderVaults, FairyVaults 和 CocoVaults3。CocoVaults3 的 Lite 版本支持 JSON/YAML 数据的导入。
玩家命令、管理员查看、检查以及玩家/保险箱快捷方式需要游戏内的玩家实体。其他管理操作可以从控制台运行;forceopen 针对的是在线玩家。
请遵循 clear, delete, restore, purge 和迁移过程中的确认提示。迁移需要在确认窗口内连续执行三次相同的命令,并为目标创建备份。
所有权限与默认值
玩家权限
cocovaults.open— 打开保险箱和选择器。所有人。cocovaults.rename— 重命名保险箱。操作员。cocovaults.icon— 更改保险箱图标。操作员。cocovaults.sort— 排序保险箱物品。所有人。cocovaults.quantity.<n>— 允许拥有第 1 到 n 个保险箱;最多 999 个。Default-Vaults 是回退选项。分配数值节点。cocovaults.unlocked.<vault>— 除正常配额外,解锁特定的一个保险箱。分配数值节点。cocovaults.size.<slots>— 设置通用大小:9, 18, 27, 36, 45 或 54 格。分配数值节点。cocovaults.size.<vault>.<slots>— 设置单个保险箱的大小;优先级高于通用大小。分配数值节点。cocovaults.bypass.blacklist— 允许存储被黑名单拦截的物品。未授予。cocovaults.bypass.restrictions— 绕过禁用的世界、禁止的游戏模式以及打开冷却时间。操作员。
工作人员权限
cocovaults.admin— 授予所有管理权限,包括编辑权限。操作员。cocovaults.admin.reload— 重新加载插件配置。管理员组 / 单独授予。cocovaults.admin.view— 使用查看、检查和玩家/保险箱快捷方式。操作员。cocovaults.admin.edit— 允许通过管理员视图进行编辑。检查保持只读。操作员。cocovaults.admin.forceopen— 为在线玩家打开保险箱。管理员组 / 单独授予。cocovaults.admin.list— 列出玩家的保险箱。管理员组 / 单独授予。cocovaults.admin.clear— 清空保险箱。管理员组 / 单独授予。cocovaults.admin.delete— 删除保险箱。管理员组 / 单独授予。cocovaults.admin.backup— 创建备份。管理员组 / 单独授予。cocovaults.admin.restore— 恢复备份数据。管理员组 / 单独授予。cocovaults.admin.purge— 清理空或长时间未使用的保险箱。管理员组 / 单独授予。cocovaults.admin.migrate— 在存储后端之间迁移。管理员组 / 单独授予。cocovaults.admin.import— 从支持的插件导入数据。管理员组 / 单独授予。cocovaults.admin.info— 查看插件和存储状态。管理员组 / 单独授予。
这些是默认的权限名称。Open, admin, rename, icon, sort 和 bypass 节点可以在 Settings.yml 的 Permissions 部分中更改。空白命令权限意味着所有人都可以使用该命令。
默认保险箱数量为 0;默认大小为 27 格。分配数值型数量/大小节点或更改默认值。将使用最高的有效数值授予;每个保险箱的大小设置将覆盖通用大小。
操作员使用 Op-Vaults 作为其选择器配额(默认为 999),可以访问任何有效的保险箱编号,并使用 54 格的保险箱。命令权限检查接受 * 和父级通配符;对于非操作员的保险箱数量和大小,仍需具体的数值节点。
plugin.yml 将 cocovaults.quantity., cocovaults.size. 和 cocovaults.unlocked.* 声明为权限家族。请使用具体的数值节点来定义数量、大小和解锁状态。
cocovaults.admin 授予所有工作人员操作权限。你也可以单独授予各个管理员节点。没有单独的 cocovaults.admin.inspect 节点:检查功能使用的是 cocovaults.admin.view。
PlaceholderAPI 引用
两个版本均为可选。将 n 替换为保险箱编号,例如 %cocovaults_items_1%。保险箱内容值会在后台缓存并刷新,最多每 30 秒更新一次。
%cocovaults_max_vaults%— 玩家默认的保险箱数量上限。%cocovaults_available_vaults%— 可用保险箱数量,包括单独解锁的保险箱。%cocovaults_used_vaults%— 已使用的保险箱数量。%cocovaults_size_<n>%— 第 n 个保险箱配置的格子容量。%cocovaults_items_<n>%— 第 n 个保险箱中已占用的格子数。%cocovaults_free_<n>%— 第 n 个保险箱中剩余的格子数。%cocovaults_name_<n>%— 第 n 个保险箱的自定义名称。
合作伙伴 · Teramont
你的下一个服务器从这里开始。
Teramont 是我们的官方托管合作伙伴。使用代码 Byte 可享首月费用 85 折(立减 15%)。
CocoVaults Lite · 由 FruitForge 制作
CocoVaults Lite
A personal place for every player’s items.
Free personal vaults · Local storage · Backups & restore
Give players their own place to keep items. CocoVaults Lite combines customizable vaults, local storage and practical recovery tools in a free plugin.
Minecraft 26.3+ · CocoVaults Lite 5
Minecraft 1.8.8–26.2 · CocoVaults Lite Legacy
Spigot & Paper · Choose the jar for your version. Folia is not supported.
01 · Make every vault feel personal.
Open a numbered vault directly or browse the selector. The space is theirs; the experience is yours to configure.
Make it personal
Custom vault names, material or held-item icons, and one-command item sorting.
Make room for your ranks
Permission-based vault counts, sizes and individual unlocks.
Make it feel like your server
A configurable selector with navigation, locked-vault previews and space details.
Set your own rules
Item blacklist or whitelist, world and game-mode restrictions, cooldowns and optional ender chest access.
Messages, sounds & PlaceholderAPI
Customize messages with MiniMessage, color codes and hex colors. Set opening, closing, denied-access and page sounds. Optional PlaceholderAPI support brings vault information into your messages.
A look inside the vaults
Watch the vault selector
Recorded with earlier builds; the version 5 interface may differ.
02 · Your server. Your local storage.
JSON & YAML
Readable files stored on your server.
Embedded H2
A local database included with the plugin. No separate database service to maintain.
Lite is built for one server. Migrate between JSON, YAML and H2 with confirmation steps and a destination backup.
03 · Look after what players keep.
Owners and authorized staff share one live vault inventory. Backups and clear admin permissions keep recovery and maintenance within reach.
Save with care
Ordered saves, reported and retried failures, and unreadable vaults kept closed. Item metadata is preserved.
Keep a way back
Automatic and manual backups, restore tools, and a backup before destructive admin actions.
Give staff the right tools
Inspect, edit with permission, clear, delete or purge vaults. Audit staff actions and optionally player item movements.
Importers & storage migration
Bring your existing vaults. Import supported data from PlayerVaultsX, AxVaults, EnderVaults or FairyVaults. CocoVaults 3 imports in Lite support JSON and YAML data.
04 · Compare the editions.
Both editions include personal vaults, permissions, customization, H2, backups, restore and staff tools. Premium adds SQLite, shared MySQL/MariaDB/Redis storage and cross-server vaults.
Ready to give players more room?
Read the guide, set up your vaults and join the FruitForge community.
Installation, commands & permissions
- Back up
plugins/CocoVaults-Lite. - Stop the server, install the jar for your Minecraft version, remove the previous CocoVaults jar, and start the server.
- Review
Settings.ymland choose storage. Follow the documentation when migrating existing data. - Grant
cocovaults.quantity.<n>or changeDefault-Vaults. The default vault count is zero. Grant rename and icon permissions if you want players to customize them.
Useful commands
/cv gui Browse the vault selector
/cv 1 Open vault 1
/cv rename 1 Supplies Name vault 1
/cv icon 1 HAND Use the held item as its icon
/cv sort 1 Merge stacks and sort the vault
/cv admin backup Create a backup (staff permission required)
Starter permissions · three 54-slot vaults
cocovaults.open
cocovaults.quantity.3
cocovaults.size.54
cocovaults.rename
cocovaults.icon
Use a full restart when replacing jars. Server /reload is unsupported; /cv admin reload reloads the plugin configuration.
Updating from an earlier version
Version 5 reads CocoVaults Lite 4 JSON and YAML data. Existing names, icons and settings are retained. Back up the plugin folder before updating.
Coming from CocoVaults 3? After a backup, use /cv admin import CocoVaults3 to import JSON/YAML data. Configuration updates keep your values and save the previous file in old-configs/.
Commands & permissions
The normal and Legacy builds use the same commands and permission names. Angle brackets mark required arguments; square brackets mark optional arguments.
Main command: /cv
Aliases: /cocovaults, /vault, /vaults, /cocov, /cocovault, /pv, /pvault, /pvaults
All player commands
/cv
Show help. Permission: none
/cv help
Show help. Permission: none
/cv <vault>
Open your numbered vault. Permission: cocovaults.open
/cv gui
Open the vault selector. Permission: cocovaults.open
/cv rename <vault> <name>
Rename an accessible vault. Permission: cocovaults.rename
/cv icon <vault> <material|HAND>
Set a material icon or use the held item. Permission: cocovaults.icon
/cv sort <vault>
Merge stacks and sort an accessible vault. Permission: cocovaults.sort
Players also need access to the chosen vault through their allowance or an individual unlock.
All staff commands
/cv admin
Show administrative help. Permission: cocovaults.admin
/cv admin reload
Reload configuration; changing storage does not migrate data. Permission: cocovaults.admin.reload
/cv admin view <player> <vault>
View another player’s vault; editing also needs admin.edit. Permission: cocovaults.admin.view
/cv <player> <vault>
Shortcut for administrative view. Permission: cocovaults.admin.view
/cv admin inspect <player> <vault>
Inspect a vault read-only, even if you can edit. Permission: cocovaults.admin.view
/cv admin forceopen <vault> <player>
Open a vault for an online player. Permission: cocovaults.admin.forceopen
/cv admin list <player>
List saved vaults and their details. Permission: cocovaults.admin.list
/cv admin clear <player> <vault>
Empty a vault after confirmation and backup. Permission: cocovaults.admin.clear
/cv admin delete <player> <vault>
Delete a vault after confirmation and backup. Permission: cocovaults.admin.delete
/cv admin backup
Back up all vaults now. Permission: cocovaults.admin.backup
/cv admin restore <file> [player]
Restore a backup, optionally for one player. Permission: cocovaults.admin.restore
/cv admin purge <empty|inactive> [days]
Remove empty or inactive vaults; inactive defaults to 90 days. Permission: cocovaults.admin.purge
/cv admin migrate <source> <destination>
Migrate between supported backends with confirmation and a destination backup. Permission: cocovaults.admin.migrate
/cv admin import <plugin> [option]
Import supported data; without a plugin name, list importers. Permission: cocovaults.admin.import
/cv admin info
Show storage, serialization, loaded vaults and backup status. Permission: cocovaults.admin.info
Migration backends: JSON, YAML and H2. Importers: PlayerVaultsX, AxVaults, EnderVaults, FairyVaults and CocoVaults3. CocoVaults3 imports in Lite support JSON/YAML data.
Player commands, administrative view, inspect and the player/vault shortcut need an in-game player. Other administrative actions can run from the console; forceopen targets an online player.
Follow the confirmation prompts for clear, delete, restore, purge and migration. Migration requires the same command three times within the confirmation window and backs up the destination.
All permissions & defaults
Player permissions
cocovaults.open— Open vaults and the selector. Everyone.cocovaults.rename— Rename vaults. Operators.cocovaults.icon— Change vault icons. Operators.cocovaults.sort— Sort vault items. Everyone.cocovaults.quantity.<n>— Allow vaults 1 through n; up to 999. Default-Vaults is the fallback. Assign a numeric node.cocovaults.unlocked.<vault>— Unlock one specific vault in addition to the normal allowance. Assign a numeric node.cocovaults.size.<slots>— Set the general size: 9, 18, 27, 36, 45 or 54 slots. Assign a numeric node.cocovaults.size.<vault>.<slots>— Set one vault’s size; it takes priority over the general size. Assign a numeric node.cocovaults.bypass.blacklist— Allow storage of blacklisted items. Not granted.cocovaults.bypass.restrictions— Bypass disabled worlds, blocked game modes and the opening cooldown. Operators.
Staff permissions
cocovaults.admin— Grant every administrative permission, including editing. Operators.cocovaults.admin.reload— Reload the plugin configuration. Admin bundle / individual grant.cocovaults.admin.view— Use view, inspect and the player/vault shortcut. Operators.cocovaults.admin.edit— Allow editing through administrative view. Inspect stays read-only. Operators.cocovaults.admin.forceopen— Open a vault for an online player. Admin bundle / individual grant.cocovaults.admin.list— List a player’s vaults. Admin bundle / individual grant.cocovaults.admin.clear— Empty a vault. Admin bundle / individual grant.cocovaults.admin.delete— Delete a vault. Admin bundle / individual grant.cocovaults.admin.backup— Create a backup. Admin bundle / individual grant.cocovaults.admin.restore— Restore backup data. Admin bundle / individual grant.cocovaults.admin.purge— Purge empty or inactive vaults. Admin bundle / individual grant.cocovaults.admin.migrate— Migrate between storage backends. Admin bundle / individual grant.cocovaults.admin.import— Import data from supported plugins. Admin bundle / individual grant.cocovaults.admin.info— View plugin and storage status. Admin bundle / individual grant.
These are the default permission names. Open, admin, rename, icon, sort and bypass nodes can be changed in the Permissions section of Settings.yml. A blank command permission allows that command for everyone.
The default vault count is zero; the default size is 27 slots. Assign numeric quantity/size nodes or change the defaults. The highest valid numeric grant is used; a per-vault size overrides the general size.
Operators use Op-Vaults for their selector allowance (999 by default), have access to any valid vault number and use 54-slot vaults. Command permission checks accept * and parent wildcards; concrete numeric nodes are still needed for non-operator vault counts and sizes.
plugin.yml declares cocovaults.quantity., cocovaults.size. and cocovaults.unlocked.* as permission families. Use concrete numeric nodes to define counts, sizes and unlocks.
cocovaults.admin grants all staff actions. You can grant individual admin nodes instead. There is no separate cocovaults.admin.inspect node: inspect uses cocovaults.admin.view.
PlaceholderAPI reference
Optional in both editions. Replace n with a vault number, for example %cocovaults_items_1%. Vault-content values are cached and refreshed in the background, at most every 30 seconds.
%cocovaults_max_vaults%— The player’s normal vault allowance.%cocovaults_available_vaults%— Available vaults, including individual unlocks.%cocovaults_used_vaults%— Number of saved vaults.%cocovaults_size_<n>%— Configured slot capacity of vault n.%cocovaults_items_<n>%— Occupied slots in vault n.%cocovaults_free_<n>%— Free slots in vault n.%cocovaults_name_<n>%— Custom name of vault n.
Partners · Teramont
Your next server starts here.
Teramont is our official hosting partner. Use code Byte for 15% off your first month.
CocoVaults Lite · Made by FruitForge
下载 CocoVaults Lite
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CocoVaults Lite
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CocoVaults Lite
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CocoVaults Lite
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CocoVaults Lite
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CocoVaults Lite
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CocoVaults Lite
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CocoVaults Lite
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CocoVaults Lite
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CocoVaults Lite
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
? 更新 5.0.0-LITE The Rebuild
CocoVaults Lite - 发布于 2026年9月28日
⚠️ 完全重写
CocoVaults Lite 已从头重建,以修复 CocoVaults 4 中所有的物品复制和数据丢失漏洞,适用于 Minecraft 26.3+。你的金库、名称、图标和设置均已保留,且金库现在可以存储在内置的 H2 数据库中。
?️ 新增:H2 数据库
-
嵌入式 H2 数据库 - 将存储模式设置为 H2,每个金库都保存在一个本地数据库文件中(
storage/data.mv.db,Settings.yml 中的 H2-Name)。无需安装任何东西,也无需运行数据库服务器:H2 包含在插件内部,该文件是标准 H2 数据库文件,可使用 H2 自带的工具打开 -
严格本地化 - H2 文件仅供本服务器使用:服务器运行时 H2 会锁定该文件,且从不使用其网络模式
-
崩溃安全写入 - 每次保存都会先写入磁盘才算完成,因此如果在保存后立即被强制关闭服务器,数据依然保留。大容量的金库没有大小限制
-
跨版本文件一致 - CocoVaults Lite Legacy 会直接打开此 H2 数据库(两个版本写入相同的格式),因此它可以随着服务器从 26.2 迁移到 26.3
? 修复物品复制与数据丢失问题
-
单一共享实时库存 - 所有者和工作人员现在查看的是同一个实时库存。CocoVaults 4 会给每个查看者提供一个副本并合并回去,从而导致物品复制
-
无法读取的金库保持关闭 - 数据无法读取的金库永远不会被打开或覆盖。CocoVaults 4 会将其作为空金库打开并覆盖真实物品
-
安全的序列化变更 - 读取时检测物品格式,因此更改 Serialization-Type 不再导致现有金库无法读取
-
有序且崩溃安全的保存 - 每个玩家的保存操作在专用线程上按顺序运行,基于深度复制的快照;文件先写入临时文件,刷新后再移动到位,始终使用 UTF-8 编码
-
无静默失败 - 失败的保存操作会被报告并重试,而不是被忽略,空金库也会被保存
-
关机与世界保存 - 服务器停止时仍打开的金库会在关闭前写入,每次世界保存都会写入待处理的金库
-
金库大小修复 - 选择器不再加载 54 格的金库(这是一种权限绕过行为);缩小金库容量会将物品移动到空闲槽位,并保留额外的行直到它们被清空
-
无主线程阻塞 - 玩家离开服务器时不再因保存金库而冻结服务器
-
黑名单无法被绕过 - Shift 点击、数字键、副手交换和拖拽均经过检查,包括隐藏在潜影盒和包裹内的物品;被阻止的物品仅在保存成功后返还
-
安全的金库名称 - 金库名称可以使用颜色和样式,但绝不允许使用点击、悬停或插入标签
✨ 新功能
-
备份与恢复 - 自动备份(间隔时间和保留数量)、
/cv admin backup命令,以及/cv admin restore <file> [player]恢复到任何存储。每次破坏性操作前都会进行备份 -
审计日志 - 每日文件记录所有工作人员操作,并可选地记录玩家进出金库的操作
-
管理员工具箱 -
/cv admin list、inspect(只读)、delete、clear、purge empty|inactive 和 info;管理员命令也可从控制台运行;支持/cv <player> <vault>快捷方式;每个管理员命令对应单独的权限以及cocovaults.admin.edit -
/cv sort- 合并堆叠并按物品类型对金库进行排序 -
智能黑名单 - 支持按材质、正则表达式 (
regex:)、名称 (name:)、描述 (lore:)、模型 (model:) 和附魔 (enchant:) 设置规则,另提供白名单模式 (WHITELIST mode) -
限制设置 - 禁用世界、阻止的游戏模式以及开启冷却时间,附带绕过权限
-
末影箱访问 - 右键点击末影箱可打开金库选择器
-
更好的选择器 - 填充物品、锁定金库预览、日期格式、可配置的导航槽位和 Lore 占位符 (
{items},{free},{size},{last_access}) -
PlaceholderAPI 支持 -
%cocovaults_max_vaults%,_available_vaults,_used_vaults,_size_<n>,_items_<n>,_free_<n>和_name_<n>,以及消息中的所有 PlaceholderAPI 占位符 -
音效与更新检查器 - 打开、关闭、拒绝和翻页音效,以及新版本发布时在控制台和管理员处的通知
-
MiniMessage 全消息支持 - MiniMessage、
&代码和&#RRGGBB颜色代码在所有消息中可用 -
导入器 - PlayerVaultsX(即使未安装也可使用)、AxVaults、EnderVaults、FairyVaults 和 CocoVaults 3(JSON/YAML 数据)
-
迁移工具 - 在 JSON、YAML 和 H2 之间迁移金库,需三次确认、显示进度条并在迁移前进行备份;通过
/cv admin reload实时切换存储
⚠️ 重要变更
-
Minecraft 版本 - CocoVaults 5 针对 Paper 和 Spigot 上的 Minecraft 26.3+。对于 1.8.8 - 26.2 请使用 CocoVaults Lite Legacy
-
Settings.yml 自动更新 - 你设置的所有值都会被保留,旧配置文件会保存在
old-configs/目录中 -
数据兼容 - CocoVaults Lite 4 的数据(JSON 和 YAML)会被原样读取
-
CocoVaults 3 - CocoVaults 3 的配置会保留为
Settings-v3.yml;使用/cv admin import CocoVaults3迁移金库 -
Folia - 不支持 Folia
? 更新说明
- 备份你的数据 - 更新前复制
plugins/CocoVaults-Lite文件夹 - 停止服务器
- 用
CocoVaults-Lite-5.0.0-LITE.jar替换旧的 jar 文件 - 启动服务器并检查控制台:Settings.yml 已更新并保留了你的设置值
- 来自 CocoVaults 3?运行
/cv admin import CocoVaults3
? 技术细节
供对技术细节感兴趣的管理员:
- 代码与 CocoVaults 5 相同,但去除了数据库功能
- 基于 Spigot API 26.3(Java 21 字节码;26.3 服务器运行于 Java 25)从头重写
- Adventure 5.2.0 和 NBT-API 2.16.1,已重新定位
- H2 2.2.224 随 JAR 包内置 XZ 压缩格式,首次使用时解压至
plugins/CocoVaults-Lite/libraries/(通过 SHA-256 校验),并在独立于服务器的环境中加载,且禁用了其 Web 控制台及 TCP/PG 服务器(从未使用:数据库严格为本地模式)。JAR 文件大小为 2.4 MB - 故意选用 H2 2.2.224,各版本保持一致:在使用 H2 2.5 时,硬崩溃后 8 次测试中有 4 次丢失最后一次保存数据;而使用 2.2.224 时,33 次测试中无一发生
- 在 Paper 26.3 上使用机器人玩家测试 H2:涵盖所有金库场景、在金库保存后立即终止服务器、备份、重载、H2 <-> JSON 迁移以及 CocoVaults Lite Legacy 的 H2 文件
- 在 Paper 26.3 上使用机器人玩家测试:共享库存、无物品复制、重启、在金库开启状态下关闭服务器
感谢您使用 CocoVaults Lite!
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧