Skip to main content

Statroles - Limit Types

Stats below will refer to text messages for the Message Condition and minutes for the Voice and Activity Conditions.

Limit Type controls how the Statrole will process the Stats and the boundaries that a member's stats must fall within. It is specific to the Message, Voice, and Activity Conditions that are based on the stats that Statbot has tracked.

info

All values are inclusive. This means that the number that you provide to a setting is the number that's included.

For instance, setting a Minimum of 1 will match members with 1 and the same for Maximum. To make tiered Statroles, you want to make sure that their Minimum / Maximum are +- 1 from each other. (i.e. Make sure they don't overlap.)

Example: Tier 1 Maximum = 10 messages, Tier 2 Minimum = 11 messages

Threshold

Looks at the count of messages or minutes.

Options
  • Minimum: The least amount of Stats a member can have to match this condition.
  • Maximum (Optional): The most amount of Stats a member can have before no longer matching this condition. Leave empty for no upper limit.
  • Lookback: The number of days from now, or starting Date that Stats will be used from.
caution

Maximum is required when Minimum is set to 0.

Top

Compares members' Stats. There are two options for how the top members are decided: Rank, and Percentile.

Options
  • Rank: Use the raw count of Stats to rank members.
    • Top Rank: The top rank that will match this condition. In top 10, this is Rank 1.
    • Bottom Rank: The bottom rank that will match this condition. In top 10, this is Rank 10.
  • Percentile: Chunk users based on the percent of user activity they fall in.
    • Top Percentile: The top block of users that will match this condition based on percent. In the top 10%, this is 1.
    • Bottom Percentile: The bottom block of users that will match this condition based on percent. In the top 10%, this is 10.
  • Lookback: The number of days from now, or starting Date that Stats will be used from.

Percentile has an additional option: Count only matching members. This determines which value to based the percentile size on.

  • Checked: Base on matching members only. If 100 members match the condition, a percentile block size will be 1 member.
  • Unchecked: Base on server member count. If there are 1000 members in the server, a percentile block will be 10 members.

Day Range

A special operation that checks for a member's Stats each day and counts how many days they met that requirement. The member must meet that requirement for a set amount of days to receive the role.

Options
  • Required # of Message/Minutes: How many Stats the member must have had to be counted for that day.
  • Required Days Within Lookback: How many days the member must have met the Stats requirement.
  • Lookback: The number of days back from now that Stats will be used from.
tip

A quick example of Day Range is that a member must have sent at least 5 messages each day in the last week. This would look like:

- **Required # of Messages**: 5
- **Required Days Within Lookback**: 7
- **Lookback**: 7

If you want to be lenient and allow one day to be missed, you would change Required Days Within Lookback to 6.