Docs / Einführung

Willkommen zur KynxBot Dokumentation

KynxBot ist ein leistungsstarker Discord-Bot mit umfangreichen Funktionen für Stream-Alerts, Content-Posts, Custom Commands und vieles mehr. Diese Dokumentation hilft dir dabei, alle Features optimal zu nutzen.

Welcome & Farewell
Begrüße neue Mitglieder mit animierten GIFs und individuellen Nachrichten
Stream Alerts
Automatische Benachrichtigungen für Twitch, YouTube & Kick Streams
Content Posts
Teile neue Videos und Content automatisch auf deinem Server
Commands
Erstelle eigene Commands mit Variablen und API-Integration

Bot Einrichten

Folge diesen Schritten, um KynxBot auf deinem Discord-Server einzurichten:

1. Bot Einladen

  1. Gehe zur KynxBot Homepage
  2. Klicke auf "Bot hinzufügen"
  3. Wähle deinen Server aus der Liste
  4. Bestätige die benötigten Berechtigungen
Benötigte 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!

Dashboard

Das KynxBot Dashboard ist deine zentrale Anlaufstelle für alle Einstellungen:

/welcome
Welcome-Nachrichten mit animierten GIFs erstellen
/farewell
Verabschiede Mitglieder die den Server verlassen
/streams
Stream-Benachrichtigungen für mehrere Plattformen
/content
Automatische Content-Posts für neue Videos
/commands
Eigene Commands erstellen und verwalten
/embeds
Rich Embeds mit visuellen Elementen erstellen

Welcome & Farewell

Begrüße neue Mitglieder und verabschiede Ausgehende mit individuellen Nachrichten und animierten GIFs.

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
GIF-Optimierung

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
Wichtiger Unterschied

Nutze %placeholder% für Text im GIF selbst und @placeholder für Embed-Felder!

Stream Alerts

Erhalte automatische Benachrichtigungen, wenn deine Streamer live gehen auf Twitch, YouTube oder Kick.

Unterstützte Plattformen

  • Twitch: Voll unterstützt ✅
  • YouTube: Voll unterstützt ✅
  • Kick: Voll unterstützt ✅

Einrichtung

  1. Gehe zu /streams im Dashboard
  2. Wähle einen Discord-Channel für die Alerts
  3. Füge Streamer hinzu (Username oder Kanal-URL)
  4. Passe die Embed-Nachricht an
  5. Aktiviere Stream-Nachrichten
Auto-Updates

Stream-Nachrichten werden automatisch aktualisiert, wenn der Stream endet. Du musst nichts manuell löschen!

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: Coming Soon 🚧
  • Kick: Coming Soon 🚧
Wichtig

Content-Posts werden nur für neue Videos erstellt. Bereits gepostete Videos werden nicht erneut geteilt.

Moderation

KynxBot bietet umfangreiche Moderations-Commands für Server-Verwaltung:

Verfügbare 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.
Berechtigungen

Moderations-Commands sind standardmäßig deaktiviert. Aktiviere sie im Dashboard unter /commands und konfiguriere Rollen-Berechtigungen.

Command System

KynxBot bietet ein flexibles Command-System mit Standard-Commands und der Möglichkeit eigene Commands zu erstellen.

Standard 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

  1. Gehe zu /commands im Dashboard
  2. Klicke auf "Moderation Commands" oder "Fun & Utils Commands"
  3. Aktiviere die gewünschten Commands
  4. Konfiguriere Berechtigungen (Rollen & Channels)
  5. Klicke auf "Speichern & Aktualisieren"
Instant Deployment

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.

Command Erstellen

  1. Gehe zu /commands
  2. Klicke auf "+ Command Hinzufügen"
  3. Gib einen Namen ein (z.B. "info", "rules", "socials")
  4. Füge eine Beschreibung hinzu
  5. Schreibe deine Nachricht (mit Variablen)
  6. Optional: Füge Embeds hinzu
  7. Konfiguriere Berechtigungen
  8. 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
Pro-Tipp

Nutze Embeds für professionelle Nachrichten! Du kannst Farben, Bilder, Thumbnails und Footer hinzufügen.

Command 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
Cache & Performance

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:

  1. Öffne die Command-Einstellungen
  2. Klicke auf "Berechtigungen"
  3. Wähle den Tab "Rollen"
  4. Aktiviere "Alle Server-Mitglieder" ODER wähle spezifische Rollen
  5. Speichern!

Channel-Berechtigungen

Begrenze Commands auf bestimmte Channels:

  1. Öffne die Command-Einstellungen
  2. Klicke auf "Berechtigungen"
  3. Wähle den Tab "Channels"
  4. Aktiviere "Alle Channels" ODER wähle spezifische Channels
  5. Speichern!
Wichtig

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
  • /commands - Custom Commands
  • /embeds - Standalone Embeds

Placeholders

Placeholders mit @ werden in Welcome, Farewell, Stream und Content Posts verwendet.

Unterschied: @ vs { }

@-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
@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):

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 Videos, Twitch VODs):

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

Troubleshooting

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
Weitere Hilfe benötigt?

Tritt unserem Support-Server bei oder kontaktiere uns über das Dashboard!

FAQ

Ist KynxBot kostenlos?

Ja! KynxBot ist komplett kostenlos nutzbar mit allen Features.

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 nur notwendige Daten für die Bot-Funktionen (Server-ID, Channel-IDs, Einstellungen). Keine persönlichen Nachrichten oder Chat-Verläufe.

Kann ich eigene Variablen erstellen?

Aktuell nicht, aber wir arbeiten an dieser Funktion! Schau regelmäßig im Changelog vorbei.

Wie oft werden Streams überprüft?

Stream-Status wird alle 3-5 Minuten überprüft für optimale Performance.

Support

Brauchst du Hilfe? Wir sind für dich da!

Discord Server
Tritt unserem Community-Server bei für direkten Support
Dokumentation
Durchsuche diese Docs für detaillierte Anleitungen
E-Mail Support
Kontaktiere uns per E-Mail für spezielle Anfragen

Changelog

Version 2.1.0 - Oktober 2024

  • ✨ Neue Command-Variablen mit API-Integration
  • ✨ Conditional Logic für Commands ({`if:condition?true:false`})
  • ✨ Channel-spezifische Command-Berechtigungen
  • 🎨 Verbessertes UI für Berechtigungs-Management
  • 🐛 Bugfixes für Content-Posts

Version 2.0.0 - September 2024

  • ✨ Vollständiges Custom-Command-System
  • ✨ Rollen-basierte Berechtigungen
  • ✨ Content-Posts für YouTube & Twitch
  • 🎨 Komplett überarbeitetes Dashboard
  • ⚡ Performance-Verbesserungen

Version 1.5.0 - August 2024

  • ✨ Stream-Alerts für Kick hinzugefügt
  • ✨ GIF-Optimierung für Welcome/Farewell
  • 🐛 Diverse Bugfixes