Common problems
Fixes for the problems server owners hit most: plugin off, vaults that look empty, vaults in use, missing items after a rank change and purchases.
Find your symptom, then follow the fix.
The plugin stays off#
ExyliaLib is missing or did not load. The console says where to get it. Install ExyliaLib in plugins/ and restart. See Install ExyliaPlayerVaults.
Every vault looks empty after installing#
The plugin is reading a different database from the one the vaults are in, usually a fresh H2 file in its own folder while the vaults are still in ExyliaSurvivalCore's. Nothing is lost: set the right database in plugins/ExyliaPlayerVaults/database.yml and restart. See Coming from ExyliaSurvivalCore.
"That vault is open somewhere else right now"#
Somebody has the vault open: the player in another window, on another server, or staff. After a server crash its vaults stay shut for up to a minute, until the lock expires. If staff cannot close a vault open on another server, Redis is not enabled on every server in database.yml. See Share vaults across servers.
A player lost a rank and their items are gone#
They are not. With vaults.hidden-slots: keep, the default, stacks past the vault's new size stay stored out of sight and come back when the vault has enough rows again. Staff see them with /pvadmin edit <player> <number>, which is always six rows. Vaults past the player's new count show as locked and keep everything inside. With return, the stacks were handed back to the player or wait for their next join. See Give ranks more and bigger vaults.
/pv 2 says "You do not have vault 2"#
The player's rank gives them fewer vaults. Give them exyliaplayervaults.amount.<number>, or let them buy more. The number is also capped by vaults.max-amount.
A player cannot open a vault#
One of the restrictions refuses it: a disabled world, a disabled game mode (spectator by default), combat, or the cooldown. The message says which. Operators skip the world, game-mode and combat checks with exyliaplayervaults.bypass.restrictions. See Limit where and when vaults open.
A player cannot put an item in a vault#
The item is in vaults.blocked-materials, or it is a shulker box or bundle holding one. They see "That item cannot go in a vault." Only exyliaplayervaults.bypass.blocked skips the list, and nobody has it by default.
A player cannot buy another vault#
Purchases are off (purchase.enabled), they bought purchase.max-purchases, or their rank's vaults plus the ones they bought already reach vaults.max-amount. Raise max-amount when you add ranks with more vaults. See Sell extra vaults.
A purchase took the money but gave no vault#
This only happens when the database stopped answering mid-purchase. The console logs an error with the player, the price and the value playervaults_buyers should hold. Check that row and refund the player if it was not raised.
The vault list shows the wrong number#
A permission plugin may be giving a lower node than you think: the largest amount or rows number a player holds wins. Check with /lp user <player> permission info.
A placeholder shows as text#
PlaceholderAPI is not installed, the player is not online, or the name is misspelled. See Placeholders.
My edits to a staff menu disappeared#
Files under lang/<code>/menus/admin/ are replaced from the jar on every start and reload. Edit only menus/user/.
A crash lost a few items#
Open vaults are written every vaults.checkpoint (30 seconds) and on close, so a crash costs at most that much. /pvadmin history <player> <number> lists earlier copies, and any of them can be put back.
Something missing on this page? Tell us on Discord