Events
A leaderboard counts forever. An event gives everyone the same starting line and a finish date, so newcomers stand a chance against your regulars, and your server's own counters stay exactly as they are.
How it works
An invite event gives the inviter a point each time a member joins through their invite and counts as a regular invite: your fake rules, rejoins and verification apply, as for /invites, and the point goes back if that member leaves before the end. A message event counts every message your message counting counts, with the same channels, roles, minimum of words and delay.
At the start, InviteCount posts the event with its rules, the end as a countdown in each reader's own time and the top 10, refreshed every 15 minutes. My rank tells a member their score, their rank and the gap to the next one; Full leaderboard pages through everyone, 10 at a time. Only the member who clicks sees the answer.
Start an event right away, or plan it from 1 minute to a year ahead in your own time zone. If a planned start can't happen, because the channel is gone, a permission is missing or a limit is reached, the event waits on the dashboard with the reason and a Retry button.
Choose how many ranks win, a minimum score to qualify and a role members need to take part. Ties go to the member who reached the score first. Bots, members hidden from your leaderboards and, in invite events, your invite blacklist never score.
When time is up, the standings freeze, the live message becomes the final board with the winners marked, and a new message mentions the winners, nobody else. With Premium, the winners of a message event also get the reward roles you chose. Need to stop early? End the event from the dashboard: the same happens at once.
Free servers run 1 event at a time and plan 1 ahead, for up to 31 days with 10 winning ranks. Premium runs 10 at once and plans as many as you want, for up to 93 days with 50 winning ranks, gives up to 10 reward roles to the winners of a message event, lists the last 50 ended events instead of 10, and exports the standings to CSV.
What this module includes on each plan.
| Feature | Free | Premium |
|---|---|---|
| Invite and message events: live message, /event commands, winners announced | Included | Included |
| Events running at the same time | 1 | 10 |
| Events planned ahead | 1 | Unlimited |
| Longest event | 31 days | 93 days |
| Winning ranks per event | 10 | 50 |
| Reward roles for the winners of a message event | Not included | 10 |
| Ended events listed in the history | 10 | 50 |
| CSV export of an event's standings | Not included | Included |
The slash commands behind this module. Most settings also live in the dashboard.
/event listList the running events with their end, and the planned ones with their start./event leaderboardShow the standings of an event, 10 members per page./event rankShow your score and rank in an event, or another member's.More in the documentation.
No. An event keeps its own scores, from zero, from its start. Invite and message counters, leaderboards and resets never change it, and it never changes them.
Yes, from the dashboard: its name, description, duration, required role, winning ranks, minimum score and reward roles. The live message updates right after you save. Its type and channel stay as they are, while a planned event can change everything until it starts.
Giving roles in exchange for invites is what Discord's platform manipulation policy forbids, so InviteCount only gives reward roles to the winners of message events. Any other prize you announce is yours to deliver, within Discord's rules.
Running events go on to their end with all their settings, reward roles included: nobody's race is cut short. A planned event that no longer fits the free plan waits on the dashboard with the reason, until you edit it, retry it or delete it.
Add InviteCount, then choose invites or messages, a channel and an end on the dashboard: the live leaderboard and the winners announcement take it from there.