Red Discord Bot einrichten

Diese Anleitung führt Sie durch die Einrichtung des Red Discord Bots auf ServerPrism, von der Erstellung des Bots im Discord-Entwicklerportal über die Beanspruchung des Besitzers bis zum Laden Ihrer ersten Cogs.

Bevor Sie beginnen

Sie benötigen ein Discord-Konto und einen Server, auf dem Sie die Berechtigung Server verwalten haben.

1. Erstellen Sie Ihren Bot im Discord Developer Portal

1. Gehen Sie zu discord.com/developers/applications und klicken Sie auf New Application.
2. Geben Sie ihm einen Namen (dies ist die Identität Ihres Bots – wählen Sie etwas, mit dem Sie zufrieden sind), akzeptieren Sie die Bedingungen und klicken Sie auf Create.
3. Klicken Sie in der linken Seitenleiste auf Bot.
4. Klicken Sie unter dem Benutzernamen des Bots auf Reset Token und kopieren Sie den Token an einen sicheren Ort. Sie werden ihn gleich in ServerPrism einfügen. Behandeln Sie dies wie ein Passwort – jeder, der es besitzt, kann Ihren Bot steuern.

2. Privileged Gateway Intents aktivieren

Dieser Schritt ist entscheidend – Red weigert sich zu starten, wenn nicht alle drei Intents aktiviert sind, und beendet sich mit CONFIGURATION_ERROR (Exit-Code 78).

Bleiben Sie auf der Seite Bot, scrollen Sie nach unten zu Privileged Gateway Intents und aktivieren Sie:

• Presence Intent
• Server Members Intent
• Message Content Intent

Klicken Sie unten auf Save Changes.

3. Laden Sie den Bot auf Ihren Discord-Server ein

1. Klicken Sie in der linken Seitenleiste auf OAuth2 → URL Generator.
2. Unter Scopes aktivieren Sie bot und applications.commands.
3. Unter Bot Permissions aktivieren Sie die Berechtigungen, die der Bot haben soll. Für die meisten Setups ist Administrator der einfachste Ausgangspunkt – Sie können dies später einschränken.
4. Kopieren Sie die generierte URL unten, öffnen Sie sie in einem neuen Tab, wählen Sie Ihren Discord-Server und autorisieren Sie.

Der Bot tritt Ihrem Server bei, wird aber als offline angezeigt, bis Sie ihn auf ServerPrism starten.

4. Bestellen Sie Red Discord Bot auf ServerPrism

1. Gehen Sie zur Discord Bots Kategorie auf unserer Website und wählen Sie das Produkt Red Discord Bot.
2. Wählen Sie einen Plan (1 GB RAM ist für die meisten Setups ausreichend), wählen Sie eine Region in Ihrer Nähe und schließen Sie die Bestellung ab.
3. Während der Bestellung werden Sie nach Folgendem gefragt:
   • Discord Bot Token – fügen Sie den Token aus Schritt 1 ein.
   • Command Prefix – das Zeichen, das Benutzer vor Befehlen eingeben, z.B. ! oder <. Sie können dies später in Discord ändern.
4. Nach der Bereitstellung installiert das Panel Red und startet den Bot. Die erste Installation dauert ein paar Minuten (pip-Installationen + Abhängigkeiten).

5. Besitz in Discord beanspruchen

Wenn der Bot online ist, müssen Sie Red mitteilen, wer sein Besitzer ist, damit Sie Admin-Befehle ausführen können.

1. Senden Sie in Discord Ihrem Bot den Befehl <set owner (ersetzen Sie < durch Ihr Präfix) als Direktnachricht.

2. Red gibt einen einmaligen Bestätigungstoken in der Panel-Konsole aus – Sie sehen etwas Ähnliches wie:

   Use the command [p]set owner XXXXXX in DM to confirm
   

3. Kopieren Sie diesen Bestätigungstoken aus der Konsole und senden Sie dann dem Bot eine Direktnachricht:

   <set owner XXXXXX
   

4. Red antwortet mit „I now recognise you as my owner.“ Sie sind fertig – Admin-Befehle funktionieren jetzt für Sie.

6. Laden Sie Ihre ersten Cogs

Cogs sind Reds Plugins. Um das Herunterladen und Installieren zu ermöglichen:

<load downloader
<repo add aikaterna-cogs https://github.com/aikaterna/aikaterna-cogs
<cog install aikaterna-cogs trivia
<load trivia

Durchsuchen Sie den Red Cogs Index nach Hunderten weiteren Cogs. Jeder hat Installationsanweisungen auf seiner Seite.

Häufige Probleme

„redbot: command not found“ beim ersten Start

Der Installer wurde nicht abgeschlossen. Dies war ein bekannter Fehler in unserem Red-Egg, der jetzt behoben ist – wenn Sie ihn bei einer Neuinstallation feststellen, öffnen Sie ein Support-Ticket und wir werden das Egg auf Ihrem Server neu installieren.

„You need to configure the bot instance using redbot-setup prior to running the bot“

Die Instanzkonfigurationsdatei fehlt. Wie oben – öffnen Sie ein Ticket und wir werden es beheben. Eine Neuinstallation des Servers über das Panel behebt dies auch bei frisch bereitgestellten Eggs.

Exit-Code 78 / „Red requires all Privileged Intents to be enabled“

Gehen Sie zurück zu Schritt 2 oben und aktivieren Sie alle drei privilegierten Intents im Discord Developer Portal. Sie sind standardmäßig deaktiviert.

Bot ist online, reagiert aber nicht auf Befehle

Zwei häufige Ursachen:

1. Message Content Intent ist deaktiviert – überprüfen Sie Schritt 2 erneut. Ohne dies kann der Bot den Nachrichtentext nicht sehen.
2. Sie verwenden das falsche Präfix – überprüfen Sie Ihre Panel-Konsole auf das Präfix, mit dem der Bot gestartet wurde, oder verwenden Sie @YourBot prefix in Discord (das Erwähnen des Bots funktioniert immer, unabhängig vom Präfix).

Ändern des Bot-Präfixes

<set prefix !

Das neue Präfix wird sofort wirksam.

Hilfe erhalten

Für Red-spezifische Fragen ist die offizielle Red-Dokumentation die beste Ressource. Für ServerPrism-Hosting-Fragen – Abrechnung, Planänderungen, Leistung – öffnen Sie ein Support-Ticket und wir werden uns bei Ihnen melden.