ποΈ 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