ItemVaultX – Secure Item Vaults ✅ Rename ✏️ Share ➡️ Upgrade ⬆️ [1.12 – 1.21+] ✅ icon

ItemVaultX – Secure Item Vaults ✅ Rename ✏️ Share ➡️ Upgrade ⬆️ [1.12 – 1.21+] ✅ -----

Allow players to have personal vaults, shared vaults with others and even upgrade to add more pages



ItemVaultX - Official Documentation
Reference guide for installation, usage, configuration & permissions


Installation
  • Requires: Vault
  • Tested on Minecraft 1.20+
  • Drop ItemVaultX.jar into your /plugins folder
  • Restart or reload your server
  • Edit
    Code (Text):
    config.yml
    &
    Code (Text):
    lang.yml
    as needed


Code (Text):

# -------------------------
# ItemVaultX Configuration
# -------------------------

# Type of storage backend to use.
# Options:
#   - sqlite: Local file-based storage (default, no setup needed)
#   - sql:    External MySQL database (must configure below)
storage-type: sqlite

# MySQL database configuration (used only if storage-type is 'sql')
mysql:
  host: "localhost"         # MySQL server address
  port: 3306                # MySQL server port
  database: "itemvaultx"    # Database name
  user: "root"              # MySQL username
  password: "password"      # MySQL password

# Vault system configuration
vaults:
  max-vaults: 100           # Maximum number of vaults a player can create

vault-settings:
  enable-sounds: true       # Play sounds when interacting with vaults/upgrading

# Vault page upgrade costs
# Page 1 is always unlocked by default.
# These values define the cost to unlock each subsequent page:
#   1: Cost to unlock Page 2
#   2: Cost to unlock Page 3
#   3: Cost to unlock Page 4, etc.
vault-upgrades:
  upgrade-costs:
    1: 10000                # Cost to unlock Page 2
    2: 25000                # Cost to unlock Page 3
    3: 50000                # Cost to unlock Page 4
    # Add more entries (e.g. 4: 75000) to allow more page upgrades

# Auto-save configuration
auto-save:
  enabled: true             # Whether vaults auto-save in the background
  interval-minutes: 10      # Time interval between auto-saves (in minutes)
 
→ Customize vault count, and optional economy-based upgrades.

Code (Text):

# ---------------------------
# ItemVaultX Language Config
# ---------------------------

# Plugin message prefix (used at the start of most messages)
prefix: "&8[&aItemVaultX&8]"

# Error & interaction messages
invalid-vault-number: "%prefix% &cThat vault number is invalid."
vault-no-permission: "%prefix% &cYou do not have permission to open Vault #%vault%."
vault-opened: "%prefix% &aYou have opened Vault #%vault%."
vault-rename: "%prefix% &aVault #%vault% renamed to &e%name%&a."
vault-upgraded: "%prefix% &aVault #%vault% upgraded to size &e%size%."
vault-upgrade-no-economy: "%prefix% &cEconomy support is not available."
vault-upgrade-invalid-size: "%prefix% &cInvalid upgrade size: %size%"
vault-upgrade-open-first: "%prefix% &cYou must open this vault at least once before upgrading it."
vault-maxed: "%prefix% &cThis vault is already at its maximum size."

# Vault sharing messages
vault-shared: "%prefix% &aYou shared Vault #%vault% with &e%player%&a."
vault-unshared: "%prefix% &aYou unshared Vault #%vault% with &e%player%&a."
vaultshared-not-shared: "%prefix% &cThat vault isn't shared with you."
vaultshared-not-found: "%prefix% &cVault data not found."
vaultshared-usage: "%prefix% &eUsage: /vaultshared <player> <vault>"
vaultshared-already-shared: "%prefix% &cVault #%vault% is already shared with &e%player%&c."
vaultshared-not-owned: "%prefix% &cYou don't own Vault #%vault%."

# General errors & reload messages
player-not-found: "%prefix% &cPlayer not found."
vault-not-found: "%prefix% &cNo vault data found."
config-reloaded: "%prefix% &aConfiguration reloaded!"
plugin-reload-failed: "%prefix% &cFailed to reload configuration. Check console for errors."
only-players: "%prefix% &cOnly players can use this command."
error-invalid-command: "%prefix% &cUnknown command or usage. Type /vaulthelp."
vault-no-access: "%prefix% &cYou cannot access this vault right now."
vault-invalid-command: "%prefix% &cInvalid subcommand. Use &e/vaulthelp &cfor help."

# Command usage messages
usage-vaultupgrade: "%prefix% &eUsage: /vaultupgrade <number>"
usage-vaultrename: "%prefix% &eUsage: /vaultrename <vault> <name>"
usage-vaultshare: "%prefix% &eUsage: /vaultshare <player> <vault>"
usage-vaultunshare: "%prefix% &eUsage: /vaultunshare <player> <vault>"
usage-vaultadmin: "%prefix% &eUsage: /vaultadmin <open/openoffline/reload> [player] [vault]"

# Vault admin feedback
vaultadmin-reload-success: "%prefix% &aConfiguration successfully reloaded."
vaultadmin-openfail-player: "%prefix% &cPlayer not found or not online."
vaultadmin-openfail-data: "%prefix% &cNo vault data found for that player."
vaultadmin-openfail-console: "%prefix% &cOnly players can open vault GUIs."

# GUI elements
vaults-gui-title: "&8Your Vaults"
sort-button-title: "&bSort: &f%type%"
sort-label-name: "Name"
sort-label-number: "Number"
sort-label-last-accessed: "Last Accessed"
sort-label-favorites: "Favorites"

sort-button-lore:
  - "&7Click to change sorting"

vault-item-lore:
  - "&7Click to open Vault #%vault%"

# Page & upgrade related messages
vault-locked-page: "%prefix% &cYou have not unlocked this page yet. Use &e/vaultupgrade %vault% &cto unlock more pages."
vault-max-pages: "%prefix% &cYou have already unlocked all available pages for Vault #%vault%."
vault-upgrade-success: "%prefix% &aSuccessfully unlocked page &e%page% &afor Vault #%vault%."
vault-upgrade-cost: "%prefix% &cYou need &e$%cost% &cto unlock the next page."
vault-upgrade-no-cost: "%prefix% &cThis vault cannot be upgraded further."
not-enough-money: "%prefix% &cYou do not have enough money."
vault-page-nav-invalid: "%prefix% &cYou cannot go to that page."

# Help command menu
vault-help:
  - "&8&m----------------------------------------"
  - "&a&lItemVaultX Help Menu"
  - "&7/vault <number> &f- Open a specific vault"
  - "&7/vaults &f- View GUI of available vaults"
  - "&7/vaultrename <number> <name> &f- Rename a vault"
  - "&7/vaultupgrade <number> &f- Upgrade a vault"
  - "&7/vaultshare <player> <vault> &f- Share a vault"
  - "&7/vaultunshare <player> <vault> &f- Unshare a vault"
  - "&7/vaultshared <player> <vault> &f- Open a shared vault"
  - "&7/vaultadmin <subcommand> [...] &f- Admin vault access"
  - "&8&m----------------------------------------"

 
→ Supports full message customization with color codes and placeholders.

Code (Text):

/vault [#]             - Open your personal vault
/vaults               - GUI of all your vaults
/vaultadmin open <player> <#>         - Force-open a player's vault
/vaultadmin openoffline <player> <#>  - Open an offline player's vault
/vaultadmin reload     - Reload configuration files
/vaultrename <v> <name> - Rename a vault
/vaultupgrade <v>       - Upgrade a vault (costs $)
/vaultshare <player> <v> - Share vault access
/vaultunshare <player> <v> - Revoke sharing
/vaultshared <player> <#> - Access shared vault
/vaulthelp              - Show help
 

Node Function Default
itemvaultx.vault Base access to vaults true
itemvaultx.vault.<number> Access up to vault declared true
itemvaultx.vault.rename Rename vaults true
itemvaultx.vault.upgrade Upgrade vaults true
itemvaultx.vault.share Share vaults true
itemvaultx.vault.unshare Unshare vaults true
itemvaultx.vault.shared Access shared vaults true
itemvaultx.admin Admin commands op

/vaultadmin open <player> <vault>
→ Opens a vault of an online player

/vaultadmin openoffline <player> <vault>
→ Access vaults of offline players (read-only)

/vaultadmin reload
→ Reload all configs without restarting

Admin tools are protected by itemvaultx.admin permission

To enable economy-based upgrades:
  • Define costs under upgrade-costs and add more to allow more page upgrades
  • Requires Vault + Economy plugin (EssentialsX, CMI, etc.)
  • Players need /vaultupgrade permission


Additional Notes
  • Async-safe for performance on large servers
  • Plugin auto-generates vaults on join
  • Works seamlessly with other GUI plugins
  • UUID-based user tracking
  • SQL fallback if SQLite fails


For support, bug reports, or feature suggestions, use the Spigot Discussion tab
Resource Information
Author:
----------
Total Downloads: 118
First Release: May 2, 2025
Last Update: May 11, 2025
Category: ---------------
All-Time Rating:
1 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings