Voxel Shop beta is live. Expect occasional bugs. Learn more
-66% CocoVaults ⭐ 5.0.0
A lightweight plugin, compatible with NBT-Data, CustomModelData and Databases
5.0.0
7 days ago
Update 5.0.0
🚀 UPDATE 5.0.0 The Rebuild
CocoVaults Premium - Released September 28th, 2026
⚠️ COMPLETE REWRITE
CocoVaults Premium was rebuilt from scratch to close every duplication and data-loss path of CocoVaults 4, for Minecraft 26.3+. Your vaults, names, icons and settings are kept, and vaults can now live in an embedded H2 database.
🗄️ New: H2 Database
• Embedded H2 Database - Set Storage-Mode: H2 and every vault lives in one local database file (storage/data.mv.db, H2-Name in Settings.yml). Nothing to install and no database server to run: H2 comes inside the plugin, and the file is a standard H2 database that H2's own tools can open
• Strictly Local - The H2 file belongs to this server alone: H2 locks it while the server runs, its network modes are never used, and it does not work with Cross-Server (networks use MySQL, MariaDB or Redis)
• Crash-Safe Writes - Every save is on disk before it counts as done, so a server that is killed right after a save keeps it. Big vaults have no size limit
• Same File on Every Version - CocoVaults Legacy opens this H2 database as it is (both editions write the same format), so it moves with the server across 26.2 and 26.3
• Strictly Local - The H2 file belongs to this server alone: H2 locks it while the server runs, its network modes are never used, and it does not work with Cross-Server (networks use MySQL, MariaDB or Redis)
• Crash-Safe Writes - Every save is on disk before it counts as done, so a server that is killed right after a save keeps it. Big vaults have no size limit
• Same File on Every Version - CocoVaults Legacy opens this H2 database as it is (both editions write the same format), so it moves with the server across 26.2 and 26.3
🔒 Duplication & Data-Loss Fixes
• One Shared Live Inventory - The owner and staff now look at the very same live inventory. CocoVaults 4 gave every viewer a copy and merged them back, which duplicated items
• Unreadable Vaults Stay Closed - A vault whose data cannot be read is never opened or overwritten. CocoVaults 4 opened it empty and saved over the real items
• Safe Serialization Changes - The item format is detected when reading, so changing Serialization-Type no longer makes existing vaults unreadable
• Ordered, Crash-Safe Saves - Each player's saves run in order on dedicated threads from deep-copied snapshots; files go to a temporary file, are flushed and moved into place, always in UTF-8
• No Silent Failures - Failed saves are reported and retried instead of being ignored, and empty vaults are saved too
• Shutdown & World Saves - Vaults still open when the server stops are written before it closes, and every world save writes the pending vaults
• Vault Size Fixes - The selector no longer loads vaults at 54 slots (a permission bypass); shrinking a vault moves the items into the free slots and keeps extra rows until they are emptied
• No Main-Thread Stalls - Players leaving the server no longer freeze it while their vaults are saved
• Blacklist Can't Be Bypassed - Shift-clicks, number keys, off-hand swaps and drags are all checked, including items hidden inside shulker boxes and bundles; blocked items are only handed back after a successful save
• Safe Vault Names - Vault names can use colors and styles but never click, hover or insertion tags
• Unreadable Vaults Stay Closed - A vault whose data cannot be read is never opened or overwritten. CocoVaults 4 opened it empty and saved over the real items
• Safe Serialization Changes - The item format is detected when reading, so changing Serialization-Type no longer makes existing vaults unreadable
• Ordered, Crash-Safe Saves - Each player's saves run in order on dedicated threads from deep-copied snapshots; files go to a temporary file, are flushed and moved into place, always in UTF-8
• No Silent Failures - Failed saves are reported and retried instead of being ignored, and empty vaults are saved too
• Shutdown & World Saves - Vaults still open when the server stops are written before it closes, and every world save writes the pending vaults
• Vault Size Fixes - The selector no longer loads vaults at 54 slots (a permission bypass); shrinking a vault moves the items into the free slots and keeps extra rows until they are emptied
• No Main-Thread Stalls - Players leaving the server no longer freeze it while their vaults are saved
• Blacklist Can't Be Bypassed - Shift-clicks, number keys, off-hand swaps and drags are all checked, including items hidden inside shulker boxes and bundles; blocked items are only handed back after a successful save
• Safe Vault Names - Vault names can use colors and styles but never click, hover or insertion tags
🌐 Cross-Server Rework
• Per-Player Leases - A server only loads a player's vaults while holding their lease (MySQL/MariaDB table or Redis key with expiry), and releases it after every pending save
• Version-Checked Writes - A server never overwrites changes made by another one; the conflicting copy is kept in conflicts/
• Crash Recovery - Leases left by a crashed server are cleared when it starts again, or taken over by another server after Heartbeat-Timeout
• Redis Locking - Redis now has real locks (CocoVaults 4 had none)
• Server Identity - Server-Name "auto" keeps a stable id in server-id.txt, and Lock-Wait-Seconds lets players switch servers smoothly
• Version-Checked Writes - A server never overwrites changes made by another one; the conflicting copy is kept in conflicts/
• Crash Recovery - Leases left by a crashed server are cleared when it starts again, or taken over by another server after Heartbeat-Timeout
• Redis Locking - Redis now has real locks (CocoVaults 4 had none)
• Server Identity - Server-Name "auto" keeps a stable id in server-id.txt, and Lock-Wait-Seconds lets players switch servers smoothly
✨ New Features
• Backups & Restore - Automatic backups (interval and how many to keep), /cv admin backup, and /cv admin restore <file> [player] into any storage. A backup is taken before every destructive action
• Audit Log - Daily files with every staff action and, optionally, what players move in and out of their vaults
• Admin Toolkit - /cv admin list, inspect (read-only), delete, clear, purge empty|inactive and info; admin commands also run from the console; /cv <player> <vault> shortcut; one permission per admin command and cocovaults.admin.edit
• /cv sort - Merges stacks and sorts a vault by item
• Smart Blacklist - Rules by material, regex:, name:, lore:, model: and enchant:, plus a WHITELIST mode
• Restrictions - Disabled worlds, blocked game modes and an open cooldown, with a bypass permission
• Ender Chest Access - Right-clicking an ender chest can open the vault selector
• Better Selector - Filler items, locked-vault previews, date format, configurable navigation slots and lore placeholders ({items}, {free}, {size}, {last_access})
• PlaceholderAPI - %cocovaults_max_vaults%, _available_vaults, _used_vaults, _size_<n>, _items_<n>, _free_<n> and _name_<n>, and PlaceholderAPI placeholders inside every message
• Sounds & Update Checker - Open, close, denied and page sounds, and a notice to the console and admins when a new version is out
• MiniMessage Everywhere - MiniMessage, & codes and &#RRGGBB in every message
• Importers - PlayerVaultsX (even when it is no longer installed), AxVaults, EnderVaults, FairyVaults, CocoVaults 3 (files, SQLite, MySQL and MariaDB) and CocoVaults Lite
• Migrations - Move vaults between YAML, JSON, SQLite, H2, MySQL, MariaDB and Redis with three confirmations, a progress bar and a backup of the destination first; switch storage live with /cv admin reload
• Database Options - Table-Prefix, extra JDBC properties, and Redis user, SSL and key prefix
• Audit Log - Daily files with every staff action and, optionally, what players move in and out of their vaults
• Admin Toolkit - /cv admin list, inspect (read-only), delete, clear, purge empty|inactive and info; admin commands also run from the console; /cv <player> <vault> shortcut; one permission per admin command and cocovaults.admin.edit
• /cv sort - Merges stacks and sorts a vault by item
• Smart Blacklist - Rules by material, regex:, name:, lore:, model: and enchant:, plus a WHITELIST mode
• Restrictions - Disabled worlds, blocked game modes and an open cooldown, with a bypass permission
• Ender Chest Access - Right-clicking an ender chest can open the vault selector
• Better Selector - Filler items, locked-vault previews, date format, configurable navigation slots and lore placeholders ({items}, {free}, {size}, {last_access})
• PlaceholderAPI - %cocovaults_max_vaults%, _available_vaults, _used_vaults, _size_<n>, _items_<n>, _free_<n> and _name_<n>, and PlaceholderAPI placeholders inside every message
• Sounds & Update Checker - Open, close, denied and page sounds, and a notice to the console and admins when a new version is out
• MiniMessage Everywhere - MiniMessage, & codes and &#RRGGBB in every message
• Importers - PlayerVaultsX (even when it is no longer installed), AxVaults, EnderVaults, FairyVaults, CocoVaults 3 (files, SQLite, MySQL and MariaDB) and CocoVaults Lite
• Migrations - Move vaults between YAML, JSON, SQLite, H2, MySQL, MariaDB and Redis with three confirmations, a progress bar and a backup of the destination first; switch storage live with /cv admin reload
• Database Options - Table-Prefix, extra JDBC properties, and Redis user, SSL and key prefix
⚠️ Important Changes
• Minecraft Version - CocoVaults 5 targets Minecraft 26.3+ on Paper and Spigot. For 1.8.8 - 26.2 use CocoVaults Legacy
• Settings.yml Updated Automatically - Every value you set is kept and the previous file is saved in old-configs/
• Data Compatible - CocoVaults 4 data (JSON, YAML, SQLite, MySQL, MariaDB and Redis) is read as it is; SQL tables get two new columns automatically
• CocoVaults 3 - A CocoVaults 3 configuration is kept as Settings-v3.yml; bring the vaults over with /cv admin import CocoVaults3
• Folia - Folia is not supported
• Settings.yml Updated Automatically - Every value you set is kept and the previous file is saved in old-configs/
• Data Compatible - CocoVaults 4 data (JSON, YAML, SQLite, MySQL, MariaDB and Redis) is read as it is; SQL tables get two new columns automatically
• CocoVaults 3 - A CocoVaults 3 configuration is kept as Settings-v3.yml; bring the vaults over with /cv admin import CocoVaults3
• Folia - Folia is not supported
📋 Update Instructions
1. BACKUP YOUR DATA - copy plugins/CocoVaults and your database before updating
2. Stop your server
3. Replace the old jar with CocoVaults-5.0.0.jar
4. Start your server and check the console: Settings.yml is updated keeping your values
5. Coming from CocoVaults 3? Run /cv admin import CocoVaults3
2. Stop your server
3. Replace the old jar with CocoVaults-5.0.0.jar
4. Start your server and check the console: Settings.yml is updated keeping your values
5. Coming from CocoVaults 3? Run /cv admin import CocoVaults3
🔍 Technical Details
For server administrators interested in the technical details:
• Rewritten from scratch against Spigot API 26.3 (Java 21 bytecode; 26.3 servers run Java 25)
• Adventure 5.2.0, NBT-API 2.16.1 and HikariCP 7.1.0, relocated; Redis is spoken by CocoVaults' own small client (no Jedis)
• H2 2.2.224 and MariaDB Connector/J 3.5.10 travel packed with XZ inside the jar, are unpacked on first use into plugins/CocoVaults/libraries/ (checked by SHA-256) and load apart from the server; H2 keeps its own class names, which it writes into the database file
• H2 ships without its web console and TCP/PG servers, which are never used: the database is strictly local. The jar is 3.0 MB
• H2 2.2.224 on purpose, the same in every edition: with H2 2.5 the last save was lost after a hard crash in 4 of 8 tests, with 2.2.224 in none of 33
• H2 tested with bot players on Paper 26.3: every vault scenario on H2, a server killed right after a save, backups, reloads, H2 <-> JSON migrations, the H2 file of CocoVaults Legacy and the import of CocoVaults Lite's H2 database
• Tested with bot players on Paper and Spigot 26.3: shared inventories, no duplication, restarts, shutdown with open vaults, migrations and serialization switches
• Cross-server tested on MySQL 8.4, MariaDB and Redis, including a server crash while holding a lease
• Checked again with the final jar: every H2 scenario and hard-crash test, cross-server on MySQL 8.4, MariaDB and Redis, the admin commands and the import of CocoVaults Lite's H2 database
• PlaceholderAPI 2.12.3 tested on 26.3
• Reads vaults written by CocoVaults Legacy on any version, upgrading 1.8 items
• Rewritten from scratch against Spigot API 26.3 (Java 21 bytecode; 26.3 servers run Java 25)
• Adventure 5.2.0, NBT-API 2.16.1 and HikariCP 7.1.0, relocated; Redis is spoken by CocoVaults' own small client (no Jedis)
• H2 2.2.224 and MariaDB Connector/J 3.5.10 travel packed with XZ inside the jar, are unpacked on first use into plugins/CocoVaults/libraries/ (checked by SHA-256) and load apart from the server; H2 keeps its own class names, which it writes into the database file
• H2 ships without its web console and TCP/PG servers, which are never used: the database is strictly local. The jar is 3.0 MB
• H2 2.2.224 on purpose, the same in every edition: with H2 2.5 the last save was lost after a hard crash in 4 of 8 tests, with 2.2.224 in none of 33
• H2 tested with bot players on Paper 26.3: every vault scenario on H2, a server killed right after a save, backups, reloads, H2 <-> JSON migrations, the H2 file of CocoVaults Legacy and the import of CocoVaults Lite's H2 database
• Tested with bot players on Paper and Spigot 26.3: shared inventories, no duplication, restarts, shutdown with open vaults, migrations and serialization switches
• Cross-server tested on MySQL 8.4, MariaDB and Redis, including a server crash while holding a lease
• Checked again with the final jar: every H2 scenario and hard-crash test, cross-server on MySQL 8.4, MariaDB and Redis, the admin commands and the import of CocoVaults Lite's H2 database
• PlaceholderAPI 2.12.3 tested on 26.3
• Reads vaults written by CocoVaults Legacy on any version, upgrading 1.8 items
Thank you for using CocoVaults Premium!
5.0.0-LEGACY
7 days ago
Update 5.0.0-LEGACY
🚀 UPDATE 5.0.0-LEGACY The Rebuild
CocoVaults Legacy - Released September 28th, 2026
⚠️ COMPLETE REWRITE
CocoVaults Legacy was rebuilt from scratch to close every duplication and data-loss path of CocoVaults 4, for Minecraft 1.8.8 - 26.2. Your vaults, names, icons and settings are kept, and vaults can now live in an embedded H2 database.
🗄️ New: H2 Database
• Embedded H2 Database - Set Storage-Mode: H2 and every vault lives in one local database file (storage/data.mv.db, H2-Name in Settings.yml). Nothing to install and no database server to run: H2 comes inside the plugin, and the file is a standard H2 database that H2's own tools can open
• Strictly Local - The H2 file belongs to this server alone: H2 locks it while the server runs, its network modes are never used, and it does not work with Cross-Server (networks use MySQL, MariaDB or Redis)
• Crash-Safe Writes - Every save is on disk before it counts as done, so a server that is killed right after a save keeps it. Big vaults have no size limit
• Same File on Every Version - CocoVaults 5 (Premium) opens this H2 database as it is (both editions write the same format), so it moves with the server across 26.2 and 26.3
• Strictly Local - The H2 file belongs to this server alone: H2 locks it while the server runs, its network modes are never used, and it does not work with Cross-Server (networks use MySQL, MariaDB or Redis)
• Crash-Safe Writes - Every save is on disk before it counts as done, so a server that is killed right after a save keeps it. Big vaults have no size limit
• Same File on Every Version - CocoVaults 5 (Premium) opens this H2 database as it is (both editions write the same format), so it moves with the server across 26.2 and 26.3
🔒 Duplication & Data-Loss Fixes
• One Shared Live Inventory - The owner and staff now look at the very same live inventory. CocoVaults 4 gave every viewer a copy and merged them back, which duplicated items
• Unreadable Vaults Stay Closed - A vault whose data cannot be read is never opened or overwritten. CocoVaults 4 opened it empty and saved over the real items
• Safe Serialization Changes - The item format is detected when reading, so changing Serialization-Type no longer makes existing vaults unreadable
• Ordered, Crash-Safe Saves - Each player's saves run in order on dedicated threads from deep-copied snapshots; files go to a temporary file, are flushed and moved into place, always in UTF-8
• No Silent Failures - Failed saves are reported and retried instead of being ignored, and empty vaults are saved too
• Shutdown & World Saves - Vaults still open when the server stops are written before it closes, and every world save writes the pending vaults
• Vault Size Fixes - The selector no longer loads vaults at 54 slots (a permission bypass); shrinking a vault moves the items into the free slots and keeps extra rows until they are emptied
• No Main-Thread Stalls - Players leaving the server no longer freeze it while their vaults are saved
• Blacklist Can't Be Bypassed - Shift-clicks, number keys, off-hand swaps and drags are all checked, including items hidden inside shulker boxes and bundles; blocked items are only handed back after a successful save
• Safe Vault Names - Vault names can use colors and styles but never click, hover or insertion tags
• Unreadable Vaults Stay Closed - A vault whose data cannot be read is never opened or overwritten. CocoVaults 4 opened it empty and saved over the real items
• Safe Serialization Changes - The item format is detected when reading, so changing Serialization-Type no longer makes existing vaults unreadable
• Ordered, Crash-Safe Saves - Each player's saves run in order on dedicated threads from deep-copied snapshots; files go to a temporary file, are flushed and moved into place, always in UTF-8
• No Silent Failures - Failed saves are reported and retried instead of being ignored, and empty vaults are saved too
• Shutdown & World Saves - Vaults still open when the server stops are written before it closes, and every world save writes the pending vaults
• Vault Size Fixes - The selector no longer loads vaults at 54 slots (a permission bypass); shrinking a vault moves the items into the free slots and keeps extra rows until they are emptied
• No Main-Thread Stalls - Players leaving the server no longer freeze it while their vaults are saved
• Blacklist Can't Be Bypassed - Shift-clicks, number keys, off-hand swaps and drags are all checked, including items hidden inside shulker boxes and bundles; blocked items are only handed back after a successful save
• Safe Vault Names - Vault names can use colors and styles but never click, hover or insertion tags
🌐 Cross-Server Rework
• Per-Player Leases - A server only loads a player's vaults while holding their lease (MySQL/MariaDB table or Redis key with expiry), and releases it after every pending save
• Version-Checked Writes - A server never overwrites changes made by another one; the conflicting copy is kept in conflicts/
• Crash Recovery - Leases left by a crashed server are cleared when it starts again, or taken over by another server after Heartbeat-Timeout
• Redis Locking - Redis now has real locks (CocoVaults 4 had none)
• Server Identity - Server-Name "auto" keeps a stable id in server-id.txt, and Lock-Wait-Seconds lets players switch servers smoothly
• Version-Checked Writes - A server never overwrites changes made by another one; the conflicting copy is kept in conflicts/
• Crash Recovery - Leases left by a crashed server are cleared when it starts again, or taken over by another server after Heartbeat-Timeout
• Redis Locking - Redis now has real locks (CocoVaults 4 had none)
• Server Identity - Server-Name "auto" keeps a stable id in server-id.txt, and Lock-Wait-Seconds lets players switch servers smoothly
✨ New Features
• Backups & Restore - Automatic backups (interval and how many to keep), /cv admin backup, and /cv admin restore <file> [player] into any storage. A backup is taken before every destructive action
• Audit Log - Daily files with every staff action and, optionally, what players move in and out of their vaults
• Admin Toolkit - /cv admin list, inspect (read-only), delete, clear, purge empty|inactive and info; admin commands also run from the console; /cv <player> <vault> shortcut; one permission per admin command and cocovaults.admin.edit
• /cv sort - Merges stacks and sorts a vault by item
• Smart Blacklist - Rules by material, regex:, name:, lore:, model: and enchant:, plus a WHITELIST mode
• Restrictions - Disabled worlds, blocked game modes and an open cooldown, with a bypass permission
• Ender Chest Access - Right-clicking an ender chest can open the vault selector
• Better Selector - Filler items, locked-vault previews, date format, configurable navigation slots and lore placeholders ({items}, {free}, {size}, {last_access})
• PlaceholderAPI - %cocovaults_max_vaults%, _available_vaults, _used_vaults, _size_<n>, _items_<n>, _free_<n> and _name_<n>, and PlaceholderAPI placeholders inside every message
• Sounds & Update Checker - Open, close, denied and page sounds, and a notice to the console and admins when a new version is out
• MiniMessage Everywhere - MiniMessage, & codes and &#RRGGBB in every message
• Importers - PlayerVaultsX (even when it is no longer installed), AxVaults, EnderVaults, FairyVaults, CocoVaults 3 (files, SQLite, MySQL and MariaDB) and CocoVaults Lite
• Migrations - Move vaults between YAML, JSON, SQLite, H2, MySQL, MariaDB and Redis with three confirmations, a progress bar and a backup of the destination first; switch storage live with /cv admin reload
• Database Options - Table-Prefix, extra JDBC properties, and Redis user, SSL and key prefix
• Audit Log - Daily files with every staff action and, optionally, what players move in and out of their vaults
• Admin Toolkit - /cv admin list, inspect (read-only), delete, clear, purge empty|inactive and info; admin commands also run from the console; /cv <player> <vault> shortcut; one permission per admin command and cocovaults.admin.edit
• /cv sort - Merges stacks and sorts a vault by item
• Smart Blacklist - Rules by material, regex:, name:, lore:, model: and enchant:, plus a WHITELIST mode
• Restrictions - Disabled worlds, blocked game modes and an open cooldown, with a bypass permission
• Ender Chest Access - Right-clicking an ender chest can open the vault selector
• Better Selector - Filler items, locked-vault previews, date format, configurable navigation slots and lore placeholders ({items}, {free}, {size}, {last_access})
• PlaceholderAPI - %cocovaults_max_vaults%, _available_vaults, _used_vaults, _size_<n>, _items_<n>, _free_<n> and _name_<n>, and PlaceholderAPI placeholders inside every message
• Sounds & Update Checker - Open, close, denied and page sounds, and a notice to the console and admins when a new version is out
• MiniMessage Everywhere - MiniMessage, & codes and &#RRGGBB in every message
• Importers - PlayerVaultsX (even when it is no longer installed), AxVaults, EnderVaults, FairyVaults, CocoVaults 3 (files, SQLite, MySQL and MariaDB) and CocoVaults Lite
• Migrations - Move vaults between YAML, JSON, SQLite, H2, MySQL, MariaDB and Redis with three confirmations, a progress bar and a backup of the destination first; switch storage live with /cv admin reload
• Database Options - Table-Prefix, extra JDBC properties, and Redis user, SSL and key prefix
🕹️ Built for 1.8.8 - 26.2
• Java 8 Ready - One jar for Spigot and Paper 1.8.8 up to 26.2, running on Java 8 and every newer Java
• Modern Names Everywhere - Materials and sounds use their modern names on every version (BLACK_STAINED_GLASS_PANE, block.chest.open) and are translated for old servers; old names work too
• Items Survive Minecraft Upgrades - Vaults remember the data version they were saved with, and items are upgraded with Mojang's own converters when the server is updated: 1.8 potions and spawn eggs, the 1.13 flattening and every later rename
• Exact Item Copies - Items are stored as binary NBT, which keeps names, lore and books exactly (quotes and brackets included) on every version
• MySQL 8.4 on Old Servers - MySQL and MariaDB go through the bundled MariaDB driver, which also logs into MySQL 8.4+ (the MySQL driver shipped with 1.8 - 1.16 servers cannot)
• Old-Version Details - The 32-character title limit of 1.8 is handled, hex colors are used from 1.16 (the nearest classic color before), and off-hand and bundle checks apply where they exist
• Every Command Works on 1.8 - Commands such as /cv icon work on 1.8 (CocoVaults 4 answered with an internal error there), and the server's own SQLite driver of 1.8 is supported
• Easy Move to 26.3+ - CocoVaults 5 (Premium) shares the folder and the data format, and reads these vaults as they are
• Modern Names Everywhere - Materials and sounds use their modern names on every version (BLACK_STAINED_GLASS_PANE, block.chest.open) and are translated for old servers; old names work too
• Items Survive Minecraft Upgrades - Vaults remember the data version they were saved with, and items are upgraded with Mojang's own converters when the server is updated: 1.8 potions and spawn eggs, the 1.13 flattening and every later rename
• Exact Item Copies - Items are stored as binary NBT, which keeps names, lore and books exactly (quotes and brackets included) on every version
• MySQL 8.4 on Old Servers - MySQL and MariaDB go through the bundled MariaDB driver, which also logs into MySQL 8.4+ (the MySQL driver shipped with 1.8 - 1.16 servers cannot)
• Old-Version Details - The 32-character title limit of 1.8 is handled, hex colors are used from 1.16 (the nearest classic color before), and off-hand and bundle checks apply where they exist
• Every Command Works on 1.8 - Commands such as /cv icon work on 1.8 (CocoVaults 4 answered with an internal error there), and the server's own SQLite driver of 1.8 is supported
• Easy Move to 26.3+ - CocoVaults 5 (Premium) shares the folder and the data format, and reads these vaults as they are
⚠️ Important Changes
• Minecraft Version - This edition targets Minecraft 1.8.8 - 26.2 on Paper and Spigot. On 26.3+ use CocoVaults 5 (Premium) (a warning is shown at startup)
• Settings.yml Updated Automatically - Every value you set is kept and the previous file is saved in old-configs/
• Data Compatible - CocoVaults 4 data (JSON, YAML, SQLite, MySQL, MariaDB and Redis) is read as it is; SQL tables get two new columns automatically
• CocoVaults 3 - A CocoVaults 3 configuration is kept as Settings-v3.yml; bring the vaults over with /cv admin import CocoVaults3
• Folia - Folia is not supported
• Settings.yml Updated Automatically - Every value you set is kept and the previous file is saved in old-configs/
• Data Compatible - CocoVaults 4 data (JSON, YAML, SQLite, MySQL, MariaDB and Redis) is read as it is; SQL tables get two new columns automatically
• CocoVaults 3 - A CocoVaults 3 configuration is kept as Settings-v3.yml; bring the vaults over with /cv admin import CocoVaults3
• Folia - Folia is not supported
📋 Update Instructions
1. BACKUP YOUR DATA - copy plugins/CocoVaults and your database before updating
2. Stop your server
3. Replace the old jar with CocoVaults-Legacy-5.0.0-LEGACY.jar
4. Start your server and check the console: Settings.yml is updated keeping your values
5. Coming from CocoVaults 3? Run /cv admin import CocoVaults3
2. Stop your server
3. Replace the old jar with CocoVaults-Legacy-5.0.0-LEGACY.jar
4. Start your server and check the console: Settings.yml is updated keeping your values
5. Coming from CocoVaults 3? Run /cv admin import CocoVaults3
🔍 Technical Details
For server administrators interested in the technical details:
• Same features as CocoVaults 5, compiled against Spigot 1.8.8 for Java 8
• Adventure 4.26.1, NBT-API 2.16.1, XSeries 13.7.1, Gson 2.14.0 and HikariCP 4.0.3, relocated, with Adventure, XSeries and Gson trimmed to the classes CocoVaults uses; Redis is spoken by CocoVaults' own small client (no Jedis)
• H2 2.2.224 (the last H2 built for Java 8, the same in every edition) and MariaDB Connector/J 3.5.10 travel packed with XZ, are unpacked on first use into plugins/CocoVaults/libraries/ (checked by SHA-256) and load apart from the server; H2 ships without its web console and TCP/PG servers. The jar is 3.5 MB
• H2 tested with bot players on Paper 1.8.8, 1.12.2, 1.16.5, 1.21.11 and 26.2: every vault scenario on H2, a server killed right after a save, backups, reloads and H2 <-> JSON migrations
• Tested with bot players on Paper 1.8.8, 1.9.4, 1.11.2, 1.12.2, 1.13.2, 1.14.4, 1.15.2, 1.16.5, 1.17.1, 1.18.2, 1.19.4, 1.20.4, 1.21.11, 26.1.2 and 26.2
• Items stored on 1.8.8 checked on 1.9.4, 1.11.2 and every major version from 1.12.2 to 1.21.11, and in CocoVaults 5 on 26.x
• On 1.8.8: upgrade from CocoVaults 4, migrations, storage and serialization switches, backups and restores, PlaceholderAPI, and cross-server locking on MySQL 8.4, MariaDB and Redis
• Checked again with the final jar on 1.8.8, 1.12.2, 1.16.5, 1.21.11 and 26.2: every H2 scenario and hard-crash test, cross-server on MySQL 8.4, MariaDB and Redis, the admin commands and the migration progress bar
• Same features as CocoVaults 5, compiled against Spigot 1.8.8 for Java 8
• Adventure 4.26.1, NBT-API 2.16.1, XSeries 13.7.1, Gson 2.14.0 and HikariCP 4.0.3, relocated, with Adventure, XSeries and Gson trimmed to the classes CocoVaults uses; Redis is spoken by CocoVaults' own small client (no Jedis)
• H2 2.2.224 (the last H2 built for Java 8, the same in every edition) and MariaDB Connector/J 3.5.10 travel packed with XZ, are unpacked on first use into plugins/CocoVaults/libraries/ (checked by SHA-256) and load apart from the server; H2 ships without its web console and TCP/PG servers. The jar is 3.5 MB
• H2 tested with bot players on Paper 1.8.8, 1.12.2, 1.16.5, 1.21.11 and 26.2: every vault scenario on H2, a server killed right after a save, backups, reloads and H2 <-> JSON migrations
• Tested with bot players on Paper 1.8.8, 1.9.4, 1.11.2, 1.12.2, 1.13.2, 1.14.4, 1.15.2, 1.16.5, 1.17.1, 1.18.2, 1.19.4, 1.20.4, 1.21.11, 26.1.2 and 26.2
• Items stored on 1.8.8 checked on 1.9.4, 1.11.2 and every major version from 1.12.2 to 1.21.11, and in CocoVaults 5 on 26.x
• On 1.8.8: upgrade from CocoVaults 4, migrations, storage and serialization switches, backups and restores, PlaceholderAPI, and cross-server locking on MySQL 8.4, MariaDB and Redis
• Checked again with the final jar on 1.8.8, 1.12.2, 1.16.5, 1.21.11 and 26.2: every H2 scenario and hard-crash test, cross-server on MySQL 8.4, MariaDB and Redis, the admin commands and the migration progress bar
Thank you for using CocoVaults Legacy!
4.0.2
Feb 21, 2026
Update 4.0.2
🔒 UPDATE 4.0.2 Security Hotfix
CocoVaults Premium - Released February 16th, 2026
⚠️ CRITICAL SECURITY UPDATE
This update patches multiple item duplication exploits and data integrity vulnerabilities.
All servers should update immediately.
All servers should update immediately.
🔒 Critical Security Fixes
• MySQL/MariaDB Dupe Exploit Fixed - Fixed critical bug where emptying a vault would not save, causing old items to reload from database (infinite item duplication)
• Race Condition Dupe Fixed - Fixed race condition where delayed click tasks could overwrite vault saves on close, causing item duplication or loss
• Cross-Server Duplication Fixed - Added missing cross-server validation checks to prevent simultaneous vault access across multiple servers
• Blacklist Save Failure Exploit Fixed - Blacklisted items are now only returned to players after successful save, preventing duplication on save failures
• Race Condition Dupe Fixed - Fixed race condition where delayed click tasks could overwrite vault saves on close, causing item duplication or loss
• Cross-Server Duplication Fixed - Added missing cross-server validation checks to prevent simultaneous vault access across multiple servers
• Blacklist Save Failure Exploit Fixed - Blacklisted items are now only returned to players after successful save, preventing duplication on save failures
✨ Data Integrity Improvements
• Thread-Safe Vault Data - VaultData now uses proper synchronization to prevent corruption from concurrent access
• Thread-Safe Active Vaults - Fixed non-thread-safe ArrayList causing potential crashes in ACTIVE_VAULTS registry
• Async Save Performance - Vault close saves are now fully async, eliminating main thread blocking during slow database operations
• Cross-Server Cache Invalidation - Vault cache is properly invalidated on cross-server opens to ensure fresh data is loaded
• Heartbeat Synchronization - markPlayerOffline now properly awaits completion, preventing cross-server race conditions
• Thread-Safe Active Vaults - Fixed non-thread-safe ArrayList causing potential crashes in ACTIVE_VAULTS registry
• Async Save Performance - Vault close saves are now fully async, eliminating main thread blocking during slow database operations
• Cross-Server Cache Invalidation - Vault cache is properly invalidated on cross-server opens to ensure fresh data is loaded
• Heartbeat Synchronization - markPlayerOffline now properly awaits completion, preventing cross-server race conditions
🛠️ Additional Fixes
• Single-Server Memory Leak Fixed - Player quit now properly flushes pending saves and clears cache in single-server mode
• Event Priority Corrected - InventoryCloseEvent changed from MONITOR to HIGH priority to properly handle state modifications
• Debounced Save Race Fixed - Fixed race condition where async removal could delete newly scheduled saves
• Click Task Leak Fixed - Pending click/drag delayed tasks are now properly cancelled when vaults close
• Event Priority Corrected - InventoryCloseEvent changed from MONITOR to HIGH priority to properly handle state modifications
• Debounced Save Race Fixed - Fixed race condition where async removal could delete newly scheduled saves
• Click Task Leak Fixed - Pending click/drag delayed tasks are now properly cancelled when vaults close
⚠️ Important Changes
• Breaking Behavior Change - Empty vaults are now saved to database (previously skipped in MySQL/MariaDB only)
• PlayerChangeServerListener - Now always registered and handles both single-server and cross-server modes
• Config Reload Support - Cross-server protection now works correctly when enabled via /cv admin reload
• PlayerChangeServerListener - Now always registered and handles both single-server and cross-server modes
• Config Reload Support - Cross-server protection now works correctly when enabled via /cv admin reload
📋 Update Instructions
1. BACKUP YOUR DATABASE - Always backup before updating
2. Stop your server
3. Replace the old CocoVaults.jar with version 4.0.2
4. Start your server
5. Monitor console for any errors during startup
2. Stop your server
3. Replace the old CocoVaults.jar with version 4.0.2
4. Start your server
5. Monitor console for any errors during startup
⚠️ Critical Notes
• UPDATE IMMEDIATELY - Multiple critical duplication exploits have been patched
• All empty vaults will now be saved to the database (fixing the dupe exploit)
• Cross-server setups will see improved data consistency
• Single-server setups will have better memory management
• No configuration changes required
• Fully compatible with existing vault data
• All empty vaults will now be saved to the database (fixing the dupe exploit)
• Cross-server setups will see improved data consistency
• Single-server setups will have better memory management
• No configuration changes required
• Fully compatible with existing vault data
🔍 Technical Details
For server administrators interested in the technical details:
• 12 distinct vulnerabilities patched in this release
• 5 critical severity issues resolved
• Thread safety improvements across 3 core classes
• Cross-server sync logic completely redesigned
• All changes are Java 8 compatible
• 12 distinct vulnerabilities patched in this release
• 5 critical severity issues resolved
• Thread safety improvements across 3 core classes
• Cross-server sync logic completely redesigned
• All changes are Java 8 compatible
Thank you for using CocoVaults Premium!
4.0.1
Jan 3, 2026
Update 4.0.1
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
UPDATE 4.0.1 Stable
CocoVaults Premium - Released January 3rd, 2026
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ What's New
• Custom Model Data Icons - Added support for custom items with Custom Model Data for /cv icon
• Version Detection System - New version detection system for smoother compatibility
• SQL Operation Boosts - Added new operations to speed up SQL workflows
• Dependency Resolution - Dependencies updated and resolved
• Version Detection System - New version detection system for smoother compatibility
• SQL Operation Boosts - Added new operations to speed up SQL workflows
• Dependency Resolution - Dependencies updated and resolved
Bug Fixes
• Cross-Server Dupe Fixed - Event priority issues resolved to eliminate cross-server duplication
⚠️ Important Changes
• Java Support Notice - Considering removal of Java 8, 11, 12, 16, and 17 support; plan accordingly
Update Instructions
1. Stop your server
2. Replace the old .jar file with the new one
3. Start your server
2. Replace the old .jar file with the new one
3. Start your server
⚠️ Important Notes:
• This update requires a server restart
• Back up your data before updating
• Improved stability for cross-server environments
• This update requires a server restart
• Back up your data before updating
• Improved stability for cross-server environments
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
4.0.0
Nov 13, 2025
Update 4.0.0
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
UPDATE 4.0.0 Stable
CocoVaults Premium - Released November 13th, 2025
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ What's New
• Complete Plugin Refactoring - The plugin has been completely refactored for better performance
• Redis Support - Added Redis support for improved data management
• Shared Cache System - New shared cache system for real-time editing
• Enhanced Customization Options - More customization options for commands and other features
• Storage Migration System - New migration system for storage backends
• NBT Serialization - Implemented NBT serialization for more efficient storage
• Custom Vault Icons - Added ability to set custom icons for Vaults based on the item in hand (supports Custom Model Data)
• Enhanced Server Switching Resistance - Improved stability for rapid server changes
• Cross-Server Cache Improvements - Significant cache and usage enhancements for cross-server environments
🔧 Bug Fixes
• Synchronization Issue Fixed - Resolved known synchronization problem
• Dependency Loading Fixed - Fixed known dependency loading issues
• Vault Editing Errors Fixed - Resolved errors when editing or viewing other players' vaults
• MySQL Storage Fixed - Fixed errors preventing Vaults from being saved to MySQL storage
• GUI Interface Fixed - Resolved interface issues in the /cv gui command
⚠️ Important Changes
• Updated Dependencies - Java 8 and 11 support may be removed soon, including corresponding Minecraft versions
• Configuration System Overhaul - The configuration and storage system has been completely changed
• Migration Required - You must perform the proper migration using the command:
/cv admin migrate CocoVaults3📋 Update Instructions
1. Stop your server
2. Replace the old .jar file with the new one
3. Start your server
4. Run the migration command:
/cv admin migrate CocoVaults3⚠️ Important Notes:
• This update requires a server restart
• Migration is mandatory for existing installations
• Backup your data before updating
• Improved stability for cross-server environments
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
3.8-BETA
Sep 2, 2025
Update 3.8-BETA
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
UPDATE 3.8-BETA
CocoVaults Premium - Released September 2, 2025
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ What's New
- Enhanced Server Switching Resistance - Improved stability for rapid server changes
- Cross-Server Cache Improvements - Significant cache and usage enhancements for cross-server environments
- Synchronization Issue Fixed - Resolved specific synchronization problem
📥 Update Instructions
- Stop your server
- Replace the old .jar file with the new one
- Start your server
⚠️ Important Notes:
- This update requires a server restart
- Improved stability for cross-server environments
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
3.7-BETA
Aug 27, 2025
Update 3.7-BETA
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
UPDATE 3.7-BETA
CocoVaults Premium - Released August 27, 2025
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ What's New
- No more Alpha stage! - The plugin has entered BETA
- Database Storage Performance Improved - Loading delays fixed and speed increased
- Cache Handling Issues Fixed - Resolved all known cache management problems
- Mohist & Magma Compatibility - Now compatible with Mohist and Magma servers
- Hybrid/Server Data Crossover - Cross-server and Paper hybrid data migration now supported
📥 Update Instructions
- Stop your server
- Replace the old .jar file with the new one
- Start your server
⚠️ Important Notes:
- This update requires a server restart
- Compatible with Mohist, Magma, and hybrid servers
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
3.6-ALPHA
Aug 25, 2025
Snapshot
Update 3.6-ALPHA
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
UPDATE 3.6-ALPHA
CocoVaults Premium - Released August 25, 2025
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ What's New
- EnderVaults Converter Fixed - Fixed issues with database conversion
📥 Update Instructions
- Stop your server
- Replace the old .jar file with the new one
- Start your server
⚠️ Important Notes:
- This update requires a server restart
- The EnderVaults converter is available only in the Premium version
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
3.4-ALPHA
Aug 22, 2025
Snapshot
Update 3.4-ALPHA
━━━━━━━━━━━━━━━━━━━━━━━━━━━
UPDATE 3.4-ALPHA
CocoVaults Premium - Released August 22, 2025
━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ What's New
- AxVaults Importer (Beta) - Exclusive Preview for Premium version
- FairyVaults Importer (Beta) - Exclusive Preview for Premium version
📥 Update Instructions
- Stop your server
- Replace the old .jar file with the new one
- Start your server
⚠️ Important Notes:
- This update requires a server restart
- Importers are available as a Preview only in the Premium version
━━━━━━━━━━━━━━━━━━━━━━━━━━━
3.3-ALPHA
Aug 22, 2025
Snapshot
Update 3.3-ALPHA
━━━━━━━━━━━━━━━━━━━━━━━━━━━
UPDATE 3.3-ALPHA
CocoVaults Premium - Released August 22, 2025
━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ What's New
- PlayerVaultsX Importer Fixed - Importer now works as expected
- Cache Responsibilities Improved - Separated and optimized for better performance
- Storage Methods Refactored - Partial refactor (except YAML) with up to 60% performance boost
- Fixed /cv 0 Bug - Command no longer allows usage with zero as vault number
📥 Update Instructions
- Stop your server
- Replace the old .jar file with the new one
- Start your server
⚠️ Important Notes:
- This update requires a server restart
- Configuration files are compatible with previous versions
━━━━━━━━━━━━━━━━━━━━━━━━━━━
3.2-ALPHA
Jul 20, 2025
Snapshot
Update 3.2-ALPHA
━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔄 UPDATE 3.2-ALPHA 🔄
CocoVaults Premium - Released July 20, 2025
━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ What's New
- • Minecraft 1.21.8 BETA Support - Be aware of update notes and report bugs on Discord
🔧 Improvements
- • Implemented improvements in the SQLite storage method
- • Some bugs found in Legacy versions were resolved
📋 Development Status
When will we leave ALPHA versions?
When the deprecations in the plugin's storage methods are resolved and support for Minecraft 1.21.8 is totally stable. (An update from NBT-API (@tr7zw/Item-NBT-API) is expected)
📥 Update Instructions
- Stop your server
- Replace the old .jar file with the new one
- Start your server
⚠️ Important Notes:
- This update requires a server restart
- Configuration files are compatible with previous versions
- BETA support for MC 1.21.8 - Please report any issues
━━━━━━━━━━━━━━━━━━━━━━━━━━━
3.1-ALPHA
Jul 8, 2025
Snapshot
Update 3.1-ALPHA
━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔄 UPDATE 3.1-ALPHA 🔄
CocoVaults Premium - Released July 8, 2025
━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ What's New
- • Minecraft 1.21.6/7 Support - Full compatibility with the latest Minecraft versions
🔧 Improvements
- • Updated dependencies to latest versions
- • Better stability with newer server implementations
🐛 Bug Fixes
- • Fixed errors when disabling the server
- • Resolved shutdown sequence issues
📥 Update Instructions
- Stop your server
- Replace the old .jar file with the new one
- Start your server
⚠️ Important Notes:
- This update requires a server restart
- Configuration files are compatible with previous versions
━━━━━━━━━━━━━━━━━━━━━━━━━━━
3.0-ALPHA
May 24, 2025
Snapshot
Update 3.0-ALPHA
CocoVaults Plugin - Major Update
CRITICAL UPDATE NOTICE
WARNING: DESTRUCTIVE UPDATE AHEAD!
BACKUP YOUR DATA BEFORE UPDATING!
* * * * *
We've completely redesigned our data storage and management system. We acknowledge the recent issues and have worked hard to address them.
Important Note About Cross-Server Usage:
We've received negative feedback regarding cross-server performance. It is ESSENTIAL to have a good internet connection between your database and your server. To mitigate these issues, we've implemented improved cache management and data transmission/reception protocols to enhance your experience. We're committed 100% to ensuring our clients have an excellent experience with our resources.
What's New:
Storage Improvements:
- 100% optimization of JSON storage mechanisms
- Fixed a critical write operation bug that was consuming excessive resources
- Enhanced YAML writing capabilities
- Implemented a robust caching system making operations light as a feather
Data Protection:
- Fixed corruption issues that occurred during server shutdowns
- Introduced a comprehensive backup and restoration system
Upgrade Instructions:
- BACKUP YOUR EXISTING DATA
- Disable the current plugin
- Delete the old version
- Install the new version
- Restart your server
Thank you for your continued support.
- TeoremalDev
2.0.15
May 1, 2025
Update 2.0.15
Please shut down your server, install the update, and then start it up. Do not use Plugin Loaders.
✳️ Fixes:
- Fixed bug validating MySQL credentials
- Fixed data‐saving error in MariaDB on the latest versions
- Fixed performance issue when saving in MariaDB
- Fixed error writing data to JSON
- Fixed JSON corruption and malformation when writing in bulk
- Fixed error writing to YAML when shutting down the server
⭐ Improvements:
- General optimization applied to all storage types
- Massive optimization when loading and saving data
- Now vaults that receive no modifications are not saved
- Dependencies updated
- Added a “Maximum Vaults” setting in the configuration
2.0.14
Apr 21, 2025
Update 2.0.14
🔨 Fixes:
- Corrected error that did not read the permits properly to non -operator players
- Fixed /cv admin view
2.0.13
Apr 18, 2025
Update 2.0.13
🔨 Fixes:
- Corrected known general errors
- Corrected error that did not allow data save when using the command /cv admin forceopen/view
- Reinforced mysql storage
✅ New Features:
- NEW Minecraft 1.8.8 - 1.21.5 Support
- Added support for disconnected players
2.0.12
Mar 1, 2025
Update 2.0.12
Improvements:
- Optimized and updated dependencies
- Now, MariaDB is included with the plugin, it will no longer be charged as an additional library
Fixes:
- Fixed known error by having plugins to use MariaDB driver
2.0.11
Feb 27, 2025
Hotfix 2.0.11
Hotfix:
- Corrected fatal error that caused inconsistencies in the plugin cache
2.0.10
Feb 26, 2025
Hotfix 2.0.10
Hotfix:
- Fixed SQL syntax error that prevented data from being saved in MySQL/MariaDB. Update safely
2.0.9
Feb 25, 2025
Update 2.0.9
Improvements:
- Now, command messages are nullable
- Refactored LogManager class for greater efficiency
New Features:
- NEW Vault Renaming System, applicable with /cv rename
Sign in
$4.99 USD
Sign in to purchase, save this product to your cart, and keep downloads tied to your account.
Stripe
Related resources