Openings

From the click to the prize

With the Instant animation the prize simply appears over the crate for about two seconds.

If an animation never reaches its reveal — it broke, or a player kept it waiting — the plugin reveals for it once its time is up, so a prize is never lost to an animation.

Shared or private

Opening → Audience on a crate's overview.

A player busy with an opening of their own does not see other openings, so two animations never mix on one screen. The labels, effects and celebration follow the same audience. Announcements and the chat summary do not depend on it.

Opening away from the block

/crates open <crate> — and clicking the crate item on the contents screen — opens a crate from anywhere. The animation plays on the ground about three blocks in front of the player, seen by whoever the crate's audience allows. It takes no block, so it never makes anybody wait. Add true to open as many as they can pay for: /crates open vote true.

It needs exyliacrates.use and exyliacrates.open.remote, which everybody holds by default, plus the crate's own node. Deny exyliacrates.open.remote to keep every crate to its block, or exyliacrates.crate.<id> to lock one crate everywhere. See Permissions.

Opening several at once

Sneak while right-clicking the block, shift-click the crate item on the contents screen, or add true to /crates open: the crate opens as many times as every cost allows, up to settings.max-multi-open (10) or the player's highest exyliacrates.multiopen.<n>. It needs exyliacrates.multiopen.

All the prizes come out together. The animation lands on the rarest; when it comes out, up to seven prizes line up under it, rarest last, each with a count when it was won more than once. The chat summary lists them the same way:

CRATES • You opened Vote and won 10 rewards:
 ▎ Diamond x3
 ▎ 500 Coins x6
 ▎ Netherite Sword

The guarantee counter advances once per key.

Speeding up

A click while your own opening plays — any click, anywhere — plays the rest of it settings.click-speed-up times quicker (4 by default), up to the reveal. Once per opening; the reveal plays at its own pace. click-speed-up: 1 turns it off.

When an animated opening starts, the opener is reminded over the hotbar: speed-up-hint in messages.yml. Pick a Card ignores clicks while the player is choosing a card, since that click is the choice.

Leaving mid-opening

A prize is handed over whatever happens to the opening:

Prizes that do not fit in the inventory, or that reach a player who is not online, are kept by ExyliaLib's delivery queue and handed over on their next join: "Delivered 3 rewards that were waiting for you."

History

Every reward won is one row of history: who, which crate, what, its rarity and when.

Rows older than settings.history-retention-days (30) are deleted a minute after start and every six hours after. 0 keeps them forever.

Announcements

When somebody wins a reward whose rarity has broadcast: true in tiers.yml — legendary and epic by default — the server reads:

CRATES • Steve pulled Netherite Sword from Vote » LEGENDARY

That is broadcast in messages.yml. Announcements go through ExyliaLib's Crate wins channel (crate-announcements): every player can mute it from the Announcements screen of /settings. settings.broadcast-enabled: false turns announcements off for everybody.

A bulk opening announces each broadcasting prize once, however many times it was won.

Other plugins

Prizes are paid through ExyliaLib's reward modifiers with the source crates and the scope crate:<id>, so a modifier provider can boost every crate or one crate alone.