promotional bannermobile promotional banner

Better Crates/LootBox

Better Crates & LootBox have configurable Roll, CSGO Roll, Flash Grid, Wheel & Slot openings. Features UI editor support, rarity tiers, real item rewards, keys system, custom UI, and smooth animated highlights with tuned timing for exciting reveals.

File Details

BetterLootBox-4.3.5.jar

  • R
  • May 2, 2026
  • 5.46 MB
  • 128
  • Early Access

File Name

BetterLootBox-4.3.5.jar

Supported Versions

  • Early Access

BetterLootBox — Patch Notes v4.3.5

New Features

/lb forceopen <player> <boxid>

A new admin command that forces a lootbox to open for a targeted player without requiring a key in their inventory. Perfect for quest systems, automated rewards, or server events.

  • Required permission: betterlootbox.admin
  • Target player must be online
  • Opening animation is played normally on the client side
  • The LootBoxPreOpenEvent is triggered and respects cancellation
  • Fully compatible with all existing animation styles

CanOpenBoxWithKeyInsideKeysInventory (config.json)

New global toggle (default: false). When enabled, if a player does not have a physical key in their inventory when opening a lootbox, the plugin will automatically check their /key inventory (stored keys). If a matching key is found, it is consumed and the opening proceeds normally.

  • Works as a fallback: physical inventory always has priority
  • Supported in bulk openings (/lb open <n>)
  • Key counting includes both sources

ExtensionsAPIBox System

A new ExtensionsAPIBox/ directory is now available in the plugin data folder. Other mods or developers can drop .json files into this folder to inject custom lootbox definitions without modifying the main config.json.

  • Automatically loaded on startup and /lb reload
  • Injected boxes appear in /lb editor, /lb bind, /lb list, etc.
  • Fully read-only: never written into config.json
  • In case of ID conflicts, config.json takes priority and a warning is logged
  • template.json is explicitly ignored (case-insensitive)

ExtensionsAPIBox/template.json

A fully documented template file automatically generated in the ExtensionsAPIBox/ directory. It showcases all available fields for creating extension lootboxes, including examples for:

  • Basic item rewards
  • Command-only rewards
  • One-time rewards per player (oneTimeOnlyPerPlayer)
  • Visual-only rewards (visualOnly)
  • Permission-restricted rewards (prohibitPermission)
  • Tier configuration, pity system, rotation, key purchasing, opening effects

New Opening Animations

Casino

A slot-machine-style animation with rolling reels that gradually align to reveal the reward.

Ascent

A vertical progression animation that builds upward before culminating in the final reward.

Both styles are available via the openingStyle field in any lootbox definition (config.json or ExtensionsAPIBox).


New Language Messages

Key Value (en-US)
betterlootbox.cmd.forceopen_success Force-opened {box} for {player}.
betterlootbox.cmd.forceopen_player_offline That player is not online.
betterlootbox.notify.used_stored_key Used a stored key from your /key inventory.

French translations (fr-FR) are included.


Available Opening Styles

roll · flash · wheel · csgo · number · slot · ladder · ritual · fracture · decrypt · meteor · ascent · casino