Einen Discord-Bot zu KiroCloud hinzufügen

Mit KiroCloud kannst du deinen eigenen benutzerdefinierten Discord-Bot in wenigen Minuten hosten, verwalten und mit leistungsstarken Modulen wie Tickets, Minecraft-Verknüpfung, Auto-Moderation und Level-Systemen ausstatten.

In dieser Anleitung erfährst du, wie du eine neue Bot-Applikation im Discord Developer Portal erstellst, die erforderlichen Berechtigungen und Intents konfigurierst und den Bot sicher mit KiroCloud verbindest.

Voraussetzungen

Bevor du beginnst, stelle sicher, dass du folgende Voraussetzungen erfüllst:

• Einen aktiven Discord-Account.
• Einen eigenen Discord-Server (oder Administrator-Rechte auf einem bestehenden Server), auf dem der Bot hinzugefügt werden soll.
• Einen registrierten Account auf KiroCloud.

Schritt 1: Applikation im Discord Developer Portal erstellen

1. Öffne das offizielle Discord Developer Portal.
2. Melde dich mit deinem Discord-Account an.
3. Klicke oben rechts auf die Schaltfläche "New Application".
4. Vergib einen Namen für deine Applikation (z. B. MeinServer Bot) und akzeptiere die Discord Developer Terms of Service.
5. Klicke auf "Create". Du gelangst nun zur Übersicht deiner neuen Applikation.

!TIP Unter General Information kannst du ein Profilbild (App Icon) und eine kurze Beschreibung für deinen Bot hinterlegen.

Schritt 2: Bot-Nutzer erstellen & Privileged Gateway Intents aktivieren

1. Navigiere im linken Menü zum Reiter "Bot".
2. Scrolle nach unten zum Abschnitt Privileged Gateway Intents.
3. Aktiviere zwingend die folgenden drei Schalter:
   • Presence Intent: Ermöglicht dem Bot das Erkennen von Online-Status und Aktivitäten.
   • Server Members Intent: Notwendig für Willkommensnachrichten, Auto-Rollen, Minecraft-Synchronisation und Mitgliederlisten.
   • Message Content Intent: Zwingend erforderlich, damit der Bot Chat-Befehle (z. B. !ticketpanel), AutoMod-Filter und Textnachrichten verarbeiten kann.
4. Klicke unten auf "Save Changes".

!IMPORTANT Ohne die Aktivierung von Message Content Intent und Server Members Intent können zentrale Funktionen wie Tickets, Moderation und Verifikation nicht ordnungsgemäß ausgeführt werden!

Schritt 3: Bot-Token generieren und kopieren

Der Bot-Token fungiert als Passwort für deinen Discord-Bot. KiroCloud benötigt diesen Token, um sich in deinem Namen mit den Discord-Gateways zu verbinden.

1. Bleibe im Reiter "Bot" des Developer Portals.
2. Klicke unter dem Benutzernamen des Bots auf "Reset Token" (bzw. "View Token").
3. Bestätige eventuell die Zwei-Faktor-Authentifizierung (2FA) deines Discord-Accounts.
4. Klicke auf "Copy", um den Token in deine Zwischenablage zu kopieren.

!CAUTIONHalte deinen Bot-Token absolut geheim! Gib ihn niemals an Dritte weiter und lade ihn nicht in öffentliche GitHub-Repositories hoch. KiroCloud speichert deinen Token sicher und verschlüsselt (AES-256).

Schritt 4: Bot in KiroCloud registrieren

1. Öffne das KiroCloud Dashboard.
2. Klicke auf die Schaltfläche "Bot hinzufügen" (+).
3. Schritt 1 (Server auswählen): Wähle den Discord-Server aus der Liste aus, auf dem der Bot primär laufen soll.
4. Schritt 2 (Konfiguration eingeben):
   • Bot-Name: Wähle einen Anzeigenamen für das KiroCloud Dashboard.
   • Application / Client-ID: Kopiere die Application ID aus dem Discord Developer Portal (unter General Information).
   • Client Secret: (Optional) Kopiere das Client Secret für erweiterte OAuth2-Integrationen.
   • Bot-Token: Füge den in Schritt 3 kopierten Token ein.
5. Klicke auf "Bot erstellen".

KiroCloud validiert den Token sofort gegen die Discord API und richtet eine isolierte Laufzeitumgebung für deinen Bot ein.

Schritt 5: Bot auf deinen Discord-Server einladen

Damit dein Bot auf deinem Discord-Server aktiv werden kann, musst du ihn mit den passenden Rechten einladen:

1. Gehe im Discord Developer Portal zum Reiter "OAuth2" > "URL Generator".
2. Wähle unter Scopes:
   • bot
   • applications.commands (für Slash-Commands)
3. Wähle unter Bot Permissions die erforderlichen Berechtigungen aus:
   • Empfohlen: Administrator (für reibungslose Funktion aller Module)
   • Alternativ (Minimal): Manage Roles, Manage Channels, Kick Members, Ban Members, Send Messages, Embed Links, Attach Files, Read Message History, Manage Messages.
4. Kopiere die generierte URL ganz unten, öffne sie im Browser und wähle deinen Discord-Server aus, um den Bot zu autorisieren.

Schritt 6: Bot starten & Status prüfen

Nach erfolgreicher Verknüpfung wirst du direkt in das Bot-Dashboard weitergeleitet.

1. Klicke oben rechts im Bot-Dashboard auf "Bot starten".
2. Im integrierten Live-Terminal kannst du den Verbindungsaufbau in Echtzeit mitverfolgen.
3. Sobald der Status-Badge auf "Online" wechselt, ist dein Bot einsatzbereit und reagiert auf Discord-Interaktionen!

Häufige Fehlerquellen & Troubleshooting