fragbot auf ServerPrism einrichten

fragbot ist der offizielle Discord-Bot für Fragforce und bietet verschiedene Dienstprogramme. Diese Anleitung behandelt die Erstellung Ihrer Bot-Anwendung, die Einladung auf Ihren Server, die Konfiguration auf ServerPrism und die Inbetriebnahme.

Erstellen Sie Ihren Bot im Discord Developer Portal

1. Gehen Sie zum Discord Developer Portal.
2. Klicken Sie auf New Application.
3. Geben Sie Ihrer Anwendung einen Namen (z.B. fragbot) und klicken Sie auf Create.
4. Navigieren Sie in der linken Seitenleiste zum Tab Bot.
5. Klicken Sie auf Add Bot, dann auf Yes, do it!.
6. Klicken Sie unter TOKEN auf Reset Token, dann auf Yes, do it!.
7. Kopieren Sie diesen Token sofort. Sie benötigen ihn für Ihre ServerPrism-Konfiguration. Bewahren Sie ihn sicher auf; geben Sie ihn nicht weiter.
8. Aktivieren Sie unter Privileged Gateway Intents die Option MESSAGE CONTENT INTENT. fragbot benötigt dies, um Nachrichten zu lesen und auf Befehle zu antworten.

Laden Sie den Bot auf Ihren Server ein

1. Gehen Sie zum Tab OAuth2, dann zu URL Generator.
2. Wählen Sie unter SCOPES die Optionen bot und applications.commands.
3. Wählen Sie unter BOT PERMISSIONS die Berechtigungen aus, die Ihr Bot benötigt. Für fragbot ist ein guter Ausgangspunkt:
   • Read Messages/View Channels
   • Send Messages
   • Embed Links
   • Attach Files
   • Manage Messages (wenn Sie möchten, dass er Nachrichten löscht, z.B. für die Moderation)
4. Kopieren Sie die generierte URL unten.
5. Fügen Sie die URL in Ihren Browser ein und wählen Sie den Discord-Server aus, auf den Sie den Bot einladen möchten.
6. Klicken Sie auf Authorize.

Bestellung auf ServerPrism

Bei der Bestellung Ihres Discord-Bot-Servers auf ServerPrism sind 1 GB RAM für fragbot in der Regel ausreichend. Wählen Sie die Region, die Ihrer primären Benutzerbasis am nächsten liegt, um eine optimale Leistung zu erzielen. Nach der Bestellung wird Ihr Server bereitgestellt und das fragbot-Paket vorinstalliert.

Startvariablen konfigurieren

Im 'Startup'-Tab Ihres ServerPrism-Panels konfigurieren Sie fragbot mithilfe von Umgebungsvariablen. Diese Variablen teilen dem Bot mit, wie er sich mit Discord verbinden und welches Präfix er für Befehle verwenden soll.

Legen Sie die folgenden Variablen fest:

• BOT_TOKEN: Fügen Sie den Bot-Token ein, den Sie aus dem Discord Developer Portal kopiert haben.
• PREFIX: Das Befehlspräfix, auf das Ihr Bot reagiert. Eine gängige Wahl ist !. Wenn Sie PREFIX beispielsweise auf ! setzen, würden Sie !help verwenden.
• OWNER_ID: Die Discord-Benutzer-ID des Bot-Besitzers. Sie können Ihre Benutzer-ID erhalten, indem Sie den Entwicklermodus in Discord aktivieren (Benutzereinstellungen > Erweitert) und dann mit der rechten Maustaste auf Ihren Benutzernamen klicken und Copy ID auswählen.

fragbot erfordert möglicherweise zusätzliche Konfigurationen, abhängig von seinen Funktionen. Konsultieren Sie das fragbot GitHub-Repository für spezifische, erweiterte Umgebungsvariablen, die es für Funktionen wie Datenbankverbindungen oder API-Schlüssel verwenden könnte.

Erster Start

1. Nachdem Sie die Umgebungsvariablen festgelegt haben, navigieren Sie zum 'Console'-Tab in Ihrem ServerPrism-Panel.
2. Klicken Sie auf die Schaltfläche Start.
3. Beobachten Sie die Konsolenausgabe. Ein erfolgreicher Start zeigt typischerweise Meldungen an, die darauf hinweisen, dass der Bot sich mit Discord verbindet und anmeldet, gefolgt von einer Meldung wie Bot is ready! oder Logged in as fragbot#1234.
4. Ihr Bot sollte nun auf Ihrem Discord-Server als online erscheinen.

Häufige Probleme

• Bot-Token abgelehnt/ungültiger Token: Überprüfen Sie, ob BOT_TOKEN in Ihrem 'Startup'-Tab genau der Token ist, den Sie aus dem Developer Portal kopiert haben. Stellen Sie sicher, dass keine führenden/nachfolgenden Leerzeichen vorhanden sind.
• Bot online, reagiert aber nicht auf Befehle: Vergewissern Sie sich, dass Sie die MESSAGE CONTENT INTENT im Discord Developer Portal unter den Einstellungen Ihres Bots aktiviert haben. Ohne dies kann der Bot den Nachrichteninhalt nicht lesen, um Befehle zu verarbeiten.
• Bot geht nicht online: Überprüfen Sie die Konsole auf Fehler. Häufige Probleme sind ein falscher BOT_TOKEN oder fehlende erforderliche Umgebungsvariablen. Stellen Sie sicher, dass alle notwendigen Variablen im 'Startup'-Tab festgelegt sind.

Nächste Schritte

Nachdem fragbot läuft, können Sie seine Befehle erkunden. Verwenden Sie den Befehl !help (oder das von Ihnen konfigurierte Präfix) auf Ihrem Discord-Server, um eine Liste der verfügbaren Befehle anzuzeigen. Für eine erweiterte Konfiguration oder um spezifische Funktionen zu verstehen, konsultieren Sie das fragbot GitHub-Repository.