Events

An event is a race with a finish line. From its start, InviteCount counts the invites or the messages of your members on a scoreboard of its own, keeps a live message up to date in a channel and, when time is up, freezes the standings and announces the winners.

Every event starts from zero and stays apart from the rest of the server: invite and message counters, leaderboards and resets never change it, and it never changes them.

Events are free. Premium runs more of them at once, for longer, with more winning ranks, reward roles and a CSV export (see Free and Premium). Events are created and managed on the dashboard: see Run an event.

Invite events and message events#

The type of an event can't change once it has started.

What an invite event counts#

An invite event follows invite tracking: it adds a point where the bot credits a regular invite to an inviter, for the joins made while the event runs.

• Your fake invite rules apply, rejoins count as fake if you chose so and, with verification on, the inviter scores once the member is verified: exactly as for /invites.
• If the invited member leaves before the end, the inviter loses that point. A member who joined before the start changes nothing by leaving.
• Bonus invites never count. Joins credited to nobody (vanity link, unknown invite, missing permission) score for nobody.

What a message event counts#

Every message that your message counting counts, sent while the event runs: the same excluded channels, roles and members, the same whitelists, minimum number of words and delay between two counted messages.

Who can score#

• Never bots, and never the members hidden from the leaderboards: they don't appear in the standings either.
• In an invite event, never the members of the invite blacklist or members with a blocked role.
• With a required role, only the members who have it when they invite or send the message. A point already earned stays if the role is removed later.

Standings and winners#

The standings rank members by score, highest first. On a tie, the member who reached that score first is ahead. A member with 0 is not listed.

When the event ends, the first ranks win, up to the number of winning ranks, as long as their score reaches the minimum score (0: no minimum). If fewer members qualify, only they win. If nobody does, the announcement says that nobody won.

In Discord#

The live message#

At the start, InviteCount posts the event in its channel:

• its name, its description and the kind of race;
• its end, as a Discord timestamp: each member sees a countdown in their own time;
• the rules that apply: what counts, the required role, the winning ranks and the minimum score;
• the top 10.

The message is refreshed every 15 minutes when the standings have changed, and right after you edit the event. Its two buttons answer only the member who clicks:

• My rank: their score, their rank and how far they are from the next rank, or their lead when they are first;
• Full leaderboard: every ranked member, 10 per page, with previous and next buttons.

When the event ends, the message becomes the final board, with the winners marked. Its buttons keep answering from the final standings.

If the live message is deleted, it isn't posted again: the event goes on, and its winners are still announced in the channel.

The winners announcement#

At the end, a new message in the channel names the winners. It mentions the winners only: nobody else is notified. If the channel was deleted, the event still ends (standings and reward roles), without an announcement.

Reward roles (message events, Premium)#

Each reward role is given to each winner when the event ends, if InviteCount can: it needs Manage Roles, and its highest role must be above the reward role. Reward roles are never removed afterwards.

Reward roles are only for message events: giving roles in exchange for invites is what Discord's platform manipulation policy forbids.

Commands#

Every member can follow events in Discord:

Details: Event commands.

Free and Premium#

On every plan: a name of up to 100 characters and a description of up to 1,000, a duration from 1 minute, a planned start from 1 minute to 365 days ahead, a minimum score from 0 to 1,000,000, one required role or none, the live message and its two buttons, the /event commands and the winners announcement.

When Premium ends#

• Running events go on to their end with all their settings: nobody's race is cut short, and reward roles are still given.
• A planned event that doesn't fit the free plan when its start comes (premium options, or an event already running) doesn't start. It waits on the dashboard with the reason, until you edit it, retry it or delete it. See A planned start that fails.
• The dashboard lists the last 10 ended events; the others come back with Premium.

Data kept#

For each event: its settings and, for each member who scored, their score, the time of their last point and their name as last seen (for members who leave). For an invite event, also which member's join gave which inviter a point, to take it back if that member leaves.

Each server keeps its 50 most recently ended events: when another event ends, the oldest one is deleted with its scores. Deleting an event deletes its scores; the messages already posted in Discord stay. Events are also deleted with the server's member data when InviteCount leaves the server (see Privacy and data).

Permissions#

In the event channel, InviteCount needs View Channel, Send Messages and Embed Links. For reward roles, Manage Roles, with its highest role above them.

Creating and managing events on the dashboard needs the Manage Server permission, like the rest of the dashboard. The /event commands are open to every member.