Willkommen zur KynxBot-Dokumentation
KynxBot ist ein leistungsstarker Discord-Bot mit Web-Dashboard: Tickets, Giveaways, GitHub-Updates, Steam-Game-Updates, visuelle Embeds, Stream- und Content-Posts, Moderation und eigene Commands. Diese Dokumentation führt dich Schritt für Schritt durch die wichtigsten Systeme.
Voice-KI und Tools
Server & Struktur
Ticket-System
Kartengenerierung
Embeds · Livestreams & Content
Giveaways & Commands
Auto-Posts
Rollen · Mod · KI-Einstellungen
Bot Einrichten
Folge diesen Schritten, um KynxBot auf deinem Discord-Server einzurichten:
1. Bot Einladen
- Gehe zur KynxBot Homepage
- Klicke auf "Bot hinzufügen"
- Wähle deinen Server aus der Liste
- Bestätige die benötigten Berechtigungen
Der Bot benötigt folgende Berechtigungen: Nachrichten senden, Embeds einbetten, Dateien anhängen, Mitglieder verwalten
2. Dashboard Zugriff
Nach der Installation kannst du das Dashboard nutzen:
- Klicke auf "Login" in der Navigation
- Autorisiere dich mit Discord
- Wähle deinen Server aus dem Dropdown
- Jetzt kannst du alle Features konfigurieren!
Schritt für Schritt
- Auf kynxbot.de mit Discord anmelden.
- Über „Bot einladen“ KynxBot auf deinen Server holen. Du brauchst dafür „Server verwalten“ oder Administrator.
- Oben im Server-Menü deinen Server wählen – das Dashboard öffnet sich.
- Die Rolle von KynxBot in den Discord-Servereinstellungen möglichst weit oben einordnen, damit er Rollen vergeben und moderieren kann.
- Module im Dashboard einrichten – z. B. Begrüßung, Tickets oder Leveling. Änderungen gelten sofort.
Dashboard
Das KynxBot Dashboard ist deine zentrale Anlaufstelle für alle Einstellungen:
Tipp: Mit Strg+K (Mac: Cmd+K) springst du auf jeder Seite direkt zu deinen Servern und allen Modulen – zum Beispiel „leveling“ eintippen und Enter drücken.
Checkliste „Erste Schritte“: Im Server-Dashboard siehst du, was noch fehlt, damit dein Server startklar ist – Begrüßung, Regeln, Leveling, Tickets und mehr. Mit einem Klick öffnest du das Modul oder lässt den Assistenten den Schritt für dich erledigen.
Channel-Editor
Der Channel-Editor zeigt die Kanalstruktur deines Discord-Servers wie in der Desktop-App: Kategorien, Text-, Sprach- und weitere Kanaltypen. Du verwaltest alles im Browser — ohne Discord zu wechseln.
Schnellzugriff
Oberfläche (3 Bereiche)
Einrichtung & Pfad
- Öffne
/channeleditor?guildId=…oder wähle im Server-Dashboard die Karte „Channel & Rollen & Design“ → Channel-Editor. - Kanäle erstellen, umbenennen, Kategorie zuweisen, Slowmode, NSFW und Bitrate (Voice) einstellen.
- Per Drag & Drop innerhalb von Kategorien und zwischen Kategorien sortieren.
- Kanal-Berechtigungen für Rollen und Mitglieder im Editor bearbeiten (wie in Discord).
KI-Anbindung
Rechts im Editor findest du den KI-Assistenten. Er nutzt die KynxBot-KI (oder das eigene Modell eures Servers für die Editor-KI) — du beschreibst auf Deutsch, was am Server passieren soll, und erhältst einen prüfbaren Plan statt sofortiger Discord-Änderungen.
- Einfache Fragen beantwortet die KI im Chat (mode chat) — z. B. Erklärungen zur Struktur.
- Bei Bauwünschen („leg Support-Kategorie an …“) liefert sie einen Plan mit Kanälen, Kategorien und optional Berechtigungen.
- Klicke im Chat auf Vorschlag · Klicken zum Prüfen, prüfe einzelne Kanäle in der Review-Ansicht und übernimm den Plan in den Entwurf.
- Änderungen landen erst nach Speichern auf Discord — du kannst vorher manuell nachjustieren.
- Über das Schild-Symbol konfigurierst du Moderations-Rollen für KI-Pläne (welche Rollen in Overwrites vorkommen dürfen).
Fragst du nach neuen Server-Rollen, leitet die KI dich in den Rollen-Editor weiter — Rollen werden dort mit eigener KI geplant, nicht im Channel-Editor.
Manuelle Bearbeitungen und KI-Entwürfe sind lokal, bis du oben speicherst. Fehlt der Bot das Recht „Kanäle verwalten“, schlagen einzelne Operationen fehl — die Oberfläche zeigt dann eine Fehlermeldung.
Speichern & Neuerungen
- Beim Speichern zeigt ein Fortschrittsbalken jede Änderung einzeln. Neue Kanäle werden mit weniger Einzelschritten angelegt und sind dadurch schneller fertig.
- Bremst Discord bei vielen Änderungen, zeigt der Editor an, wie lange es noch dauert – das Speichern läuft automatisch weiter.
Der Bot benötigt „Kanäle verwalten“. Dein Account braucht „Kanäle verwalten“, „Server verwalten“ oder Administrator — sonst sind Aktionen im Editor ausgegraut oder schlagen fehl.
Rollen-Editor
Im Rollen-Editor siehst du alle Server-Rollen mit Farben und Hierarchie wie in Discord. Du erstellst, bearbeitest, sortierst und löschst Rollen direkt im Web-Dashboard.
Schnellzugriff
Oberfläche (3 Bereiche)
Einrichtung & Pfad
- Öffne
/roleeditor?guildId=…oder die Karte „Channel & Rollen & Design“ → Rollen-Editor. - Neue Rollen anlegen, Namen, Farbe, Anzeige (getrennt) und Rechte setzen.
- Per Drag & Drop die Rollen-Hierarchie sortieren — wichtig für Berechtigungs-Auflösung.
- Bot-Rollen und @everyone getrennt erkennbar; Löschen nur, wenn die Rolle nicht mehr gebraucht wird.
KI-Anbindung
Der rechte KI-Assistent erstellt Rollen-Pläne: mehrere createRole-Operationen mit Farben und Rechte-Sets — angepasst an deinen Wortlaut, ohne feste Standard-Sets.
- Die KI ändert nur Rollen — keine Kanäle (dafür Channel-Editor).
- @everyone, verwaltete Bot-Rollen und fremde Bots werden nicht gelöscht oder umbenannt.
- Review-Ansicht wie im Channel-Editor: Vorschlag anklicken, einzelne Rollen prüfen, dann übernehmen.
- Ist die KI serverseitig nicht konfiguriert, bleibt manuelles Anlegen über die Liste möglich.
Kanal-Berechtigungen im Channel-Editor beziehen sich auf bestehende Rollen. Lege Rollen zuerst hier an (manuell oder per KI), nutze sie danach in Kanal-Overwrites.
Speichern & Neuerungen
- Farbverlauf-Rollen: Gib einer Rolle eine zweite Farbe – Discord zeigt den Namen dann mit Farbverlauf. Die Option erscheint auf Servern, denen Discord Farbverläufe freigeschaltet hat (Boost-Stufe 2).
- Beim Speichern siehst du wie im Kanal-Editor einen Fortschrittsbalken und jede Änderung einzeln. Hat etwas nicht geklappt, hilft „Rest erneut versuchen“.
- Bremst Discord bei vielen Änderungen, zeigt der Editor an, wie lange es noch dauert – das Speichern läuft automatisch weiter.
Der Bot benötigt „Rollen verwalten“. Dein Account braucht „Rollen verwalten“, „Server verwalten“ oder Administrator. Die Bot-Rolle muss in der Hierarchie über den Rollen liegen, die der Bot vergeben soll.
Community Showcase
Stellt euren Discord-Server auf kynxbot.de vor — Banner, Tags, Votes und Einladungslink, verwaltet über die Community-Seite.
- Auf
/communityservereinloggen und euren Server listen oder bearbeiten. - Banner, Beschreibung, Tags und Kategorien pflegen — Besucher finden euch über Suche und Votes.
- Mitgliederzahl und Invite-Link werden automatisch bzw. manuell gepflegt; Votes heben beliebte Server hervor.
- Besucher können einen Eintrag über „Melden“ markieren. Wir prüfen das und nehmen den Server bei einem Verstoß aus der Liste (Notice-and-Action).
Kartengenerierung
Welcome-, Farewell- und Moderations-Karten (Kick, Ban, Timeout) nutzen dasselbe Karten-System: Editor im Dashboard, Presets, Vorschau und GIF-/PNG-Hintergründe – je nach Server-Stufe.
Welcome-Nachrichten
Erstelle personalisierte Begrüßungen für neue Server-Mitglieder:
- Wähle einen Channel für Welcome-Nachrichten
- Lade ein Hintergrundbild oder GIF hoch (max. 5MB)
- Passe Text, Farben und Position an
- Nutze Placeholders wie
@user,@membercount - Aktiviere die Nachrichten und teste sie mit der Vorschau
GIFs werden automatisch optimiert: Max. 20 FPS, 3 MB Größe, 5 Sekunden Länge. Größere Dateien werden komprimiert.
Verfügbare Placeholders
GIF-Text (im Generator):
%user% ? Benutzername des neuen Mitglieds
%membercount% ? Aktuelle Mitgliederanzahl
Embed-Text (Titel, Beschreibung, etc.):
@user ? Benutzername
@membercount ? Mitgliederanzahl
@timestamp ? Aktuelles Datum und Uhrzeit
Nutze %placeholder% für Text im GIF selbst und @placeholder für Embed-Felder!
Farewell-Nachrichten
Verabschiede ausgehende Mitglieder mit derselben Karten-Logik wie Welcome: /farewell?guildId=… im Dashboard öffnen, Channel und Presets wählen, Vorschau nutzen.
Kick-, Ban- & Timeout-Karten
Analog zu Welcome-Cards kannst du für Kick, Ban und Timeout eigene Bilder generieren: Texte, Farben, Positionen und Vorschau – pro Vorgang ein eigener Editor.
Timeout-Karte
/timeout?guildId=…
Kick-Karte
/kick?guildId=…
Ban-Karte
/ban?guildId=…
Die Karten sind visuelle Templates für Ankündigungen. Die eigentlichen Moderations-Aktionen (z. B. /kick als Slash-Command) werden über die Commands-Seite gesteuert — siehe Abschnitt Commands (/commands).
Bedienung des Karten-Editors
- Oben zeigt eine Status-Leiste, ob ein Kanal gewählt ist, ob automatisch gesendet wird und ob alles gespeichert ist.
- Schnell-Stile setzen Schriften und Farben aller Texte, des Rahmens und des Hintergrunds mit einem Klick.
- Platzhalter-Knöpfe fügen %user%, %displayname%, %server% und %membercount% ein – in allen Kartentexten, auch für Kick, Ban und Timeout.
- Rahmen-Layout (optional): Bei Willkommen, Abschied, Kick, Ban und Timeout erscheinen Text, Karte und bis zu drei Link-Buttons (z. B. „Regeln“) zusammen in einem farbigen Rahmen. Die Karte selbst bleibt gleich – ohne Schalter ändert sich nichts.
- Der Zoom mit dem Mausrad bleibt beim Bearbeiten erhalten. Auf dem Handy passt die Vorschau immer auf den Bildschirm, und die Rahmen-Einstellungen nehmen ihr keinen Platz weg.
Stream Alerts
Erhalte automatische Benachrichtigungen, wenn deine Streamer live gehen auf Twitch, YouTube, Kick oder TikTok.
Unterstützte Plattformen
- Twitch: Voll unterstützt ✅
- YouTube: Voll unterstützt ✅
- Kick: Voll unterstützt ✅
- TikTok: Voll unterstützt ✅
Einrichtung
- Gehe zu
/streamsim Dashboard - Wähle einen Discord-Channel für die Alerts
- Füge Streamer hinzu (Username oder Kanal-URL)
- Passe die Embed-Nachricht an
- Aktiviere Stream-Nachrichten
Stream-Nachrichten werden automatisch aktualisiert, wenn der Stream endet. Du musst nichts manuell löschen!
Gut zu wissen
- Unterstützt werden Twitch, YouTube und TikTok. TikTok-Konten verbindest du per Anmeldung, mehrere Konten sind möglich.
- Die Live-Nachricht aktualisiert sich während des Streams (z. B. Zuschauer) und wird nach Stream-Ende entfernt oder angepasst.
- Rollen-Pings im Text sind echte Erwähnungen – so bekommen Mitglieder mit der Rolle eine Benachrichtigung.
- Neues Layout: Oben in der Vorschau der Streams-Seite umschalten – dann steht das Vorschaubild groß oben und ein „Jetzt ansehen“-Button sitzt direkt im Rahmen.
Content Posts
Teile automatisch neue Videos deiner Content-Creator auf deinem Discord-Server.
Funktionen
- Automatische Erkennung neuer Videos
- Individuelle Embeds pro Channel
- Thumbnail-Vorschau direkt in Discord
- Link-Embeds für Plattform-Preview
Unterstützte Plattformen
- YouTube: Voll unterstützt ✅
- Twitch: VODs & Highlights ✅
- TikTok: Voll unterstützt ✅
Content-Posts werden nur für neue Videos erstellt. Bereits gepostete Videos werden nicht erneut geteilt.
Gut zu wissen
- Neue Videos von YouTube, TikTok und Twitch-Clips werden automatisch gepostet – jedes Video nur einmal.
- Neue Inhalte werden regelmäßig geprüft (etwa alle 10 Minuten). Mit der manuellen Prüfung auf der Content-Seite geht es sofort.
- Das Embed zeigt Vorschaubild, Titel und einen Link-Button. Platzhalter wie @title oder @link setzen die Video-Daten ein.
Ticket-System
Mitglieder öffnen Tickets über dein eingebettetes Panel in Discord; das Team arbeitet in eigenen Ticket-Kanälen. Auf der Website richtest du das System ein – getrennt davon gibt es eine Web-Ansicht fürs Team, um alle Tickets zu sehen und zu bearbeiten.
Schnellzugriff
Einrichtungs-Reihenfolge
Einrichten (Website)
Unter /tickets?guildId=… richtest du Panel, Formulare und pro-Formular-Konfiguration ein. Die Oberfläche ist in Tabs gegliedert:
- Tab „Panel“: Embed-Nachricht mit Button oder Menü, Kanal wählen und Panel in Discord posten.
- Tab „Formulare“: Formulare anlegen, Felder definieren (Text, Auswahl, …) und Begrüßungs-Embed pro Formular.
- Tab „Ticket-Konfiguration“: Sidebar mit allen Formularen — pro Formular Kategorien (1→2→3), Team-Rollen, Limits und Schließen-Verhalten.
Formulare
Jedes Formular kann eigene Felder und einen Titel haben. Buttons im Panel können „Formular öffnen“ auslösen — Mitglieder füllen die Felder aus, bevor das Ticket angelegt wird.
- Im Tab „Formulare“ auf „Formular hinzufügen“ klicken und Titel sowie Felder festlegen (max. 5 Felder pro Formular).
- Im Panel-Tab Buttons mit Aktion „Formular öffnen“ verknüpfen und das passende Formular auswählen.
- Speichern und Panel erneut posten, wenn sich Formulare geändert haben.
Formularfelder können mehr als Text: Auswahllisten, Einfach- und Mehrfachauswahl, Ja/Nein-Häkchen, Nutzer-, Rollen- und Kanalauswahl sowie Datei-Uploads (z. B. Screenshots). Jedes Feld kann eine kurze Beschreibung bekommen; hochgeladene Dateien landen direkt im Ticket.
Ticket-Konfiguration (Sidebar)
Im Tab „Ticket-Konfiguration“ wählst du links ein Formular aus der Sidebar. Rechts erscheinen die Einstellungen nur für dieses Formular:
- Discord-Kategorien für neue Ticket-Kanäle (bis zu drei Ebenen).
- Support-Rollen, die Tickets sehen und bearbeiten dürfen.
- Limits (z. B. maximale offene Tickets pro Nutzer) und Transkript-Optionen.
- Auto-Löschen: Wartezeit nach Schließen — Schnellauswahl 1, 2, 3 oder 7 Tage oder eigene Angabe.
Auto-Löschen
Geschlossene Ticket-Kanäle können nach einer Wartezeit automatisch gelöscht werden. In der Ticket-Konfiguration pro Formular findest du Presets (1 / 2 / 3 / 7 Tage) oder stellst die Dauer manuell ein — praktisch, wenn euer Team Transkripte nutzt und Kanäle danach aufräumen möchte.
Unter „Schließen & Aufräumen“: Schnellauswahl per Preset-Buttons, Schieberegler und Stundenfeld — die gewählte Zeit gilt nur für das aktuell gewählte Formular in der Sidebar.
- Kategorien und Ziel-Kanäle pro Formular in der Ticket-Konfiguration wählen
- Panel-Nachricht (Embed) mit Button oder Menü im Tab „Panel“
- Optional: Transkripte, Auto-Löschen-Presets, Mod-Panel im Discord-Kanal posten
Ticket-Dashboard (für das Team)
Die Seite /tickets-dashboard ist die Übersicht für Moderation: Tickets filtern, übernehmen (claim), schreiben und schließen – inklusive Transkripte. Den Zugang bekommst du nur über einen kurz gültigen Link (z. B. von der Karte „Dashboard“ oder vom Mod-Panel); ist der Link abgelaufen, einfach einen neuen erzeugen.
Wo findest du was?
- Auf kynxbot.de/server unter „Ticket-System“: Tickets öffnet die Einrichtung, Dashboard erzeugt den Link zum Team-Dashboard.
- Im Discord-Mod-Panel: Tickets zeigt dir eine private Kurzübersicht, Dashboard denselben Web-Link. Wer die Buttons sieht, stellst du unter Mod-Panel → Berechtigungen ein (sonst: Discord „Mitglieder moderieren“).
Der Bot braucht in Ticket-Kanälen Schreibrechte und ggf. Rechte für Kanäle oder Threads – kurz testen, ob Anlegen und Schließen klappt.
Überblick & Tastatur
- Kennzahlen oben zeigen wartende und bearbeitete Tickets sowie die längste Wartezeit.
- Eine Ampel markiert lange Wartezeiten (gelb ab 1 Std., rot ab 12 Std.); Tickets lassen sich durchsuchen und sortieren.
- Tastatur: J/K wählen, Enter öffnen, C übernehmen, / sucht.
Giveaways
Giveaways werden pro Discord-Channel geplant: du gestaltest Embed und Nachricht wie in Discord, legst Dauer, Gewinnerzahl, Teilnahme (Button oder Reaktion), Bonus-Einträge und Rollen-Bedingungen fest – und startest oder planst den Lauf direkt aus dem Dashboard.
Einrichtung
- Öffne
/giveaways?guildId=…und wähle den Ziel-Channel - Titel, Beschreibung, Farbe und Bilder per Klick auf die Vorschau bearbeiten (wie auf der Embeds-Seite)
- Dauer, Gewinner und Teilnahmemethode in den Seitenleisten setzen
- Entwürfe speichern oder Giveaway starten; aktive Läufe erscheinen in der Übersicht
Beim Verlassen des Editors kannst du ungespeicherte Änderungen als Entwurf sichern. Beim Schließen des Browsers wird ebenfalls versucht, den Stand zu speichern.
Möglichkeiten
- Teilnahme per Button oder Reaktion, Countdown direkt im Embed.
- Bedingungen wie benötigte Rollen oder Mindest-Account-Alter; Bonus-Chancen für bestimmte Rollen.
- Mehrere Gewinner mit Preis-Pool oder Plätzen; Gewinner erhalten ihren Preis (z. B. Code oder Link) per DM.
- Gewinner-Rollen optional mit Ablaufzeit, maximale Gewinne pro Person, „Neu ziehen“ und Entwürfe zum späteren Starten.
- Neue Giveaways erscheinen im neuen Discord-Layout mit großem Bild oben und Teilnahme-Button im Rahmen. Unter „Nachrichten-Layout“ kannst du jederzeit auf das klassische Embed zurückschalten.
GitHub Auto-Posts
Verknüpfe ein GitHub-Konto per OAuth und wähle Repositories aus. KynxBot postet konfigurierbare Embeds in einen Discord-Channel, wenn es neue Commits oder passende Aktivität gibt – ideal für Entwickler-Communities.
Schritte
- Öffne
/github-updates?guildId=… - „Mit GitHub verbinden“ und Zugriff im GitHub-Dialog bestätigen
- Channel wählen und Repository aus der Liste auswählen
- Embed-Text, Farben und Verhalten anpassen und speichern
Die Verbindung gilt für deine Session; nur Repositories, auf die dein GitHub-Account Zugriff hat, können ausgewählt werden.
Tipps
- Private Repositories: einmal „Mit GitHub verbinden“ – die Verbindung bleibt für den Server gespeichert.
- Commits mit [intern] im Titel werden nicht gepostet – praktisch für interne Änderungen.
- Nachricht, Embed-Felder (Beschreibung, Autor, Commit-ID, Branch) und Bilder stellst du pro Kanal ein. Umbenannte Repositories werden erkannt.
- Bilder in Patchnotes: Schreib  in die Commit-Beschreibung und lade das Bild im selben Commit hoch – es erscheint im Update-Post. Neue Bilder im Ordner patchnotes/ kommen auch ohne Zeile mit. Bis zu 4 Bilder pro Commit; Ordner und Schalter stellst du pro Kanal ein.
Game Updates (Steam-News)
Poste offizielle Steam-News zu ausgewählten Spielen in einen Discord-Kanal: Patches, Events und Ankündigungen vom Steam-News-Feed – mit anpassbarem Embed, optionaler Nachricht darüber und bis zu vier zusätzlichen Embeds.
Einrichtung
- Öffne /game-updates?guildId=… im Dashboard (nach Auswahl deines Servers).
- „Channel hinzufügen“ und den Discord-Kanal wählen, in dem die Meldungen erscheinen sollen.
- „Spiele hinzufügen“: im Steam-Store suchen und die gewünschten Titel zur Liste hinzufügen.
- Schalter „Updates aktiv“ einschalten und unter „Posting“ festlegen, ob unter dem Post ein Link zur News erscheinen soll und ob primär Embed, Link oder beides genutzt wird.
- Unter „Steam-News-Embed“ Sprache und Store-Region für den Feed wählen sowie Felder (z. B. Autor, Zeitstempel) nach Bedarf ein- oder ausblenden.
- Optional: Kurznachricht und Zusatz-Embeds in der Live-Vorschau bearbeiten, anschließend „Speichern“.
Automatik und manueller Lauf
- Im Hintergrund prüft der Bot regelmäßig pro Spiel und Einstellung die Steam-News (typisch etwa alle 30 Minuten; der genaue Rhythmus kann serverseitig variieren).
- Pro Lauf wird höchstens die jeweils neueste Meldung berücksichtigt; bereits erfolgreich gepostete News wird nicht erneut gesendet.
- „Jetzt prüfen & senden“ startet dieselbe Logik sofort – praktisch nach manuell gelöschten Nachrichten oder zum Testen.
Link-Modi (Posting)
- Ohne Link unter dem Post: Steam-News als Embed (optional mit Text und Zusatz-Embeds darüber).
- Mit Link unter dem Post: Embed plus zweite Nachricht mit der News-URL.
- Nur Link ohne Steam-Embed: schlanke Nachricht mit der URL; Zusatz-Embeds werden in diesem Modus nicht mitgesendet.
Der Bot benötigt im Zielkanal die Berechtigung, Nachrichten und Embeds zu senden. Wenn nichts ankommt, prüfe „Updates aktiv“, die Spieleliste und ob der Kanal noch existiert.
Indicators
Indicators zeigen Live-Kennzahlen als Discord-Embed in einem Kanal deiner Wahl. Der Bot aktualisiert dieselbe Nachricht im Hintergrund – ohne Spam mit neuen Posts. Du kombinierst Krypto-Kurse, Discord-Server-Statistiken und KynxBot-Metriken (Premium, Streams, Content usw.) in einem oder mehreren Indicator-Posts pro Kanal.
Einrichtung
- Öffne
/indicators?guildId=…(Server-Dashboard → Kategorie mit Embeds/Streams → Karte „Indicators“). - „Channel“ hinzufügen und den Discord-Textkanal wählen, in dem die Indicator-Nachrichten erscheinen sollen.
- „Neuer Post“: Titel setzen, Anzeige-Style wählen (Ticker, Karten, Grid oder Minimal) und Aktualisierungsintervall (5, 15, 30 oder 60 Minuten).
- Indikatoren hinzufügen: Krypto (Suche nach Name, Symbol oder Vertragsadresse; EUR/USD), Discord (Mitglieder, Online, Boosts, Channels, Rollen-Mitglieder …) oder KynxBot (Whitelabel, Premium, Feature-Liste, Stream-/Content-Setups).
- Optional Thumbnail: bei einem Krypto-Wert oft automatisch das Coin-Logo; sonst eigenes Bild hochladen.
- „Veröffentlichen“ (ein Post) oder „Veröffentlichen“ in der Übersicht (alle Posts des Kanals) – die Live-Vorschau zeigt das Embed wie in Discord.
Anzeige & Sortierung
- Ticker: kompaktes Mehrzeilen-Layout (bis zu drei Werte pro Zeile).
- Karten / Grid / Minimal: Felder oder Listen – Grid nutzt drei Spalten (sinnvoll bis ca. 25 Werte).
- Mehrere Posts pro Kanal möglich; Reihenfolge per Drag & Drop in der Übersicht.
- Entwürfe bleiben lokal, bis du veröffentlichst; veröffentlichte Posts tragen das Badge „Live“.
Aktualisierung
- Nach dem Veröffentlichen bearbeitet der Bot die bestehende Nachricht im Intervall (kein neuer Post pro Update).
- Wurde die Nachricht in Discord gelöscht, legt der Bot beim nächsten Lauf bei Bedarf eine neue an.
- Änderungen am Post speichern und erneut veröffentlichen, um Inhalt und Intervall sofort zu übernehmen.
Zugriff & Berechtigungen
Wer die Seite /indicators und die Karte im Server-Dashboard sehen darf, steuerst du wie bei anderen Modulen im Admin-Panel unter Rang-Berechtigungen („Indicators“). Server-Admins und KynxBot-Team-Ränge haben standardmäßig Zugriff.
Der Bot braucht im Zielkanal „Nachrichten senden“ und „Nachrichten verwalten“ (zum Bearbeiten der Indicator-Nachricht). Bei Krypto-Indikatoren werden Kurse extern abgerufen – bei Server- und KynxBot-Werten zählen die aktuellen Discord- bzw. Dashboard-Daten.
KynxGuard – automatische Moderation
KynxGuard prüft jede neue Nachricht nach den Regeln deines Servers – ohne KI und ohne Kosten. Du findest es im Mod-Dashboard unter „KynxGuard“.
Regeln
- Nachrichten-Flut und wiederholte Nachrichten (Spam)
- Fremde Discord-Einladungen und Links (mit Liste erlaubter Seiten)
- GROSSBUCHSTABEN, Massen-Erwähnungen, Emoji-Flut
- Verbotene Wörter – erkennt auch Schreibweisen wie
1d10toderi.d.i.o.t;scam*trifft jede Endung
Was passiert automatisch?
Pro Regel wählst du: nur löschen, löschen + Verwarnung oder löschen + Timeout (höchstens 60 Minuten). Kick, Ban und längere Timeouts macht KynxGuard nie allein: Fällt jemand mehrfach auf, legt es einen Vorschlag an, den ein Mod unter „Fälle“ mit einem Klick bestätigt oder verwirft.
Mods und Admins (Recht „Nachrichten verwalten“), der Server-Eigentümer, Bots und Webhooks werden nie geprüft. Weitere Rollen, Kanäle und Kategorien kannst du ausnehmen.
Fälle & Beweise
Jeder Eingriff wird als Fall mit Regel, Kanal und Maßnahme gespeichert. Den Text der entfernten Nachricht hebt KynxGuard als Beweis 30 Tage auf, danach wird er gelöscht; der Fall selbst bleibt 12 Monate. Optional postet KynxGuard jeden Fall in einen Protokoll-Kanal und informiert das Mitglied per DM.
Unter „Testen“ kannst du eine Beispiel-Nachricht prüfen lassen, ohne dass auf dem Server etwas passiert.
Benötigte Rechte für den Bot: Nachrichten verwalten und Mitglieder stummschalten; für bestätigte Vorschläge zusätzlich Kicken bzw. Bannen.
Premium: Schutz, KI & Statistik
- Raid-Schutz: Treten sehr viele Konten in kurzer Zeit bei, bekommen neue Mitglieder automatisch einen Timeout (höchstens 60 Min.). Alle Raid-Konten lassen sich unter „Fälle“ mit einem Klick kicken. Optional auch für sehr neue Konten.
- Nuke-Schutz: Löscht jemand viele Kanäle oder Rollen, schlägt KynxGuard Alarm, warnt den Server-Eigentümer per DM und schlägt vor, dem Täter alle Rollen zu entziehen (braucht „Audit-Log anzeigen“ und „Rollen verwalten“).
- KI-Zweitmeinung: Zu jedem Strafvorschlag schätzt eine KI kurz ein, ob die Strafe angemessen ist – gekennzeichnet als „KI-generiert“, ohne Namen oder IDs, höchstens 100 pro Tag. Die Entscheidung trifft immer dein Team.
- Statistik: Fälle pro Tag, häufigste Regeln, auffälligste Mitglieder und unruhigste Kanäle.
Auto-Veröffentlichen
In Ankündigungskanälen kann Discord Nachrichten „veröffentlichen“: Alle Server, die dem Kanal folgen, bekommen sie dann automatisch in einen eigenen Kanal. Auto-Veröffentlichen erledigt das für jede neue Nachricht – auch für Beiträge, die KynxBot selbst postet (Spiele- und Schnell-Updates, Embeds, Ankündigungen, API).
Einrichtung
- Server-Dashboard → Karte „Auto-Veröffentlichen“ öffnen.
- Beim gewünschten Ankündigungskanal den Schalter einschalten. Normale Textkanäle erscheinen nicht – mach sie in Discord unter Kanal bearbeiten → Übersicht → Ankündigungskanal zu einem.
- Wählen, was veröffentlicht wird: alle Nachrichten, nur Bots & Webhooks (Standard) oder nur Mitglieder mit bestimmten Rollen.
- Optional ein Ausnahme-Präfix wie
!nopublisheintragen – Nachrichten, die so beginnen, bleiben unveröffentlicht.
Limit: 10 pro Stunde und Kanal
Discord erlaubt höchstens 10 Veröffentlichungen pro Stunde und Kanal. Das Dashboard zeigt live, wie viele in der letzten Stunde schon veröffentlicht wurden und wann der nächste Platz frei wird. Ist das Limit voll und „Bei vollem Limit nachholen“ an (Standard), kommt die Nachricht in eine Warteschlange und wird automatisch veröffentlicht, sobald wieder Platz ist – höchstens 60 Minuten lang. Wird eine wartende Nachricht gelöscht, fällt sie aus der Warteschlange.
Benötigte Rechte
- Kanal ansehen und Nachrichten senden – immer.
- Nachrichten verwalten – für Nachrichten von anderen (Mitglieder, andere Bots, Webhooks).
Fehlt etwas, zeigt das Dashboard den Kanal als „Blockiert“ mit dem genauen Recht an. Jeder Vorgang steht im Verlauf (letzte 20 Einträge) mit Link zur Nachricht.
Kanal folgen (für andere Server)
- Im Ankündigungskanal oben auf Folgen klicken.
- Den eigenen Server und den Zielkanal wählen und bestätigen.
- Ab jetzt erscheint jede veröffentlichte Nachricht automatisch auch dort.
Per API: GET/PATCH /api/v1/settings/autopublish (siehe KynxBot-Funktionen per API).
Auto-Rolle
Rollen können neuen Mitgliedern automatisch beim Beitritt zugewiesen werden. Die Einstellung findest du im Server-Einstellungsfenster (Zahnrad) auf der Seite „Server“, nachdem du einen Server ausgewählt hast.
- Auf
/serverden gewünschten Server öffnen - Zahnrad (Server-Einstellungen) öffnen
- Auto-Rolle aktivieren und eine oder mehrere Rollen wählen (getrennt nach Bot- und Nutzer-Kontext, je nach Angebot)
Mod-Panel
Das Mod-Panel stellt Moderatoren eine übersichtliche Oberfläche bereit – typischerweise gebunden an einen Channel und an deine Rollenrechte.
- Im Server-Einstellungsfenster (Zahnrad) den Mod-Panel-Channel setzen oder über die Mod-Panel-Verwaltung
- Berechtigungen für Moderatoren-Rollen prüfen (wer das Panel nutzen darf)
- Nach dem Speichern kann das Panel im Discord genutzt werden — inklusive Buttons für Ticket-Dashboard und Mod-Dashboard
Was das Panel zeigt
- Aktive Warns, offene Tickets, Aktionen dieser Woche im Vergleich zur Vorwoche, Gesamtzahlen und die letzte Aktion – live aktualisiert.
- Darstellung als Embed oder als Bild mit eigenem Design (Farben, Hintergrund, Größen).
- Buttons: Verwarnungen verwalten, Nutzer-Info, Historie, Aktualisieren sowie Links ins Mod- und Ticket-Dashboard. Antworten sieht nur, wer klickt.
- Nach einer Verwarnung erhält das Mitglied eine DM; das Team sieht, ob sie zugestellt wurde.
Mod-Dashboard
Das Mod-Dashboard ist die webbasierte Moderations-Zentrale: Warns, interne Notizen, Kick, Ban, Timeout, User-Profile und Aktivitäts-Historie — alles in einer Oberfläche neben dem Discord-Mod-Panel.
Das Mod-Panel ist ein Embed mit Buttons im Discord-Kanal (Tickets, User-Info, Session-Links). Das Mod-Dashboard ist die vollständige Team-Webansicht zum Ausführen und Nachverfolgen von Moderations-Aktionen.
Zugang & Session
Der Zugang erfolgt nur über einen kurz gültigen Session-Link — nicht durch direktes Öffnen von /mod-dashboard ohne Token.
- Im Server-Dashboard die Karte „Mod-Dashboard“ (erzeugt einen neuen Session-Link)
- Im Discord-Mod-Panel den Button „Mod-Dashboard“ (ebenfalls Session-Link)
- Der Link ist einmal verwendbar und läuft nach einer Stunde ab — bei Bedarf einfach einen neuen Link erzeugen
Berechtigungen
Wer einen Session-Link erhalten darf, steuerst du an zwei Stellen: unter Mod-Panel → Berechtigungen die Rolle „Mod-Dashboard“ sowie im Server-Dashboard die Seiten-Berechtigung für mod-dashboard. Ohne passende Discord-Rechte (z. B. „Mitglieder moderieren“) schlagen Aktionen fehl.
Funktionen
- Übersicht: Statistiken, letzte Aktivität, Schnellaktionen und Ticket-Hinweis
- Warns: Verwarnungen vergeben, entfernen und im User-Profil einsehen
- Notizen: interne Vermerke zu Mitgliedern (nur für das Team sichtbar)
- Kick, Ban, Timeout: Aktionen ausführen, aktive Strafen und Historie einsehen
- User-Profil: Mitglied suchen — Warns, Notizen und Historie auf einen Blick
Für Ticket-Bearbeitung (Claim, Antworten, Schließen) nutze das separate Ticket-Dashboard — das Mod-Dashboard zeigt in der Übersicht nur einen kompakten Ticket-Überblick.
Funktionen im Überblick
- Übersicht mit Kennzahlen, Aktivitätsdiagramm, „Braucht Aufmerksamkeit“ und Team-Aktivität.
- Nutzerprofile öffnen sich als Seitenpanel mit Verlauf, Warns, Notizen und Risiko-Einstufung.
- Alle Listen – auch die Mitgliederliste – lassen sich filtern, sortieren und als CSV exportieren. Mehrere Einträge kannst du auswählen und gemeinsam bearbeiten, z. B. Warns entfernen, Timeout, Kick oder Ban.
- Strg+K öffnet die Befehlspalette, „?“ zeigt alle Tastenkürzel.
Bot-Assistent (KI)
Im rechten Bereich der Server-Einstellungen (Zahnrad auf „Server“) kannst du den KI-Assistenten aktivieren. Er nutzt die KynxBot-KI-Modelle – oder, falls eingerichtet, das eigene KI-Modell eures Servers (siehe „KI-Modelle & Anbieter“).
Der Bot-Assistent antwortet auf @Erwähnungen und Antworten im Textkanal. Voice-KI ist Sprache im Voice-Channel. Channel-/Rollen-Editor-KI erzeugt Pläne für Struktur — drei getrennte Module.
Wann antwortet der Bot?
Der Bot reagiert, wenn jemand @KynxBot erwähnt oder auf eine Bot-Nachricht antwortet. Als Kontext dienen deine Nachricht und bei Bedarf die vorherige Bot-Nachricht.
Einstellungen
- Persönlichkeit & Stil (optional): Freitext bis 2000 Zeichen – z. B. Tonfall, Du/Sie, Themenschwerpunkte.
- Auf @Erwähnungen antworten und Auf Antworten auf Bot-Nachrichten antworten können einzeln aktiviert werden.
- Bilder bei Aufforderung (wie /imagine): optional abschaltbar.
- Websuche für Fakten: optional, für aktuelle Informationen.
- Max. Antwortlänge (400–2000 Zeichen) und Kreativität (Schieberegler 0 = sachlich bis 1 = kreativer).
- Optional: die letzten zehn Kanal-Nachrichten (vor deiner Anfrage) als zusätzlicher Kontext für die KI — im Server-Einstellungsfenster per Schalter aktivierbar.
Eigenes KI-Modell
- Hat euer Server unter „KI-Modelle & Anbieter“ ein eigenes Modell für den Bot-Assistenten gewählt, antwortet der Bot damit. Solche Antworten sind im Chat mit einem kleinen Hinweis gekennzeichnet.
- Klappt der eigene Key nicht, sagt die Fehlermeldung Admins direkt, wo sie ihn prüfen können. Tageslimits für eure Mitglieder legt ihr im selben Fenster fest.
Änderungen werden mit „Speichern“ im Server-Einstellungsfenster übernommen. Ohne aktivierten Schalter bleibt der Assistent aus.
KI-Modelle & Anbieter
Standardmäßig nutzen alle KI-Funktionen die KynxBot-Modelle. Server-Admins können in den Server-Einstellungen unter „Verwaltung & KI“ → „KI-Modelle & Anbieter“ eigene API-Keys von Anthropic, OpenAI oder Google hinterlegen und für einzelne Funktionen ihr eigenes Modell wählen. Die Kosten laufen dann über euer Konto beim Anbieter.
Einrichtung
- Server-Einstellungen öffnen und unter „Verwaltung & KI“ auf „KI-Modelle & Anbieter“ klicken.
- Bei „Eigene Anbieter“ den API-Key einfügen und speichern. KynxBot prüft den Key direkt beim Speichern.
- Bei „Modell je Funktion“ für jede Funktion „Plattform (KynxBot)“ oder dein eigenes Modell wählen. Fehlt ein Modell in der Liste, kannst du den Namen auch selbst eintragen.
- Mit „Speichern“ übernehmen. Entfernst du später einen Key, nutzen die betroffenen Funktionen automatisch wieder die KynxBot-Modelle.
Welche Funktionen?
- Eigenes Modell möglich: Bot-Assistent, Editor-KI (Kanal- und Rollen-Editor, Karten-Designs), Texte verbessern („KI verbessern“), Bilder und Videos.
- Audio (/createaudio) läuft aktuell nur mit den KynxBot-Modellen.
- Antworten des Bot-Assistenten vom eigenen Modell tragen im Chat den Hinweis „Antwort vom eigenen KI-Modell dieses Servers“.
Limits für deine Community
- KynxBot-Modelle: Es gelten die Tageskontingente deines Tarifs (Free oder Premium).
- Eigene Modelle: Keine KynxBot-Kontingente. Für Bot-Assistent, Bilder und Videos legst du selbst Tageslimits fest – pro Server und pro Mitglied. Sind beide gesetzt, gilt das, was zuerst erreicht ist.
- Leeres Feld = unbegrenzt. Fehlgeschlagene Anfragen zählen nicht. Alle Limits starten um Mitternacht (deutsche Zeit) neu.
- Im Fenster siehst du, wie viel heute schon genutzt wurde, und deine Plattform-Kontingente.
Mit eigenem Modell gehen die Eingaben dieser Funktion direkt an deinen Anbieter. Den Vertrag mit dem Anbieter schließt du selbst und bist dafür verantwortlich (Datenschutz, ggf. AVV). Details stehen in den AGB unter 4.5.
API Integration
Premium-Server können ihren Preferred-Bot (Whitelabel wenn aktiv, sonst KynxBot) per REST-API steuern, Discord-Events per signiertem Webhook empfangen und eigene Slash-Commands registrieren. Einrichtung im Server-Einstellungsfenster (Zahnrad) unter „API Integration“.
Preferred-Bot
Alle API-Aktionen und Event-Webhooks nutzen denselben Bot wie der Server: Whitelabel, falls in den Settings aktiv und online — sonst KynxBot. So funktioniert die Integration auch, wenn nur der Whitelabel-Bot auf dem Server ist.
Authentifizierung
Öffentliche Endpunkte unter /api/v1. Header: Authorization: Bearer kynx_live_…. Jeder Schlüssel ist an genau eine Guild gebunden; Scopes steuern die Rechte.
Endpunkte (Auswahl)
GET /me— Key-Info, Guild, ScopesPOST /channels/:id/messages— Nachricht senden (messages:send), klassisch oder im neuen Layout; Antwort enthält die komplette Nachricht inkl.idPATCH /channels/:id/messages/:messageId— vom Bot gesendete Nachricht bearbeiten, Body{"content": "…", "embeds": [...]}(messages:send)DELETE /channels/:id/messages/:messageId— Nachricht löschen: eigene Bot-Nachrichten mitmessages:send, fremde mitmessages:manageGET /channels/:id/messages/:messageId— Nachricht abrufen (eigene mitmessages:send, alle mitmessages:read)GET /channels/:id/messages?limit=50&before=…— Verlauf lesen, max. 100 (messages:read)PUT/DELETE /channels/:id/pins/:messageId— Nachricht anheften/lösen (messages:manage)GET /channels— Kanäle auflisten (channels:read)GET /roles,POST/DELETE /members/:userId/roles/:roleId— Rollen (roles:*)GET /members/:userId(members:read),POST /members/:userId/timeout|kick|ban(moderation:*)GET/POST/DELETE /commands— Integration-Commands (commands:manage)GET/POST/DELETE /subscriptions— Webhooks (events:subscribe)POST /interactions/:token/callback— Antwort auf weitergeleitete Slash-Commands, Button-Klicks und Auswahlmenüs
Rollen, Spitznamen & Kanäle verwalten
GET /roles/:roleId(roles:read) ·POST /roles,PATCH /roles/:roleId,DELETE /roles/:roleId(roles:manage) — Felder:name,color("#RRGGBB"oder Zahl),hoist,mentionable,permissions(Namen wie["SendMessages","AttachFiles"]oder Bitfeld-Text),unicode_emoji,positionGET /members?limit=100&after=…oder?query=name— Mitglieder auflisten/suchen (members:read)PATCH /members/:userIdmit{"nick": "Neuer Name"}— Spitzname setzen,nullentfernt ihn;/members/@meändert den Bot-Spitznamen (members:manage)GET /channels/:id(channels:read) ·POST /channels,PATCH /channels/:id,DELETE /channels/:id(channels:manage) — Felder:name,type(text,voice,category,announcement,stage,forum; nur beim Anlegen),topic,nsfw,rate_limit_per_user,parent_id,position,bitrate,user_limit,permission_overwritesPUT /channels/:id/permissions/:roleOderUserIdmit{"type": "role"|"member", "allow": [...], "deny": [...]}·DELETEentfernt die Überschreibung (channels:manage)
Der Bot kann nur Rollen und Mitglieder unterhalb seiner eigenen höchsten Rolle ändern (Antwort 403 role_hierarchy); den Spitznamen des Server-Inhabers erlaubt Discord Bots nicht. Discord erlaubt pro Kanal nur zwei Umbenennungen in 10 Minuten – darüber hinaus antwortet die API mit 202 queued und die Änderung wird nachgeholt. Die Rechte eines bestehenden Schlüssels lassen sich im Dashboard unter „API Integration“ → „Rechte ändern“ anpassen, ohne einen neuen Schlüssel zu erstellen.
Dateien & Bilder
Senden (POST) und Bearbeiten (PATCH) von Nachrichten nehmen Dateien im Discord-üblichen Format an: multipart/form-data mit dem Nachrichten-JSON im Teil payload_json und den Dateien als files[0], files[1], … (max. 10 Dateien, zusammen max. 25 MB). In Embeds kannst du mit attachment://dateiname.png auf eine hochgeladene Datei verweisen; über "attachments": [{"id": 0, "filename": "…", "description": "…"}] setzt du Dateiname und Beschreibung.
curl -X POST https://kynxbot.de/api/v1/channels/CHANNEL_ID/messages \
-H "Authorization: Bearer kynx_live_…" \
-F 'payload_json={"content":"Neues Bild","embeds":[{"image":{"url":"attachment://bild.png"}}]}' \
-F "files[0]=@bild.png"
Beim Bearbeiten ersetzen neue Dateien die bisherigen. Bestehende Anhänge behältst du, indem du sie in "attachments": [{"id": "…"}] aufführst; "attachments": [] ohne neue Dateien entfernt alle. Antworten enthalten zu jedem Anhang url, content_type, size, width und height (bei Bildern) – Embed-Bilder aus Anhängen bekommen dieselben Angaben.
Webhook-Abos per API
POST /subscriptions mit {"target_url": "https://…", "event_types": ["message.create", "interaction.component"]} (Alternativ-Namen url/events werden ebenfalls akzeptiert; ohne event_types gibt es alle Events). Unbekannte Event-Namen werden mit der Liste der erlaubten Werte abgelehnt. Das Signing-Secret steht nur in der Antwort beim Anlegen.
Buttons & Auswahlmenüs
Beim Senden oder Bearbeiten kannst du components mitschicken (Discord-Format: Action-Rows mit Buttons oder Auswahlmenüs, max. 5 Reihen à 5 Elemente, custom_id max. 94 Zeichen). Link-Buttons (style: 5) brauchen nur eine url.
{"content": "Benachrichtigungen",
"components": [{"type": 1, "components": [
{"type": 2, "style": 3, "label": "An", "custom_id": "notify_toggle"}
]}]}
Klickt jemand darauf, bestätigt KynxBot den Klick sofort und schickt das Event interaction.component an deine Webhooks (auch an Webhooks, die interaction.command abonniert haben). Es enthält interaction_token, custom_id, component_type, values (bei Menüs), user, member_roles und die message samt aktuellen Buttons.
Antworten (innerhalb von 15 Minuten, mehrfach möglich) mit POST /interactions/:token/callback:
{"type": "update", "components": [...], "content": "…"}— die Nachricht mit dem Button ändern, z. B. „An“ → „Aus“ umschalten (Standard bei Buttons){"type": "reply", "content": "…", "ephemeral": true}— zusätzliche Antwort, mitephemeralnur für den Klickenden sichtbar{"type": "message", …}— bei Slash-Commands die Antwort setzen (Standard bei Commands)
KynxBot-Funktionen per API (für Agenten)
Statt eigene Bots oder eigenen Code zu bauen, nutzt eine Integration die fertigen KynxBot-Systeme – gehostet, gepflegt und im Dashboard sichtbar. GET /features liefert den Katalog mit Zweck, wichtigsten Aufrufen und Beispielen. Jeder Funktionsbereich ist unter /features/<bereich>/<pfad> erreichbar und nutzt intern dieselben Dashboard-Routen, inklusive Rechte- und Premium-Prüfung (settings:read für Lesen, settings:write für Ändern; aktives Premium nötig).
tickets– komplette Ticketsysteme:GET /features/tickets/templates,POST /features/tickets/tickets/apply-template, Panels speichern und senden, Tickets schließen, Statistik, Kurzantwortenembeds– gestaltete Nachrichten mit Knöpfen und Reaktionsrollen; ein Schritt:POST /features/embeds/poststreams,content– Live-Benachrichtigungen und Content-Posts (Twitch, YouTube, Kick, TikTok)github-updates,game-updates,birthdays,indicators,leveling,reminders,referral,mod-panel,community,banner,server
curl -X POST https://kynxbot.de/api/v1/features/embeds/post \
-H "Authorization: Bearer kynx_live_…" -H "Content-Type: application/json" \
-d '{"channel_id":"CHANNEL_ID","name":"Rollen","embeds":[{"title":"Wähle deine Rollen",
"description":"🎮 Gamer\n🎨 Künstler","color":"#5865f2","layout":"modern",
"buttons":[{"type":"reaction-role","emoji":"🎮","roleId":"ROLE_ID"},
{"type":"reaction-role","emoji":"🎨","roleId":"ROLE_ID_2"}]}]}'
Nicht über die API erreichbar sind Bot-Tokens, KI-Schlüssel, API-Schlüssel und Sitzungen. Im Dashboard unter „API Integration“ findest du eine fertige Anleitung zum Kopieren, die deinem KI-Agenten genau das erklärt.
Neues Discord-Layout (Components V2)
Nachrichten im neuen Layout bestehen aus Bausteinen statt Embeds: ein Rahmen (container) mit Akzentfarbe, Texten, Bildern, Trennlinien und Knöpfen direkt im Kasten. Senden, Bearbeiten und Klick-Antworten unterstützen das Layout. Du hast drei Möglichkeiten:
- Bequem:
"layout": "modern"zusammen mit deinenembeds(und optional Button-Reihen incomponents) – KynxBot baut daraus automatisch einen Rahmen mit Titel, Text, Feldern, Bildern als Galerie und den Knöpfen im Kasten. - Selbst gebaut:
"components_v2": true(oder wie bei Discord"flags": 32768) und die Bausteine incomponents. - Typen gehen als Zahl oder Name:
container(17),text_display(10),section(9, 1–3 Texte +accessory:thumbnailoder Knopf),media_gallery(12, 1–10 Bilder),file(13, nurattachment://),separator(14,spacing1 oder 2), Action-Row (1) mit Knöpfen/Menüs.
{"components_v2": true,
"components": [{"type": "container", "accent_color": "#5865f2", "components": [
{"type": "text_display", "content": "## 🔴 Jetzt live\nKomm vorbei!"},
{"type": "media_gallery", "items": [{"media": {"url": "https://…/vorschau.png"}}]},
{"type": "separator", "spacing": 2},
{"type": "section",
"components": [{"type": "text_display", "content": "**Stream ansehen**"}],
"accessory": {"type": "button", "style": 5, "label": "Öffnen", "url": "https://twitch.tv/…"}},
{"type": 1, "components": [{"type": 2, "style": 1, "label": "Erinnern", "custom_id": "remind"}]}
]}]}
{"layout": "modern",
"embeds": [{"title": "Neues Update", "description": "Das ist neu", "color": 16746496,
"image": {"url": "https://…/bild.png"}}],
"components": [{"type": 1, "components": [
{"type": 2, "style": 5, "label": "Changelog", "url": "https://…"}]}]}
Regeln von Discord, die die API vorab prüft (Antwort 400 mit genauer Stelle, z. B. components[0].components[3]):
- Kein
contentund keineembedszusammen mit selbst gebauten Bausteinen – Text gehört intext_display. - Höchstens 40 Bausteine pro Nachricht (verschachtelte mitgezählt) und 4.000 Zeichen Text insgesamt.
- Bilder nur über
https://oder hochgeladene Dateien (attachment://name.png, siehe „Dateien & Bilder“). - Ein Auswahlmenü steht allein in seiner Action-Row, Knöpfe höchstens 5 pro Reihe.
- Bearbeiten: Eine Nachricht bleibt in ihrem Layout. Eine klassische Nachricht lässt sich nicht in das neue Layout umbauen (Antwort
409 layout_mismatch) – dann löschen und neu senden.
Antworten enthalten components_v2: true und flags; Knöpfe und Menüs im Rahmen lösen wie gewohnt interaction.component aus. Mit POST /interactions/:token/callback und "components_v2": true kannst du auch Klick-Antworten im neuen Layout senden ("type": "update" nur für Nachrichten im neuen Layout, "type": "reply" jederzeit, mit "ephemeral": true nur für den Klickenden).
Modul-Einstellungen & Giveaways
Die Einstellungen von KynxBot-Modulen lassen sich per API lesen und ändern – mit denselben Prüfungen und Premium-Grenzen wie im Dashboard. PATCH ändert nur die mitgeschickten Felder, alles andere bleibt erhalten.
GET /settings— verfügbare Module (settings:read)GET /settings/:modul— Einstellungen lesen (settings:read)PATCH /settings/:modul— Einstellungen ändern (settings:write)GET /giveaways,POST /giveaways(mit"start": truesofort posten) (giveaways:manage)POST /giveaways/:id/end|reroll|cancel|pause|resume|extend|start(giveaways:manage)
Module: leveling, welcome, farewell, kick, ban, timeout
curl -X PATCH https://kynxbot.de/api/v1/settings/leveling \
-H "Authorization: Bearer kynx_live_…" \
-H "Content-Type: application/json" \
-d '{"settings":{"enabled":true}}'
Webhook-Events & Signatur
Events: u. a. message.create, member.join, member.remove, interaction.command. POST an deine URL mit X-Kynx-Timestamp und X-Kynx-Signature (HMAC-SHA256 über timestamp + "." + body). Signing-Secret wird beim Anlegen einmalig angezeigt.
Eigene Commands kollidieren nicht mit Built-ins. Webhook-Zustellung läuft asynchron mit Queue und Timeouts — Ausfälle blockieren den Bot nicht. Private/localhost-URLs werden abgelehnt. Nach 10 Fehlversuchen wird ein Webhook deaktiviert. Rate-Limits: ca. 120 Req./Min. pro Schlüssel (+ Burst), zusätzlich Guild-Limit; max. 10 Webhooks und 25 Commands pro Server.
Leveling
Das Leveling-System ist als Season-Pass für deinen Server gebaut: Wizard-Setup, Game HQ, Prestige, Quests, Shop und ein öffentliches interaktives Leaderboard unter /lb/<guildId>.
Öffentliches Leaderboard
Premium-Server können die öffentliche Seite aktivieren. Link teilen — ohne Login. Privacy-Settings können Namen anonymisieren oder das Board verstecken.
Free und Premium
Es zählt nur der Rang des Servers. Free: XP für Nachrichten, Sprache, Reaktionen und Streak, 10 Belohnungsstufen, eigener Level-up-Text, 6 Kartenvorlagen und /leaderboard mit Seiten und Zeitraum. Premium: alle XP-Quellen (auch Threads, Befehle, Einladungen), unbegrenzte Belohnungen inkl. Kanälen, Karten-Designer mit eigenem Hintergrund, GIF und KI-Design, angepinnter Live-Post, öffentliche Web-Rangliste, Prestige, Saisons, Quests, Münzen-Shop, Boosts, Import aus anderen Bots und der Verlauf je Mitglied.
Umzug von einem anderen Bot
Im Dashboard unter „Mitglieder“ holst du Level und XP direkt aus MEE6 (Rangliste muss öffentlich sein) oder aus einer CSV-/JSON-Datei von Arcane, Amari, Lurkr, Tatsu und anderen. Mit „Gleiches Level“ landet jedes Mitglied auf seinem bisherigen Level, Belohnungsrollen werden nachgetragen. Vorher wird eine Sicherung angelegt – 7 Tage lang kannst du den Import rückgängig machen.
Commands
/rank·/level— Rangkarte mit Platz und nächster Belohnung/leaderboard— Discord-Rangliste inkl. Link zur Web-Seite/prestige·/quests·/shop— Premium Game-Features
Befehle & Funktionen
- /level oder /rank – eigenes Level mit Fortschritt als Banner (auch für andere Mitglieder).
- /leaderboard – Bestenliste des Servers. Zusätzlich gibt es eine öffentliche Web-Bestenliste mit eigenem Design.
- /quests (Premium) – tägliche und wöchentliche Aufgaben mit Belohnung; /shop (Premium) – Münzen gegen Belohnungen eintauschen (Münzen sammelst du nebenbei mit deinen XP, dein Level sinkt dabei nicht).
- /prestige (Premium) – ab einem Ziel-Level das Level zurücksetzen und einen Prestige-Rang aufsteigen.
- Im Dashboard: XP-Regeln, Rollen-Belohnungen, Saisons, Level-Up-Nachricht und eigene Banner-Hintergründe (Bild oder GIF) festlegen. Prestige, Quests und Shop lassen sich einzeln ein- und ausschalten.
- /setxp – Moderatoren können XP eines Mitglieds korrigieren.
- Server-Tag-Bonus: Wer den Server-Tag eures Servers im Discord-Profil trägt, kann mehr XP bekommen (z. B. +10 %). Den Bonus schaltest du auf der Leveling-Seite bei der XP-Kurve ein.
- Neue öffentliche Web-Bestenlisten zeigen Mitglieder zuerst ohne Namen – Admins können die Namen im Leveling-Dashboard einschalten. Mitglieder können sich mit /privacy selbst in der Web-Bestenliste verbergen.
Karten-Designer
- Im Reiter „Karten-Designer“ wählst du aus 14 KynxBot-Stilen (z. B. Synthwave, Galaxie, Royal oder Evolution) und passt Farben, Texte und Hintergrundbild an.
- Im Baukasten gestaltest du eine komplett eigene Karte: Format, Anordnung, Hintergrund, Rahmen, Avatar, Level-Anzeige, Texte, Info-Chips und Effekte.
- Mit Regeln bekommen einzelne Level, Levelbereiche, „alle X Level“ oder Meilensteine ein eigenes Design. Für alle übrigen Level gilt ein Standard – fest, abwechselnd oder zufällig.
- Die /level-Karte kann klassisch bleiben, das Design des aktuellen Levels nutzen oder ein festes Design – jeweils mit Fortschrittsleiste.
- „In Discord testen“ sendet die Karte aus dem Editor einmal in einen Kanal deiner Wahl. Der Einrichtungs-Check in der Übersicht zeigt, was noch fehlt.
- Animierte Karten: Glanz, Funkeln, Leuchten oder Konfetti – für alle Level-Ups oder nur für Meilensteine. Die Karte wird dann als GIF gepostet, auch bei /level.
- KI-Design: Beschreibe im Dialog „Neues Design“ einfach deine Idee (z. B. „Neon-Cyberpunk in Pink und Türkis“) und die KI baut daraus eine fertige Karte, die du weiter anpassen kannst.
Voice-KI
Die Voice-KI verbindet Sprachgespräche im Discord-Voice mit einer Sprach-KI – standardmäßig Google Gemini Live, mit eigenem API-Key auch andere Anbieter. Mitglieder starten über eine öffentliche Karte im festgelegten Textkanal; die gesamte Einrichtung läuft in den Server-Einstellungen (Zahnrad) auf der Website – analog zum Bot-Assistenten.
Ablauf für Mitglieder
Einrichtung (Website)
- Nach Serverwahl unter „Server“ das Zahnrad (Server-Einstellungen) öffnen und Voice-KI wählen.
- Einen Embed-Textkanal wählen, dort erscheint die Karte mit „Bot beitreten“. Ohne gewählten Kanal lässt sich die Voice-KI nicht aktivieren.
- Änderungen im Modal speichern. Optional: mehrere Worker-Bots pro Sprachkanal konfigurieren (Multi-Channel-Bots), falls eure Stufe und der Bot-Pool das erlauben.
So nutzen Mitglieder es
- In den eingestellten Textkanal schauen: dort steht das Embed mit Status (freie Slots, aktive Sessions) und Hinweisen.
- Ziel-Sprachkanal joinen und in der Discord-Oberfläche „Bot beitreten“ wählen, um mit der Voice-KI zu sprechen.
- Die Konversation erfolgt über Mikrofon und Bot-Audio; konkretes Verhalten bei Mute/Leerlauf-Timeouts ergibt sich aus den erweiterten Einstellungen.
Bereiche im Voice-KI-Fenster
- Einrichtung: Embed-Kanal und Aktivierungs-Schalter.
- Channel-Embed: Öffentliche Karte, Platzhalter (z. B. freie Slots), Live-Vorschau, Kurz-Datenschutzhinweis (bearbeitbar, ohne automatische Rechts-Linkliste).
- Modell & Stimme: Gemini-Live-Modell und Stimmenwahl.
- KI-Anbieter: KynxBot-Kontingent oder eigener API-Key – mit Anbieter, Modell und Stimme.
- Charakter: Persönlichkeit und Leitplanken für die Konversation.
- Skills: Zusätzliche Fähigkeiten (z. B. Geburtstag des aktuellen Sprechers aus der Datenbank), falls aktiviert.
- Erweitert: Session-Limits, Timeouts und technische Details.
Eigener Anbieter & Neuerungen
- Im Reiter „KI-Anbieter“ kannst du einen eigenen API-Key hinterlegen: Google Gemini Live, OpenAI Realtime, xAI Grok Voice oder ein kompatibler Dienst – samt Modell und Stimme, auch für brandneue Modelle. Mit eigenem Key ist die Voice-KI kostenlos und ohne Minuten- und Kanal-Limit; die Kosten rechnet dein Anbieter direkt mit dir ab.
- Wer einem Sprachkanal mit laufender Voice-KI beitritt, bekommt einen kurzen Hinweis, dass die KI mithört. Das Bedien-Panel zeigt, an welchen Anbieter die Sprachdaten gehen.
- Lange Gespräche laufen ohne Abbruch weiter – die Voice-KI vergisst dabei nicht, worüber ihr gerade geredet habt.
- Projekt-Kollege (Beta, nur mit eigenem Key): Koppelst du im Profil unter „Geräte & Projekte“ deinen PC mit der KynxBot Bridge, sagt dir die Voice-KI, woran deine Claude-Code-Agenten gerade arbeiten und wann sie fertig sind. Aufträge gibt sie nur weiter, wenn du das ausdrücklich einschaltest und jeden Auftrag bestätigst.
Sobald eine Session läuft, hört die KI mit. Sprache geht live an den eingestellten KI-Anbieter (Standard: Google Gemini), ohne Tonarchiv bei uns. Chat-Lesen und Bildanalyse bleiben standardmäßig aus und brauchen einen eigenen Opt-in. Beim Start steht das im Bedien-Panel. Details: Datenschutzerklärung und Privacy-Center.
Ein und derselbe Discord-Bot-Benutzer kann standardmäßig nur einen Sprachkanal gleichzeitig pro Server aktiv bedienen. Für mehr gleichzeitige Gespräche nutzt ihr die dokumentierte Multi-Bot-/Pool-Lösung. Ohne freien Slot zeigen Embed und Status wartende Nutzer entsprechend an.
KI-Reminder
KI-Reminder sind zeitgesteuerte Erinnerungen, die ihr per Assistent oder Konfig-Oberfläche anlegen lasst: einmal als Embed in einem Textkanal (Server-Reminder) und zusätzlich als gesprochene Erinnerung über die Voice-KI (Voice-Reminder). Ein Scheduler im Bot bearbeitet fällige Termine etwa alle 15 Sekunden.
Einrichtung (Website)
- Server-Einstellungen (Zahnrad) nach Auswahl eines Servers öffnen und „KI Reminder“ wählen.
- Nutzt die Tabs Voice-Reminder, Server-Reminder und Einstellungen: dort legt ihr neue Reminder an oder bearbeitet ihr aktive Einträge in den Listen.
- Administratoren können optional einen Audit-Kanal aktivieren – aktive Voice- und Server-Reminder werden dort als Übersichts-Embed gespiegelt (ohne Spam im Sekunden-Takt).
Server-Reminder (Text)
Fällige Reminder werden als Discord-Embed im konfigurierten Textkanal gepostet. Nutzt den Einrichtungs-Assistenten im Tab „Server-Reminder“, um Inhalt und Zielkanal festzulegen.
Voice-Reminder
- Läuft die Voice-KI bereits im passenden Voice-Channel, wird die Ansage dort direkt vorgelesen; der Bot schaltet dafür kurz das Mikrofon frei.
- „Persistente“ Voice-Reminder dürfen den Bot auch dann in den Voice holen, wenn gerade keine reguläre Session läuft: Es startet kurz eine Reminder-only-Sitzung mit Ansage. Optionales automatisches Verlassen, sobald ihr wieder allein mit dem Bot seid.
- „Temporäre“ Voice-Reminder verfallen, wenn ihr den Voice-Kanal komplett verlasst oder keine Session aktiv ist — es gibt absichtlich keinen Textnachrichtenersatz für reine Voice-Reminder.
- Konkurrierende Prioritäten: Ohne zusätzliche Bot-Worker kann ein Bot-Benutzer nur einen Voice gleichzeitig bedienen; der Scheduler verschiebt andere Jobs bei Bedarf.
Je Server-Stufe gelten Höchstwerte gleichzeitig aktiver KI-Reminder pro Nutzer (Voice plus Server zusammengezählt) sowie separat wie viele davon persistent sein dürfen. Details nach Server-Limits oder Abonnement-Stufe – siehe zentrale Preis-/Limitinfos.
Geburtstage
Das Geburtstagsmodul kombiniert Anmelde-Karten für Mitglieder, automatische Glückwunsch-Nachrichten am Datum und optional Geschenk-Embeds. Die Oberfläche nutzt denselben Mehrkanal-/Embed-Stil wie der große Embed-Editor, jedoch mit geburtstagsspezifischen Textbausteinen.
Seite öffnen
- Direkt im Browser:
/birthdays?guildId=…mit eurer Server-ID (wie bei anderen Dashboard-Modulen). - Voraussetzung ist ein gültiger Website-Login und die Seitenberechtigung „Geburtstage“ für den Nutzeraccount – anderenfalls wird die Oberfläche nicht freigeschaltet.
Typischer Ablauf
- Channel hinzufügen und Anmelde-Embeds oder Text wie gewohnt über die Live-Vorschau pflegen.
- Nachricht(en) mit „Veröffentlichen“ in Discord posten – Mitglieder tragen dort Geburtstdatum und Zeitzone nach.
- Scheduler postet automatisch Geburtstagsglückwünsche pro konfiguriertem Kanal/Zeit; Geschenk-Embeds lassen sich separat definieren.
Über einen optionalen Skill in den Voice-KI-Einstellungen darf das Modell beim aktiven Sprecher gespeicherte Geburtstage lesen oder Einträge anlegen/löschen. Das ersetzt nicht die Pflege der Embed-Anmeldung – es ergänzt die Voice-Erfahrung.
Der Bot benötigt Schreib- und Embeds-Rechte in den angekündeten Kanälen sowie den Server Members Intent zur Auswertung der Anmeldungen. Bei fehlenden Rechten können Veröffentlichen oder automatische Posts scheitern – die Website zeigt entsprechende Fehlertexte aus der API.
Eigener Bot (Whitelabel)
Mit Whitelabel läuft KynxBot unter eurem eigenen Bot – mit eigenem Namen, Profilbild, Banner und Status. Alle Funktionen aus dem Dashboard bleiben gleich. Whitelabel ist eine Premium-Funktion.
Einrichtung
- Im Discord Developer Portal eine neue Anwendung mit Bot anlegen.
- Unter „Bot“ → „Privileged Gateway Intents“ den Intent „Server Members“ aktivieren (für Begrüßung und Auto-Rolle). „Message Content“ nur, wenn der Bot Nachrichten lesen soll – alles andere aus lassen.
- Im Dashboard unter Server-Einstellungen → Whitelabel die Anwendungs-ID und den Bot-Token eintragen.
- Den Bot über den angezeigten Einladungs-Button auf euren Server holen. Die Statusanzeige wird grün, sobald er online ist.
- Optional: „Als Haupt-Bot verwenden“ einschalten, Beschreibung und Aktivität festlegen und im Banner-Editor ein eigenes Profil-Banner gestalten.
Den Bot-Token nie weitergeben. Er wird bei uns verschlüsselt gespeichert und ist im Dashboard nicht mehr sichtbar.
Nur Name und Aussehen ändern: Bot-Profil
Ohne eigenen Bot geht es auch: Mit Premium gibst du KynxBot in den Server-Einstellungen unter „Bot-Profil“ einen eigenen Namen, Avatar, Banner und eine Beschreibung – nur für deinen Server, mit Live-Vorschau. Andere Server sehen weiter das normale Profil.
Community-Votes
Mit Community-Votes können Mitglieder euren Server im Community-Showcase nach oben voten – direkt auf kynxbot.de oder mit einem Button in eurem Discord-Kanal. Mehr Votes bedeuten mehr Sichtbarkeit.
- Voraussetzung: Der Server ist im Community-Showcase veröffentlicht.
- In den Server-Einstellungen unter „Votes“ einen Kanal wählen – der Bot postet dort ein Embed mit Vote-Button.
- Jedes Mitglied hat ein tägliches Vote-Kontingent (standardmäßig 5 Votes pro Tag, Zurücksetzung um Mitternacht deutscher Zeit).
- Wer jeden Tag votet, baut einen Streak auf – das Embed zeigt auf Wunsch einen Hinweis dazu.
KI-Bilder, Videos & Audio
KynxBot erstellt auf Wunsch Bilder, kurze Videos und Musik direkt in Discord. Die Befehle schaltet ihr auf der Befehle-Seite unter „Fun & Utils“ frei.
- /imagine – Bild aus einer Beschreibung. Unter dem Ergebnis: Neu generieren, Verbessern, Hochskalieren und Video aus dem Bild.
- /createvideo – kurzes Video (2–10 Sekunden). Mit Zusätzen wie --16:9, --9:16 oder --720p steuerst du Format und Qualität.
- /createaudio – Musik oder Soundeffekte aus einer Beschreibung.
- KI-Bilder, -Videos und -Audios sind als „KI-generiert“ gekennzeichnet – bei Videos und Audios auch in der Datei selbst. Anfragen mit verbotenen oder jugendgefährdenden Inhalten werden abgelehnt.
- Mehr pro Woche: Mit einem KI-Paket (oder KI-Paket Pro) bekommt ein Server deiner Wahl jede Woche deutlich mehr Bilder, Videos und Musik. Nutzt euer Server ein eigenes KI-Modell, legt ihr die Limits für Bilder und Videos selbst fest (siehe „KI-Modelle & Anbieter“).
Videos brauchen einige Minuten. Der Fortschrittsbalken zeigt den Stand; laufende Aufträge setzen nach einem Neustart des Bots automatisch fort. Wie viele Erstellungen möglich sind, hängt von eurem Plan ab.
Konto & Datenschutz
Du meldest dich mit deinem Discord-Konto an – ein extra Passwort gibt es nicht. Du bleibst bis zu 30 Tage angemeldet, ohne dich ständig neu einloggen zu müssen.
- Im Profil siehst du Rang, Server und Keys und kannst Einstellungen wie den animierten Mauszeiger ändern.
- Im Privacy-Center (Profilmenü) lädst du alle gespeicherten Daten zu deinem Konto als Datei herunter.
- Im Profil unter „Konto & Daten“ löschst du dein Konto selbst – auf Wunsch auch die Daten deiner eigenen Server. Gelöscht wird erst nach 21 Tagen, bis dahin kannst du jederzeit abbrechen. Daten auf fremden Servern (z. B. Tickets) verwalten deren Admins.
- Abmelden geht über das Profilmenü. Den Zugriff von KynxBot auf dein Discord-Konto kannst du zusätzlich in Discord unter „Autorisierte Apps“ entfernen.
- In Discord zeigt dir /privacy auf jedem Server, was KynxBot zu dir speichert. Dort lädst du eine vollständige Kopie deiner Daten herunter, beantragst eine Löschung (der Server-Betreiber erfährt davon automatisch) oder verbirgst dich in der Web-Bestenliste – auch ohne Website-Konto.
- Wird der Bot von einem Server entfernt, bleiben die Einstellungen noch 60 Tage erhalten – lädst du ihn wieder ein, ist alles noch da.
App & Hilfe-Chat
kynxbot.de lässt sich als App installieren – auf dem Handy wie am PC. Sie startet schneller, läuft im eigenen Fenster und aktualisiert sich selbst.
- Installieren: auf den „App“-Button oben in der Navigation tippen (oder im Browsermenü „Zum Startbildschirm hinzufügen“).
- Neue Versionen lädt die App automatisch – du hast immer gleich den neuesten Stand.
KI-Hilfe-Chat
- Die Sprechblase unten rechts öffnet den Hilfe-Chat. Stell deine Frage einfach in eigenen Worten.
- Der Chat kann dich direkt zur passenden Seite bringen und die richtige Stelle hervorheben.
- Mit der Nadel bleibt der Chat beim Seitenwechsel offen. Frühere Unterhaltungen findest du in der Seitenleiste des Chats.
Website-Assistent
- Im Hilfe-Chat kannst du nicht nur Fragen stellen, sondern auch Aufgaben geben – z. B. „Richte eine Willkommenskarte ein“ oder „Leg einen Kanal für Ankündigungen an“. Der Assistent erledigt das sichtbar für dich im Dashboard. Dafür musst du angemeldet sein.
- Vor Schritten wie Veröffentlichen, Senden oder Löschen fragt er nach. Mit „Automatisch vertrauen“ entscheidet er alles selbst – welcher Server, welcher Kanal, ob etwas neu angelegt werden muss – und fragt nicht mehr nach.
- Mit dem X oben rechts im Assistenten-Fenster oder mit „Abbrechen und Plan verwerfen“ stoppst du eine laufende Aufgabe sofort.
- Bricht die Verbindung kurz ab, macht der Assistent danach automatisch weiter. Abgebrochene Aufgaben setzt du mit „Weitermachen“ fort – oder du schreibst einfach „mach weiter“. Er arbeitet dann auf demselben Server weiter.
- Aus dem Chat kommst du mit „Live-Ansicht öffnen“ zurück zum Assistenten-Fenster. Nach einer erledigten Aufgabe schlägt er dir passende nächste Schritte vor.
Commands (/commands)
Auf der Seite /commands verwaltest du alles zu Slash-Commands: eingebaute Moderation- und Fun/Utils-Befehle aktivieren, Berechtigungen setzen und eigene Commands mit Variablen und Embeds erstellen. Nach „Speichern & Aktualisieren“ werden die Commands sofort auf deinem Server deployed.
Weitere Befehle
- /roleinvite – Einladungslink, über den neue Mitglieder beim Beitritt automatisch eine oder zwei Rollen bekommen, z. B. für Partner, Events oder VIPs. Gültigkeit (bis 168 Stunden) und Anzahl der Nutzungen (bis 100) legst du fest. Den Befehl schaltest du unter Commands frei.
- Rechtsklick auf einen Nutzer → Apps: Verwarnen, Rang anzeigen oder Benutzerinfo öffnen. Diese Befehle gibt es nur, wenn der passende Slash-Befehl aktiv ist, und sie haben dieselben Rechte.
- /privacy – zeigt jedem Mitglied, was KynxBot zu ihm speichert, mit Datenkopie, Löschantrag und Verbergen in der Web-Bestenliste. Der Befehl ist immer verfügbar.
- /poll nutzt echte Discord-Umfragen, die automatisch enden und das Ergebnis zeigen. /warn speichert Verwarnungen in der Historie.
Moderation
KynxBot bietet umfangreiche Moderations-Commands für Server-Verwaltung. Sie sind standardmäßig deaktiviert — auf /commands über „Moderation Commands“ ein- und ausschalten.
Verfügbare Moderation-Commands
| Command | Beschreibung | Optionen |
|---|---|---|
/clear |
Löscht Nachrichten (1-100, max. 14 Tage alt) | amount (1-100), user (optional) |
/ban |
Bannt einen Benutzer vom Server | user, reason (optional) |
/kick |
Kickt einen Benutzer vom Server | user, reason (optional) |
/timeout |
Gibt einem Benutzer einen Timeout | user, duration, reason (optional) |
/warn |
Warnt einen Benutzer | user, reason |
/slowmode |
Setzt den Slowmode (0-21600 Sek.) | seconds |
/lock |
Sperrt den Channel für @everyone | - |
/unlock |
Entsperrt den Channel für @everyone | - |
/purge |
Löscht Nachrichten nach Filtern | type (bots/users/links/etc.) |
/announce |
Erstellt eine Ankündigung | message, channel (optional) |
/embed |
Erstellt ein Custom Embed | title, description, color, etc. |
Moderations-Commands sind standardmäßig deaktiviert. Aktiviere sie auf /commands und konfiguriere Rollen-Berechtigungen — Details unter Berechtigungen.
Standard Commands (Fun & Utils)
KynxBot bietet ein flexibles Command-System mit vordefinierten Befehlen und eigenen Commands.
Der Bot enthält vordefinierte Commands in drei Kategorien:
Moderation Commands
/clear- Löscht 1-100 Nachrichten (optional nur von einem User)/ban- Bannt einen Benutzer vom Server/kick- Kickt einen Benutzer vom Server/timeout- Gibt einem Benutzer einen Timeout/warn- Warnt einen Benutzer/slowmode- Setzt den Slowmode für einen Channel/lock- Sperrt den aktuellen Channel/unlock- Entsperrt den aktuellen Channel/purge- Löscht Nachrichten nach verschiedenen Filtern/announce- Sendet eine Ankündigung/embed- Erstellt ein individuelles Embed
Fun & Utils Commands
- Info:
/userinfo,/serverinfo,/avatar,/membercount,/channelinfo,/roleinfo,/ping,/help - Utility:
/poll- Erstellt eine Umfrage,/remind- Setzt eine Erinnerung,/emoji- Zeigt Emoji-Informationen - Fun:
/8ball- Magische 8-Ball,/roll- Würfelt eine Zahl,/coinflip- Wirft eine Münze,/meme- Zeigt ein zufälliges Meme oder ein Meme zu einem bestimmten Thema,/yugiohcard- Suche Yu-Gi-Oh! Karten,/pokemoncard- Suche Pokémon Karten
Commands Aktivieren
- Gehe zu
/commandsim Dashboard - Klicke auf "Moderation Commands" oder "Fun & Utils Commands"
- Aktiviere die gewünschten Commands
- Konfiguriere Berechtigungen (Rollen & Channels)
- Klicke auf "Speichern & Aktualisieren"
Nach dem Klick auf "Speichern & Aktualisieren" werden alle Commands sofort auf deinem Server aktualisiert und sind direkt nutzbar!
Eigene Commands
Erstelle vollständig anpassbare Commands mit Nachrichten, Embeds und Variablen — direkt auf /commands in der Command-Liste.
Command Erstellen
- Gehe zu
/commands - Klicke auf "+ Command Hinzufügen"
- Gib einen Namen ein (z.B. "info", "rules", "socials")
- Füge eine Beschreibung hinzu
- Schreibe deine Nachricht (mit Variablen)
- Optional: Füge Embeds hinzu
- Konfiguriere Berechtigungen
- Speichere und aktualisiere!
Beispiel: /socials Command
📱 Folge uns auf Social Media!
👤 User: {user.name}
🆔 User ID: {user.id}
📅 Member seit: {user.joinedAt}
🔗 Twitch: twitch.tv/username
🔗 YouTube: youtube.com/@username
🔗 Twitter: twitter.com/username
Nutze Embeds für professionelle Nachrichten! Du kannst Farben, Bilder, Thumbnails und Footer hinzufügen. Variablen findest du im Abschnitt Variablen.
Variablen
Variablen machen deine Commands dynamisch und personalisiert. Nutze geschweifte Klammern {variable} um sie einzufügen.
Verfügbare Kategorien
- User Variablen: Informationen über den Command-Nutzer
- Target Variablen: Daten über erwähnte User
- Server Variablen: Server-Informationen
- Channel Variablen: Channel-Details
- Zeit/Datum: Timestamps und Datum
- Random: Zufallswerte und Würfel
- APIs: Externe Daten (Bilder, Jokes, etc.)
- Conditional: If/Else Logik
User Variablen
| Variable | Beschreibung | Beispiel |
|---|---|---|
{user} |
Erwähnung (Ping) des Command-Nutzers | @KynxUser |
{user.mention} |
Erwähnung (Ping) des Command-Nutzers | @KynxUser |
{user.name} |
Username ohne Tag | KynxUser |
{user.tag} |
Username mit Diskriminator (falls vorhanden) | KynxUser#1234 |
{user.displayName} |
Server-Nickname oder Username | Kynx |
{user.id} |
Discord User ID | 503938791686406165 |
{user.avatar} |
Avatar URL (256px) | https://cdn.discordapp.com/avatars/... |
{user.joinedAt} |
Server-Beitrittsdatum | 15.03.2024 |
{user.createdAt} |
Account-Erstellungsdatum | 10.01.2020 |
{user.isBot} |
Ist der User ein Bot? | true / false |
{user.roles} |
Anzahl der Rollen | 5 |
{user.topRole} |
Name der höchsten Rolle | Admin |
{user.topRole.color} |
Farbe der höchsten Rolle | #5865f2 |
Target Variablen (Erwähnter User)
| Variable | Beschreibung |
|---|---|
{target} |
Erwähnung des Target-Users |
{target.mention} |
Erwähnung des Target-Users |
{target.name} |
Username des Target-Users |
{target.id} |
User ID des Target-Users |
{target.avatar} |
Avatar URL des Target-Users |
{target.displayName} |
Nickname oder Username des Target-Users |
Server Variablen
| Variable | Beschreibung | Beispiel |
|---|---|---|
{server.name} |
Name des Servers | KynxBot Community |
{server.id} |
Server ID | 1397727400971866122 |
{server.memberCount} |
Mitgliederanzahl | 1337 |
{server.icon} |
Server Icon URL (256px) | https://cdn.discordapp.com/icons/... |
{server.owner} |
Server Owner (Erwähnung) | @OwnerName |
{server.createdAt} |
Server-Erstellungsdatum | 01.01.2020 |
{server.boostLevel} |
Boost-Level (0-3) | 2 |
{server.boostCount} |
Anzahl der Boosts | 14 |
Channel Variablen
| Variable | Beschreibung | Beispiel |
|---|---|---|
{channel} |
Channel-Erwähnung | #general |
{channel.mention} |
Channel-Erwähnung | #general |
{channel.name} |
Channel-Name | general |
{channel.id} |
Channel ID | 1427114790043517008 |
{channel.topic} |
Channel-Topic | Allgemeiner Chat |
Zeit & Datum Variablen
| Variable | Beschreibung | Beispiel |
|---|---|---|
{time} |
Aktuelle Uhrzeit (HH:MM) | 14:30 |
{time.full} |
Uhrzeit mit Sekunden | 14:30:45 |
{date} |
Aktuelles Datum | 26.10.2024 |
{date.short} |
Datum ohne Jahr | 26.10. |
{date.long} |
Datum ausgeschrieben | Samstag, 26. Oktober 2024 |
{datetime} |
Datum und Uhrzeit | 26.10.2024, 14:30:45 |
{timestamp} |
Discord-Timestamp (absolut) | |
{timestamp.relative} |
Discord-Timestamp (relativ) | vor 2 Stunden |
{day} |
Wochentag | Samstag |
{month} |
Monat | Oktober |
{year} |
Jahr | 2024 |
Random Variablen
| Variable | Beschreibung | Beispiel |
|---|---|---|
{random:1-100} |
Zufallszahl zwischen min und max | 42 |
{random:A|B|C} |
Zufällige Auswahl aus Optionen (mit | getrennt) | B |
{dice:6} |
Würfel mit N Seiten | 4 |
{coin} |
Münzwurf | Kopf |
{percent} |
Zufälliger Prozentsatz (0-100%) | 73% |
{color.random} |
Zufällige Hex-Farbe | #FF5733 |
{uuid} |
Generiert eine eindeutige UUID | a1b2c3d4-e5f6-... |
Math Variablen
| Variable | Beschreibung | Beispiel |
|---|---|---|
{math:5+3*2} |
Berechnet mathematische Ausdrücke | 11 |
{round:3.14159} |
Rundet eine Zahl | 3 |
API Variablen (Externe Daten)
| Variable | Beschreibung | Quelle |
|---|---|---|
{cat} |
Zufälliges Katzenbild (URL) | thecatapi.com |
{dog} |
Zufälliges Hundebild (URL) | random.dog |
{fox} |
Zufälliges Fuchsbild (URL) | randomfox.ca |
{duck} |
Zufälliges Entenbild (URL) | random-d.uk |
{panda} |
Zufälliges Pandabild (URL) | some-random-api.com |
{bird} |
Zufälliges Vogelbild (URL) | some-random-api.com |
{meme} |
Zufälliges Meme (URL) | meme-api.com |
{joke} |
Zufälliger Witz (Text) | official-joke-api.appspot.com |
{fact} |
Zufälliger Fakt (Text) | uselessfacts.jsph.pl |
{advice} |
Zufälliger Ratschlag (Text) | api.adviceslip.com |
{quote} |
Zufälliges Zitat mit Autor (Text) | api.quotable.io |
{8ball} |
Magische 8-Ball Antwort (Text) | Intern |
{yesno} |
Ja/Nein Antwort mit GIF (URL) | yesno.wtf |
API-Variablen werden für 60 Sekunden gecacht, um Performance zu optimieren und API-Rate-Limits zu respektieren.
Conditional Logic
Nutze If/Else Logik für dynamische Nachrichten:
{if:condition?true_value:false_value}
Beispiele:
{if:{user.name}==Admin?Du bist Admin!:Du bist kein Admin}
{if:{random:1-100}>50?Glück gehabt!:Pech gehabt!}
{if:{server.memberCount}>1000?Großer Server:Kleiner Server}
Berechtigungen
Kontrolliere genau, wer welche Commands nutzen darf und in welchen Channels sie verfügbar sind.
Rollen-Berechtigungen
Lege fest, welche Discord-Rollen einen Command nutzen dürfen:
- Öffne die Command-Einstellungen
- Klicke auf "Berechtigungen"
- Wähle den Tab "Rollen"
- Aktiviere "Alle Server-Mitglieder" ODER wähle spezifische Rollen
- Speichern!
Channel-Berechtigungen
Begrenze Commands auf bestimmte Channels:
- Öffne die Command-Einstellungen
- Klicke auf "Berechtigungen"
- Wähle den Tab "Channels"
- Aktiviere "Alle Channels" ODER wähle spezifische Channels
- Speichern!
Commands werden nur bei Usern angezeigt, die die Berechtigung haben sie zu nutzen. User ohne Berechtigung sehen den Command nicht in der Slash-Command-Liste!
Embed Builder
Erstelle professionelle Rich Embeds mit Farben, Bildern und strukturiertem Text.
Embed Elemente
- Titel: Hauptüberschrift des Embeds
- Beschreibung: Haupttext-Inhalt
- Farbe: Seitenleiste in deiner Wunschfarbe
- Author: Name und Icon oben im Embed
- Footer: Text und Icon unten im Embed
- Thumbnail: Kleines Bild oben rechts
- Image: Großes Bild im Embed
- Fields: Zusätzliche Felder (inline/block)
- Timestamp: Zeitstempel anzeigen
Verfügbare Sections
/welcome- Welcome-Nachrichten/farewell- Farewell-Nachrichten/streams- Stream Alerts/content- Content Posts/game-updates- Game Updates (Steam-News)/indicators- Indicators (Live-Embeds)/commands- Custom Commands/embeds- Standalone Embeds- Schnell-Updates (Karte „Updates“ im Embeds-Bereich)
Neues Discord-Layout
- Im Embed-Editor wählst du oben zwischen „Klassisch“ und „Neues Layout“. Im neuen Layout steht das Bild groß oben, Buttons und Reaktions-Rollen sitzen direkt im Rahmen. Wechselst du das Layout, wird die veröffentlichte Nachricht automatisch ersetzt.
- Mehrere Embed-Karten einer Nachricht werden im neuen Layout zu einem Rahmen mit Abschnitten: das Bild der ersten Karte als Titelbild, jede weitere Karte als Abschnitt mit Bild rechts, Buttons unten. Praktisch z. B. für Live-Boards mit Events, Rankings und News.
- Das neue Layout gibt es auch für Giveaways, Ticket-Panels, Stream-Benachrichtigungen, Level-ups und Geburtstage. Umschalten kannst du jeweils auf der Seite des Moduls, meist oben in der Vorschau.
- /serverinfo und /userinfo zeigen Server- bzw. Profilbanner groß oben im neuen Layout. Geteilte Links zu kynxbot.de und zu Server-Bestenlisten erscheinen in Discord als Karte.
Unter /embeds?guildId=… öffnest du den vollen Editor: mehrere Embeds pro Nachricht, Buttons, Reaction Roles, Bild-Uploads, Live-Vorschau und Versand in einen Channel – ohne die anderen Module zu verlassen.
Schnell-Updates
Schnell-Updates sind kurze Ankündigungen mit einem eingebetteten Discord-Embed – optimiert für Changelog, Patch-Notes und Statusmeldungen. Im Dashboard steht die Karte unter „Embeds“ neben dem normalen Embeds-Editor (Beschriftung „Updates“ / „Schnell-Posts“).
Öffnen
- Server im Dashboard wählen und im Bereich „Embeds“ die Karte „Updates“ anklicken (oder Tastatur: Fokus + Enter).
- Es öffnet sich ein Vollbild-Panel: oben wählst du den Ziel-Kanal.
Aufbau
- Links: optionale Kurznachricht über dem Embed (z. B.
@everyone) mit Markdown-Vorschau. - Darunter die Live-Embed-Vorschau wie beim Embeds-Editor – Klick auf Bereiche zum Bearbeiten (Titel, Beschreibung, Farbe, Bilder, Felder, Autor, Footer).
- Rechts: Felder „Titel“ und „Beschreibung“ (werden mit der Vorschau synchronisiert); optional Zeitstempel im Embed.
KI & Entwurf
- „KI Verbesserung“ formatiert Titel und Beschreibung per KI; zwischen Aufrufen liegt eine kurze Wartezeit (Cooldown).
- „Rückgängig“ und „Wiederholen“ beziehen sich auf die letzte KI-Änderung.
- Der Entwurf wird automatisch gespeichert (Server und lokales Backup); du kannst die Arbeit unterbrechen und später weitermachen.
Senden & Historie
- „Absenden“ postet die Nachricht in den gewählten Kanal (Text + Embed, ggf. Medien).
- Unter „Letzte Updates“ siehst du frühere Posts; Einträge kannst du erneut bearbeiten – in dem Fall aktualisiert der Bot die bestehende Discord-Nachricht, sofern möglich.
- Medien: Bilder und Videos per Drag & Drop oder Klick; optional „Dateien in separater Nachricht senden“ (nach Text und Embed).
Verfügbarkeit und Kontingente (z. B. bearbeitbare Verläufe) können von der Server-Stufe / Premium abhängen – siehe Abo-Seite und Server-Limits.
Platzhalter
Placeholders mit @ werden in Welcome, Farewell, Stream und Content Posts verwendet.
@-Placeholders funktionieren in Welcome, Farewell, Stream und Content Posts.
{}-Variablen funktionieren nur in Custom Commands.
Welcome & Farewell Placeholders
Diese Placeholders können in Welcome/Farewell-Nachrichten und GIFs verwendet werden:
| Placeholder | Beschreibung | Beispiel |
|---|---|---|
%user% |
Username des Mitglieds (für GIF-Text) | KynxUser |
%membercount% |
Aktuelle Mitgliederanzahl (für GIF-Text) | 1337 |
%displayname% | Anzeigename des Mitglieds (Kartentexte) | Kynx |
%server% | Name des Servers (Kartentexte) | KynxBot Community |
@user |
Username (für Embeds) | KynxUser |
@membercount |
Mitgliederanzahl (für Embeds) | 1337 |
@timestamp |
Aktuelles Datum & Uhrzeit | 26.10.2024, 14:30 |
Stream Alert Placeholders
Verfügbar in Stream-Benachrichtigungen (Twitch, YouTube, Kick, TikTok):
| Placeholder | Beschreibung | Beispiel |
|---|---|---|
@user |
Streamer-Name | KynxStreamer |
@title |
Stream-Titel | Chilling & Gaming 🎮 |
@link |
Stream-URL | https://twitch.tv/kynxstreamer |
@viewercount |
Aktuelle Zuschauerzahl | 523 |
@timestamp |
Stream-Start Zeit | 26.10.2024, 20:00 |
Content Post Placeholders
Verfügbar in Content-Posts (YouTube, Twitch, TikTok):
| Placeholder | Beschreibung | Beispiel |
|---|---|---|
@user |
Creator-Name | KynxCreator |
@title |
Video-Titel | Best Gaming Moments 2024 |
@link |
Video-URL | https://youtube.com/watch?v=... |
@views |
View-Count (formatiert) | 12.345 |
@likes |
Like-Count (formatiert) | 1.234 |
@duration |
Video-Dauer (nur Twitch VODs) | 1:23:45 |
@publishedAt |
Veröffentlichungsdatum | 26.10.2024, 18:00 |
@timestamp |
Aktuelles Datum & Uhrzeit | 26.10.2024, 20:30 |
Fehlerbehebung
Häufige Probleme und ihre Lösungen:
Bot reagiert nicht auf Commands
- Stelle sicher, dass der Bot online ist
- Prüfe ob Commands im Dashboard aktiviert sind
- Überprüfe Berechtigungen (Rollen & Channels)
- Klicke auf "Speichern & Aktualisieren" nach Änderungen
Stream Alerts funktionieren nicht
- Stelle sicher, dass "Stream-Nachrichten aktivieren" AN ist
- Überprüfe den Benutzernamen (ohne @ oder URL-Präfix)
- Warte bis zu 5 Minuten für die erste Überprüfung
GIF wird nicht angezeigt
- Max. Dateigröße: 5 MB
- GIFs werden automatisch optimiert (max. 20 FPS, 5 Sekunden)
- Nutze die Vorschau-Funktion zum Testen
Tritt unserem Support-Server bei oder kontaktiere uns über das Dashboard!
Häufige Probleme
- Rolle wird nicht vergeben: Die Rolle von KynxBot muss in Discord über der zu vergebenden Rolle stehen.
- Bot postet nicht im Kanal: Prüfe, ob KynxBot den Kanal sehen und dort schreiben, Einbettungen senden und Dateien anhängen darf.
- Slash-Befehle fehlen: Auf der Befehle-Seite aktivieren und speichern. Discord braucht manchmal ein paar Minuten; notfalls Discord neu laden (Strg+R).
- Dashboard zeigt „Anmeldung abgelaufen“: Einmal abmelden und wieder mit Discord anmelden.
- Server fehlt im Server-Menü: Du brauchst auf dem Server „Server verwalten“ oder Administrator. Mit „Aktualisieren“ unten im Menü lädst du die Liste neu.
- Begrüßungskarten oder Auto-Rolle reagieren nicht bei eigenem Bot (Whitelabel): Im Developer Portal den Intent „Server Members“ aktivieren.
- Ticket wird nicht angelegt: Der Bot sagt genau, welches Recht ihm fehlt – dieses Recht in Discord ergänzen und erneut versuchen.
- Eigenes KI-Modell antwortet nicht: In den Server-Einstellungen unter „KI-Modelle & Anbieter“ prüfen, ob der Key noch gültig ist und ob ein Tageslimit erreicht wurde. Entfernst du den Key, nutzt die Funktion wieder die KynxBot-Modelle.
FAQ
Kosten, Limits & Abonnements
Fast alle Funktionen sind kostenlos nutzbar, jeweils mit Limits pro Server. Stufen, Limits und Preise findest du auf unserer Preise-Seite.
Wie viele Server kann ich hinzufügen?
Unbegrenzt! Du kannst KynxBot auf so vielen Servern nutzen wie du möchtest.
Werden meine Daten gespeichert?
Wir speichern Server-IDs, Kanal-IDs und Einstellungen. Zusätzlich je nach Funktion: Ticket-Transkripte, Moderationsdaten, Leveling (XP), optional die letzten Nachrichten als KI-Kontext (Standard aus) sowie bei Voice-KI den Live-Sprachstream an den eingestellten KI-Anbieter (Standard: Google). Kein pauschales „keine persönlichen Nachrichten“.
Datenschutzerklärung · Privacy-Center · AVV
Kann ich eigene Variablen erstellen?
Aktuell nicht, aber wir arbeiten an dieser Funktion! Neuigkeiten findest du auf unserem Discord.
Wie oft werden Streams überprüft?
Stream-Status wird alle 3-5 Minuten überprüft für optimale Performance.
Weitere Fragen
- Kann ich KynxBot mit eigenem Namen und Bild nutzen? – Ja, mit Whitelabel (Premium).
- Wer darf das Dashboard eines Servers nutzen? – Alle mit „Server verwalten“ oder Administrator auf diesem Server.
- Gibt es KynxBot als App? – Ja, kynxbot.de lässt sich über den „App“-Button installieren.
- Wie lösche ich meine Daten? – Im Privacy-Center (Profilmenü) oder mit /privacy in Discord lädst du deine Daten herunter oder beantragst die Löschung. Dein Konto löschst du im Profil unter „Konto & Daten“.
- Kann ich eigene KI-Keys nutzen? – Ja. In den Server-Einstellungen unter „KI-Modelle & Anbieter“ hinterlegst du Keys von Anthropic, OpenAI oder Google. Für die Voice-KI gibt es im Voice-KI-Fenster den Reiter „KI-Anbieter“.
- Wie kündige oder widerrufe ich einen Kauf? – Online unter kynxbot.de/kuendigen bzw. kynxbot.de/widerrufen. Die Links stehen auch unten auf jeder Seite.
Support
Brauchst du Hilfe? Wir sind für dich da!
Kein Discord-Konto? Über das Kontaktformular unter kynxbot.de/kontakt schreibst du uns direkt – ganz ohne Anmeldung.
Changelog
Hier siehst du alle Änderungen, die für dich wichtig sind – automatisch aktuell, genau wie in unserem Discord-Kanal für Patchnotes.
Zum Discord (Updates & Changelog)