The box data is the root object of all loot boxes.

name (String, Default: "Unnamed")

This is the display name of the loot box.

id (String, Default: "mycoolbox")

This is the unique identifier of the loot box. The id is stored with a loot box item so changing this will break any loot box items with this id.

color (String, Default: "FFFFFF")

This is a hexadecimal RGB string that defines the color of the loot box.

openmessage (String, Default: "You are unable to open this!")

This message is sent to the player's chat if they do not meet the requirements to open this loot box.

amount (Integer, Default: 1)

The amount items the player will receive.

unique (Boolean, Default: true)

Only used if amount > 1. Whether or not the player can get the same loot item multiple times. If unique is true and amount is greater than the number of obtainable (ones that the player meets the requirements for) loot items, all obtainable loot items are given.

rarity (Integer, Default: -1)

Rarity is used for upgrade crafting. If the rarity is -1, the item can not be crafted/used to craft. Rarities of all the bags in the crafting grid are added up and the output is a loot bag with the total combined rarity, if it exists.

loot (LootData Array)

This is an array of all of the loot items the box contains.

requirements (ReqData Array)

This is an array of all the requirements needed to open this box.

dropchance (DropData)

This defines the drop rate of this bag.

dropchance_player (DropData)

If this is defined, this overrides dropchance if the entity was killed by a player.