✏️ Edit Reward

#Weight

On a crate using the Random rewards mode, the weight is what decides how likely this reward is compared to the others in the crate. A higher weight means a bigger share of the openings.

#Win Limits

• Win Limit - How many times a single player can win this reward.
• Global Win Limit - How many times this reward can be won by everyone on the server combined.

Both can be combined with an Alternative Reward, which is given once the limit is reached.

#Cooldowns

A reward can be put on a cooldown so it is not won again straight away, by the same player or by anyone on the server. It has its own page: Cooldowns.

#Guaranteed Win

A reward can be guaranteed after, or every, a number of openings. The mode and the opening count are set here, and the whole system is described on Guaranteed Rewards.

#Required Keys

On a crate using the Selective (non RNG) rewards mode, players spend keys to redeem the reward they picked. Key Requirement sets how many keys this particular reward costs, and defaults to 1.

Use it to price rewards against each other, so a cosmetic costs one key while the best reward in the crate costs five. A player without enough keys is told how many they need and the reward stays unredeemed.

The value is exposed to the menus as %required_keys%, so the preview can show the price on each reward.

Required Keys does not apply in Random mode, where the crate's own key cost is what matters.

#Requirements

From the reward's Requirements menu, you can set a Required Permission the player must have to see this reward as available. If the player lacks it, the reward will appear as locked in the preview.

This is the opposite of Restricted Permissions, which instead prevents players who have any of the listed permissions from winning the reward.

#Win Items & Win Commands

What the reward actually gives, whether that is real items, commands, or both, has its own page: Win Items & Win Commands.

#Win Message

Allow Win Message decides whether the player gets a message at all when they win this specific reward, and Notification Type picks where that message is delivered, in the chat or on the action bar.

#Share with Players Online

With this option, when a user wins a specific item, all online players on the server will also receive the same reward.

#Restrict a Reward

This option prevents users from winning the reward if they have any of the specified permissions on the reward.

If a user is assigned to a listed permission, such as group.default, they won’t be able to win this reward. Since they won’t have access to it, you can use the Alternative Reward to give them a different item instead.

This option is especially useful for situations where a user already owns a cosmetic item, such as tags, chat colors, prefixes, or other cosmetics.

#Broadcast a Reward

To broadcast a message to all online players when a user wins a specific reward, simply enable the Broadcast Message feature.

By default this feature is not activated.

To modify the broadcast message, you can do so in the main crate settings.

#Display Item

With this option, you can customize the material, display name, and lore. Note that this is the display item and will not be given to the user.

Right-clicking the display item (or any win item in the Win Items menu) gives you a physical copy of it, useful if you want to grab the exact item you configured.

An Item Properties sub-menu also lets you fine-tune the display item further: RGB color, item flags, banner patterns, enchantments, custom model data/item model, enchantment glint override, potion effects, armor trim, and tooltip style.

#Reward Identifier

With this option, you can set a unique identifier for the reward. By default, the plugin automatically assigns a unique identifier to each reward. Changing this identifier will result in data loss.

#Enabled

With this option, you can disable a single reward. It stays configured on the crate but can no longer be won or picked.

#Delete Reward

With this option, you can delete the reward from your crate.