Getting started

Installation and requirements

mcVaults is a crate plugin for Paper servers. It needs no other plugin to work. Vault, PlayerPoints and PlaceholderAPI are optional extras.

RequirementDetails
ServerPaper 1.21.4 or newer
Java21 or newer
Vault (optional)Lets crates be bought with money. Needs an economy plugin (for example EssentialsX) behind it.
PlayerPoints (optional)Lets crates be bought with points.
PlaceholderAPI (optional)Enables the %mcvaults_...% placeholders.
  1. Stop the server and put mcVaults-2.0.2.jar in the plugins/ folder.
  2. Start the server. mcVaults creates plugins/mcVaults/ with config.yml, messages.yml, guis.yml, a crates/ folder (16 example crates) and an animations/ folder (23 animations).
  3. Check the console for the mcVaults banner. If you use Vault or PlayerPoints, make sure they load before you test paid crates.
No hologram plugin needed

Holograms, the floating reward and the particle ring are built from Minecraft display entities by mcVaults itself, and nothing is saved into your world files.

Upgrading from 1.x#

Replace the old jar. Crates, animations, player data and bound crate blocks carry over. The old messages.yml and guis.yml are kept as messages-v1.yml and guis-v1.yml and the new layout takes their place. If a crate file has its own hologram: section it still works; remove it to get the new hologram look.