# Roll Limits

With ExcellentCrates you can limit how many times a reward can be rolled out on global and per-player basis.

You can edit reward's roll limits using the editor.

# About

There are 2 limit types:

  • Global. Applies to all players at the same time.
  • Player. Applies to a specific player only.

Limits has the following options:

  • Amount. Defines initial amount of available reward rolls.
  • Reset Time. Defines how soon (if ever) amount of available global/player rolls will reset to inital value.
  • Reset Time Step. Defines amount of reward rolls required for the Reset Time to apply.

If there are both limits present in a reward, the smallest Amount is used to determine amount of reward rolls available for a player.

# Examples

Here are a few simple examples that will help you to understand how the feature works.

# Global Limit

Let's say we have a reward with global rolls limit:

  • Amount: 10
  • Reset Time: 86400
  • Reset Step: 10

This means that a reward can be obtained 10 times in total.

When there is 10 rolls, the Reset Time will apply. After 24 hours (86400 seconds) a reward will be obtainable again for 10 times.

# Player Limit

Let's say we have a reward with player rolls limit:

  • Amount: 3
  • Reset Time: -1
  • Reset Step: 3

This means that a reward can be obtained 3 times per player.

When there is 3 rolls, the Reset Time will apply. Since it has a negative value, a reward will never be obtainable again for that player.