Run an event
Create, plan, edit, end and delete an event on the dashboard, retry a planned start that failed, and read or export its standings.
Events are created and managed on the dashboard: Dashboard → Events. You need the Manage Server permission, like on every page of the dashboard. The page lists the running events (ending first), the planned events (starting first) and the ended events (latest first).
Create an event#
- Dashboard → Events → New event.
- Choose the type: Invites or Messages.
- Fill in the settings below.
- Choose when it starts: now, or at a date and time (see Plan an event).
- Click Start the event (or Plan the event for a planned start). Started now, its live message is posted in the channel at once.
| Setting | What it does | Free | Premium |
|---|---|---|---|
| Type | Invites or Messages. | ✓ | ✓ |
| Name | 1 to 100 characters, shown on the live message. | ✓ | ✓ |
| Description | Up to 1,000 characters, for example the prizes. Optional. | ✓ | ✓ |
| Channel | A text or announcement channel, where the live message and the winners announcement are posted. | ✓ | ✓ |
| Duration | From 1 minute. The event ends at its start plus its duration. | Up to 31 days | Up to 93 days |
| Required role | Only members with this role score. None: everyone. | ✓ | ✓ |
| Winning ranks | How many ranks win. | 1 to 10 | 1 to 50 |
| Minimum score | The score a member needs to win, from 0 to 1,000,000 (0: no minimum). | ✓ | ✓ |
| Reward roles | Roles given to each winner at the end. Message events only. | — | Up to 10 |
InviteCount needs View Channel, Send Messages and Embed Links in the channel; otherwise the dashboard says what is missing. A reward role must be below InviteCount's role and below your own highest role. Roles with moderation or administrator permissions, managed roles and @everyone are refused, as for giveaway winner roles. @everyone can't be the required role either: leave it empty to let everyone take part.
Plan an event#
Click Plan an event (or choose At a date and time under Start in the form), then a date and a time from 1 minute to 365 days ahead. The dashboard uses your browser's time zone and shows it; you can pick another one. At that moment, the event starts, posts its live message and runs for its whole duration.
| Free | Premium | |
|---|---|---|
| Events planned ahead | 1 | Unlimited |
| Events running at once | 1 | 10 |
Until it starts, a planned event can be edited entirely, its type, channel and start included.
Edit an event#
Click Edit on a planned or running event.
- Planned event: every setting can change.
- Running event: every setting can change except its type and its channel. Its start has already happened. The live message is refreshed right after you save.
- Ended event: it can't be edited any more.
The duration of a running event still counts from its real start, so changing it moves the end. The new end must be at least 1 minute away: if the event has already run longer than the duration you enter, choose a longer one or end the event now.
A new required role applies to the points earned from then on: points already earned stay. The winning ranks and the minimum score are applied when the event ends.
End an event early#
End early on a running event, confirmed with End now, ends it at once, exactly as at its planned end: the standings freeze, the live message becomes the final board, the winners are announced and, for a message event, get their reward roles. The event is marked as ended early.
Delete an event#
Delete removes a planned or an ended event, with its scores. A running event must be ended first. The messages already posted in Discord stay.
A planned start that fails#
When its start time comes, a planned event checks its channel, InviteCount's permissions there and your plan. If something is wrong, it doesn't start: it stays with the planned events, shows the reason and a Retry button.
| Reason | What to do |
|---|---|
| The channel was deleted | Edit the event and choose another channel. |
| Missing permissions | Give InviteCount View Channel, Send Messages and Embed Links in the channel. |
| Running limit reached | End a running event (1 at a time free, 10 with Premium), or upgrade the server. |
| Premium options on a server without Premium | The reason names them, for example reward roles or more than 10 winning ranks: edit the event to fit the free plan, or bring Premium back. |
| Another error | Try again with Retry. If it keeps failing, ask in the support server. |
- Retry starts the event now, for its whole duration, after the same checks. If they fail again, the reason is updated.
- Editing the event clears the reason. If its start time is still ahead, it starts then; if it has already passed, the event waits for Retry.
- You can also delete it.
Standings#
Standings on a running or ended event opens its standings: live while it runs, final once it has ended, with the winners marked. 25 members per page, in the order of the standings. A planned event has no standings until it starts.
Members who left the server stay in the standings, under the name they had when last seen.
Export the standings (Premium)#
Export CSV downloads the standings of a running or ended event: one line per ranked member, with the columns rank, user_id, username and score. The file, event-<ID>-standings.csv, is UTF-8 and opens in Excel, Numbers or Google Sheets with every name intact. One export per minute per server.
History#
Ended events stay listed, latest first: the last 10 on free servers, the last 50 with Premium. Each server keeps its 50 most recently ended events; when another one ends, the oldest is deleted with its scores. A server that loses Premium sees its last 10 again, and the others come back with Premium.