pixel-bot auf ServerPrism einrichten

Dieser Leitfaden führt Sie durch die Einrichtung von pixel-bot, einem Python-basierten Discord-Bot, auf Ihrem ServerPrism-Server. Sie erstellen Ihre Bot-Anwendung in Discord, laden sie auf Ihren Server ein und konfigurieren sie auf ServerPrism.

Erstellen Sie Ihren Bot im Discord Developer Portal

1. Gehen Sie zum Discord Developer Portal.
2. Klicken Sie auf New Application.
3. Geben Sie einen Namen für Ihren Bot ein (z.B. pixel-bot) und klicken Sie auf Create.
4. Klicken Sie in der linken Seitenleiste auf 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! Kopieren Sie diesen Token sofort; Sie werden ihn später benötigen. Halten Sie ihn geheim.
7. Aktivieren Sie unter Privileged Gateway Intents die Option Message Content Intent. pixel-bot benötigt dies, um Nachrichten zu lesen und auf Befehle zu antworten.

Laden Sie den Bot auf Ihren Server ein

1. Gehen Sie im Discord Developer Portal zur Anwendung Ihres Bots.
2. Klicken Sie in der linken Seitenleiste auf OAuth2 -> URL Generator.
3. Wählen Sie unter SCOPES die Option bot.
4. Wählen Sie unter BOT PERMISSIONS die Berechtigungen aus, die Ihr Bot benötigt. Für pixel-bot sind Send Messages und Read Message History gute Ausgangspunkte.
5. Kopieren Sie die generierte URL am unteren Rand der Seite.
6. Fügen Sie die URL in Ihren Browser ein und wählen Sie den Discord-Server aus, zu dem Sie den Bot einladen möchten. Klicken Sie auf Authorize.

Bestellung auf ServerPrism

Bei der Bestellung Ihres Discord-Bot-Servers auf ServerPrism ist ein 1 GB RAM-Plan für pixel-bot in der Regel ausreichend. Wählen Sie eine Region, die Ihren Benutzern am nächsten liegt, um eine optimale Leistung zu erzielen. Nach der Bestellung wird Ihr Server automatisch mit der vorinstallierten pixel-bot-Laufzeitumgebung bereitgestellt.

Startvariablen konfigurieren

Ihr ServerPrism-Panel ermöglicht es Ihnen, Umgebungsvariablen für Ihren Bot festzulegen. Diese sind entscheidend für seinen Betrieb.

1. Navigieren Sie im ServerPrism-Panel zum Server Ihres Bots.

2. Klicken Sie auf den Tab Startup.

3. Legen Sie die folgenden Umgebungsvariablen fest:

   • BOT_TOKEN: Fügen Sie den Bot-Token ein, den Sie aus dem Discord Developer Portal kopiert haben.
   • PREFIX: Legen Sie dies auf Ihr gewünschtes Befehlspräfix fest (z.B. !, /, p!). So interagieren Benutzer mit Ihrem Bot (z.B. !ping).
   • OWNER_ID: Ihre Discord-Benutzer-ID. Diese ist für einige Admin-Befehle erforderlich. Um Ihre Benutzer-ID zu erhalten, aktivieren Sie den Entwicklermodus in Discord (Benutzereinstellungen > Erweitert), klicken Sie dann mit der rechten Maustaste auf Ihr Profil und wählen Sie Copy ID.

   Der 'Startup'-Tab kann auch andere Variablen auflisten. Beachten Sie das offizielle pixel-bot GitHub-Repository für zusätzliche Konfigurationen, die für bestimmte Funktionen spezifisch sind:

   • pixel-bot GitHub

Erster Start

1. Gehen Sie im ServerPrism-Panel zum Tab Console.

2. Klicken Sie auf Start.

3. Beobachten 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] discord.client: logging in using static token
   [INFO] discord.gateway: Shard ID 0 has connected to Gateway (Session ID: ...)
   [INFO] discord.client: Ready! Logged in as pixel-bot#1234 (ID: ...)
   

4. Überprüfen Sie Ihren Discord-Server; Ihr Bot sollte online erscheinen.

Häufige Probleme

• Bot-Token abgelehnt: Überprüfen Sie, ob BOT_TOKEN im Tab Startup korrekt ist und keine zusätzlichen Leerzeichen enthält. Generieren Sie den Token im Developer Portal neu, wenn Sie unsicher sind.
• Bot online, reagiert aber nicht: Stellen Sie sicher, dass Message Content Intent im Discord Developer Portal unter den Einstellungen Ihres Bots aktiviert ist. Ohne diese kann der Bot keine Nachrichtenbefehle lesen.
• Bot geht nicht online: Überprüfen Sie die Konsolenprotokolle auf Fehlermeldungen. Häufige Probleme sind falsche Tokens, fehlende Umgebungsvariablen oder kritische Fehler im Bot-Code. Stellen Sie sicher, dass alle erforderlichen Startup-Variablen gesetzt sind.

Nächste Schritte

Ihr pixel-bot läuft jetzt! Sie können seine Befehle auf Ihrem Discord-Server verwenden. Eine Liste der verfügbaren Befehle und weitere Anpassungsoptionen finden Sie im pixel-bot GitHub-Repository.