✏️ Edit Reward

#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

From the reward's Cooldowns menu, you can configure:

• Win Limit Cooldown - How long a player must wait before being able to win this reward again.
• Global Win Limit Cooldown - How long must pass before this reward can be won again by anyone on the server.
• Time Limited Cooldown - How long this reward stays available once its cooldown is started. When it expires, the reward automatically disables itself.

#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 Commands

When adding or editing a win-command, a dialog box will pop up asking you to type the command. On older server versions that don't support dialogs, it will fall back to the usual chat input.

#Virtual Reward

To create virtual rewards, simply exclude win-items from your rewards and use the win-commands option to run commands when a user wins the item. Make sure that you have a display item if you want to set up a virtual reward.

Example of adding a reward that gives balance to the user:

#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.

Example of adding a permission:

In the example above, if a user is assigned to the permission 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.

#Delete Reward

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