JMusicBot auf ServerPrism einrichten

JMusicBot ist ein leistungsstarker und benutzerfreundlicher Discord-Musikbot. Diese Anleitung behandelt die Erstellung Ihres Bots in Discord, das Einladen auf Ihren Server, die Konfiguration auf ServerPrism und das Online-Schalten.

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. "My Music Bot") 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 diesen Token sofort. Sie benötigen ihn für Ihre ServerPrism-Konfiguration. Halten Sie ihn geheim!
8. Scrollen Sie nach unten zu Privileged Gateway Intents.
9. Aktivieren Sie den Schalter Message Content Intent. JMusicBot benötigt dies, um Befehle wie !play song name zu lesen.

Laden Sie den Bot auf Ihren Server ein

1. Gehen Sie zum Tab OAuth2 und wählen Sie dann in der linken Seitenleiste URL Generator.
2. Wählen Sie unter SCOPES bot.
3. Wählen Sie unter BOT PERMISSIONS die folgenden Berechtigungen aus:
   • Read Messages/View Channels
   • Send Messages
   • Connect
   • Speak
   • Use Voice Activity
   • Manage Messages (empfohlen für die Warteschlangenverwaltung)
   • Read Message History
4. Kopieren Sie die generierte URL am unteren Rand der Seite.
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. Klicken Sie auf Authorize.

Bestellung auf ServerPrism

Als Sie Ihren Discord-Bot-Server bestellt haben, haben Sie wahrscheinlich JMusicBot als Laufzeitumgebung ausgewählt. Ein 1 GB RAM-Plan ist in der Regel ausreichend für JMusicBot. Sie haben während des Bestellvorgangs Ihre bevorzugte Region ausgewählt, und Ihr Server ist nun bereitgestellt und wartet auf die Konfiguration.

Startvariablen konfigurieren

Ihre JMusicBot-Instanz auf ServerPrism verwendet Umgebungsvariablen zur Konfiguration. Diese legen Sie im Tab Startup Ihres Server-Panels fest.

1. Navigieren Sie zum Panel Ihres Servers auf ServerPrism.

2. Klicken Sie auf den Tab Startup.

3. Suchen Sie die folgenden Variablen und legen Sie deren Werte fest:

   • BOT_TOKEN: Fügen Sie den Bot-Token ein, den Sie aus dem Discord Developer Portal kopiert haben.
   • PREFIX: Legen Sie Ihr gewünschtes Befehlspräfix fest (z.B. !, ?, j!). So interagieren Benutzer mit Ihrem Bot (z.B. !play).
   • OWNER_ID: Ihre Discord-Benutzer-ID. Dies gewährt Ihnen spezielle administrative Befehle. 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 "ID kopieren".
   • SPOTIFY_CLIENT_ID (Optional): Wenn Sie Spotify-Integration wünschen, erstellen Sie hier eine Spotify Developer-Anwendung und holen Sie sich Ihre Client ID.
   • SPOTIFY_CLIENT_SECRET (Optional): Das Client Secret für Ihre Spotify Developer-Anwendung.
   • YOUTUBE_API_KEY (Optional, aber empfohlen): Obwohl JMusicBot oft auch ohne funktioniert, hilft ein YouTube API-Schlüssel bei der Suchzuverlässigkeit und vermeidet Ratenbegrenzungen. Holen Sie sich einen von der Google Cloud Console.

   Hinweis: JMusicBot benötigt für seinen grundlegenden Betrieb in der Regel keine MONGODB_URI oder ähnliche Datenbankverbindungszeichenfolge, da er eine einfache dateibasierte Konfiguration verwendet.

4. Speichern Sie alle Änderungen.

Erster Start

1. Gehen Sie zum Tab Console in Ihrem ServerPrism-Panel.
2. Klicken Sie auf die Schaltfläche Start.
3. Beobachten Sie die Konsolenausgabe. Ein erfolgreicher Start zeigt Meldungen an, die darauf hinweisen, dass der Bot sich mit Discord verbindet, Befehle lädt und schließlich eine Zeile ähnlich [INFO] JMusicBot is ready! oder [INFO] Logged in as <YourBotName>#<Discriminator> anzeigt. Der Status Ihres Bots in Discord ändert sich auf online.

Häufige Probleme

• Bot geht nicht online / Token abgelehnt: Überprüfen Sie Ihren BOT_TOKEN im Tab Startup. Stellen Sie sicher, dass keine zusätzlichen Leerzeichen oder falschen Zeichen vorhanden sind. Generieren Sie den Token bei Bedarf im Discord Developer Portal neu.
• Bot online, reagiert aber nicht auf Befehle: Vergewissern Sie sich, dass Sie den Message Content Intent im Discord Developer Portal unter dem Tab Bot aktiviert haben. Stellen Sie außerdem sicher, dass Ihr PREFIX korrekt eingestellt ist und Sie ihn verwenden (z.B. !play, wenn Ihr Präfix ! ist). Überprüfen Sie die Konsole auf Fehlermeldungen, wenn Sie versuchen, einen Befehl zu verwenden.
• Bot im Sprachkanal, aber kein Audio: Stellen Sie sicher, dass der Bot die Berechtigungen Connect und Speak in dem Kanal oder der Kategorie hat, dem/der er beitreten möchte. Überprüfen Sie auch die Konsole auf Fehler im Zusammenhang mit der Audiowiedergabe.

Nächste Schritte

Nachdem Ihr JMusicBot läuft, können Sie seine Befehle erkunden, indem Sie Ihr PREFIX gefolgt von help eingeben (z.B. !help). Sie können Warteschlangen verwalten, Songs überspringen, die Lautstärke anpassen und vieles mehr. Für erweiterte Konfiguration oder Fehlerbehebung lesen Sie das offizielle JMusicBot GitHub-Repository.

Haftungsausschluss: Das Streamen von Audio von YouTube mithilfe von Bots kann gegen die Nutzungsbedingungen von YouTube verstoßen. Discord kann Bot-Tokens widerrufen, die gegen diese Bestimmungen verstoßen.