NexaVaults | Modern Storage System v1.0.0

NexaVaults


What is NexaVaults?

NexaVaults is an advanced Minecraft vault system designed for servers that need more than a simple numbered chest.

Instead of only giving players /pv 1, NexaVaults provides configurable player vaults, rank-based progression, paid upgrades, shared vaults, admin inspection tools, audit logs, recovery snapshots, migration tools, binary item storage and optional network synchronization.

It is built for server owners who want vaults to become a real part of their economy, rank system, staff workflow and long-term storage infrastructure.


Main Features

• Personal player vaults with /vault, /pv, /v and /cv aliases.
• Vault selector GUI with locked vault states, pagination, filler items, placeholders and configurable amount display.
• Permission-based progression for rank systems, crates, subscriptions and staff grants.
• Economy-based progression with paid unlocks, paid upgrades, renewals, limited-time vaults and recurring rent.
• Custom vault types with size, price, currency, share limit, expiry and seasonal behavior.
• Vault customization with rename, description, icon from hand, material icons, pinning and categories.
• Shared vaults with viewer, member and manager roles.
• Temporary session sharing for short-term vault access.
• Community vault for server-wide shared storage.
• Indexed item search by material, display name, lore and CustomModelData.
• Vault sorting for cleaner player storage.
• Offline admin spy so staff can inspect and edit player vaults even when the player is offline.
• Item-level audit logs with GUI history and export tools.
• Suspicious activity alerts for large withdrawals and rapid vault access.
• Manual and scheduled snapshots with preview, rollback and revert commands.
• Anti-dupe focused save flow with live shared inventory state, per-vault locks, WAL recovery, revision-guarded saves and serialized save queues.
• Binary item serialization to preserve custom items more safely than fragile text storage.
• Blacklist, whitelist and sanitize rules for controlled item storage.
• Overflow pickup-to-vault inventory extension with permission control.
• SQLite, H2, MySQL and MariaDB support.
• Optional Redis network invalidation and SQL-backed cross-server vault locks.
• Backup, restore and migration tools for existing vault servers.
• PlayerVaultsX, PlayerVaultsZ, AxVaults and CocoVaults migration entrypoints.
• Modern server support for Paper-family servers, Folia-style environments and Java 21.

Why NexaVaults is Different

Most vault plugins are just a shortcut to a numbered inventory.

NexaVaults is designed like a complete storage platform.

Players can unlock vaults through permissions or economy purchases. Server owners can sell premium vault types, create limited-time storage, enable recurring rent, let players share vaults with roles, allow item searching, add category-based organization and keep staff tools available for moderation and recovery.

For larger servers, NexaVaults also includes SQL storage, optional Redis sync, per-vault locks, migration commands and backup tools so the plugin can grow with your network instead of becoming a limitation later.


Player Vault Access

Players can use simple commands to open and manage their storage:

• /vault opens the vault selector.
• /vault <id> opens a specific vault.
• /vault last opens the last used vault.
• /vault list shows created vaults with used slot information.
• /vault create <id> creates or loads a vault after permission checks.

Physical vault blocks are also supported through admin block linking, allowing a configured block in-game to open a specific vault number.


Rank and Permission Progression

NexaVaults is rank-friendly by design.

You can control how many vaults a player can access and how large those vaults can be using permissions.

Examples:

• Starter rank: nexavaults.vault.3 + nexavaults.size.27
• Elite rank: nexavaults.vault.10 + nexavaults.size.54
• Legendary rank: nexavaults.vault.* + nexavaults.size.*

Permission modes allow you to choose whether a permission such as nexavaults.vault.10 includes all previous vaults or whether every vault slot must be granted strictly.


Economy and Premium Vault Types

NexaVaults supports economy-based progression through Vault economy integration.

Players can buy, unlock, upgrade and renew vaults depending on your configuration.

• /vault buy <type> buys the next available vault using a configured vault type.
• /vault unlock <type> works as an unlock alias.
• /vault upgrade <id> <type> upgrades an existing vault.
• /vault renew <id> [days] extends an expiring vault.

Vault types can define:

• Display name
• Storage size
• Price
• Currency
• Share limit
• Expiry duration
• Recurring rent
• Seasonal mode

This makes it easy to sell premium vaults, seasonal vaults, temporary storage, subscription-style storage or rank-based vault products.


Vault Customization

Players can organize and personalize their storage.

• Rename vaults.
• Add descriptions.
• Set icons from the item in hand.
• Set icons from Bukkit materials.
• Reset custom icons.
• Pin important vaults.
• Assign categories or tags.
• Open category-filtered selectors.

Custom icons use the same binary item storage path as vault contents, helping renamed items, CustomModelData and supported custom item data survive as selector icons.


Sharing and Community Vaults

NexaVaults includes real shared vault access.

Players can grant other players access with different roles:

• Viewer can open the vault but cannot edit contents.
• Member can edit contents.
• Manager is a higher edit-capable role.

Supported sharing features:

• Permanent shared access.
• Temporary session sharing.
• Share limits per vault type.
• Ownership transfer.
• Owner notifications.
• Shared vault audit logs.
• Community vault for server-wide shared storage.

Players viewing the same vault on the same server share one live inventory state, so changes are visible immediately instead of relying on stale copied inventories.


Item Search and Management

Large vault setups are hard to manage when players forget where they stored items.

NexaVaults solves this with item search and organization tools.

• /vault find <query> searches the player's own indexed vault contents.
• /vaultadmin find <query> searches across all indexed vault contents.
• Search can include material names, display names, lore and CustomModelData.
• /vault sort <id> sorts vault contents.
• Blacklist and whitelist rules can control what may be stored.
• Save-time sanitizing can remove unwanted enchantments, attributes or custom NBT depending on config.
• Admin item purge tools can remove matching items from every vault.

Offline Admin Spy and Staff Tools

NexaVaults gives staff real moderation and recovery tools.

Admins can inspect and edit player vaults even when the target player is offline.

Useful staff commands include:

• Open a player's selector.
• Open a specific player vault.
• Edit offline player vault contents.
• Clear a specific vault.
• Reset all vaults for a player.
• Grant extra vault slots.
• Force-close a player's vault GUI.
• Globally lock vault access.
• Lock one player's vault access.
• Lock one specific player vault with a reason.
• Unlock previously locked vault access.
• Remove physical vault block links.

Admin edits are detected and written to the audit log with admin attribution.


Anti-Dupe and Crash Safety

NexaVaults is designed to avoid the common item duplication and item loss problems created by simple copy-on-open vault plugins.

Safety layers include:

• One live local inventory state while a vault is open.
• Per-vault active viewer tracking.
• Local and SQL-backed vault locks.
• Write-ahead log recovery.
• Startup replay for unfinished writes.
• Dirty viewer barrier before database commit.
• Revision-guarded saves to prevent stale writes.
• Serialized per-vault save queue.
• Post-click and post-drag scans.
• Save-on-close and save-on-shutdown options.
• SQLite WAL journal mode.
• Binary item storage.
• Search index replacement after successful content saves.

No plugin should claim that every possible crash or third-party conflict is impossible, but NexaVaults is built with item integrity as a core design goal.


Audit Logs, Alerts and Recovery

NexaVaults tracks important vault actions and provides recovery tools for staff.

Audit events can include:

• Put
• Take
• Swap
• Admin edit
• Sort
• Share
• Unshare
• Clear
• Rollback
• Replace
• Purge
• Rent
• Overflow deposits

Staff can view vault history, open global audit logs and export logs as CSV or TXT.

Recovery tools include:

• Manual snapshots.
• Scheduled snapshots.
• Read-only snapshot previews.
• Rollback to a specific snapshot.
• Revert to the latest snapshot.
• Replace one vault with another vault's contents.
• Automatic snapshots before delete and purge operations.

Seasonal Vault Mode

NexaVaults includes seasonal vault behavior for reset-based servers.

Supported modes include:

• Normal editable vaults.
• Store-only phase.
• Claim-only phase.
• Claim-after-reset vault types.

This is useful for SkyBlock, Prison and seasonal Survival networks where players need controlled storage before or after a reset.


Storage and Network Support

NexaVaults supports multiple storage backends:

• SQLite
• H2
• MySQL
• MariaDB

Small servers can run locally with SQLite or H2.

Larger servers can use MySQL or MariaDB with connection pooling, table prefixes, autosave settings and binary item storage.

Optional network features include:

• Redis pub/sub invalidation.
• Server ID configuration.
• SQL-backed distributed vault locks.
• Lock timeout configuration.
• Same-vault multi-open prevention.
• Network diagnostics command.

Migration and Backups

NexaVaults includes tools for servers switching from another vault plugin.

Migration and backup features include:

• Create NexaVaults backups.
• Restore backup-compatible YAML files.
• Dry-run legacy data scans.
• Migration reports.
• Import NexaVaults backup files.
• PlayerVaultsX import path.
• PlayerVaultsZ import path.
• AxVaults import path.
• CocoVaults import path.
• Generic legacy YAML-shaped data import path.

The importer is report-driven, meaning unsupported or incompatible files produce report entries instead of silently dropping data.


Configuration

NexaVaults is heavily configurable.

Main configuration files:

• config.yml controls vault defaults, permissions, safety, sharing, security, search, economy, inventory extension, access rules, database backend, Redis and distributed locks.
• vault-types.yml controls sellable and upgradeable vault products.
• messages.yml controls player-facing messages.
• menus/*.yml controls selector, vault, shared vault, audit, preview and confirmation menus.
• integrations.yml controls optional integrations.

Optional Integrations

NexaVaults can hook into popular server systems while keeping the core plugin usable without them.

Soft dependencies include:

• PlaceholderAPI
• Vault
• WorldGuard
• ItemsAdder
• Oraxen
• MMOItems

Compatibility

• Built for modern Paper-family servers.
• Folia-supported plugin configuration.
• Designed for Folia and Leaf-style modern fork environments.
• Java 21.
• Soft dependency design so the core plugin can start without optional integrations installed.

Example Commands

Player commands:

• /vault
• /vault <id>
• /vault last
• /vault list
• /vault create <id>
• /vault buy <type>
• /vault upgrade <id> <type>
• /vault renew <id> [days]
• /vault rename <id> <name>
• /vault description <id> <text>
• /vault icon <id> hand
• /vault icon <id> <material>
• /vault icon <id> reset
• /vault pin <id>
• /vault category <id> <name>
• /vault category <category>
• /vault find <query>
• /vault sort <id>
• /vault share <id> <player> viewer|member|manager
• /vault share <id> <player> viewer|member|manager session
• /vault unshare <id> <player>
• /vault transfer <id> <player> [targetId]
• /vault community

Admin commands:

• /vaultadmin spy <player>
• /vaultadmin spy <player> <vault>
• /vaultadmin clear <player> <vault>
• /vaultadmin reset <player>
• /vaultadmin give <player> <amount>
• /vaultadmin forceclose <player>
• /vaultadmin lock global
• /vaultadmin lock <player>
• /vaultadmin lock <player> <vault> [reason]
• /vaultadmin unlock ...
• /vaultadmin audit
• /vaultadmin audit <player> <vault>
• /vaultadmin exportaudit csv
• /vaultadmin exportaudit txt
• /vaultadmin snapshot <player> <vault> [reason]
• /vaultadmin preview <snapshotId>
• /vaultadmin rollback <player> <vault> <snapshotId>
• /vaultadmin revert <player> <vault>
• /vaultadmin replace <targetPlayer> <targetVault> <sourcePlayer> <sourceVault>
• /vaultadmin purge expired
• /vaultadmin purge inactive [days]
• /vaultadmin purge item <itemSpec>
• /vaultadmin backup
• /vaultadmin migrate dryrun <path>
• /vaultadmin migrate import <file>
• /vaultadmin network
• /vaultadmin diagnostics

Best For

• Survival servers that need safe long-term player storage.
• SkyBlock servers that sell storage upgrades and seasonal vaults.
• Prison servers with rank-based vault progression.
• SMP servers that need shared vaults and staff recovery tools.
• Networks that want SQL storage and optional Redis synchronization.
• Server owners migrating away from basic player vault plugins.

Final Pitch

NexaVaults is not just a vault plugin.

It is a premium storage system for servers that care about economy progression, player convenience, staff control, item safety, migration and long-term scalability.

If your server needs more than /pv 1, NexaVaults is built for that.