Configurer Sinusbot sur ServerPrism

Sinusbot est un puissant bot musical pour Discord et TeamSpeak. Ce guide se concentre sur la mise en marche de votre instance Sinusbot pour Discord sur votre serveur ServerPrism.

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

1. Rendez-vous sur le portail des développeurs Discord.
2. Cliquez sur New Application.
3. Donnez un nom à votre application (par exemple, "My Sinusbot") 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! pour révéler le jeton de votre bot. Copiez ce jeton immédiatement ; vous en aurez besoin pour la configuration de votre ServerPrism. Gardez ce jeton privé !
7. Faites défiler jusqu'à Privileged Gateway Intents.
8. Activez le bouton Message Content Intent. Sinusbot en a besoin pour lire les commandes et les liens des messages.

Inviter le bot sur votre serveur

1. Dans le portail des développeurs Discord, allez dans l'onglet OAuth2, puis URL Generator.
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
4. Copiez l'URL générée en bas de la page.
5. Collez cette URL dans votre navigateur et appuyez sur Entrée. Sélectionnez le serveur Discord auquel vous souhaitez ajouter le bot et autorisez-le.

Commande sur ServerPrism

Vous avez déjà commandé votre produit Discord Bots et sélectionné Sinusbot comme runtime. Pour un bot musical, 1 Go de RAM est généralement suffisant pour une seule instance. Votre serveur est maintenant déployé dans la région choisie.

Configurer les variables de démarrage

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

1. BOT_TOKEN : Collez ici le jeton de bot que vous avez copié depuis le portail des développeurs Discord.
2. PREFIX : Définissez le préfixe de commande pour votre bot (par exemple, !). Les utilisateurs l'utiliseront avant des commandes comme !play.
3. TS3_ENABLED : Réglez sur false si vous n'utilisez que Discord. (Sinusbot est également un bot TeamSpeak).
4. TS3_API_KEY : Laissez vide si TS3_ENABLED est false.
5. YOUTUBE_API_KEY : (Facultatif, mais fortement recommandé pour la lecture YouTube). Obtenez une clé API YouTube Data v3 depuis la Google Cloud Console. Sans cela, la lecture YouTube peut être peu fiable ou échouer.

Référez-vous à l'onglet Startup de votre panneau pour toutes les options de configuration disponibles.

Premier démarrage

1. Après avoir défini vos variables d'environnement dans l'onglet Startup, naviguez vers l'onglet Console.
2. Cliquez sur le bouton Start.
3. Surveillez la sortie de la console. Un démarrage réussi affichera des messages indiquant que le bot se connecte à Discord et initialise ses services. Recherchez des messages comme "Discord bot connected!" ou similaires.
4. Vérifiez votre serveur Discord. Votre bot devrait apparaître en ligne dans votre liste de membres.
5. Rejoignez un canal vocal et essayez une commande, par exemple, !play [URL YouTube] (en utilisant votre préfixe configuré).

Problèmes courants

• Le bot ne se connecte pas/Jeton rejeté : Vérifiez à nouveau votre BOT_TOKEN dans l'onglet Startup. Assurez-vous qu'il n'y a pas d'espaces supplémentaires et qu'il s'agit du jeton exact du portail des développeurs Discord.
• Le bot est en ligne mais ne répond pas aux commandes : Vérifiez que l'option Message Content Intent est activée dans le portail des développeurs Discord sous les paramètres de votre bot. Assurez-vous également que le bot dispose des autorisations nécessaires (en particulier Send Messages) dans les paramètres du canal de votre serveur Discord.
• Problèmes de lecture YouTube : Assurez-vous d'avoir une YOUTUBE_API_KEY valide configurée. Sans elle, la fonctionnalité YouTube est sévèrement limitée ou défaillante.
• Le bot ne rejoint pas le canal vocal : Assurez-vous que le bot dispose des autorisations Connect et Speak dans le canal vocal où vous vous trouvez.

Prochaines étapes

Explorez les fonctionnalités avancées de Sinusbot, telles que l'ajout de sources musicales supplémentaires ou la configuration de commandes personnalisées. Référez-vous à la documentation officielle de Sinusbot pour des informations détaillées sur ses capacités.