Automate Community Events

Levlix runs seasonal events on your server: for a few days or weeks, themed drops, messages and hunts appear in the channels where people are chatting. Members react or guess to earn event score, climb the event leaderboard and win bonus points at the end. One event runs per server at a time, and every run ends with a winners' round.

How an Event Works

While an event is running, Levlix watches how active the chat is. A server counts as active when its channels saw at least 5 messages from at least 2 members in the last 10 minutes. Nothing appears in a quiet server, and every channel holds at most one open drop at a time.

There are three things to catch:

• Emoji drop: Levlix adds a theme emoji as a reaction to a recent message. Add the same reaction to claim it. When the drop is full or runs out, the bot removes its reaction.
• Themed message: Levlix posts a short themed message and reacts to it with the matching emoji. React with that emoji to claim it.
• Hunt: a card with five hiding spots and a countdown. Pick one spot; your answer is private. When the countdown ends, the card shows the right spot, how many members found it and up to 10 of their names. A click after the countdown gets "This hunt is already over."

Server admins can set the activity level to Low (half as many drops) or High (one and a half times as many), and a cooldown between two scoring drops or messages of the same member (60 seconds by default). A claim inside your cooldown does not count, so the slot stays free for someone else. Hunts have no cooldown.

Score, Server Points and the Leaderboard

Every event keeps its own score for its leaderboard. Each score gain also pays server points: by default 1 point per score, and admins can set the payout between 0 and 200 %. The score itself is never reduced, so the leaderboard stays fair whatever the payout.

On the leaderboard, a higher score ranks first. On a tie, the member whose last scoring action came earlier ranks higher.

The Winners' Round

When the end date is reached, or an admin ends the event early, Levlix:

1. closes all open drops and resolves open hunts,
2. pays the bonus points for places 1, 2 and 3 (500, 300 and 150 by default),
3. gives the winner role, if one is set, to the new top members (the top 3 by default, up to 10),
4. posts the winners' round with the top 10, the number of members who took part and the number of finds,
5. stores the run in the archive.

The bonus points are always paid in full as server points; the payout ratio only applies to the regular score gains. The winners keep the winner role until the next event starts; then Levlix takes it back so the new run starts fresh.

Seasonal Themes

Levlix ships nine themes, each with its own emojis, messages and hunt. They follow a fixed yearly calendar (UTC) without overlaps:

With auto-season switched on, Levlix starts the theme in season on its own and ends it with its window. Admins can also start any theme by hand with their own end date.

Taking Part

Members use /event to see the running theme, when it ends, their own score and place, the leaderboard page by page and the rewards on offer. Without a running event, the card shows the next theme on the calendar and the last winners. The same information is on the server's events page in the web dashboard.

/event also has an Opt out button. Opted-out members are ignored by every event, on every server that uses Levlix: their reactions and guesses do not count, and their messages do not count towards the chat activity. Opt in brings them back.

Not to Be Confused With Giveaways

If you're looking for a classic raffle or prize drawing, that's a different module. See the Giveaway Automation page.