Animations

A crate opens with one of eleven animations, or with Instant, which shows the prize over the crate at once. Pick one from Opening → Animation on a crate's overview: left-click chooses, right-click plays it in front of you for free. Every crate can use a different one.

The names and one-line descriptions shown in the picker are screens.animations in messages.yml. A crate stored with an id no animation answers to opens with the Wheel of Fortune.

How they all work

Every animation is drawn with display entities sent as packets, so nothing is spawned in the world and nothing can be picked up. They face the player who opened the crate, and everybody watching sees the same thing from where they stand.

The prize is decided before an animation starts. An animation can never pay the wrong prize or pay twice: it draws the crate's own rewards as fillers, at their real odds, and lands on the prize that was drawn. The fillers are spread apart so the same icon rarely sits next to itself.

Every opening runs through the same five phases:

So a legendary sounds the same whatever animation the crate uses. The phase lines are ExyliaLib sequences; %reward%, %tier%, %tier_color%, %player%, %crate% and %amount% are filled in on every line and {item:reward} draws the prize. [LID] open opens a chest's lid when the crate block is one.

Each animation has a deadline — its own timings plus two or three seconds. If it has not revealed by then, the plugin reveals for it.

Common keys

Every file has its own keys, below, and most share these:

Block materials, palette tokens ({primary}) and icon sources (a material, a head, an item from another plugin) are accepted where the tables say so. A value outside a key's range is clamped to it.

Edit a file and run /cratesadmin reload: the next opening plays the new values.

Wheel of Fortune

animations/wheel_of_fortune.yml. A wheel of the crate's rewards stands over the block, facing the opener. A flapper at the top clicks on every peg; the wheel brakes, creeps, and stops with the prize under it. The prize comes out toward the player.

Carousel

animations/carousel.yml. A strip of the crate's rewards slides past a marker in front of the opener, fading out at both edges, brakes for a long time and stops with the prize under the marker. The prize lifts toward the player.

Cosmic Orb

animations/cosmic_orb.yml. The lid opens and a glowing orb rises out of the crate. Inside it one prize after another flickers past, faster, then slower, until one is held a beat too long and the orb settles on the real prize. It cracks in the colour of the prize's rarity — never shown before the crack — and the prize floats out.

Pick a Card

animations/pick_a_card.yml. Face-down cards are dealt in a fan in front of the opener and shuffled. The opener picks one by looking at it and clicking: the card looked at lifts, and a title says how long they have. It turns over to show the prize, then the others turn over to show what else the crate holds.

The prize was decided when the key was spent, so every card is the winning card. A player who waits too long gets the card they are looking at, or any. Clicks while choosing never speed the opening up.

Its title and subtitle are pick-title and pick-subtitle in messages.yml; %seconds% is the time left.

Tier Slots

animations/tier_slots.yml. Three lanes of gems, one gem per rarity in tiers.yml, spin in front of the opener and stop left to right. The third lane always lands on the prize's rarity. The first two land on a pair: the same rarity (three of a kind) or, as a near miss, the next rarer rarity the crate really holds, which the third lane then breaks. The prize rises out of the middle lane — or the last, after a near miss.

Add a rarity to tiers.yml and give it a gem here, or it takes the next fallback gem.

Rift

animations/rift.yml. A portal tears open over the crate, facing the opener. The crate's rewards stream out and circle inside it, braking as the rift pulses; one is pulled out toward the player while the rest are sucked back in, and the rift collapses behind it.

Tesseract

animations/tesseract.yml. A hollow cube of glowing edges and faint glass faces appears over the crate, one prize on each face. It is tossed up and tumbles like a die, bounces, rolls to a stop and teeters on an edge before falling back with the winner facing the player. Its edges flash in the rarity's colour, it shatters, and the prize floats out.

Tesseract has no facing-offset.

Event Horizon

animations/event_horizon.yml. A black hole forms over the crate: a dark core inside a tilted, glowing disc. The crate's rewards orbit on the disc and spiral inward; one by one they are stretched thin and swallowed, each wait longer than the last. The final two dive at the horizon together, one is taken, and the hole collapses in a flash, ejecting the survivor.

Constellation

animations/constellation.yml. Night falls over the crate. The rewards appear one after another as stars on a sky facing the opener, and lines of light join them into a figure. A comet hops from star to star, quick at first, slowing, lingering on a neighbour; it lands on the prize, every line converges on it, and it flares in its rarity's colour and drifts out.

Orrery

animations/orrery.yml. A glowing sun rises over the crate with the rewards circling it as planets, each on its own tilted orbit, a few with a moon. They brake together and drift into one line, all but one, which creaks the last of the way in. The sun charges and fires along the line; the planet at its near end is the prize and is pulled out while the others fall from their orbits.

Starfall

animations/starfall.yml. The sky over the crate turns to night and a glowing target lights up on its lid. The rewards fall as meteors, each crashing into the target and knocking the last one off, a barrage that slows. A huge meteor comes for the target and swerves away; then the last one falls slowly, lands with a shockwave, and rises toward the player: the prize.

The instant reveal

Choosing Instant (stored as NONE) skips the animation: the prize grows over the crate for about two seconds while its rarity celebrates. Nothing to configure; the celebration still comes from tiers.yml.