SnLootBoxes changelog

Changes

• Keys of the same lootbox always stack: the keys a player holds are re-rendered from the current lootbox definition on join and before every grant, so keys from before a reward edit (or from a non-stackable era) merge with new ones. key-items.stackable: false keeps the old per-grant unique behavior.
• Fast-open is gated by stack size: fast-open.max-stack-amount (default 1, 0 = unlimited) denies sneak + right-click on a bigger stack before the key is consumed, with the new messages.errors.fast-open-stack message. Split the stack or open it without sneaking.

Changes

• Editor saves can no longer silently delete rewards: a lootbox whose file loaded with skipped rewards (typo'd material, item saved by a newer server) is flagged lossy and every save is refused with a clear message until the file is fixed and reloaded.
• Per-action permissions now work on their own: /lootbox no longer requires lootboxes.admin; a helper holding only lootboxes.admin.give can run /lootbox give, and the generated help lists only what the sender may run.
• AIR and block-only materials are rejected as key material in the editor prompt, the store and the file parser (an AIR key hid the editor's own buttons and spammed SEVERE logs).
• Display names with fancy-font or emoji characters render correctly in the gradient (no more ?? glyphs).
• Store failures (rename/delete/folder/example/validation) now use lang keys instead of leaking English Java exception text into chat.

Changes

• Fixes the 1.20.x crash: v2.0.0 threw IncompatibleClassChangeError on every Paper 1.20.x server when opening a lootbox (key consumed, session stuck) - all InventoryView usage replaced with ABI-safe calls; verified clean at the bytecode level.
• Super reward can no longer be lost: it is reserved the moment you click the super chest, so quitting, restarts, timeouts or a deleted lootbox mid-spin now deliver it instead of voiding it.
• Particle config can no longer stall payouts: data-requiring particles (DUST, BLOCK, ...) in effects.complete-particle are rejected safely instead of throwing inside the animation.
• Broadcast announcements now render the full text pipeline (MiniMessage, hex, [center]) with server-context PlaceholderAPI.
• Key items are protected from being destroyed by crafting, furnaces, dispensers and entity interactions (feeding, saddling, item frames).
• Editor: two-step delete confirm with a configurable window (editor.delete-confirm-seconds), chat prompts expire (editor.prompt-timeout-seconds), reward odds display matches the real roll, list-overflow notices, rename warns about circulating keys.
• Atomic lootbox file saves, plus ~35 further robustness and diagnostics fixes from a full severity-gated audit (2 independent close passes clean).

Configurable lootbox system for Paper 1.20.x/1.21.x, built on SnLib.

Admins define lootboxes as YAML files (weighted normal rewards plus one super reward per opening); players receive physical key items and right-click them to open an animated chest-grid GUI. Rolls are decided and reserved the moment a chest is clicked, and every close path (Esc, logout, timeout, restart) completes the box, so reserved rewards are never lost.

Features

• Animated opening GUI with an owner-editable layout (grid slots, super chest, filler, titles), plus shift-click fast-open.
• Weighted rewards with a per-reward enable toggle, NBT item rewards captured from real inventory items, and console-command rewards.
• Full in-game editor: create, rename, duplicate and delete lootboxes, capture rewards by clicking items, edit amounts, weights, delivery methods and per-box aesthetics (3-stop gradient names, bullet, glow) via menus and chat prompts.
• Per-lootbox personal/global opening announcements, world and WorldGuard-region restrictions, per-IP giveall cap prioritizing highest playtime, PlaceholderAPI expansion (%lootboxes_*%).

Install

• SnLib.jar goes in plugins/ (SnLib 1.28.0 or newer) alongside SnLootBoxes-2.0.0.jar.
• The plugin generates its own config.yml, lang/, guis/, opening.yml and lootboxes/ files on first boot.

Requires Java 21+ and Paper 1.20.4+.