# 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."
# 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."
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