Erfolge: Eigene Errungenschaften mit automatischer Freischaltung

Mit Erfolgen (Achievements) definierst du eigene Errungenschaften für deinen Server, zum Beispiel „Vielschreiber“ ab 1.000 Nachrichten oder „Level 10“. Kage schaltet sie automatisch frei, sobald ein Mitglied die Bedingung erreicht, und kann optional XP als Belohnung geben und die Freischaltung ankündigen. Manche Erfolge vergibst du von Hand.

Eine kurze Anleitung findest du im Ratgeber Erfolge einrichten.

Voraussetzungen

• Zugriff auf das Modul: Du meldest dich im Dashboard mit Discord an und brauchst das Recht Server verwalten (oder einen für dieses Modul freigegebenen Zugriff). Die Verwaltungsbefehle verlangen dasselbe Recht.
• Für Level-Erfolge und XP-Belohnungen: Das Level-System muss eingeschaltet sein (Level und XP).
• Für Ankündigungen: Kage braucht im Ankündigungs-Kanal Nachrichten senden und Links einbetten.
• Obergrenze: Wie viele Erfolge du anlegen darfst, hängt vom Tarif ab: Basic 15, Premium 100, Enterprise unbegrenzt.

Die Kriterien

Jeder Erfolg hat ein Kriterium. Drei prüft Kage automatisch, eines vergibst du von Hand:

Wichtig zu den Zählern:

• Die Nachrichtenzahl zählt jede Nachricht des Mitglieds auf dem Server, unabhängig von XP-Cooldowns und -Ausnahmen. Bots zählen nicht.
• Das Level richtet sich nach den aktuellen XP und der Level-Kurve (Ränge, Level und Belohnungen).
• Die Einladungszahl ist der einfache Zähler des Einladungs-Trackings: Er zählt alle Beitritte über die Einladungen der Person, auch gefälschte oder inzwischen verlassene. Die genaue Aufschlüsselung steht im Einladungs-Tracking.

Was bei einer Freischaltung passiert

1. Kage prüft die Bedingung und, dass das Mitglied den Erfolg noch nicht hat. Jeder Erfolg wird pro Mitglied nur einmal vergeben.
2. Kage speichert die Freischaltung und vermerkt sie im Reiter Logs des Moduls.
3. Hat der Erfolg eine XP-Belohnung, schreibt Kage die XP als Event-XP gut. Sie werden nicht multipliziert.
4. Kage baut ein Embed „Errungenschaft freigeschaltet!“ mit Emoji, Name, Beschreibung und Belohnung. Die Texte dieser Ankündigung sind deutsch.
5. Ist „Mitglied zusätzlich per DM benachrichtigen“ an (Standard), schickt Kage das Embed per Direktnachricht. Sind Direktnachrichten gesperrt, überspringt er das.
6. Ist ein Ankündigungs-Kanal gewählt, postet Kage das Embed dort.

Befehle

Die Gruppe /erfolge (englisch /achievements) hat Befehle für alle und für Admins. Alle Antworten sehen nur du.

Im Dashboard

Unter Erfolge siehst du alle Erfolge mit der Zahl der Freischaltungen und eine Rangliste (meiste Erfolge). Mit + Neue Errungenschaft legst du einen Erfolg an (Name, Beschreibung, Kriterium, Schwellenwert, XP-Belohnung), und du kannst ihn löschen (mit Sicherheitsabfrage, alle Freischaltungen gehen dabei verloren). Hier stellst du auch ein, ob und wohin Freischaltungen angekündigt werden.

Einstellungen im Überblick

Ist das Modul ausgeschaltet, prüft Kage die automatischen Kriterien nicht. Manuelles Verleihen mit /erfolge vergeben bleibt möglich.

Ergebnis überprüfen

1. Anlegen: Lege einen Erfolg „Test“ mit Typ „Nachrichtenzahl“ und Schwelle 3 an.
2. Auslösen: Schreibe mit einem Testkonto 3 Nachrichten. Die Ankündigung erscheint.
3. Kontrolle: /erfolge meine zeigt den Erfolg, /erfolge liste die Zahl der Freischaltungen.
4. Reiter Logs: Dort steht die Freischaltung.

Fehlerbehebung

Ein Erfolg wird nicht freigeschaltet

Prüfe, ob „Achievements aktiv“ an ist und der Erfolg einen gültigen Typ und eine Schwelle hat. Die automatischen Kriterien prüft Kage nur bei neuen Nachrichten bzw. Beitritten. Ein Mitglied, das die Bedingung schon vor dem Anlegen erfüllte, bekommt den Erfolg bei seiner nächsten Nachricht.

Level-Erfolge kommen nicht

Das Level-System muss an sein, damit XP vergeben werden. Die Prüfung läuft nach der Nachricht, sobald die XP gebucht sind.

Es kommt keine Ankündigung

Prüfe den Ankündigungs-Kanal und die Rechte von Kage dort. Direktnachrichten kommen nur an, wenn das Mitglied sie erlaubt.

Die Einladungszahl wirkt zu hoch

Der Einladungs-Erfolg nutzt den einfachen Zähler, der auch gefälschte und verlassene Beitritte mitzählt.

Ein Erfolg lässt sich nicht mehr anlegen

Die Obergrenze deines Tarifs ist erreicht. Bereits vorhandene Erfolge werden nicht gekürzt, nur weiteres Wachstum wird blockiert.

Weiterführend

XP und Level: Level und XP. Einladungen: Einladungs-Tracking. Virtuelle Währung: Economy.