Skip to main content

Statrole - Conditions

Conditions are where all the work happens. A Statrole primarily uses these to determine who should have the role.

Conditions

Conditions come in 7.5 flavors:

  • Message: Text messages a user has sent.

  • Voice: Time a user has spent in voice / stage channels. Allows you to select what Voice States you want to count.

  • Activity: Minutes a user has spent interacting with a game / application. You can select a specific Activity from the list of Tracking Activities, or "Any Activity" with Data+. Also allows you to select which of Playing, Streaming, and Listening to include.

  • Joined Age: How long the member has been in the server. Can select between a relative time or specific date. Must be paired in a Match Condition with at least one of Message, Voice, or Activity.

  • Account Age: How old the member's account is. Can select between a relative time or specific date. Must be paired in a Match Condition with at least one of Message, Voice, or Activity.

  • Statrole: The results of another Statrole.

  • Match: Allows for grouping the other Conditions together. Will be either Any or All.

    • Any: A member must match any of the Sub-Conditions in this group. ("OR" logic)
    • All: A member must match all of the Sub-Conditions in this group. ("AND" logic)

Condition Settings

info

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

Limit Types

Each Limit Type is explained here.

Filters

Channel Filter

What channels to use when computing Stats. Supports categories. Leave empty to include all channels that Statbot is tracking. Can choose between either Whitelisting or Blacklisting.

  • Whitelist: Only include these channels' Stats when checking the Condition.
  • Blacklist: Do not include these channels' Stats when checking the Condition. (Will use all others.)

Member Filter

What members to include when computing Stats. Leave empty to include all members. Can choose between either Whitelisting or Blacklisting.

  • Whitelist: Only include these members' Stats when checking the Condition.
  • Blacklist: Do not include these members' Stats when checking the Condition. (Will use all others.)
caution

A Blacklisted member is not ignored. Rather it makes them automatically fail to meet the Condition. If you want to ignore members (not change their role), use the Statrole's Ignore Members filter.

Role Filter

What members to include when computing Stats based on their roles. Leave empty to include all members. Supports both Whitelisting and Blacklisting.

  • Whitelist: A member must have at least one of the roles in this list.
  • Blacklist: A member can not have any of the roles in this list.
tip

The easiest way to make sure that a Statrole doesn't match the members in another Statrole is to add an Inverted Statrole Condition.

Inverting

Conditions have the additional option to be Inverted. This takes the results of the Condition and instead matches everyone else in the server. This is how you can introduce "NOT" logic into your Statroles. This is also how Inactivity Statroles are accomplished (though there's a shortcut with using Minimum 0).

warning

Inverting a Condition will invert its Filters as well. Think of Inverting as taking the exact opposite results of the Statrole after its calculated normally.