Opening animations
There are 23 animations. A crate picks one with animation: <id> in its file. Players cannot close or skip an animation, and a reward is never lost if they log out or the server restarts mid-animation.
Menu animations (play in an inventory screen)#
| Id | Type | What it does |
|---|---|---|
horizontal-roulette | ROULETTE_H | Horizontal reel that slows down onto the win. |
vertical-roulette | ROULETTE_V | Vertical reel. |
slot-machine | SLOTS_3 | Three-reel slot machine. |
ring-reveal | RING_EXPAND | Slots fill outward from the center. |
card-flip | CARD_FLIP | Face-down cards flip over. |
countdown | COUNTDOWN | Candidates are eliminated one by one. |
chest-unlock | CHEST_UNLOCK | A lock dial cycles, then unlocks. |
mystery-pick | PICK_ROLL | The player clicks a mystery slot to roll it. |
scratch-card | SCRATCH | The player scratches panels off a card. |
balloon-pop | BALLOON_POP | The player pops a balloon, the rest follow. |
dice-roll | DICE_ROLL | Two dice flash, then the result reveals. |
lucky-wheel | LUCKY_WHEEL | A ring of rewards spins under a pointer. |
mining-dig | MINING_DIG | A pickaxe smashes a wall open. |
fishing-reel | FISHING_REEL | Catches rise from the water to the surface. |
World animations (play on the crate block, GUI closed)#
| Id | Type | What it does |
|---|---|---|
carousel | CAROUSEL | A ring of rewards circles the crate and stops on the win. |
crate-spin | CRATE_SPIN | A reward rises out of the crate and flips through the rewards. |
meteor | METEOR | A burning rock falls onto the crate and the win rises out. |
fountain | FOUNTAIN | Rewards shoot out in arcs, then the win. |
chest-reveal | CHEST_REVEAL | A chest appears in front of the player, decoy rewards orbit and are sucked in, then the chest bursts open and the win rises out. |
flicker-landing | ITEM_FLICKER | A floating item flickers and lands. |
lightning-reveal | LIGHTNING_REVEAL | Visual lightning bolts strike, then reveal. |
vortex-burst | VORTEX_BURST | A particle spiral bursts into the reward. |
firework-show | FIREWORK_SHOW | An accelerating firework volley and a finale. |
World animations play on the crate block that was clicked. When a crate is opened from /crates or a command, they play in front of the player instead. The floating reward above a crate hides while an animation plays on it.
Make your own animation#
Copy any file in animations/, rename it (the file name is the id), edit it, point a crate at it and run /mv reload. Each file has a display-name, a type (from the tables above), settings for that type (rows, title, timing, anchor height) and a list of steps.
Each step has an action and a when hook (START, TICK, REVEAL or END; no when means REVEAL):
| Action | Main parameters |
|---|---|
SOUND | sound (required, a vanilla id), volume, pitch |
TITLE | title and/or subtitle, fade-in, stay, fade-out |
ACTIONBAR, MESSAGE | text |
BOSSBAR | text, color, style, progress, seconds |
PARTICLE | particle (particles without extra data), count, dx, dy, dz, speed, spread values |
FIREWORK | color (hex), flicker, power, offsets |
LIGHTNING | offsets. Visual only, never damages. |
DELAY | ticks (required) |
REVEAL | No parameters. The moment the reward is actually given, commands run and the win is announced. Without a REVEAL step the reward is given when the animation ends. |
ITEM_DISPLAY | op (spawn, set, despawn), id, material, offsets, scale |
Text in steps can use {reward}, {crate}, {player} and {rarity}. The bundled animations/_TEMPLATE.yml has the full schema and a worked example. Unknown keys are ignored and missing keys get defaults. /mv reload reports any animation problems.