Démarrer avec les bots Discord

Ce guide vous explique comment configurer votre bot Discord sur ServerPrism. Vous apprendrez à commander un serveur, à configurer votre bot et à le connecter à Discord.

Avant de commencer

Avant de déployer votre bot, vous avez besoin d'un jeton de bot Discord. Vous pouvez générer ce jeton depuis le Portail des développeurs Discord. Créez une nouvelle application, accédez à l'onglet 'Bot' et cliquez sur 'Add Bot'. Une fois créé, vous pouvez révéler et copier votre jeton. Gardez ce jeton en sécurité ; il donne un contrôle total sur votre bot.

Commander sur ServerPrism

1. Sélectionnez un plan : Les bots Discord nécessitent généralement au moins 2 Go de RAM. Pour les bots avec des fonctionnalités lourdes ou de nombreuses guildes, envisagez 4 à 8 Go. Vous pouvez mettre à niveau votre plan plus tard depuis le tableau de bord ServerPrism si nécessaire.
2. Choisissez un runtime : ServerPrism propose plusieurs runtimes de bot Discord préconfigurés comme Aoede, Bastion, Dynamica et JMusicBot. Sélectionnez le bot que vous souhaitez déployer. Vous pouvez changer de runtime plus tard via l'onglet 'Startup' dans le panneau.
3. Déployez : Sélectionnez votre région préférée et finalisez la commande.

Premier démarrage

Après la commande, votre serveur de bot commencera le provisionnement. Ce processus prend généralement quelques minutes. Vous pouvez suivre la progression dans le panneau ServerPrism à l'adresse https://serverprism.com/dashboard. Une fois que le statut du serveur affiche 'Running' et que la sortie de la console se stabilise, votre bot est prêt pour la configuration.

Bases de la configuration

La plupart des bots Discord nécessitent un jeton de bot pour fonctionner. Ce jeton authentifie votre bot auprès de Discord.

1. Accédez aux variables de démarrage : Dans votre panneau ServerPrism, accédez à l'onglet 'Startup'.
2. Saisissez votre jeton de bot : Localisez la variable d'environnement pour votre jeton de bot. Celle-ci est généralement nommée BOT_TOKEN, DISCORD_TOKEN, ou similaire. Collez votre jeton de bot Discord dans le champ correspondant.
3. Sauvegardez et redémarrez : Cliquez sur 'Save' puis redémarrez votre serveur depuis l'onglet 'Console' ou 'Power' pour que les modifications prennent effet.

Pour des configurations de bot spécifiques (par exemple, préfixes personnalisés, messages de bienvenue, clés API pour les intégrations), vous utiliserez généralement l'une de ces méthodes :

• Variables de démarrage : Vérifiez l'onglet 'Startup' dans votre panneau pour les options de configuration supplémentaires fournies par le runtime de bot spécifique.
• Gestionnaire de fichiers : Accédez aux fichiers de configuration du bot (par exemple, config.json, fichiers .env) via le 'File Manager' dans votre panneau. Modifiez ces fichiers directement.
• Console Web : Certains bots offrent des commandes en jeu ou une interface web pour la configuration. Consultez la documentation du bot pour plus de détails.

Inviter votre bot sur Discord

Pour inviter votre bot sur un serveur Discord :

1. Obtenez l'ID client de votre bot : Allez sur le Portail des développeurs Discord, sélectionnez votre application et copiez l'« Client ID » depuis l'onglet 'General Information'.
2. Générez une URL d'invitation : Utilisez la structure d'URL suivante, en remplaçant YOUR_CLIENT_ID par l'ID client de votre bot :

   https://discord.com/oauth2/authorize?client_id=YOUR_CLIENT_ID&scope=bot&permissions=8
   

   Le permissions=8 accorde les permissions d'administrateur, ce qui est souvent nécessaire pour la pleine fonctionnalité du bot. Ajustez les permissions selon les besoins spécifiques de votre bot.
3. Invitez : Collez l'URL générée dans votre navigateur, sélectionnez le serveur Discord auquel vous souhaitez ajouter le bot et autorisez-le.

Votre bot devrait maintenant apparaître dans la liste des membres de votre serveur Discord et se connecter peu de temps après le démarrage de votre serveur.

Problèmes courants

• Le bot ne se connecte pas :
  • Jeton incorrect : 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 manquants.
  • Permissions du bot : Dans le Portail des développeurs Discord, sous l'onglet 'Bot' de votre application, assurez-vous que les 'Privileged Gateway Intents' (comme PRESENCE INTENT et MESSAGE CONTENT INTENT) sont activés si votre bot les requiert.
  • Pare-feu : ServerPrism configure automatiquement le pare-feu. Si vous rencontrez des problèmes de connectivité, ouvrez un ticket de support à l'adresse https://serverprism.com/tickets avec votre ID de serveur et les journaux récents.
• Le bot ne répond pas aux commandes :
  • Problèmes de préfixe : Vérifiez le préfixe de commande du bot dans sa configuration. Certains bots utilisent un préfixe par défaut (par exemple, !, /, .)
  • Permissions manquantes : Assurez-vous que le bot dispose des permissions nécessaires sur le serveur Discord où il est invité.
  • Bot hors ligne : Vérifiez la console du serveur dans le panneau ServerPrism pour les erreurs. Si le bot a planté, la console affichera les messages d'erreur pertinents.

Prochaines étapes

• Personnaliser : Référez-vous à la documentation officielle de votre bot choisi pour la configuration avancée, l'ajout de commandes personnalisées ou l'intégration avec d'autres services.
• Changement de runtime : Si vous souhaitez essayer un autre type de bot Discord, vous pouvez changer de runtime directement depuis l'onglet 'Startup' de votre panneau ServerPrism sans avoir à commander un nouveau serveur.
• Mettre à niveau votre plan : Si votre bot rencontre des problèmes de performance ou si vous prévoyez d'augmenter son utilisation, vous pouvez facilement mettre à niveau la RAM et le CPU de votre serveur depuis votre tableau de bord client ServerPrism.