Events Module: Admin Setup Guide

This guide walks administrators through enabling the Events module, starting a seasonal event, setting the rewards and running events from Discord, the /setup hub and the web dashboard. For how events feel from the member side (drops, themed messages, hunts, score), see the Community Events feature page.

Switching the Module On or Off

The Events module is on by default, so /event for members and the event admin card in /setup are available right away. To switch it off (or back on):

1. Open the Levlix Dashboard and select your server.
2. Go to Server → Modules in the sidebar and switch the Events module. You can also do this in /setup under Community, Events.
3. The change reaches Discord within a minute.

One Event at a Time

A server runs at most one event at a time. An event starts in one of two ways:

• By hand: an admin picks any of the nine themes and a last day. The event ends at 23:59:59 UTC on that day.
• Auto-season: once switched on, Levlix checks the calendar every day at 00:05 UTC and when the bot starts. If a theme is in season and no event is running, it starts that theme and ends it with the theme's window.

Auto-season respects your decisions. A theme that already started in its current window is not started again, so an event you ended early stays ended. An event you started by hand blocks auto-season until it ends.

To start, Levlix needs at least one text channel where it can view, send messages, add reactions and read the message history, and that is not excluded. Otherwise the start is refused with a message telling you so. If posting in a channel fails during the event, Levlix skips that channel for the rest of the run.

The Admin Card in Discord

Admins with the Manage Server permission open the event admin card in /setup: choose Community, then Events, then Open event admin.

The card has four tabs, picked from a menu at the bottom:

• Status: whether an event is running, when it ends and how many members, drops and finds it has so far. Extend moves the end date, End event ends it after a confirmation and runs the winners' round immediately. Without a running event, pick a theme under Theme to start and enter the end date (YYYY-MM-DD, UTC).
• Rewards: the payout ratio, the bonus for places 1 to 3 and the winner role. Edit numbers opens a form for the payout (0 to 200 %), the three bonuses and how many top members get the winner role (1 to 10). Pick the role in Winner role (optional); Remove winner role clears it.
• Announcements: the announcement channel, the role to ping and the auto-season switch (Turn auto-season on or Turn auto-season off).
• Leaderboard: the top 10 of the current run and the last five past runs with their winners.

Excluded channels, the activity level and the cooldown are set on the web dashboard; the card links there.

Rewards

• Payout: every score gain pays score × payout / 100 server points, rounded down. The default is 100 %, the range 0 to 200 %. At 0 % the event is played for the leaderboard and the bonuses only.
• Bonus points: places 1, 2 and 3 get 500, 300 and 150 server points by default (0 to 100,000 each). The bonuses are always paid in full, whatever the payout ratio.
• Winner role: optional. At the end of each event, Levlix gives it to the top members (the top 3 by default). They keep it until the next event starts; then Levlix takes it back from them.
• Ties: with equal score, the member whose last scoring action came earlier ranks higher.

Announcements

Levlix posts three messages per event: the start (with the rewards on offer), a warning 24 hours before the end, and the winners' round with the top 10. They go to the announcement channel, or to the server's system channel if none is set; without either, they are skipped. The ping role is mentioned only in the start and the winners' posts.

The Setup Hub

In /setup, the Events page under Community switches the module on or off and holds the basics: Start events by the calendar (auto-season), Announcement channel and Role to ping. Open event admin opens the admin card described above, Open dashboard the web admin page.

The Web Dashboard

• Seasonal Events page (Engagement → Events in the sidebar, /server/{id}/events, visible to every member): the running event with participants, drops, catches and your own score, the leaderboard, the last winners and the calendar of the next twelve months.
• Event Admin page (Manage events on the events page, /server/{id}/events/admin, moderator role or higher): start an event with a theme and a last day, change the end or end it now, the rewards and the winner role, the announcement channel, the ping role and Start with the season (auto-season), the leaderboard and the archive of finished events with their winners.

Three settings exist only on the web admin page:

• Activity level: Low (half as many drops), Normal or High (one and a half times as many). At Normal, an active chat gets about 6 emoji drops, 2 themed messages and 1 hunt per hour.
• Cooldown: seconds between two scoring drops or messages of one member, 0 to 600 (60 by default). Hunts have no cooldown.
• Excluded channels: channels and whole categories where nothing appears and where messages do not count towards the chat activity.

Member Commands Reference

This command is available to everyone when the module is enabled:

Opting out applies to every event on every server that uses Levlix: reactions and hunt guesses of opted-out members do not count, and their messages do not count towards the chat activity.

Setup Checklist

• Pick an announcement channel, otherwise the posts go to the system channel or are skipped.
• Decide whether to switch on auto-season, or start themes by hand.
• Check the rewards: payout ratio, the three bonuses and, if you want one, a winner role.
• Exclude channels where drops would disturb (rules, announcements, support) on the web dashboard.
• Make sure Levlix can send messages, add reactions and read the message history in your chat channels.