Docs

Anleitung für Server, die Nexaly nutzen. Es steht nur drin, was der Bot tatsächlich macht. Den aktuellen Systemstatus zeigt die Statusseite.

Start

Nexaly auf den Server einladen, danach unter Dashboard mit Discord anmelden und den Server öffnen.

Du siehst nur Server, auf denen du Eigentümer bist oder die Rechte Administrator bzw. Server verwalten hast. Jeder Server hat eigene Einstellungen.

Rechte des Bots

Die Bot-Rolle muss über den Rollen stehen, die er vergeben oder entziehen soll.

Nachrichten senden, Links einbetten, Dateien anhängen, Nachrichtenverlauf lesen, Reaktionen hinzufügen
Nachrichten verwalten für Auto-Mod und /purge
Mitglieder kicken, bannen und einen Timeout geben
Rollen verwalten für Reaktionsrollen, Rollen-Menüs, Verifizierung und Level-Belohnungen
Kanäle verwalten für Tickets, Statistik-Zähler und temporäre Sprachkanäle
Öffentliche Threads erstellen und darin schreiben für Vorschläge
Mitglieder verschieben für temporäre Sprachkanäle
Audit-Log einsehen, damit Logs den Ausführer nennen können

Dashboard

Nach der Anmeldung über Mit Discord anmelden wählst du einen Server. Module schaltest du auf der jeweiligen Seite oder unter Einstellungen ein. Ohne aktives Modul passiert auf dem Server nichts, auch wenn der Bot online ist.

Unter Einstellungen legst du auch die Sprache fest, in der Nexaly auf dem Server schreibt (Deutsch oder Englisch). Antworten, die nur eine Person sieht, kommen in deren Discord-Sprache.

Unter Einstellungen kannst du einen Kanal für Neuigkeiten von Nexaly festlegen. Nach einem Update postet der Bot dort, was neu, verbessert oder behoben ist. Wählst du einen Kanal neu aus, kommt nach dem Speichern der letzte Eintrag. Der Bot braucht in dem Kanal Kanal ansehen, Nachrichten senden und Links einbetten.

Im Audit-Log (unten in der Navigation) siehst du, wer im Dashboard wann was geändert hat, zum Beispiel eine neue Auto-Mod-Regel oder einen gelöschten Live-Alert. Mit dem Filter grenzt du die Liste auf einen Bereich ein. Einträge bleiben 180 Tage gespeichert.

Logs

Pro Ereignis ein Kanal. Nexaly schreibt ein Embed, keinen Rohtext.

Nachrichten gelöscht oder bearbeitet, Beitritt und Austritt, Nickname, Ban, Entbannung, Kick, Timeout, Rollen an Mitgliedern, Rolle oder Kanal erstellt, geändert oder gelöscht, Voice beigetreten, verlassen oder gewechselt.

Ein Ausführer steht nur im Embed, wenn genau ein Audit-Log-Eintrag zu Ziel, Aktion und Zeitfenster passt. Sonst bleibt das Feld leer. Discord liefert den Ausführer nicht immer.

Moderation

Auto-Mod kann Spam, doppelte Nachrichten, zu viele Erwähnungen, zu viele Emojis, Caps, Links und Discord-Einladungen erkennen. Erlaubte und blockierte Domains lassen sich setzen. Raid-Schutz zählt Beitritte in einem Zeitfenster und kann warnen.

Regeln gelten pro Server: Wort, Einladung, Domain oder eigenes Muster, mit Aktion Löschen, Verwarnen, Timeout, Kick oder Ban. Rollen und Kanäle können ausgenommen werden. Mitglieder mit Nachrichten verwalten oder Administrator prüft der Auto-Mod nicht. Den Server-Eigentümer und sich selbst moderiert Nexaly nicht.

Strafstufen: Jeder Auto-Mod-Verstoß zählt, egal ob verbotenes Wort, Spam oder Einladung. Im Dashboard legst du fest, was beim wievielten Verstoß passiert, zum Beispiel zweimal Verwarnung, dann Timeout für einen Tag, dann Ban. Ein Timeout endet automatisch nach der eingestellten Zeit, höchstens nach 28 Tagen. Ab der letzten Stufe gilt immer diese. Verstöße verfallen nach einer einstellbaren Zahl von Tagen (Standard 30). Mehrere Verstöße innerhalb von 30 Sekunden zählen als einer.

Wortregeln mit „Strafstufen anwenden“ laufen über diese Stufen. Andere Regeln wirken sofort: nur löschen, Kick oder Ban. Das Mitglied bekommt eine Direktnachricht mit der Folge und dem, was beim nächsten Verstoß passiert. Das verbotene Wort selbst wiederholt Nexaly nirgends öffentlich. /warnings zeigt die Verstöße eines Mitglieds und die nächste Stufe, /clearwarnings setzt sie zurück.

Fallakten: Unter Moderation → Fallakten im Dashboard suchst du ein Mitglied nach Name oder Discord-ID und siehst alle Fälle, die aktiven Verstöße und die Notizen des Teams. Notizen sind intern, das Mitglied erfährt nichts davon. Du schreibst sie im Dashboard oder in Discord mit /notiz, /fallakte zeigt die Akte direkt im Kanal, nur für dich sichtbar. Beide Befehle können alle mit dem Recht „Mitglieder moderieren“ nutzen.

Verifizierung

Neue Mitglieder sehen zuerst nur einen Kanal mit den Regeln. Dort klicken sie auf einen Button und bekommen die Mitgliederrolle. Damit das wirkt, nimmst du @everyone in allen anderen Kanälen das Recht „Kanal ansehen“ und gibst es der Mitgliederrolle.

Optional bekommt jedes neue Mitglied beim Beitritt eine Rolle für Unverifizierte, die nach dem Klick wieder entfernt wird. Ein Mindestalter für das Discord-Konto hält frische Spam- und Zweitkonten fern: Ist das Konto jünger, sagt Nexaly dem Mitglied, wie viele Tage noch fehlen. Ein Log-Kanal meldet jede Freischaltung und jede Ablehnung.

Text und Button stellst du im Dashboard ein. Ist die Nachricht schon gesendet, übernimmt Nexaly Änderungen direkt. Die Rollen müssen unter der Bot-Rolle liegen.

Willkommen

Beim Beitritt eine Nachricht im Kanal, optional zusätzlich als Direktnachricht. Drei Modi: Text, Embed oder Bildkarte.

Platzhalter: {user}, {user.name}, {server}, {memberCount}. Die Bildkarte nimmt ein eigenes Hintergrundbild bis 2 MB, PNG, JPEG oder WebP.

Abschiedsnachricht: Verlässt jemand den Server, postet Nexaly auf Wunsch einen Abschied, als Text oder Embed mit Avatar, im Willkommens-Kanal oder einem eigenen. Hier steht {user} für den Namen in Fett, weil eine Erwähnung nach dem Verlassen nur als ID erscheint. Die Abschiedsnachricht funktioniert auch, wenn die Begrüßung aus ist.

Level

XP gibt es pro Nachricht, mit Cooldown. Die Kurve bis zum nächsten Level ist 5n² + 50n + 100. Rollenbelohnungen hängen an einem Level. Die Rolle muss unter der Bot-Rolle liegen.

/rank zeigt das eigene oder ein anderes Level. /leaderboard die Rangliste des Servers.

Die öffentliche Rangliste schaltest du im Dashboard unter Level ein. Dann zeigt eine eigene Seite die besten 100 Mitglieder mit Anzeigename, Avatar, Level und XP, ohne Anmeldung. Wer den Server verlassen hat, bevor Nexaly seinen Namen kannte, fehlt dort. Ist der Schalter aus, gibt es die Seite nicht.

Rollen-Menüs

Eine Nachricht mit Buttons oder einem Auswahlmenü, über die sich Mitglieder Rollen selbst geben, bis zu 25 Rollen pro Menü. Ein Klick auf einen Button gibt die Rolle, ein zweiter nimmt sie wieder weg. Im Auswahlmenü wählt man alle gewünschten Rollen auf einmal. Nexaly antwortet nur für die Person sichtbar, was sich geändert hat.

„Nur eine Rolle gleichzeitig“ eignet sich zum Beispiel für Farben: Wer eine neue wählt, verliert die vorige. Optional können nur Mitglieder mit einer bestimmten Rolle das Menü benutzen. Jede Rolle bekommt eine eigene Beschriftung und ein Emoji, im Auswahlmenü auch eine kurze Beschreibung.

Gesendete Menüs aktualisiert Nexaly beim Speichern. Wechselst du den Kanal, verschwindet die alte Nachricht und das Menü wird neu gesendet. Die Rollen müssen unter der Bot-Rolle liegen, das prüft das Dashboard schon beim Speichern.

Temporäre Sprachkanäle

Wer einen Erstellen-Kanal betritt, bekommt sofort einen eigenen Sprachkanal und wird hineinverschoben. Ist der Kanal leer, löscht Nexaly ihn. Bis zu fünf Erstellen-Kanäle pro Server, jeweils mit eigenem Namen, Limit und Kategorie, zum Beispiel „➕ Duo“ mit 2 und „➕ Squad“ mit 4 Plätzen. Im Namen steht {user} für den Namen des Mitglieds.

Der Besitzer kann seinen Kanal direkt in Discord bearbeiten oder Befehle nutzen: /voice name, /voice limit, /voice lock und /voice unlock. Gesperrte Kanäle können nur noch die betreten, die schon drin waren. Verlässt der Besitzer den Kanal, kann ein anderes Mitglied ihn mit /voice claim übernehmen. Discord erlaubt nur zwei Umbenennungen in zehn Minuten.

Die neuen Kanäle übernehmen die Rechte ihrer Kategorie. Der Bot braucht Kanäle verwalten und Mitglieder verschieben. Wurde Nexaly vor diesem Modul eingeladen, gib der Nexaly-Rolle „Mitglieder verschieben“ oder lade den Bot neu ein.

Giveaways

Start im Dashboard unter Giveaways oder mit /giveaway start: Preis, Dauer (zum Beispiel 30m, 2h, 1d 12h, bis 60 Tage), Anzahl Gewinner und optional eine Beschreibung. Mitglieder nehmen per Button teil, ein zweiter Klick nimmt sie wieder heraus. Die Zahl am Button aktualisiert sich alle paar Sekunden.

Optional dürfen nur Mitglieder mit einer bestimmten Rolle oder ab einem Level aus dem Levelsystem teilnehmen. Das prüft Nexaly bei der Teilnahme und noch einmal bei der Auslosung. Wer den Server verlassen hat, kann nicht gewinnen. Die Auslosung nutzt kryptografisch sicheren Zufall.

Am Ende markiert Nexaly die Nachricht als beendet, nennt die Gewinner und gratuliert im Kanal. /giveaway end beendet sofort, /giveaway reroll lost weitere Gewinner aus, ohne frühere zu ziehen. Im Dashboard geht beides per Klick, dort kannst du ein Giveaway auch abbrechen. Bis zu zehn Giveaways laufen gleichzeitig.

Geburtstage

Mitglieder tragen mit /geburtstag setzen Tag und Monat ein, ohne Jahr. /geburtstag anzeigen zeigt den eigenen oder einen anderen Geburtstag, /geburtstag liste die nächsten zehn, /geburtstag entfernen löscht den Eintrag. Wer den Server verlässt, dessen Geburtstag löscht Nexaly automatisch.

Zur eingestellten Uhrzeit in Serverzeit gratuliert Nexaly im gewählten Kanal, mehrere Geburtstagskinder in einer Nachricht. Optional gibt es eine Geburtstagsrolle, die am nächsten Tag wieder entfernt wird. Wer am 29. Februar Geburtstag hat, feiert in anderen Jahren am 28.

Vorschläge

Mitglieder reichen Ideen mit /vorschlag neu ein. Ist „Nachrichten umwandeln“ an, wird jede Nachricht im Vorschlagskanal automatisch zum Vorschlag (das Team mit „Nachrichten verwalten“ kann dort normal schreiben). Jeder Vorschlag bekommt eine Nummer und erscheint als Embed mit 👍 und 👎. Ein zweiter Klick nimmt die Stimme zurück, der andere Button wechselt sie. Pro Person geht alle 30 Sekunden ein Vorschlag.

Das Team setzt den Status im Dashboard oder mit /vorschlag entscheiden: offen, wird geprüft, angenommen, umgesetzt oder abgelehnt, optional mit Antwort. Danach ist die Abstimmung geschlossen. Auf Wunsch bekommt jeder Vorschlag einen Thread zur Diskussion, der nach der Entscheidung archiviert wird, und die einreichende Person eine Direktnachricht. Für Threads braucht der Bot „Öffentliche Threads erstellen“ und „Nachrichten in Threads senden“.

Statistik-Zähler

Sprachkanäle, deren Name eine Zahl zeigt: alle Mitglieder, Mitglieder ohne Bots, Bots, gerade online oder Server-Boosts. Du legst sie im Dashboard unter Statistiken an, bis zu fünf pro Server. Niemand kann den Kanälen beitreten.

Discord erlaubt das Umbenennen eines Kanals nur zweimal in zehn Minuten. Nexaly prüft die Zahlen alle fünf Minuten und benennt einen Kanal höchstens alle sechs Minuten um. Die Online-Zahl ist der ungefähre Wert, den Discord selbst angibt.

Der Bot braucht Kanäle verwalten und Rollen verwalten. Den Kanal kannst du in Discord frei verschieben. Löschst du ihn dort, verschwindet auch der Zähler.

Live-Alerts

Twitch, YouTube und Kick. Nexaly prüft die Kanäle über die offiziellen Schnittstellen und postet, wenn ein Stream live geht. Ohne die API-Keys auf dem Nexaly-Server gibt es keinen Live-Status. Keys trägst du nicht im Dashboard ein.

Die Ankündigung besteht aus Erwähnung, Text und Embed. Beim Text wählst du den Standardtext in der Server-Sprache, einen eigenen Text oder gar keinen. Im eigenen Text gehen die Platzhalter {streamer}, {platform}, {title}, {game} und {url}. Das Embed zeigt Titel, Spiel, Zuschauer und das Vorschaubild des Streams und lässt sich abschalten. Ohne Embed braucht die Ankündigung einen Text. Bestehende Alerts änderst du über „Bearbeiten“, dort lassen sie sich auch pausieren.

Beim Anlegen kannst du eine Rolle erwähnen oder keine. @everyone steht nur hier zur Auswahl, nicht bei Reaktionsrollen, Tickets oder Level-Belohnungen, weil Nexaly diese Rolle dort nicht vergeben darf.

Eine normale Rolle muss in Discord als erwähnbar gesetzt sein. Für @everyone braucht der Bot die Berechtigung „Erwähne @everyone, @here und Alle Rollen“.

Embeds und Reaktionsrollen

Vorlagen speichern und in einen Textkanal senden. Dafür braucht der Bot im Kanal Kanal ansehen, Nachrichten senden und Links einbetten. An dieselbe Nachricht können bis zu 20 Reaktionen, jede mit einer eigenen Rolle. Klick vergibt die Rolle, Entfernen nimmt sie wieder weg. Der Bot setzt die Reaktionen nacheinander.

Eine schon vorhandene Nachricht geht über den Nachrichten-Link unter „Vorhandene Nachricht“. Der Bot setzt die Reaktion selbst. Emojis gehen als Zeichen oder Kurzname, zum Beispiel :blue_heart:. Server-Emojis im Format name:id. @everyone, verwaltete Rollen und Administrator-Rollen sind gesperrt. Die Rolle muss unter der Bot-Rolle liegen.

Tickets

Kanal, Kategorie und Team-Rolle setzen, speichern, dann Panel senden. Der Button öffnet einen privaten Kanal für den Nutzer und die Team-Rolle. Pro Person nur ein offenes Ticket.

Mit Ticket-Arten bekommt das Panel einen Button pro Art, zum Beispiel Support, Bug melden oder Entbannung (bis zu zehn Arten, ab sechs als Auswahlmenü). Jede Art kann eine eigene Kategorie, Team-Rolle und Begrüßung haben; leere Felder nutzen die Standard-Einstellungen. Pro Person ist dann ein offenes Ticket je Art möglich. Die Art steht im Ticket, im Log und im Protokoll. Nach Änderungen an den Ticket-Arten das Panel neu senden.

Schließen sperrt das Schreiben und benennt den Kanal um. Löschen darf nur das Team oder jemand mit Kanäle verwalten. Dafür braucht der Bot die Berechtigung Kanäle verwalten.

Ist ein Log-Kanal gesetzt, speichert Nexaly beim Schließen ein Protokoll dort: eine HTML-Datei mit dem ganzen Verlauf, die du herunterlädst und im Browser öffnest. Bilder bis 2 MB sind eingebettet, andere Anhänge stehen nur mit Namen drin. Wird nach dem Schließen noch geschrieben, kommt beim Löschen ein aktualisiertes Protokoll. Kann das Protokoll nicht gespeichert werden, löscht der Bot den Kanal nicht. Im Log-Kanal braucht er Nachrichten senden, Links einbetten und Dateien anhängen.

Bewerbungen

Lege im Dashboard unter Bewerbungen ein Formular pro Stelle an, zum Beispiel Moderator oder Event-Team. Jedes Formular hat bis zu fünf Fragen (Discord erlaubt nicht mehr pro Pop-up), wahlweise mit kurzer oder langer Antwort. Dazu wählst du einen Prüfkanal, den nur das Team sieht. Danach Kanal für das Panel wählen und Panel senden. Änderst du Formulare, aktualisiert „Panel aktualisieren“ dieselbe Nachricht.

Klickt jemand auf eine Stelle, öffnet sich ein Pop-up mit den Fragen. Die Antworten landen mit Kontoalter im Prüfkanal. Annehmen oder Ablehnen geht dort per Button (Rechte: Server verwalten oder die Team-Rolle des Formulars) oder im Dashboard. Beim Ablehnen kann das Team eine Begründung angeben. Die Person bekommt das Ergebnis per DM, bei Annahme optional eine Rolle.

Pro Stelle ist eine offene Bewerbung möglich. Nach einer Ablehnung gilt eine Sperre (Standard 14 Tage, 0 schaltet sie ab). Geschlossene Formulare verschwinden beim nächsten Panel-Update; eingegangene Bewerbungen bleiben auch nach dem Löschen eines Formulars erhalten. Einzelne Bewerbungen löschst du im Dashboard, die Nachricht im Prüfkanal verschwindet dann mit.

Eigene Befehle

Unter Community → Eigene Befehle legst du bis zu 25 Slash-Befehle für deinen Server an, zum Beispiel /regeln, /ip oder /event. Jeder Befehl hat einen Namen (Kleinbuchstaben, ohne Leerzeichen), eine Beschreibung und eine Antwort aus Text, Embed oder beidem. Nach dem Speichern steht der Befehl sofort in Discord bereit.

Platzhalter in Text und Embed: {user} erwähnt die Person, {user.name} ist ihr Name, {server} der Servername, {channel} der Kanal und {membercount} die Mitgliederzahl. Die Antwort pingt höchstens die Person selbst, nie Rollen oder @everyone.

Optional sieht nur die aufrufende Person die Antwort, und du kannst den Befehl auf bestimmte Rollen beschränken. Wer „Server verwalten“ hat, darf ihn immer nutzen. Ausgeschaltete Befehle verschwinden aus Discord, bleiben aber gespeichert. Namen eingebauter Nexaly-Befehle wie /rank sind gesperrt.

Klappt das Anlegen nicht, fehlt Nexaly meist die Erlaubnis, Befehle auf dem Server einzurichten. Lade den Bot dann über den Einladungslink neu ein, deine Einstellungen bleiben erhalten.

Befehle

/ping und /help
/rank und /leaderboard
/warn, /warnings, /clearwarnings, /timeout, /untimeout, /kick, /ban, /unban
/notiz und /fallakte
/purge, /slowmode, /userinfo, /serverinfo
/voice name, /voice limit, /voice lock, /voice unlock, /voice claim
/giveaway start, /giveaway end, /giveaway reroll
/geburtstag setzen, /geburtstag anzeigen, /geburtstag liste, /geburtstag entfernen
/vorschlag neu, /vorschlag entscheiden

Discord zeigt die Befehle in der Sprache deiner Discord-App. Auf Englisch heißen sie zum Beispiel /birthday, /suggest, /note und /case.

Einstellungen laufen über das Dashboard, nicht über Slash-Befehle.