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
LootBoxPreOpenEventis 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.jsontakes priority and a warning is logged template.jsonis 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

