🚀 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 [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 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, items, free and name, 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!