Configuration de Game Server Watcher sur ServerPrism

Ce guide couvre la configuration de votre bot Discord Game Server Watcher, de sa création dans le portail des développeurs Discord à sa configuration sur votre instance ServerPrism.

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

1. Rendez-vous sur le Discord Developer Portal.
2. Cliquez sur New Application.
3. Donnez un nom à votre application (par exemple, "Game Server Watcher") et cliquez sur Create.
4. Accédez à 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 le token affiché. Vous en aurez besoin plus tard.
8. Désactivez le bouton Public Bot si vous ne voulez pas que d'autres personnes invitent votre bot.
9. Sous Privileged Gateway Intents, assurez-vous que PRESENCE INTENT, SERVER MEMBERS INTENT et MESSAGE CONTENT INTENT sont DÉSACTIVÉS. Game Server Watcher utilise principalement des commandes slash et ne nécessite pas ces intents.

Invitez le bot sur votre serveur

1. Dans le Discord Developer Portal, allez dans l'onglet OAuth2, puis URL Generator.
2. Sous SCOPES, sélectionnez bot et applications.commands.
3. Sous BOT PERMISSIONS, sélectionnez les éléments suivants :
   • Send Messages
   • Embed Links
   • Read Message History
   • Use External Emojis
4. Copiez l'URL générée en bas.
5. Collez l'URL dans votre navigateur, sélectionnez votre serveur Discord dans le menu déroulant et cliquez sur Authorize.

Commande sur ServerPrism

Si vous ne l'avez pas déjà fait, commandez votre serveur Discord Bot :

1. Allez sur le site web de ServerPrism et sélectionnez le produit Discord Bots.
2. Choisissez Game Server Watcher comme runtime de bot souhaité.
3. Nous recommandons au moins 1 Go de RAM pour Game Server Watcher, ce qui est généralement suffisant pour surveiller plusieurs serveurs.
4. Sélectionnez votre région préférée et terminez le processus de déploiement.

Configurer les variables de démarrage

Game Server Watcher nécessite des variables d'environnement spécifiques pour fonctionner. Vous les configurez dans l'onglet Startup de votre panneau ServerPrism.

1. BOT_TOKEN : Collez le token du bot que vous avez copié depuis le Discord Developer Portal.

2. PREFIX : Définissez un préfixe de commande pour votre bot (par exemple, !). Notez que Game Server Watcher utilise principalement des commandes slash (/), mais certaines fonctionnalités héritées ou commandes d'aide peuvent utiliser un préfixe.

3. OWNER_ID : Votre ID d'utilisateur Discord. Pour l'obtenir, activez le mode développeur dans Discord (Paramètres utilisateur > Avancé > Mode développeur), puis faites un clic droit sur votre nom d'utilisateur et sélectionnez Copy ID.

4. SERVERS : Cette variable définit les serveurs de jeu que votre bot surveillera. C'est un tableau d'objets JSON. Chaque objet représente un serveur. Voici un exemple pour un serveur Minecraft et un serveur Counter-Strike :

   [
     {
       "name": "My Minecraft Server",
       "type": "minecraft",
       "host": "play.example.com",
       "port": 25565
     },
     {
       "name": "CS:GO Fun Server",
       "type": "csgo",
       "host": "192.168.1.100",
       "port": 27015
     }
   ]
   

   Vous pouvez trouver une liste complète des types de jeux pris en charge et de leurs options de configuration sur la page GitHub de Game Server Watcher.

5. STATUS_MESSAGE : (Facultatif) Un message personnalisé pour le statut Discord du bot (par exemple, Surveillance de vos jeux !).

6. UPDATE_INTERVAL : (Facultatif) L'intervalle en secondes pour vérifier le statut du serveur (la valeur par défaut est 60).

Après avoir défini toutes les variables, cliquez sur le bouton Restart dans l'onglet Console pour appliquer les modifications.

Premier démarrage

Une fois que vous avez configuré les variables de démarrage et redémarré votre serveur, accédez à l'onglet Console.

• Succès : Vous devriez voir une sortie indiquant que le bot se connecte à Discord et récupère les informations du serveur. Recherchez des messages tels que [INFO] Logged in as Game Server Watcher et [INFO] Successfully updated slash commands.
• Statut du bot : Votre bot devrait apparaître en ligne sur votre serveur Discord.

Problèmes courants

• Le bot ne se connecte pas : Vérifiez votre BOT_TOKEN pour les fautes de frappe. Assurez-vous qu'il n'y a pas d'espaces supplémentaires.
• Le bot est en ligne mais ne répond pas aux commandes : Vérifiez que le scope applications.commands a été sélectionné pendant le processus d'invitation. Assurez-vous également que votre variable SERVERS est un JSON correctement formaté.
• "Invalid Token" dans la console : Votre BOT_TOKEN est incorrect ou révoqué. Générez un nouveau token dans le Discord Developer Portal et mettez à jour la variable BOT_TOKEN.
• Erreur d'analyse de la variable SERVERS : Assurez-vous que votre JSON est valide. Utilisez un validateur JSON en ligne si vous n'êtes pas sûr.

Prochaines étapes

Maintenant que votre bot Game Server Watcher est opérationnel, vous pouvez utiliser les commandes slash sur votre serveur Discord pour interagir avec lui. Essayez /status pour voir le statut actuel de vos serveurs de jeu configurés. Pour une configuration plus avancée et des détails sur les commandes, consultez la documentation officielle de Game Server Watcher sur GitHub.