Configuration de pixel-bot sur ServerPrism

Ce guide vous explique comment configurer pixel-bot, un bot Discord basé sur Python, sur votre serveur ServerPrism. Vous allez créer votre application de bot dans Discord, l'inviter sur votre serveur et la configurer sur ServerPrism.

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. Saisissez un nom pour votre bot (par exemple, pixel-bot) et cliquez sur Create.
4. Dans la barre latérale gauche, cliquez sur Bot.
5. Cliquez sur Add Bot, puis sur Yes, Do It!
6. Sous TOKEN, cliquez sur Reset Token, puis sur Yes, Do It! Copiez ce token immédiatement ; vous en aurez besoin plus tard. Gardez-le secret.
7. Sous Privileged Gateway Intents, activez Message Content Intent. pixel-bot en a besoin pour lire les messages et répondre aux commandes.

Invitez le bot sur votre serveur

1. Dans le portail des développeurs Discord, accédez à l'application de votre bot.
2. Dans la barre latérale gauche, cliquez sur OAuth2 -> URL Generator.
3. Sous SCOPES, sélectionnez bot.
4. Sous BOT PERMISSIONS, sélectionnez les permissions dont votre bot a besoin. Pour pixel-bot, Send Messages et Read Message History sont de bons points de départ.
5. Copiez l'URL générée en bas de la page.
6. 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

Lors de la commande de votre serveur de bot Discord sur ServerPrism, un plan de 1 Go de RAM est généralement suffisant pour pixel-bot. Choisissez une région la plus proche de vos utilisateurs pour des performances optimales. Une fois commandé, votre serveur se déploiera automatiquement avec le runtime pixel-bot préinstallé.

Configurez les variables de démarrage

Votre panneau ServerPrism vous permet de définir des variables d'environnement pour votre bot. Celles-ci sont cruciales pour son fonctionnement.

1. Accédez au serveur de votre bot dans le panneau ServerPrism.

2. Cliquez sur l'onglet Startup.

3. Définissez les variables d'environnement suivantes :

   • BOT_TOKEN : Collez le token du bot que vous avez copié depuis le portail des développeurs Discord.
   • PREFIX : Définissez-le comme votre préfixe de commande souhaité (par exemple, !, /, p!). C'est ainsi que les utilisateurs interagiront avec votre bot (par exemple, !ping).
   • OWNER_ID : Votre ID d'utilisateur Discord. Ceci est requis pour certaines commandes d'administration. Pour obtenir votre ID d'utilisateur, activez le mode développeur dans Discord (Paramètres utilisateur > Avancé), puis faites un clic droit sur votre profil et sélectionnez Copy ID.

   L'onglet Startup peut également lister d'autres variables. Référez-vous au dépôt GitHub officiel de pixel-bot pour toute configuration supplémentaire spécifique à certaines fonctionnalités :

   • pixel-bot GitHub

Premier démarrage

1. Accédez à l'onglet Console dans votre panneau ServerPrism.

2. Cliquez sur Start.

3. Observez la sortie de la console. Un démarrage réussi affichera des messages indiquant que le bot se connecte à Discord et se connecte. Vous devriez voir une sortie similaire à :

   [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. Vérifiez votre serveur Discord ; votre bot devrait apparaître en ligne.

Problèmes courants

• Token de bot rejeté : Vérifiez que BOT_TOKEN dans l'onglet Startup est correct et ne contient pas d'espaces supplémentaires. Régénérez le token dans le portail des développeurs si vous n'êtes pas sûr.
• Bot en ligne mais ne répond pas : Assurez-vous que Message Content Intent est activé dans le portail des développeurs Discord sous les paramètres de votre bot. Sans cela, le bot ne peut pas lire les commandes de message.
• Bot ne se connecte pas : Examinez les journaux de la console pour les messages d'erreur. Les problèmes courants incluent des tokens incorrects, des variables d'environnement manquantes ou des erreurs critiques dans le code du bot. Assurez-vous que toutes les variables Startup requises sont définies.

Prochaines étapes

Votre pixel-bot est maintenant en cours d'exécution ! Vous pouvez commencer à utiliser ses commandes sur votre serveur Discord. Pour une liste des commandes disponibles et des options de personnalisation supplémentaires, consultez le dépôt GitHub de pixel-bot.