Help

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.