Common problems
What to check when ExyliaCrates does not start, a crate does nothing, a key is missing or a hologram looks wrong.
Find the message you see or the thing that goes wrong, and follow the fix.
The plugin does not start#
packetevents is a hard dependency: without it the server never loads ExyliaCrates. The server must be Paper 1.21.1 or newer (Folia 1.21.4 or newer), and ExyliaLib 1.571.1 or newer is needed too. The loader installs ExyliaLib, or stages a newer one, and asks for a restart: restart once more. If the console reports a licence error, check that Exylia-Crates-Loader.jar is the jar from your purchase, and contact support if it is. See Install ExyliaCrates.
The block does nothing#
- The crate may be switched off: open it in
/cratesadminand check General → State. A disabled crate says "This crate is disabled." - The block may not be a crate any more. Place it again with the wand: see Create a crate.
- Right-clicking to open also needs the crate's own permission,
exyliacrates.crate.<id>, which everybody holds unless you denied it. See Permissions.
"Somebody is opening this crate. Wait a moment."#
The crate is shared: everybody nearby watches one opening at a time on each block. Switch it to Opener only, many at once in Opening → Audience, or place the crate on more blocks. See Openings.
"Your keys are still loading."#
A player's key balance is read from the database when they join. Until it is back they cannot open a crate. It takes a moment on a healthy database. If it lasts, check the console for a database error.
"You need 1x ... to open ..."#
The player lacks what the crate's Opening cost asks for: a key, money, or both. Give a key with /cratesadmin key give <player> <key> <amount>. See Keys and costs.
"Your rank does not include that feature."#
The player lacks a permission the action checks: exyliacrates.use, exyliacrates.open.remote, exyliacrates.preview, exyliacrates.history, exyliacrates.multiopen or the crate's own exyliacrates.crate.<id>. See Permissions.
A player spent a key and got nothing#
A draw retries a reward whose own chance misses, but only 16 times. A crate whose rewards all have a low chance can miss every time: the key is spent and the player is told the crate has no rewards. Keep chance at 100 and use the weight to make a reward rare. See Rewards and rarities.
A crate became free after I deleted a key#
Deleting a key removes it from every crate's costs, and a crate left with no cost opens for free. Give it another cost in Opening cost, or disable it. See Keys and costs.
A reward changed rarity when I edited another one#
A rarity follows the reward's share of the crate, read against every other reward. Adding, removing or reweighting a reward moves every share, so one can cross into the next band. Set the weights until the prizes sit where you want them. See Rewards and rarities.
I edited hologram-lines and nothing changed#
Holograms are drawn when a crate block is registered. After /cratesadmin reload, change anything in the crate's General, Opening or Presence section (or restart) to redraw its holograms. See Create a crate.
Another server of my network shows the old crate#
Each server reads crates and keys at startup. Restart the others, and edit crates on one server only so an older copy is never saved over the newer one. See Install ExyliaCrates.
The animation is too long#
Click during it: it plays four times quicker (settings.click-speed-up). Or pick another animation, or Instant, or shorten the phases in its file under animations/. See Animations.
Something missing on this page? Tell us on Discord