Voxel Shop beta is live. Expect occasional bugs. Learn more  
CocoVaults - Lite icon

CocoVaults - Lite 5.0.0-LITE

A lightweight & Free plugin, compatible with NBT-Data & CustomModelData

Page 1
Update 5.0.0-LITE

πŸš€ UPDATE 5.0.0-LITE The Rebuild
CocoVaults Lite - Released September 28th, 2026

⚠️ COMPLETE REWRITE
CocoVaults Lite 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 and its network modes are never used

β€’ 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 Lite 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
✨ 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 and CocoVaults 3 (JSON/YAML data)

β€’ Migrations - Move vaults between JSON, YAML and H2 with three confirmations, a progress bar and a backup first; switch storage live with /cv admin reload
⚠️ Important Changes
β€’ Minecraft Version - CocoVaults 5 targets Minecraft 26.3+ on Paper and Spigot. For 1.8.8 - 26.2 use CocoVaults Lite Legacy

β€’ Settings.yml Updated Automatically - Every value you set is kept and the previous file is saved in old-configs/

β€’ Data Compatible - CocoVaults Lite 4 data (JSON and YAML) is read as it is

β€’ 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-Lite before updating
2. Stop your server
3. Replace the old jar with CocoVaults-Lite-5.0.0-LITE.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 code as CocoVaults 5 without the database features
β€’ Rewritten from scratch against Spigot API 26.3 (Java 21 bytecode; 26.3 servers run Java 25)
β€’ Adventure 5.2.0 and NBT-API 2.16.1, relocated
β€’ H2 2.2.224 travels packed with XZ inside the jar, is unpacked on first use into plugins/CocoVaults-Lite/libraries/ (checked by SHA-256) and loads apart from the server, without its web console and TCP/PG servers (never used: the database is strictly local). The jar is 2.4 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 and the H2 file of CocoVaults Lite Legacy
β€’ Tested with bot players on Paper 26.3: shared inventories, no duplication, restarts, shutdown with open vaults
β€’ Reads vaults written by CocoVaults Lite Legacy on any version, upgrading 1.8 items

Thank you for using CocoVaults Lite!
Update 5.0.0-LITE-LEGACY

πŸš€ UPDATE 5.0.0-LITE-LEGACY The Rebuild
CocoVaults Lite Legacy - Released September 28th, 2026

⚠️ COMPLETE REWRITE
CocoVaults Lite 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 and its network modes are never used

β€’ 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 Lite 5 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
✨ 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 and CocoVaults 3 (JSON/YAML data)

β€’ Migrations - Move vaults between JSON, YAML and H2 with three confirmations, a progress bar and a backup first; switch storage live with /cv admin reload
πŸ•ΉοΈ 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

β€’ 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)

β€’ Easy Move to 26.3+ - CocoVaults Lite 5 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 Lite 5 (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 Lite 4 data (JSON and YAML) is read as it is

β€’ 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-Lite before updating
2. Stop your server
3. Replace the old jar with CocoVaults-Lite-Legacy-5.0.0-LITE-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 code as CocoVaults Legacy without the database features
β€’ Compiled against Spigot 1.8.8 for Java 8; Adventure 4.26.1, NBT-API 2.16.1, XSeries 13.7.1 and Gson 2.14.0, relocated
β€’ H2 2.2.224 (the same in every edition) travels packed with XZ, is unpacked on first use into plugins/CocoVaults-Lite/libraries/ (checked by SHA-256) and loads apart from the server, without its web console and TCP/PG servers. The jar is 2.9 MB
β€’ Tested with bot players on Paper 1.8.8 and 1.21.11, with JSON and with H2 (including a server killed right after a save)
β€’ Reads the vaults of CocoVaults Lite 4 as they are

Thank you for using CocoVaults Lite Legacy!
Update 4.0.2

πŸ”’ UPDATE 4.0.2 Security Hotfix
CocoVaults Lite - Released February 16th, 2026

⚠️ CRITICAL SECURITY UPDATE
This update patches multiple item duplication exploits and data integrity vulnerabilities.
All servers should update immediately.

πŸ”’ Critical Security Fixes
β€’ Race Condition Dupe Fixed - Fixed race condition where delayed click tasks could overwrite vault saves on close, causing item duplication or loss

β€’ 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 I/O operations
πŸ› οΈ Additional Fixes
β€’ 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
πŸ“‹ Update Instructions
1. BACKUP YOUR VAULT DATA - Always backup your plugins/CocoVaults folder 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
⚠️ Critical Notes
β€’ UPDATE IMMEDIATELY - Multiple critical duplication exploits have been patched
β€’ No configuration changes required
β€’ Fully compatible with existing vault data (JSON/YAML)
β€’ Improves stability and prevents item loss
β€’ All async operations now properly synchronized
πŸ“ Technical Details
For server admins & developers:

β€’ VaultData fields now use volatile for thread visibility
β€’ Synchronized access methods prevent data races
β€’ CopyOnWriteArrayList used for concurrent vault tracking
β€’ Async saves with proper completion callbacks
β€’ Race condition guards in close/save pipeline
β€’ Defensive copies prevent external modification

Questions? Support at fruitforge.com/discord
Update 4.0.1


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
UPDATE Lite (Aligned with Official Version 4.0.1)
CocoVaults Lite - Released January 8th, 2026
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✨ What's New
β€’ Full Version Alignment - Lite version updated to match the official plugin version
Bug Fixes
β€’ Vault Saving Fixes - Important corrections applied to vault saving
β€’ Known Issues Resolved - All known errors have been fixed
β€’ Dependencies Updated - All dependencies have been refreshed
⚠️ Important Changes
β€’ Incompatible with Previous Files - Older version files (items and configuration) are not compatible; a clean reinstall is recommended
β€’ This compatibility reset will not change again moving forward
Update Instructions
1. Stop your server
2. Remove previous Lite plugin files
3. Place the new Lite .jar and fresh configuration
4. Start your server
⚠️ Important Notes:
β€’ Perform a clean reinstall due to incompatibility with prior versions
β€’ Back up any data you wish to preserve before replacing files

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Snapshot
Update 2.4-ALPHA

━━━━━━━━━━━━━━━━━━━━━━━━━━━


UPDATE 2.4-ALPHA


CocoVaults Lite - Released August 24, 2025

━━━━━━━━━━━━━━━━━━━━━━━━━━━


βœ… What's New


  • Hotfix for plugin.yml dependencies - Fixed an inconsistency affecting dependencies
  • MiniMessage Dependency Updated - Updated to the latest version
  • Unused Dependencies Removed - Freed up storage by removing unused dependencies

πŸ“₯ Update Instructions


  1. Stop your server
  2. Replace the old .jar file with the new one
  3. Start your server

⚠️ Important Notes:
  • This update requires a server restart
  • The update improves plugin stability and reduces storage usage

━━━━━━━━━━━━━━━━━━━━━━━━━━━


 Snapshot
Update 2.3-ALPHA

━━━━━━━━━━━━━━━━━━━━━━━━━━━


UPDATE 2.3-ALPHA


CocoVaults Lite - 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


  1. Stop your server
  2. Replace the old .jar file with the new one
  3. Start your server

⚠️ Important Notes:
  • This update requires a server restart
  • Configuration files are compatible with previous versions

━━━━━━━━━━━━━━━━━━━━━━━━━━━


 Snapshot
Update 2.2-ALPHA

━━━━━━━━━━━━━━━━━━━━━━━━━━━

πŸ”„ UPDATE 2.2-ALPHA πŸ”„


CocoVaults Lite - Released July 20, 2025


━━━━━━━━━━━━━━━━━━━━━━━━━━━

βœ… What's New


  • β€’ Minecraft 1.21.8 BETA Support - Be aware of update notes and report bugs on Discord
  • β€’ CocoVaults Premium Permission - Added permission to unlock specific vaults
  • β€’ Individualized GUI Permission - Main GUI opening permission now editable in Settings.yml

πŸ“‹ 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


  1. Stop your server
  2. Replace the old .jar file with the new one
  3. 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

━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Snapshot
Update 2.1-ALPHA

━━━━━━━━━━━━━━━━━━━━━━━━━━━

πŸ”„ UPDATE 2.1-ALPHA πŸ”„


CocoVaults Lite - 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

πŸ› Bug Fixes


  • β€’ Fixed errors when disabling the server

πŸ“₯ Update Instructions


  1. Stop your server
  2. Replace the old .jar file with the new one
  3. Start your server


⚠️ Important Notes:


  • This update requires a server restart
  • Configuration files are compatible with previous versions

━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Snapshot
Update 2.0-ALPHA
CocoVaults Plugin - Major Update
Β 
Date: 2025-05-24 18:42:38
Β 
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.
Β 
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:
  1. BACKUP YOUR EXISTING DATA
  2. Disable the current plugin
  3. Delete the old version
  4. Install the new version
  5. Restart your server

Β 
Thank you for your continued support.
Β 
- TeoremalDev
Hotfix 1.2.5
Hotfix:
  • Corrected fatal error that caused inconsistencies in the plugin cache
Update 1.2.4
Improvements:
  • Now, command messages are nullable
  • Refactored LogManager class for greater efficiency
  • SplashX updated with better design
New Features:
  • NEWΒ Vault Renaming System, applicable with /cv rename
Update 1.2.3
Fixes:
  • Fixed an issue where names were not displayed on the page navigation arrows in the /cv gui.
  • Fixed a critical bug that allowed abuse of theΒ Blacklist.
  • Updated Dependencies
  • Fixed Update Checker
New Features:
  • NEWΒ version detection system that automatically configures your plugin and adds missing keys.Β WE RECOMMEND DELETING YOUR OLD CONFIGURATION FILE.
  • NEWΒ internal placeholders to indicate the available or occupied space in yourΒ Vaults.
  • NEWΒ cooldown system to prevent command abuse.
  • NEWΒ sounds added when opening/closingΒ Vaults.
  • NEWΒ system that allows you to specify whether closing aΒ VaultΒ should reopen the main GUI or not.
Update 1.2.2
Please delete your old configuration file!!
Β 
Changes:
-
Minecraft 1.21.4 Support
- Fixed NBT bug that caused casual problems in the main GUI of the /cv gui command
- Fixed a serious error detected when reloading the plugin
- Fixed maximized compatibility with Minecraft 1.8.8
- New libraries implemented for maximum compatibility of materials and design
- Implemented new fields to edit more data from the /cv gui, such as materials and lore
- Implemented new methods for improvements in error handling
- Refactored methods responsible for Deserialization and SerializationΒ [Experimental]
-Β Deprecated YAML STORAGE, Migrate your data to another storage mode such as JSON
Update 1.2.1
Changes:
- Added full support for 1.8.8 - 1.21.3
Update 1.2
Changes:
- Support for Minecraft 1.21.3
- Fixed YAML support, data will no longer be lost
- Methods, classes and functions refactored and optimized to avoid lag
- Fixed icon function in /coco gui
- Hidden attributes for /coco gui icons
Page 1
Owned
Ready to download
This resource is already attached to your account. You can download the latest file any time.

playervaults

vaults

cocovaults

storage