Skip to main content

Statroles - Limit Types

info

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

What is Limit Type?​

Limit Type controls how the Statrole will process Stats, and the boundaries that a member's Stats must fall within in order to Pass to Condition. It is available to the Message, Voice, and Activity Conditions.

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. This is because otherwise the Condition would match everyone in the server!

Top​

Passes members based on how their Stats compares to others.

Options

Settings

  • Top Type — How the top members are decided. Either Rank or Percentile.
  • Lookback — The number of days from now, or starting Date, that Stats will be used from.

Rank​

Use the 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
Example

For the top 10 members

  • Top Rank = 1
  • Bottom Rank = 10

Percentile​

Segment users based on the percent of all user activity they fall in.

  • Top Percentile — The top block of users that will match this condition based on percent.
  • Bottom Percentile — The bottom block of users that will match this condition based on percent.
  • 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.
Example

For members in top 10% of total members*

  • Top Percentile = 1
  • Bottom Percentile = 10

* Check Count only matching members for top 10% of only members who match the other settings.

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 — Amount of Stats the member must have in a day.
  • Required Days Within Lookback — How many days the member must have met the requirement.
  • Lookback — The number of days back from now that Stats will be used from.
tip

Here's a quick example of Day Range in action.

Member must have sent at least 5 messages on all days in the last week

  • Required # of Messages — 5
  • Required Days Within Lookback — 7
  • Lookback — 7

To allow one day to be missed, change Required Days Within Lookback to 6.

Considerations​

All values are inclusive. This means that the number provide to a setting is included in the boundaries. For instance, setting a Minimum of 1 will match members with only 1. The same applies to Maximum, Top Rank, etc.

To make tiered Statroles, set the Minimum / Maximum of the Statroles' Conditions +- 1 from each other. (i.e. Make sure they don't overlap.)

Example

  • Tier 1 Maximum = 10 messages
  • Tier 2 Minimum = 11 messages