CorpBot auf ServerPrism einrichten

CorpBot ist ein Python-basierter Discord-Bot mit verschiedenen Funktionen. Diese Anleitung führt Sie durch die Einrichtung Ihrer CorpBot-Instanz auf ServerPrism, von der Konfiguration im Discord Developer Portal bis zum ersten Start.

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. CorpBot Instance) und klicken Sie auf Create.
4. Navigieren Sie in der linken Seitenleiste zum Tab Bot.
5. Klicken Sie auf Add Bot und dann auf Yes, Do It!.
6. Klicken Sie unter TOKEN auf Reset Token und dann auf Yes, Do It!.
7. Kopieren Sie den angezeigten Token. Sie benötigen diesen für Ihr ServerPrism-Panel.
8. Scrollen Sie nach unten zu Privileged Gateway Intents.
9. Aktivieren Sie Message Content Intent. CorpBot benötigt das Lesen von Nachrichteninhalten für viele seiner Befehle.

Laden Sie den Bot auf Ihren Server ein

1. Gehen Sie zum Tab OAuth2 und klicken Sie dann auf URL Generator.
2. Wählen Sie unter SCOPES die Option bot.
3. Wählen Sie unter BOT PERMISSIONS die Berechtigungen aus, die Ihr Bot benötigt. Für einen Allzweck-Bot wie CorpBot sind gängige Optionen:
   • Read Messages/View Channels
   • Send Messages
   • Embed Links
   • Attach Files
   • Manage Messages (wenn der Bot Moderationsfunktionen hat)
   • Kick Members / Ban Members (wenn Sie Moderationsbefehle verwenden möchten)
4. Kopieren Sie die generierte URL am unteren Rand der Seite.
5. Fügen Sie diese URL in Ihren Browser ein und drücken Sie die Eingabetaste.
6. Wählen Sie den Discord-Server aus, dem Sie den Bot hinzufügen möchten, und klicken Sie auf Authorize.

Bestellung auf ServerPrism

Sie haben Ihr ServerPrism Discord Bots-Produkt bereits bestellt und CorpBot ausgewählt. Die typische 1 GB RAM-Zuweisung ist für CorpBot in der Regel ausreichend. Ihr Server wird in der von Ihnen gewählten Region bereitgestellt und ist bereit zur Konfiguration.

Startvariablen konfigurieren

1. Melden Sie sich bei Ihrem ServerPrism-Panel an.
2. Navigieren Sie zu Ihrer CorpBot-Serverinstanz.
3. Klicken Sie auf den Tab Startup.
4. Sie sehen Felder für Umgebungsvariablen. Konfigurieren Sie die folgenden:
   • BOT_TOKEN: Fügen Sie den Bot-Token ein, den Sie aus dem Discord Developer Portal kopiert haben.
   • PREFIX: Legen Sie das Befehlspräfix für Ihren Bot fest (z.B. !, /, cb!). Dies ist das, was Benutzer vor Befehlen eingeben werden.
   • OWNER_ID: Geben Sie Ihre Discord-Benutzer-ID ein. Dies gewährt Ihnen spezielle Berechtigungen auf Eigentümer-Ebene für den Bot. Um Ihre Benutzer-ID zu finden, aktivieren Sie den Entwicklermodus in Discord (Benutzereinstellungen > Erweitert), klicken Sie dann mit der rechten Maustaste auf Ihren Benutzernamen und wählen Sie Copy ID.
   • MONGODB_URI: CorpBot kann MongoDB zur Datenspeicherung verwenden. Wenn Sie Funktionen nutzen möchten, die persistente Daten erfordern, geben Sie hier eine MongoDB-Verbindungszeichenfolge an. Wenn Sie keine haben, können Sie dieses Feld leer lassen, aber einige Funktionen funktionieren möglicherweise nicht. Sie können dies bei Bedarf später einrichten.

Erster Start

1. Nachdem Sie Ihre Startvariablen konfiguriert haben, gehen Sie zum Tab Console in Ihrem ServerPrism-Panel.
2. Klicken Sie auf die Schaltfläche Start.
3. Überwachen Sie die Konsolenausgabe. Ein erfolgreicher Start zeigt Meldungen an, die darauf hinweisen, dass der Bot eine Verbindung zu Discord herstellt und sich anmeldet. Sie sollten eine Ausgabe ähnlich der folgenden sehen:

   [INFO] CorpBot.py started!
   [INFO] Logged in as CorpBot Instance#1234 (123456789012345678)
   

4. Überprüfen Sie Ihren Discord-Server. Ihr Bot sollte in der Mitgliederliste als online angezeigt werden.

Häufige Probleme

• Bot-Token abgelehnt/Ungültiger Token: Überprüfen Sie den BOT_TOKEN in Ihrem Startup-Tab. Stellen Sie sicher, dass keine zusätzlichen Leerzeichen vorhanden sind und es sich um den korrekten Token aus dem Discord Developer Portal handelt.
• Bot ist online, reagiert aber nicht auf Befehle: Stellen Sie sicher, dass Message Content Intent im Discord Developer Portal unter den Einstellungen Ihres Bots aktiviert ist. Stellen Sie außerdem sicher, dass Ihre PREFIX-Variable korrekt eingestellt ist und Sie diese in Discord verwenden (z.B. !help). Überprüfen Sie die Konsole auf Fehlermeldungen bezüglich der Befehlsanalyse.
• Bot geht sofort nach dem Start offline: Überprüfen Sie die Konsole auf Python-Traceback-Fehler. Dies deutet oft auf eine Fehlkonfiguration oder eine fehlende Abhängigkeit hin, obwohl ServerPrism gängige Abhängigkeiten für CorpBot vorinstalliert. Wenn Sie Fehler im Zusammenhang mit pymongo sehen, stellen Sie sicher, dass Ihre MONGODB_URI korrekt ist, oder entfernen Sie sie, wenn Sie MongoDB nicht verwenden möchten.

Nächste Schritte

Nachdem Ihr CorpBot nun läuft, können Sie seine Befehle auf Ihrem Discord-Server verwenden. Im CorpBot.py GitHub-Repository finden Sie eine Liste der verfügbaren Befehle und weitere Konfigurationsoptionen. Erkunden Sie die Funktionen des Bots und passen Sie ihn an die Bedürfnisse Ihres Servers an.