Piloter vos serveurs depuis Discord avec Boguette Client

En bref

Boguette Client est le bot que vous installez sur votre propre serveur Discord pour piloter vos serveurs de jeu. Quatre étapes depuis le dashboard, aucune manipulation technique : inviter le bot, /link (un code valable 10 minutes, aucune clé API à copier), /setup guidé, et c’est parti.

Deux bots, deux rôles

Ne confondez pas les deux bots baguetoast :

• Boguette vit sur le Discord communautaire baguetoast : règles, bienvenue, tickets, rôles.
• Boguette Client s’installe sur votre Discord et pilote vos serveurs de jeu, de La Ficelle à La Tourte d’Or. C’est lui que couvre cet article.

Installer le bot en 4 étapes

Tout part du dashboard : sidebar « Gestion » → « Bot Discord » (/dashboard/discord).

1. Invitez le bot sur votre serveur Discord — cliquez sur « Inviter Boguette Client ».
2. Liez votre compte baguetoast — tapez /link sur votre Discord (détail ci-dessous). Aucune clé API à copier ni à manipuler : la liaison est entièrement automatique et sécurisée.
3. Enregistrez vos serveurs — le plus simple : /setup, le bot vous guide avec un menu de sélection. Alternative manuelle : la page affiche vos serveurs avec leur UUID et la commande /server add <uuid> <alias> prête à copier (alias suggéré : nom raccourci, 20 caractères max).
4. Pour aller plus loin — /panel, /notifications, /status, /stats, /help.

Lier votre compte avec /link (sans clé API)

/link fonctionne en serveur comme en message privé, et la réponse n’est visible que de vous.

1. Tapez /link. Le bot affiche « Connecte ton compte BaguetToast » avec un bouton « Ouvrir la page de connexion ».
2. Cliquez le bouton : vous arrivez sur la page « Liaison du bot Discord » du dashboard (connectez-vous d’abord si besoin, vous serez ramené sur la page ensuite).
3. La page montre l’identité Discord du demandeur (avatar, pseudo) et un code de vérification au format XXXX-XXXX. Vérifiez qu’il correspond à celui affiché par le bot, puis cliquez « Autoriser » (ou « Refuser »).
4. Retournez sur Discord : la liaison se termine automatiquement en quelques secondes. Le bot confirme « Compte lié ! » et vous propose la suite (/setup, /status, /panel…).

Attention

N’autorisez cette demande que si c’est bien vous qui venez de lancer /link sur Discord. Le code n’est valable que 10 minutes, et relancer /link annule la demande précédente.

Enregistrer vos serveurs : /setup guidé

/setup affiche le panneau guidé « Boguette Client est arrivé ! » — le bot le poste aussi de lui-même quand il rejoint votre Discord. Le bouton « Commencer la configuration » ouvre une checklist privée en trois temps : connecter votre compte, enregistrer un serveur, aller plus loin. Le bouton « Enregistrer un serveur » ouvre un menu de sélection — aucun UUID à copier, l’alias est généré automatiquement.

À savoir :

• /setup ne fonctionne que dans un serveur Discord (pas en message privé) et demande la permission Discord « Gérer le serveur ».
• Lier son compte : tout le monde peut le faire. Enregistrer un serveur : réservé, là aussi, à la permission « Gérer le serveur ».
• Le menu liste au maximum 25 serveurs (limite Discord) et masque ceux déjà enregistrés.

Toutes les commandes

Commande	À quoi elle sert
/panel	Panneau de statut en direct
/status	État instantané : joueurs, ressources
/stats	Graphique CPU/RAM des dernières heures (options alias et period)
/notifications	Choisir les événements qui vous alertent
/start /stop /restart /kill	Alimentation du serveur
/console /cmd	Console et commandes
/backup	Sauvegardes
/schedule	Tâches planifiées
/diag	Diagnostic
/whoami	Infos du compte lié (date de liaison, identifiant)
/unlink	Délier le compte du bot (voir ci-dessous)
/help	L’aide du bot

Danger

/kill est une coupure brutale, à réserver aux serveurs bloqués : préférez /stop. Avant toute action sensible (arrêt, restauration), relisez Démarrer, arrêter, redémarrer… et Kill et les sauvegardes.

Révoquer vraiment l’accès du bot

La liaison crée automatiquement une clé API nommée « Boguette Client — votre pseudo Discord », visible dans Paramètres → Clés API (/dashboard/settings/api-keys).

Attention

/unlink supprime la liaison côté bot, mais ne révoque pas cette clé API. Pour couper réellement l’accès (appareil perdu, doute, ménage de printemps), révoquez la clé « Boguette Client — … » depuis Sessions actives et clés API. La révocation est irréversible ; il suffira de relancer /link pour relier le bot.

Problèmes fréquents

« Code expiré — Le lien de connexion a expiré (10 minutes) » Le code /link n’est valable que 10 minutes. Relancez /link pour en générer un nouveau, puis autorisez la demande sans tarder.

« Demande refusée » Quelqu’un (vous, peut-être) a cliqué « Refuser » sur la page d’autorisation. Aucun accès n’a été accordé. Si c’était une erreur, relancez simplement /link.

« Connexion impossible pour le moment » Le bot n’arrive pas à joindre baguetoast. Patientez quelques minutes et réessayez. Si le problème persiste, contactez le support.

/setup ou l’enregistrement de serveur refuse Vérifiez trois choses : vous êtes bien dans un serveur Discord (pas en MP), vous avez la permission « Gérer le serveur », et votre compte est lié (« Connecte d’abord ton compte » sinon). Si le menu affiche « Tous tes serveurs sont déjà enregistrés dans ce Discord », c’est déjà fait !