About LegendLootboxes
LegendLootboxes is a free plugin that allows you create unlimited lootboxes / crates for players to open and receive rewards.
Features
LegendLootboxes is a free plugin that allows you create unlimited lootboxes / crates for players to open and receive rewards.
- In-Depth GUI editor
- Unlimited Lootboxes
- Command AND Item Rewards
- Complete Customization
- Reward Categories
- Reward Previewing
- and much more!
- /lootbox create <name>
- /lootbox edit [name] - Opens Editor GUI
- /lootbox give <player> <lootbox> [amount]
- /lootbox delete <lootbox>
- /lootbox additemreward <lootbox> <category> <chance>
- /lootbox open <player> - Acts as if the player opened the lootbox.
(for example: /lootbox create is: legendlootboxes.commands.create)
Reward Categories
Each reward in a lootbox will fall under a reward category. These are configurable in the config.yml under "reward-categories". You can add new categories by copying and pasting the current format. Example format:
Spoiler: Example Format
GENERAL - The internal name of the reward category, this is not shown to players.
Code (YAML):
GENERAL:
display : "&f&lGeneral Loot (&7%items% items&f&l)"
show-in-lore : true
item-lore-without-title : "&f&l* %item-amount%x %item-display-name%"
command-lore : "&f&l* %title%" #You could also use %command% as a variable.
guaranteed-loot : false
display : "&f&lGeneral Loot (&7%items% items&f&l)"
show-in-lore : true
item-lore-without-title : "&f&l* %item-amount%x %item-display-name%"
command-lore : "&f&l* %title%" #You could also use %command% as a variable.
guaranteed-loot : false
display - This is the visual display of the category that is shown in the lore and in the reward preview menu.
show-in-lore - Whether or not to show this category (and its rewards) in the lore of a lootbox item.
item-lore-without-title - The format to show a reward that is an ITEM and does not have a title to override it.
command-lore - The format to show a reward that is a COMMAND. IF the command reward does not have a title, it will only show unless you have %command% in the format. If it DOES have a title, it will show the title unless you do not have %title% in the format. If neither %title% nor %command% are in the format, the reward will not show in the lore.
guaranteed-loot - If this is set to true, all rewards in the category will be given to the player regardless of how many items the lootbox gives.
Reward Previewing
Starting in version 1.1.0, lootboxes now have the option to allow players to preview their loot by left-clicking them. This can be enabled or disabled in each lootbox in their respective editors:
Spoiler: Enable/Disable Previewing
Spoiler: Preview GUI
IMPORTANT: In order for players to be able to preview, they must have the permission node: legendlootboxes.previewScreenshots
Spoiler: Lootbox View GUI
Spoiler: Lootbox Edit GUI
Spoiler: Lootbox Reward GUI
Spoiler: Lootbox Reward Builder GUI
Support
- Feel free to contact me on Spigot.
- Do NOT ask for support in reviews.
- Our Discord:
Suggestions & Future Features
Feel free to message me any suggestions or leave them in the plugin discussion thread or in our discord.
The current features that have already been planned and will be implemented soon:
- Multiple Different Animation Types
- Placeholder Documentation in Prompt Messages and Config
Current Plugin State: STABLE
All features should work as intended.
Utilities
Spoiler: Default config.yml
debug : false #Enable this to print error messages to console.
items:
default-lootbox:
material : BEACON
display-name : "&c&lDefault Lootbox &7(Right Click)"
lore :
- "&7Right-Click to open!"
commands:
lootbox:
description : "Main command for LegendLootboxes."
reward-categories:
GENERAL:
display : "&f&lGeneral Loot (&7%items% items&f&l)"
show-in-lore : true
item-lore-without-title : "&f&l* %item-amount%x %item-display-name%"
command-lore : "&f&l* %title%" #You could also use %command% as a variable.
guaranteed-loot : false
JACKPOT:
display : "&f&lJackpot Loot (&7%items% items&f&l)"
show-in-lore : true
item-lore-without-title : "&f&l* %item-amount%x %item-display-name%"
command-lore : "&f&l* %title%"
guaranteed-loot : false
GUARANTEED:
display : "&f&lGuaranteed Loot (&7%items% items&f&l)"
show-in-lore : true
item-lore-without-title : "&f&l* %item-amount%x %item-display-name%"
command-lore : "&f&l* %title%"
guaranteed-loot : true #All items in this category will be given regardless of total loot amount.
messages:
open-broadcast : "&a%player% has opened the %lootbox% lootbox!"
reward-each-item-broadcast : "&f&l* %item-amount%x %item%"
reward-each-title-broadcast : "&f&l* %title%"
default-lootbox-open-message : "&a&l(!) &aYou have successfully opened the %lootbox% lootbox!"
cannot-preview : "&c&l(!) &cYou cannot preview this lootbox's (%lootbox%) rewards."
commands:
no-permission : "&c&l(!) &cYou do not have permission to execute &n/%command%&c!"
incorrect-usage : "&cIncorrect Usage: &f/%command% %subcommand% %excess-arguments%"
incorrect-usage-description : "&7%description%"
Code (YAML):
debug : false #Enable this to print error messages to console.
items:
default-lootbox:
material : BEACON
display-name : "&c&lDefault Lootbox &7(Right Click)"
lore :
- "&7Right-Click to open!"
commands:
lootbox:
description : "Main command for LegendLootboxes."
reward-categories:
GENERAL:
display : "&f&lGeneral Loot (&7%items% items&f&l)"
show-in-lore : true
item-lore-without-title : "&f&l* %item-amount%x %item-display-name%"
command-lore : "&f&l* %title%" #You could also use %command% as a variable.
guaranteed-loot : false
JACKPOT:
display : "&f&lJackpot Loot (&7%items% items&f&l)"
show-in-lore : true
item-lore-without-title : "&f&l* %item-amount%x %item-display-name%"
command-lore : "&f&l* %title%"
guaranteed-loot : false
GUARANTEED:
display : "&f&lGuaranteed Loot (&7%items% items&f&l)"
show-in-lore : true
item-lore-without-title : "&f&l* %item-amount%x %item-display-name%"
command-lore : "&f&l* %title%"
guaranteed-loot : true #All items in this category will be given regardless of total loot amount.
messages:
open-broadcast : "&a%player% has opened the %lootbox% lootbox!"
reward-each-item-broadcast : "&f&l* %item-amount%x %item%"
reward-each-title-broadcast : "&f&l* %title%"
default-lootbox-open-message : "&a&l(!) &aYou have successfully opened the %lootbox% lootbox!"
cannot-preview : "&c&l(!) &cYou cannot preview this lootbox's (%lootbox%) rewards."
commands:
no-permission : "&c&l(!) &cYou do not have permission to execute &n/%command%&c!"
incorrect-usage : "&cIncorrect Usage: &f/%command% %subcommand% %excess-arguments%"
incorrect-usage-description : "&7%description%"
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.8, 1.9, 1.10
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
LegendLootboxes | Create custom reward crates | Expansive GUI Editor is a free Minecraft Java mod. Compatible with Minecraft 1.8, 1.9, 1.10, 1.11 and newer. Downloaded 2,181 times (via Spigot). Download it and open it directly in the game.