Erste Schritte mit Discord Bots

Dieser Leitfaden führt Sie durch die Einrichtung Ihres Discord-Bots auf ServerPrism. Sie erfahren, wie Sie einen Server bestellen, Ihren Bot konfigurieren und ihn mit Discord verbinden.

Bevor Sie beginnen

Bevor Sie Ihren Bot bereitstellen, benötigen Sie ein Discord Bot Token. Sie können dieses Token über das Discord Developer Portal generieren. Erstellen Sie eine neue Anwendung, navigieren Sie zum Tab 'Bot' und klicken Sie auf 'Add Bot'. Nach der Erstellung können Sie Ihr Token anzeigen und kopieren. Bewahren Sie dieses Token sicher auf; es gewährt die volle Kontrolle über Ihren Bot.

Bestellung auf ServerPrism

1. Wählen Sie einen Plan: Discord-Bots benötigen typischerweise mindestens 2 GB RAM. Für Bots mit vielen Funktionen oder vielen Gilden sollten Sie 4-8 GB in Betracht ziehen. Sie können Ihren Plan bei Bedarf später über das ServerPrism-Dashboard upgraden.
2. Wählen Sie eine Laufzeitumgebung: ServerPrism bietet mehrere vorkonfigurierte Discord-Bot-Laufzeitumgebungen wie Aoede, Bastion, Dynamica und JMusicBot. Wählen Sie den Bot aus, den Sie bereitstellen möchten. Sie können die Laufzeitumgebung später über den 'Startup'-Tab im Panel wechseln.
3. Bereitstellen: Wählen Sie Ihre bevorzugte Region und schließen Sie die Bestellung ab.

Erster Start

Nach der Bestellung beginnt die Bereitstellung Ihres Bot-Servers. Dieser Vorgang dauert in der Regel einige Minuten. Sie können den Fortschritt im ServerPrism-Panel unter https://serverprism.com/dashboard verfolgen. Sobald der Serverstatus 'Running' anzeigt und die Konsolenausgabe stabil ist, ist Ihr Bot bereit für die Konfiguration.

Grundlagen der Konfiguration

Die meisten Discord-Bots benötigen ein Bot-Token, um zu funktionieren. Dieses Token authentifiziert Ihren Bot bei Discord.

1. Zugriff auf Startup-Variablen: Navigieren Sie in Ihrem ServerPrism-Panel zum 'Startup'-Tab.
2. Geben Sie Ihr Bot-Token ein: Suchen Sie die Umgebungsvariable für Ihr Bot-Token. Diese heißt normalerweise BOT_TOKEN, DISCORD_TOKEN oder ähnlich. Fügen Sie Ihr Discord Bot Token in das entsprechende Feld ein.
3. Speichern und neu starten: Klicken Sie auf 'Save' und starten Sie dann Ihren Server über den 'Console'- oder 'Power'-Tab neu, damit die Änderungen wirksam werden.

Für spezifische Bot-Konfigurationen (z.B. benutzerdefinierte Präfixe, Willkommensnachrichten, API-Schlüssel für Integrationen) verwenden Sie typischerweise eine dieser Methoden:

• Startup-Variablen: Überprüfen Sie den 'Startup'-Tab in Ihrem Panel auf zusätzliche Konfigurationsoptionen, die von der spezifischen Bot-Laufzeitumgebung bereitgestellt werden.
• File Manager: Greifen Sie über den 'File Manager' in Ihrem Panel auf die Konfigurationsdateien des Bots (z.B. config.json, .env-Dateien) zu. Bearbeiten Sie diese Dateien direkt.
• Web Console: Einige Bots bieten In-Game-Befehle oder eine Weboberfläche zur Konfiguration. Überprüfen Sie die Dokumentation des Bots für Details.

Ihren Bot zu Discord einladen

Um Ihren Bot zu einem Discord-Server einzuladen:

1. Holen Sie sich die Client ID Ihres Bots: Gehen Sie zum Discord Developer Portal, wählen Sie Ihre Anwendung aus und kopieren Sie die 'Client ID' aus dem Tab 'General Information'.
2. Generieren Sie eine Einladungs-URL: Verwenden Sie die folgende URL-Struktur und ersetzen Sie YOUR_CLIENT_ID durch die Client ID Ihres Bots:

   https://discord.com/oauth2/authorize?client_id=YOUR_CLIENT_ID&scope=bot&permissions=8
   

   Die permissions=8 gewährt Administratorberechtigungen, die oft für die volle Funktionalität des Bots benötigt werden. Passen Sie die Berechtigungen bei Bedarf an die spezifischen Anforderungen Ihres Bots an.
3. Einladen: Fügen Sie die generierte URL in Ihren Browser ein, wählen Sie den Discord-Server aus, dem Sie den Bot hinzufügen möchten, und autorisieren Sie ihn.

Ihr Bot sollte nun in der Mitgliederliste Ihres Discord-Servers erscheinen und kurz nach dem Start Ihres Servers online gehen.

Häufige Probleme

• Bot geht nicht online:
  • Falsches Token: Überprüfen Sie Ihr BOT_TOKEN im 'Startup'-Tab. Stellen Sie sicher, dass keine zusätzlichen Leerzeichen oder fehlenden Zeichen vorhanden sind.
  • Bot-Berechtigungen: Stellen Sie im Discord Developer Portal unter dem 'Bot'-Tab Ihrer Anwendung sicher, dass 'Privileged Gateway Intents' (wie PRESENCE INTENT und MESSAGE CONTENT INTENT) aktiviert sind, falls Ihr Bot diese benötigt.
  • Firewall: ServerPrism konfiguriert die Firewall automatisch. Wenn Sie Verbindungsprobleme haben, öffnen Sie ein Support-Ticket unter https://serverprism.com/tickets mit Ihrer Server-ID und den aktuellen Logs.
• Bot reagiert nicht auf Befehle:
  • Präfix-Probleme: Überprüfen Sie das Befehlspräfix des Bots in seiner Konfiguration. Einige Bots verwenden ein Standardpräfix (z.B. !, /, .)
  • Fehlende Berechtigungen: Stellen Sie sicher, dass der Bot die notwendigen Berechtigungen auf dem Discord-Server hat, auf den er eingeladen wurde.
  • Bot offline: Überprüfen Sie die Serverkonsole im ServerPrism-Panel auf Fehler. Wenn der Bot abgestürzt ist, zeigt die Konsole relevante Fehlermeldungen an.

Nächste Schritte

• Anpassen: Beachten Sie die offizielle Dokumentation Ihres gewählten Bots für erweiterte Konfigurationen, das Hinzufügen benutzerdefinierter Befehle oder die Integration mit anderen Diensten.
• Laufzeitumgebung wechseln: Wenn Sie einen anderen Typ von Discord-Bot ausprobieren möchten, können Sie die Laufzeitumgebung direkt über den 'Startup'-Tab in Ihrem ServerPrism-Panel wechseln, ohne Ihren Server neu bestellen zu müssen.
• Plan upgraden: Wenn Ihr Bot Leistungsprobleme hat oder Sie seine Nutzung skalieren möchten, können Sie den RAM und die CPU Ihres Servers einfach über Ihr ServerPrism-Client-Dashboard upgraden.