/lootbox open <player> - Acts as if the player opened the lootbox.
All permission nodes are: legendlootboxes.commands.<subcommand> (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:
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
GENERAL - The internal name of the reward category, this is not shown to players. 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:
IMPORTANT: In order for players to be able to preview, they must have the permission node: legendlootboxes.preview
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
Keep in mind this is a free plugin, meaning that I am not paid to keep it supported. I will get around to things when I can and try to fix bugs as fast as possible.
Current Plugin State: STABLE All features should work as intended.
Utilities
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%"