Skip to content

Message Counting ​

The message counting plugin can decide where messages can be counted, how often they can be counted, and even assign roles to users who send enough messages. Its settings are split into four sections: Message counting, Counting blacklists, Counting whitelist and Reward roles.

INFO

Only messages sent by members are counted: messages from bots and webhooks never count. A member's new messages can take a short moment to show up in their message count.

Message Count Delay ​

Found in the Message counting section, the message count delay of your server is the number of seconds that need to pass between each counted message before Invite Tracker counts another message.

For example, if a user sends a message which Invite Tracker counts and the message count delay in that server is 10 seconds, Invite Tracker will not count any other messages sent by that same user before 10 seconds have passed. This is to stop people from spamming messages to be at the top of the message count leaderboard.

Message Count Delay

INFO

Every server's default message count delay is 0 seconds.

TIP

A good message count delay is 10 seconds.

WARNING

A server's message count delay must be between 0 and 300 seconds.

Minimum Words ​

Premium feature

Setting a minimum amount of words requires Invite Tracker Premium.

Also found in the Message counting section, the minimum words setting is the number of words a message needs to have to be counted. Messages with fewer words are ignored. Words are counted by splitting the message on spaces and line breaks, so gm is 1 word and good morning everyone is 3 words. Mentions, emojis and links each count as one word, and messages without any text, such as a message containing only an image, have 0 words.

For example, with minimum words set to 3, hi and ok thanks are not counted, while thanks for the help is.

A message that is too short does not start the message count delay, so the member's next long enough message can still be counted right away.

INFO

Every server's default minimum words is 0, which counts every message. A new value can take a short moment to start applying after saving. If your server's Premium expires, the setting stops applying and every message is counted again.

WARNING

A server's minimum words must be between 0 and 100.

WARNING

With a Custom Bot, the bot needs the Message Content Intent option enabled in the Discord Developer Portal to read messages. Without it, Discord hides the text of most messages from the bot, so they have 0 words and are not counted while minimum words is set.

Blacklisted Channels ​

This is where you can blacklist a channel from having messages counted. You can find it in the Counting blacklists section: pick a channel and click Add Channel. Messages sent by users in a blacklisted channel will not be counted towards their total amount of messages sent.

Messages Channels Blacklist

TIP

A good idea would be to blacklist any bot-designated channels. This is because usually, you do not want people to gain messages for spamming lots of commands.

WARNING

Free servers can only have a maximum of 5 blacklisted channels.

Premium servers can have an unlimited amount of blacklisted channels.

Blacklisted Roles ​

Also in the Counting blacklists section, this is where you can blacklist a role from having messages counted. Users with any of the selected roles will not have their messages counted.

Role Messages Blacklist

WARNING

Free servers can only have a maximum of 3 blacklisted roles.

Premium servers can have an unlimited amount of blacklisted roles.

Blacklisted Members ​

Also in the Counting blacklists section, this is where you can blacklist members from having their messages counted by using their user IDs: type an ID and click Add User ID. Messages sent by message-blacklisted users are not tracked by Invite Tracker and will not count towards their total amount of messages sent.

User Messages Blacklist

INFO

Information regarding how to get a user's ID can be found here.

WARNING

Free servers can only have a maximum of 3 blacklisted users.

Premium servers can have a maximum amount of 100 blacklisted users.

DANGER

Be careful not to blacklist the wrong users.

Whitelisted Channels ​

This is where you can restrict message counting to specific channels. You can find it in the Counting whitelist section. The channel whitelist is off by default: turn on the Whitelisted channels switch, pick a channel and click Add Channel. While it is on, only messages sent in the whitelisted channels are counted; messages sent anywhere else are ignored.

The whitelist works together with the blacklists: a channel that is both whitelisted and blacklisted is never counted, and blacklisted roles and members are still not counted in whitelisted channels.

Messages Channels Whitelist

TIP

A common setup is to whitelist your main chat channels so that only real conversations count towards the message leaderboard, without having to blacklist every other channel.

INFO

Turning the switch off keeps your whitelisted channels, so you can turn it back on later without picking them again. While the switch is on but no channel is whitelisted, messages are counted in every channel; a deleted channel is removed from the whitelist automatically.

INFO

While the whitelist is on, messages sent in threads, forum posts and voice channel chats are not counted, as they are separate channels from the ones you can whitelist. The whitelist can take a short moment to start applying after saving.

WARNING

Free servers can only have a maximum of 3 whitelisted channels.

Premium servers can have a maximum of 25 whitelisted channels. If your server's Premium expires while more than 3 channels are whitelisted, only the first 3 channels listed on the dashboard keep counting messages.

Whitelisted Roles ​

Premium feature

Whitelisting roles for message counting requires Invite Tracker Premium.

This is where you can restrict message counting to specific roles. You can find it in the Counting whitelist section. Once at least one role is whitelisted, only users who have at least one of the whitelisted roles will have their messages counted; everyone else's messages are ignored.

The whitelist works together with the blacklists: a user with a whitelisted role still does not have their messages counted in a blacklisted channel, or if they also have a blacklisted role, or if they are a blacklisted member.

Role Messages Whitelist

TIP

A common setup is to whitelist your "Member" or "Verified" role so that only verified members climb the message leaderboard.

INFO

The whitelist can take a short moment to start applying after saving. If your server's Premium expires, the whitelist stops applying and messages from every user are counted again.

WARNING

Premium servers can have a maximum of 25 whitelisted roles. Leave the whitelist empty to count messages from every user.

Highest Mode ​

Found in the Reward roles section, this switch decides the effect of the reward roles feature for the message counting plugin.

Highest mode decides whether users keep all of the reward roles they have managed to acquire or only the role that requires the most amount of messages. To keep only the highest role, enable Highest mode. To keep all the roles, leave it disabled.

Highest Mode

Example ​

Suppose you have the following reward roles configured:

  • Bronze at 100 messages
  • Silver at 500 messages
  • Gold at 1000 messages

If a user reaches 1000 messages:

Highest modeRoles the user has
DisabledBronze, Silver, and Gold (all three roles)
EnabledGold only (previous roles are removed)

TIP

Enable Highest mode if you want reward roles to represent a user's current "tier" or "rank". Disable it if you want roles to accumulate as achievements.

Reward Role Announcements ​

When reward role announcements are enabled, Invite Tracker sends a message when a member reaches a reward role. Once the toggle is on, you can select the channel the announcements are sent in. Leave the channel empty to announce in the channel the member was chatting in.

Reward Role Announcements

Reward Roles ​

A reward role is a role that is assigned to a user when they have sent a certain amount of messages. To add one, select a role, enter the Message count required, and click Add Reward Role.

Reward Roles

WARNING

Free servers can only have a maximum of 5 reward roles.

Premium servers can have an unlimited amount of reward roles.

INFO

Only roles Invite Tracker is able to assign are listed: the bot needs the Manage Roles permission and its highest role must be above the role.

Invite Tracker Documentation