Events-Modul: Anleitung zur Einrichtung für Admins

Diese Anleitung führt Administratoren durch den Schalter des Events-Moduls, den Start eines saisonalen Events, die Belohnungen und die Steuerung von Events aus Discord, dem /setup-Hub und dem Web-Dashboard. Wie sich Events aus Sicht der Mitglieder anfühlen (Drops, Themen-Nachrichten, Suchen, Score), beschreibt die Seite zu Community-Events.

Das Modul ein- und ausschalten

Das Events-Modul ist standardmäßig eingeschaltet, /event für Mitglieder und die Event-Verwaltung in /setup stehen also sofort zur Verfügung. So schaltest du es aus (oder wieder ein):

1. Öffne das Levlix Dashboard und wähle deinen Server aus.
2. Gehe in der Seitenleiste zu Server → Module und schalte das Modul Events um. Das geht auch in /setup unter Community, Events.
3. Die Änderung kommt innerhalb einer Minute in Discord an.

Immer nur ein Event

Auf einem Server läuft höchstens ein Event gleichzeitig. Ein Event startet auf einem von zwei Wegen:

• Von Hand: Ein Admin wählt eines der neun Themen und einen letzten Tag. Das Event endet an diesem Tag um 23:59:59 UTC.
• Auto-Saison: Ist sie eingeschaltet, prüft Levlix jeden Tag um 00:05 UTC und beim Start des Bots den Kalender. Ist ein Thema in der Saison und läuft kein Event, startet Levlix dieses Thema und beendet es mit dem Ende seines Zeitraums.

Die Auto-Saison respektiert deine Entscheidungen. Ein Thema, das in seinem aktuellen Zeitraum schon gestartet wurde, startet nicht noch einmal, ein vorzeitig beendetes Event bleibt also beendet. Ein von Hand gestartetes Event blockiert die Auto-Saison, bis es endet.

Für den Start braucht Levlix mindestens einen Textkanal, der nicht ausgeschlossen ist und in dem der Bot den Kanal sehen, Nachrichten senden, Reaktionen hinzufügen und den Nachrichtenverlauf lesen darf. Sonst wird der Start mit einer entsprechenden Meldung abgelehnt. Schlägt das Posten in einem Kanal während des Events fehl, überspringt Levlix diesen Kanal für den Rest des Laufs.

Die Admin-Karte in Discord

Admins mit der Berechtigung Server verwalten öffnen die Event-Verwaltung in /setup: Wähle Community, dann Events, dann Event-Verwaltung öffnen.

Die Karte hat vier Tabs, die du im Menü unten auswählst:

• Status: ob ein Event läuft, wann es endet und wie viele Mitglieder, Drops und Funde es bisher hat. Verlängern verschiebt das Enddatum, Event beenden beendet es nach einer Bestätigung und startet sofort die Gewinnerrunde. Läuft kein Event, wählst du unter Thema zum Starten ein Thema und gibst das Enddatum ein (JJJJ-MM-TT, UTC).
• Belohnungen: die Auszahlungsquote, der Bonus für Platz 1 bis 3 und die Gewinnerrolle. Werte ändern öffnet ein Formular für die Auszahlung (0 bis 200 %), die drei Boni und die Zahl der besten Mitglieder, die die Gewinnerrolle bekommen (1 bis 10). Die Rolle wählst du unter Gewinnerrolle (optional); Gewinnerrolle entfernen setzt sie zurück.
• Ankündigungen: der Ankündigungskanal, die Rolle zum Pingen und der Schalter für die Auto-Saison (Auto-Saison einschalten oder Auto-Saison ausschalten).
• Rangliste: die besten 10 des aktuellen Laufs und die letzten fünf früheren Läufe mit ihren Gewinnern.

Ausgeschlossene Kanäle, Aktivitätsstufe und Abklingzeit stellst du im Web-Dashboard ein; die Karte verlinkt dorthin.

Belohnungen

• Auszahlung: Jeder Score-Gewinn zahlt score × payout / 100 Server-Punkte aus, abgerundet. Standard sind 100 %, möglich sind 0 bis 200 %. Bei 0 % wird nur um die Rangliste und die Boni gespielt.
• Bonuspunkte: Platz 1, 2 und 3 bekommen standardmäßig 500, 300 und 150 Server-Punkte (je 0 bis 100.000). Die Boni werden immer voll ausgezahlt, unabhängig von der Auszahlungsquote.
• Gewinnerrolle: optional. Am Ende jedes Events gibt Levlix sie den besten Mitgliedern (standardmäßig den besten 3). Sie behalten sie, bis das nächste Event startet; dann nimmt Levlix sie ihnen wieder ab.
• Gleichstand: Bei gleichem Score liegt das Mitglied vorn, dessen letzte gewertete Aktion früher war.

Ankündigungen

Levlix postet pro Event drei Nachrichten: den Start (mit den ausgeschriebenen Belohnungen), eine Warnung 24 Stunden vor dem Ende und die Gewinnerrunde mit den besten 10. Sie landen im Ankündigungskanal oder, falls keiner eingestellt ist, im Systemkanal des Servers; gibt es beides nicht, entfallen sie. Die Rolle zum Pingen wird nur beim Start und in der Gewinnerrunde erwähnt.

Der Setup-Hub

In /setup findest du unter Community die Seite Events. Dort schaltest du das Modul ein oder aus und stellst die Grundlagen ein: Events nach Kalender starten (Auto-Saison), Ankündigungskanal und Rolle zum Pingen. Event-Verwaltung öffnen öffnet die oben beschriebene Admin-Karte, Dashboard öffnen die Admin-Seite im Web.

Das Web-Dashboard

Die Bezeichnungen stehen hier so, wie du sie im Web-Dashboard siehst.

• Seite Saison-Events (Engagement → Events in der Seitenleiste, /server/{id}/events, für jedes Mitglied sichtbar): das laufende Event mit Teilnehmern, Drops, Fängen und deinem eigenen Score, die Rangliste, die letzten Gewinner und der Kalender der nächsten zwölf Monate.
• Seite Event-Verwaltung (Events verwalten auf der Event-Seite, /server/{id}/events/admin, ab der Moderatorrolle): ein Event mit Thema und letztem Tag starten, das Ende ändern oder das Event sofort beenden, Belohnungen und Gewinnerrolle, Ankündigungskanal, Rolle zum Pingen und Mit der Saison starten (Auto-Saison), die Rangliste und das Archiv der beendeten Events mit ihren Gewinnern.

Drei Einstellungen gibt es nur auf der Admin-Seite im Web:

• Aktivitätsstufe: Niedrig (halb so viele Drops), Normal oder Hoch (anderthalbmal so viele). Bei Normal bekommt ein aktiver Chat pro Stunde etwa 6 Emoji-Drops, 2 Themen-Nachrichten und 1 Suche.
• Abklingzeit: Sekunden zwischen zwei gewerteten Drops oder Nachrichten eines Mitglieds, 0 bis 600 (standardmäßig 60). Suchen haben keine Abklingzeit.
• Ausgeschlossene Kanäle: Kanäle und ganze Kategorien, in denen nichts erscheint und deren Nachrichten nicht zur Chat-Aktivität zählen.

Übersicht der Befehle für Mitglieder

Dieser Befehl steht allen offen, solange das Modul eingeschaltet ist:

Die Abmeldung gilt für jedes Event auf jedem Server mit Levlix: Reaktionen und Tipps bei Suchen von abgemeldeten Mitgliedern zählen nicht, und ihre Nachrichten zählen nicht zur Chat-Aktivität.

Checkliste für die Einrichtung

• Lege einen Ankündigungskanal fest, sonst landen die Posts im Systemkanal oder entfallen.
• Entscheide, ob du die Auto-Saison einschaltest oder Themen von Hand startest.
• Prüfe die Belohnungen: Auszahlungsquote, die drei Boni und, wenn du eine möchtest, eine Gewinnerrolle.
• Schließe im Web-Dashboard Kanäle aus, in denen Drops stören würden (Regeln, Ankündigungen, Support).
• Sorge dafür, dass Levlix in deinen Chat-Kanälen Nachrichten senden, Reaktionen hinzufügen und den Nachrichtenverlauf lesen darf.