Troubleshooting and FAQ
Players are told they have no permission to open a crate
When a crate has no permission: set, the open check uses mcvaults.user.open.<crate-id>. Give your default group mcvaults.user.open.* in your permissions plugin, or set a permission: node in the crate file and give that to players.
/mv reload says there are problems
The message lists what is wrong, such as an unknown rarity, an unknown animation id, an invalid season timestamp, or a reward with no item. Fix the named crate or animation file and reload again.
A crate cannot be bought
Check that purchasable: true, that economy is vault or playerpoints, and that Vault has an economy plugin behind it (the console warns "Vault detected but no economy provider" otherwise). For playerpoints, PlayerPoints must be installed.
/mv bind says to look at a block
/mv bind targets the block you look at within 6 blocks. Air does not count. A block that already has a crate must be unbound first with /mv unbind.
Holograms do not show
Check holograms.mode is not DISABLED and that you are within holograms.view-distance blocks. Run /mv reload after changing the config; it respawns the displays. No hologram plugin is required.
A player cannot open x5 or x10
They need mcvaults.user.bulk. The amount is capped by the lower of the crate's bulk-max and bulk.max-opens, and there is a per-player wait between multi-opens (bulk.cooldown-seconds).
/mv givekeys says the player never joined
Offline keys work only for players who have joined the server before, so their UUID is known. Check the spelling of the name.
Do keys get lost on death or a full inventory?
Stored keys never do. Physical keys are normal items, so they behave like any other item. Use /mv deposit to store them.
Can players skip or close an animation?
No. The player is locked into the animation. If they log out or the server restarts, the reward they rolled is still given.
I want a reward to run a command only
Use kind: COMMAND_ONLY with a commands: list. It is shown with a placeholder icon, so give it a display-name and lore.