Configuration de JMusicBot sur ServerPrism

JMusicBot est un bot musical Discord puissant et facile à utiliser. Ce guide couvre la création de votre bot dans Discord, son invitation sur votre serveur, sa configuration sur ServerPrism et sa mise en ligne.

Créez votre bot dans le portail des développeurs Discord

1. Accédez au portail des développeurs Discord.
2. Cliquez sur New Application.
3. Donnez un nom à votre application (par exemple, "Mon Bot Musical") et cliquez sur Create.
4. Naviguez vers l'onglet Bot dans la barre latérale gauche.
5. Cliquez sur Add Bot, puis sur Yes, do it!.
6. Sous TOKEN, cliquez sur Reset Token, puis sur Yes, do it!.
7. Copiez ce token immédiatement. Vous en aurez besoin pour votre configuration ServerPrism. Gardez-le secret !
8. Faites défiler jusqu'à Privileged Gateway Intents.
9. Activez le bouton Message Content Intent. JMusicBot en a besoin pour lire des commandes comme !play nom de la chanson.

Invitez le bot sur votre serveur

1. Allez dans l'onglet OAuth2, puis sélectionnez URL Generator dans la barre latérale gauche.
2. Sous SCOPES, sélectionnez bot.
3. Sous BOT PERMISSIONS, sélectionnez les éléments suivants :
   • Read Messages/View Channels
   • Send Messages
   • Connect
   • Speak
   • Use Voice Activity
   • Manage Messages (recommandé pour la gestion de la file d'attente)
   • Read Message History
4. Copiez l'URL générée en bas de la page.
5. Collez l'URL dans votre navigateur et sélectionnez le serveur Discord sur lequel vous souhaitez inviter le bot. Cliquez sur Authorize.

Commande sur ServerPrism

Lorsque vous avez commandé votre serveur de bot Discord, vous avez probablement sélectionné JMusicBot comme environnement d'exécution. Un plan de 1 Go de RAM est généralement suffisant pour JMusicBot. Vous avez choisi votre région préférée pendant le processus de commande, et votre serveur est maintenant déployé et en attente de configuration.

Configurez les variables de démarrage

Votre instance JMusicBot sur ServerPrism utilise des variables d'environnement pour la configuration. Vous les définissez dans l'onglet Startup de votre panneau de serveur.

1. Naviguez vers le panneau de votre serveur sur ServerPrism.

2. Cliquez sur l'onglet Startup.

3. Localisez les variables suivantes et définissez leurs valeurs :

   • BOT_TOKEN : Collez le token du bot que vous avez copié depuis le portail des développeurs Discord.
   • PREFIX : Définissez le préfixe de commande souhaité (par exemple, !, ?, j!). C'est ainsi que les utilisateurs interagiront avec votre bot (par exemple, !play).
   • OWNER_ID : Votre ID d'utilisateur Discord. Cela vous accorde des commandes administratives spéciales. Pour trouver votre ID d'utilisateur, activez le mode développeur dans Discord (Paramètres utilisateur > Avancé), puis faites un clic droit sur votre nom d'utilisateur et sélectionnez "Copier l'ID".
   • SPOTIFY_CLIENT_ID (Facultatif) : Si vous souhaitez l'intégration Spotify, créez une application Spotify Developer ici et obtenez votre ID client.
   • SPOTIFY_CLIENT_SECRET (Facultatif) : Le secret client de votre application Spotify Developer.
   • YOUTUBE_API_KEY (Facultatif mais recommandé) : Bien que JMusicBot puisse souvent fonctionner sans, une clé API YouTube améliore la fiabilité de la recherche et évite les limites de débit. Obtenez-en une depuis la Google Cloud Console.

   Note : JMusicBot ne nécessite généralement pas de MONGODB_URI ou de chaîne de connexion de base de données similaire pour son fonctionnement de base, car il utilise une configuration simple basée sur des fichiers.

4. Enregistrez toutes les modifications.

Premier démarrage

1. Allez dans l'onglet Console de votre panneau ServerPrism.
2. Cliquez sur le bouton Start.
3. Observez la sortie de la console. Un démarrage réussi affichera des messages indiquant que le bot se connecte à Discord, charge les commandes, et finalement une ligne similaire à [INFO] JMusicBot is ready! ou [INFO] Logged in as <YourBotName>#<Discriminator>. Le statut de votre bot dans Discord passera à en ligne.

Problèmes courants

• Le bot ne se connecte pas / Token rejeté : Vérifiez à nouveau votre BOT_TOKEN dans l'onglet Startup. Assurez-vous qu'il n'y a pas d'espaces supplémentaires ou de caractères incorrects. Régénérez le token dans le portail des développeurs Discord si nécessaire.
• Le bot est en ligne mais ne répond pas aux commandes : Vérifiez que vous avez activé le Message Content Intent dans le portail des développeurs Discord sous l'onglet Bot. Assurez-vous également que votre PREFIX est correctement défini et que vous l'utilisez (par exemple, !play si votre préfixe est !). Vérifiez la console pour tout message d'erreur lorsque vous essayez d'utiliser une commande.
• Le bot est dans un canal vocal mais pas d'audio : Assurez-vous que le bot dispose des permissions Connect et Speak dans le canal ou la catégorie qu'il essaie de rejoindre. Vérifiez également la console pour toute erreur liée à la lecture audio.

Prochaines étapes

Maintenant que votre JMusicBot est en marche, vous pouvez explorer ses commandes en tapant votre PREFIX suivi de help (par exemple, !help). Vous pouvez gérer les files d'attente, sauter des chansons, ajuster le volume, et bien plus encore. Pour une configuration avancée ou un dépannage, consultez le dépôt GitHub officiel de JMusicBot.

Avertissement : La diffusion audio depuis YouTube à l'aide de bots peut violer les conditions d'utilisation de YouTube. Discord peut révoquer les tokens de bot jugés en violation.