All resources
Minecraft plugins

mcVaults

Buy Crates | Custom Animation

Crates players want to open again.









Changelog

v2.0.2

  • New update checker: tells the console and admins (mcvaults.admin.updates) when a new version is on BuiltByBit. It checks on startup and once a day.
  • Optional auto-download (updates.auto-download: true): the new jar goes into plugins/update and installs on the next restart, after a backup of the current jar.
  • New updates: section in config.yml. An older config.yml without it uses the default settings.

v2.0.1

mcVaults 2.0.1
Fixed

  • Opening several crates at once (x5, x10) could give the same cosmetic twice when the crate uses duplicate: policy: REROLL. Cosmetics rolled earlier in the same open now count as owned.
  • REROLL no longer gives up after 5 tries. When every retry lands on a cosmetic the player owns, the reward is picked from the ones they don’t own yet. A duplicate only happens when they own them all.

v2.0.0

2.0.0

A big update. Crates now work with physical keys, stored keys and money, players get a crates menu, can open 1, 5 or 10 at once, and crate blocks get a floating reward showcase. Many 1.x bugs are fixed. Your crates, animations, player data and crate blocks carry over; messages.yml and guis.yml are replaced by the new layout and your old ones are kept as messages-v1.yml and guis-v1.yml.

New: keys
  • Physical keys. Real items players can trade, store or sell. They are tagged with the crate id, so a renamed item can never open a crate, and they can't be placed as blocks.
  • Keys work on every crate. Purchasable crates now use a player's key first and only charge money when they have none (keys.keys-before-buying). In 1.x, purchasable crates ignored keys.
  • Right-click a crate block with its key to open it at once. Sneak to open as many as your keys and the bulk limit allow.
  • Use a key in the air to see that crate's rewards.
  • /mv withdraw <crate> [amount] turns stored keys into key items. /mv deposit stores every key item in your inventory.
  • Custom key item per crate: a key: section in the crate file, or hold any item and set it in the admin panel.
  • keys.use-first: spend stored or physical keys first.

New: giving keys
  • Offline players. givekeys, takekeys and setkeys now work for players who are offline, so store deliveries never fail. In 1.x the player had to be online.
  • Physical keys for offline players are handed out the next time they join.
  • Key all: /mv givekeys all <crate> <amount> gives every online player keys, with a chat announcement.
  • physical gives key items instead of stored keys. -s gives silently.

New: menus
  • /crates menu: every crate with its icon, description, the player's keys, the price and their next guaranteed drop. Left-click to see the rewards, right-click to open, shift-right-click to open many.
  • Redesigned crate screen: rarest rewards first, a rarity and chance line on every reward, a stats head with your keys, opens, pity progress bars and the next milestone.
  • Open x1, x5 and x10 buttons (any amounts and slots in guis.yml). They turn green or red when you can or can't afford them.
  • Results screen after a multi-open: rewards are revealed one by one with rising notes, the best one last, plus an "open again" button.
  • A denied open (no keys, not enough money) keeps the menu open and refreshes it, instead of closing it.
  • New dark theme for every menu, message and the console banner.

New: rewards and progress
  • Milestones: run bonus commands at a number of opens (at: 100) or every few opens (every: 25), per crate.
  • Any item as a reward. Items dropped into the admin panel keep their enchantments, names, lore and data from other plugins. In 1.x only the material and amount were saved, so enchanted or custom items lost their data after a restart.
  • Enchantments in crate files: item.enchantments: {sharpness: 5}.
  • Reward tooltips show the rarity and the reward type.

New: crate blocks
  • Floating showcase: a reward item floats and spins above each crate block and cycles through the crate's rewards. On or off globally or per crate.
  • Idle particles around each crate block, per crate or off.
  • Holograms update live. In 1.x the key count in a hologram never changed after it appeared.
  • Holograms count physical keys too.
  • The showcase and particles only run while a player is nearby, and are never saved into the world.

New: placeholders
  • %mcvaults_virtual_<crate>%, %mcvaults_physical_<crate>%, %mcvaults_pity_<crate>_<tier>%, %mcvaults_milestone_<crate>%, %mcvaults_keys_total%, %mcvaults_opens_total%.
  • %mcvaults_keys_<crate>% now counts stored and physical keys.

New: admin
  • Crate settings has new buttons: key item, get a test key, menu icon, show in /crates, showcase.
  • Every crate file gets a menu: section (icon, slot, description, hidden).
  • Prices use a thousands separator ($2,500.00). Turn it off with thousands-separator: false.
  • New permissions: mcvaults.user.menu and mcvaults.user.withdraw (both on by default).
  • New alias /mv (the 1.x help menu already used it, but it did not exist).

Fixes
  • Placeholders for crates with _ in the id (all 16 included crates) returned nothing. Fixed.
  • Keys could be lost at login. Player data loaded in the background and could land after the player joined, overwriting keys given in that moment. Data now loads before the player enters.
  • Deleted example crates came back on every reload. They are now only created on the first install.
  • The chat prefix was never shown. Messages now use the prefix from messages.yml.
  • Purchase history grew forever. storage.history-limit now works.
  • Saving player data and limited winners no longer reads live data from another thread.
  • Deleting a crate in the admin panel now needs a shift-click, and the button moved to the corner. One stray click deleted the crate in 1.x.
  • Removed CoinsEngine from the supported list: 1.x mentioned it, but never had a CoinsEngine hook. Vault and PlayerPoints are supported.
  • The "storage type" comment no longer suggests SQLite or MySQL, which were never available.
  • A crate file with a milestone that has neither at: nor every: is reported on load.

Compatibility
- Paper 1.21.4 or newer, Java 21 or newer. Tested on Paper 1.21.8 and 26.1.2.

v1.0.1

Fixed a warning and relic_crate not loading properly.

mcVaults | Buy Crates | Custom Animation









Full history on BuiltByBit

More from TechnoTech