Bot Discord & relais cloud
Configuration du bot Discord de Saba-chan et flux d'appairage du relais cloud, pour piloter votre serveur sans redirection de ports.
Bot Discord & relais cloud
Le bot Discord de Saba-chan est un bot officiel exploité sur le serveur relais cloud. Vous n'avez pas besoin de faire tourner un processus de bot ni de gérer vous-même un jeton Discord. Invitez le bot officiel sur votre serveur Discord, puis appairez-le une fois avec un code fourni par l'application Saba-chan.
1. Fonctionnement
- 1Daemon Saba-chanRelais Discord
Attendre de nouvelles commandes (long polling)
- 2DiscordRelais Discord
Envoyer une commande /saba … ou chat
- 3Relais DiscordDaemon Saba-chan
Transmettre la commande
- 4Daemon Saba-chan
Vérifier les droits
- 5Daemon Saba-chanServeur de jeu
Lancement · commande console
- 6Daemon Saba-chanRelais Discord
Envoyer le résultat
- 7Relais DiscordDiscord
Répondre avec le résultat
- Le bot lui-même tourne à l'intérieur du serveur relais. Rien de lié au bot n'est installé sur votre PC.
- Les serveurs de jeu tournent sur votre PC. Le démon Saba-chan de votre PC se connecte vers l'extérieur au serveur relais en long-polling, récupère les commandes et renvoie les résultats.
- Le démon envoie les commandes de jeu dans l'ordre stdin (console du serveur) → REST → RCON. Palworld utilise son API REST. RCON n'est utilisé que pour un jeu qui ne prend en charge que RCON, et uniquement en loopback (127.0.0.1).
- Le trafic démon ↔ relais se limite à du HTTPS sortant depuis votre PC. Aucune redirection de ports sur le routeur n'est nécessaire.
- La musique est gérée côté relais sans passer par votre PC ; elle fonctionne donc même lorsque votre PC est éteint.
2. Appairage
L'appairage enregistre un hôte (le démon Saba-chan) et des nœuds (serveurs Discord) sur le serveur relais. Il se termine par la saisie d'un seul code.
2.1 Schéma du flux
- 1Appli GUIDaemon Saba-chan
Demander un code d'appairage
- 2Daemon Saba-chanRelais Discord
Faire émettre un code
- 3Relais DiscordDaemon Saba-chan
Code + secret de polling (5 min)
- 4Daemon Saba-chanAppli GUI
Afficher le code
- 5DiscordRelais Discord
/saba connect code:…
- 6Relais Discord
Enregistrer le PC · émettre un jeton de nœud
- 7Appli GUIDaemon Saba-chan
Vérifier l'état toutes les 3 s
- 8Daemon Saba-chanRelais Discord
Vérifier l'état (avec le secret)
- 9Relais DiscordDaemon Saba-chan
Connecté + jeton de nœud (une seule fois)
- 10Daemon Saba-chan
Enregistrer le jeton · lancer la liaison relais
- 11Daemon Saba-chanAppli GUI
Afficher « connecté »
- Le code d'appairage fait 32 caractères, et
pollSecreten fait 48. Le code est valable 5 minutes. - Le jeton n'est renvoyé qu'une seule fois (échange atomique). C'est le démon, et non la GUI, qui l'enregistre dans
.node_tokendès sa réception et qui démarre la connexion au relais. L'application ne transmet le secret de polling qu'au démon de votre PC, et le démon l'envoie au relais dans un en-tête, jamais dans l'URL. - Même si quelqu'un voit votre code d'appairage, il ne peut pas intercepter le jeton sans le
pollSecret. - Vous pouvez relier plusieurs PC à un compte Discord. Depuis un compte qui a déjà un PC, les boutons
Relier comme nouveau PCetReconnecterpour vos PC précédents apparaissent. Reconnecter un PC rend son ancien jeton inutilisable. Un serveur Discord peut aussi avoir les PC de plusieurs personnes (Discord).
2.2 Étapes côté application
- Dans l'application Saba-chan, ouvrez Discord → Connexion et cliquez sur Connecter un serveur Discord.
- Si le bot officiel Saba-chan n'est pas encore sur votre serveur Discord, invitez-le d'abord avec Inviter le bot.
- L'écran affiche un code de connexion et la commande à taper. Cliquez sur Copier et saisissez-la dans un salon Discord sous la forme
/saba connect code:<code>(l'application peut afficher le nom coréen/사바쨩 연결 코드:<code>; il s'agit de la même commande). - Seuls les membres disposant de la permission Gérer le serveur sur ce serveur Discord peuvent exécuter cette commande. Envoyée en MP au bot, elle relie seulement votre PC à votre compte, sans serveur Discord.
- Pour un compte Discord qui débute, le bot vous guide d'abord vers l'inscription. Avec
S'inscrire, vous consultez les conditions sur le site web et vous vous inscrivez ; la réponse devient alors la confirmation de connexion. Aucun PC n'est connecté avant votre accord. - Si le bot affiche un bouton qui demande s'il faut se connecter, appuyez sur
Connecter. Si vous saisissez le code d'une autre personne, son PC sera relié à votre compte : n'appuyez que si le code vient directement de votre application Saba-chan. - L'application vérifie l'état toutes les 3 secondes par l'intermédiaire du démon et passe à « Connecté » dès que le démon a enregistré
.node_token.
Une fois l'appairage effectué, le démon maintient automatiquement une connexion long-poll avec le serveur relais. Si vous désactivez l'interrupteur Relais de commandes dans l'application, votre PC cesse de recevoir les commandes Discord et le bot ne répond plus.
2.3 Connecter un autre serveur Discord sans code
Si votre compte Discord est déjà appairé, vous pouvez exécuter simplement /saba connect (sans code) sur un autre serveur Discord.
- Le bot connecte d'un coup à ce serveur Discord tous les PC reliés à votre compte. Il n'y a rien à accepter sur le PC ni de PC à choisir.
- Pour un compte qui débute, l'inscription passe d'abord. Une fois inscrit, ce serveur Discord est aussi enregistré auprès de Saba-chan et, faute de PC connecté, il reste un serveur sans PC (§2.5). Si le compte est inscrit mais n'a aucun PC, le bot vous indique de vous connecter avec un code d'appairage.
- Un serveur Discord connecté ainsi n'affiche d'abord aucun serveur de jeu. Dans l'application Saba-chan de votre PC, choisissez les serveurs à utiliser sur ce serveur Discord.
- Un serveur Discord connecté avec un code d'appairage suit le réglage Ouvrir d'emblée mes serveurs aux nouveaux serveurs Discord de l'écran de connexion Discord de l'application. Activé, tous les serveurs sont visibles aussitôt ; désactivé, vous les choisissez vous-même.
- Comme avec un code, il faut la permission Gérer le serveur. Si un autre PC est déjà connecté à ce serveur Discord, il n'est pas écarté : votre PC s'y ajoute.
2.4 Désappairage
- Cliquez sur Déconnecter dans l'application → le démon arrête le relais de commandes et supprime
.node_token. Ce PC est déconnecté de tous les serveurs Discord. - Pour détacher un seul serveur Discord, exécutez
/saba disconnectsur ce serveur. Seule la personne qui l'a connecté ou le propriétaire du serveur Discord peut l'utiliser, et les affectations de salons du serveur sont également supprimées.
2.5 Serveur Discord sans PC
Même sans avoir installé l'application Saba-chan, on peut inviter le bot et utiliser Saba-chan qui chante, Saba-chan qui parle, Saba-chan qui lit, les commandes de gestion du serveur et les statistiques de jeu.
- Les réglages sont stockés sur le serveur relais. Le propriétaire du serveur Discord ou une personne ayant la permission Gérer le serveur change la langue, l'affectation des salons de Saba-chan qui parle et de Saba-chan qui chante, l'agrandissement des émojis, et les réglages de Saba-chan qui parle et de Saba-chan qui lit. Cela se fait avec les commandes Discord
/sabaou dans Saba-chan web, et l'inscription a lieu à la première modification. - Il n'y a ni niveaux Saba-chan (échelle de permissions) ni commandes de serveur de jeu. Les salons d'alertes, de chat du jeu et de status board ne peuvent pas être affectés, car c'est le PC qui envoie leur contenu.
- Si vous connectez un PC plus tard, il reprend les réglages tels quels, et à partir de là c'est ce PC qui en est la source de vérité.
- L'usage ordinaire par les membres, comme écouter de la musique ou discuter, ne demande aucune inscription.
3. Slash commands du bot
Voici les commandes placées sous la commande racine du bot officiel. Dans les clients Discord réglés sur une autre langue que le coréen, la racine apparaît sous la forme /saba avec des noms de sous-commandes en anglais ; en coréen, elle s'appelle /사바쨩. Sur un serveur Discord sans PC connecté, seuls connect, assign, language, settings, reading, web, big-emoji et help apparaissent, et ce sont le propriétaire du serveur Discord ou les personnes ayant la permission Gérer le serveur qui les utilisent à la place du « propriétaire du nœud ». Les autres slash commands (/tts, /stats, /clear, etc.) sont décrites dans Commandes.
| Commande | Qui | Action |
|---|---|---|
/saba status | Tout le monde | Affiche l'état du PC connecté à ce serveur et de chaque serveur de jeu (CPU, RAM) |
/saba connect [code] | Permission Gérer le serveur | Se connecter avec un code d'appairage. Laissez le code vide pour connecter à ce serveur tous les PC de votre compte (§2.3). Pour un compte qui débute, l'inscription passe d'abord |
/saba disconnect | Auteur de la connexion ou propriétaire du serveur | Déconnecte ce serveur de son PC |
/saba permission <level> [user] | Propriétaire du nœud | Si vous choisissez un membre, lui attribue un niveau de commande (Retirer dans la liste des niveaux efface son niveau propre et le ramène au niveau par défaut) ; sinon, définit le niveau par défaut des membres sans niveau propre (Utilisateur au départ). La liste des niveaux est l'échelle de permissions de ce serveur |
| Clic droit sur un membre → Applications → Changer le niveau de Saba-chan | Propriétaire du nœud | Choisit le niveau de commande de ce membre dans une liste (avec aussi Retirer). Même effet que /saba permission. Le menu n'est visible que pour les personnes ayant la permission Gérer le serveur |
/saba sleep | Propriétaire du nœud | Met le bot en veille sur ce serveur (il ignore tous les messages) |
/saba wake | Propriétaire du nœud | Réveille le bot endormi |
/saba assign kind:<Saba-chan qui parle|Saba-chan qui chante|Alertes|Chat du jeu|Status board> | Propriétaire du nœud ou du serveur | Affecte ce salon comme salon de Saba-chan qui parle (plusieurs, jusqu'à 20 ; Saba-chan qui parle ne discute que là), salon de Saba-chan qui chante (un seul ; les messages ordinaires y sont supprimés, une confirmation est donc demandée), salon d'alertes (un seul ; notifications de crash de serveur, de mise à jour, de sauvegarde et de redémarrage planifié, plus un bouton Redémarrer sur les alertes de crash), salon de chat du jeu (un seul ; relaie le chat qui se déroule dans le serveur de jeu) ou salon de status board (un seul ; une carte d'état par serveur allumé). Détails dans les fonctions par salon de Commandes. Un salon n'a qu'un seul type ; exécuter de nouveau le même type le retire. Modifiable aussi dans l'application : Serveurs Discord → Gestion du serveur, Affectation de Saba-chan |
/saba language <language> | Propriétaire du nœud | Langue dans laquelle le bot répond sur ce serveur (Auto = suivre la langue de l'application liée) |
/saba reading | Propriétaire du nœud | Volume, vitesse et hauteur de Saba-chan qui lit pour ce serveur, et réglage de l'appel par le nom. Visible par vous seul |
/saba big-emoji state:<On|Off> | Propriétaire du nœud ou du serveur | Republie en grande image un message qui ne contient qu'un émoji personnalisé (désactivé au départ) |
/saba web | Tout le monde (son propre compte) | Lien à usage unique (5 minutes) vers Saba-chan web. Il ouvre aussi votre PC s'il y en a un ; sinon, seulement les réglages des serveurs Discord que vous gérez. Visible par vous seul |
/saba settings | Propriétaire du nœud | Modifie les paramètres de Saba-chan qui parle pour ce serveur (activé/désactivé, interventions spontanées, mémoire, modération par IA, étape de confirmation avant exécution, outils par catégorie, mots déclencheurs). Un outil bloqué dans l'application par les outils autorisés globalement ne peut pas être activé. Visible par vous seul |
/saba help | Tout le monde | Affiche le mode d'emploi de Saba-chan et la liste des commandes (visible par vous seul) |
/mysaba web | Tout le monde (son propre compte) | Identique à /saba web. Fonctionne sur n'importe quel serveur et en MP |
/mysaba my-pcs | Tout le monde (ses PC) | Liste les PC reliés à votre compte Discord, pour les renommer ou les retirer (visible par vous seul) |
/mysaba agent | Tout le monde (son propre compte) | Voir et déconnecter les agents IA (MCP distant) reliés à votre compte Discord. S'il n'y en a pas, affiche l'adresse à donner à l'agent. Fonctionne aussi en MP, visible par vous seul (Connexion d'un agent IA) |
/saba update | Personne qui a relié le PC | Cherche les mises à jour de Saba-chan sur le PC relié à ce serveur et les applique après le bouton de confirmation |
/mysaba concerne votre propre compte ; elle n'apparaît donc pas dans la liste des commandes du serveur. Si vous installez Saba-chan sur votre compte Discord avec le bouton Installer sur mon compte que le bot affiche après la connexion d'un PC, ces commandes sont disponibles, visibles par vous seul, sur n'importe quel serveur et en MP. Dans un MP avec le bot, /saba web, /saba my-pcs et /saba agent fonctionnent sans installation.
Pour un serveur Discord dont le PC est connecté, la source de vérité des réglages de permissions, de veille, de langue, de Saba-chan qui chante et de Saba-chan qui lit est la configuration de Saba-chan sur votre PC ; ces commandes ne prennent donc effet que lorsque votre PC est allumé (voir le §2.5 pour un serveur sans PC). Les mêmes paramètres peuvent être modifiés dans l'écran serveur Discord de l'application. Les permissions se règlent dans Instances : ouvrez un serveur pour voir les écrans Commandes par niveau et Niveaux par membre ; Saba-chan qui chante et Saba-chan qui lit ont chacune leur onglet ; la langue, le préfixe et la forme des slash commands se trouvent dans l'onglet Paramètres du bot. Mettre tous les serveurs Discord en veille d'un coup se fait dans Discord → Connexion.
3.1 Slash commands par serveur et menu d'actions
Après l'appairage, le bot enregistre des commandes supplémentaires sur chaque serveur Discord.
/<nom du serveur> commande:<commande> arg1:… arg2:…: une commande par instance de serveur de jeu. La liste des commandes de Discord n'affiche qu'une ligne par serveur. En cliquant sur le champ commande, vous obtenez la liste des commandes utilisables sur ce serveur (démarrer, arrêter, état, actions, commandes du module) ; en tapant, la liste se filtre par nom. Les champs d'argument montrent, selon la commande choisie, une liste de choix, oui/non, une plage numérique ou une aide à la saisie.- La liste omet les commandes que votre niveau ne permet pas d'utiliser et celles qui ne conviennent pas à l'état actuel du serveur (démarrer un serveur allumé, arrêter un serveur éteint) ; les commandes que vous avez utilisées récemment sur ce serveur passent en premier. Saba-chan juge de nouveau, côté application, si la commande est réellement utilisable.
- Actions : les actions que l'application Saba-chan ouvre à Discord (redémarrage, sauvegarde, etc.) figurent aussi dans la même liste de commandes. Les actions qui demandent une confirmation selon le réglage de demande de précision (§5) montrent ce qui va changer, et la personne qui les a demandées doit appuyer sur le bouton d'exécution. Les mises à jour de l'app Saba-chan ne sont pas dans le menu des tâches ; utilisez
/saba update. - Joueurs : les serveurs dont le jeu le permet ont une commande
joueursdans la liste, qui affiche le nombre de personnes connectées et leurs noms. - Restaurer une sauvegarde : choisissez la sauvegarde dans une liste (la saisie la filtre). Si le serveur tourne, le bot demande d'abord ; Arrêter et continuer arrête le serveur puis restaure. La restauration est une action dangereuse : une confirmation est demandée encore une fois. Seule la personne qui a demandé peut appuyer sur les boutons.
- Avis de démarrage : quand vous démarrez ou redémarrez un serveur avec sa commande
/<nom du serveur>, le bouton Redémarrer d'un avis ou Saba-chan qui parle, le même salon est prévenu dès qu'il accepte des joueurs. S'il ne démarre pas, vous recevez la raison en une ligne. - Seules les instances autorisées pour ce serveur apparaissent (onglet Instances de l'écran serveur Discord de l'application).
4. Commandes de chat (préfixe)
Une fois l'appairage effectué, vous pouvez piloter vos serveurs depuis les salons textuels Discord avec des commandes à préfixe.
Saba-chan <serveur> <commande> [args…]
Le préfixe par défaut est Saba-chan. Dans l'application, onglet Serveurs Discord → Paramètres du bot, section Préfixe de commande, vous pouvez le changer ou en ajouter pour chaque serveur Discord.
<serveur> peut être un nom d'instance, un alias de serveur, ou un nom ou alias de module. Commandes communes à tous les modules :
| Commande | Description |
|---|---|
start | Démarre le serveur. Exemple : Saba-chan minecraft start |
stop | Arrête le serveur |
status | Consulte l'état |
Les mots qui désignent un serveur et ses commandes se définissent dans l'écran du serveur de l'application, onglet Discord. Consultez le document Commandes pour la liste complète des commandes.
5. Niveaux de permission
Les niveaux sont Propriétaire (3) > Admin (2) > Utilisateur (1) > Saba-chan qui parle (0) > Banni (-1). Les niveaux sont cumulatifs : un niveau supérieur peut utiliser toutes les commandes des niveaux inférieurs.
- Le Propriétaire est la personne qui a connecté le serveur (le propriétaire du nœud). Il peut utiliser toutes les commandes et ne peut pas être rétrogradé.
- Chaque commande a un niveau de risque (Sûre, Prudence, Dangereuse). Avec le préréglage par défaut, les niveaux requis sont Sûre = Saba-chan qui parle, Prudence = Utilisateur, Dangereuse = Admin. Dans l'application, onglet Serveurs Discord → Instances, ouvrez un serveur : sur l'échelle Commandes par niveau, choisissez un préréglage (Souple, Par défaut, Strict) ou déplacez une commande vers un autre niveau. Le niveau de chaque membre et le niveau par défaut se définissent au même endroit, dans Niveaux par membre, et s'appliquent à tous les serveurs de ce serveur Discord.
- L'aide et la liste sont ouvertes à tous, sauf aux Bannis. Les membres Bannis ne peuvent utiliser aucune fonctionnalité du bot, y compris Saba-chan qui chante et Saba-chan qui parle.
- Les requêtes qui passent par Saba-chan qui parle ne peuvent pas dépasser la Limite de Saba-chan qui parle (au départ, le niveau Saba-chan qui parle).
Demande de précision : le réglage qui décide si l'on demande confirmation par un bouton à la personne qui a fait la demande avant l'exécution se trouve dans l'application, onglet Serveurs Discord → Paramètres du bot, carte Demande de précision (ou avec saba-chan-cli bot confirm). Pour une demande faite directement au bot (préfixe ou slash command), seules les commandes dangereuses sont confirmées au départ ; Saba-chan qui parle confirme toutes les commandes au départ. Dans les deux cas, vous choisissez entre Toutes les commandes, Prudence et plus, Seulement les dangereuses et Aucune confirmation. Vous pouvez changer le niveau de risque utilisé pour la confirmation de chaque commande dans la fenêtre d'édition des puces de l'écran des permissions (le niveau requis ne change pas). Les actions d'administration choisies par Saba-chan qui parle sont toujours confirmées, quel que soit le réglage. Seule la personne qui a fait la demande peut appuyer sur le bouton de confirmation.
6. Fonctionnalités musicales
La lecture de musique est assurée par le serveur de musique officiel (music-server) qui tourne aux côtés du serveur relais.
- Lorsque vous exécutez une commande comme
Saba-chan play …, le bot la transmet au serveur de musique, qui diffuse l'audio dans le salon vocal Discord. - Vous n'avez pas besoin d'installer ffmpeg/yt-dlp sur votre PC.
- Les commandes musicales fonctionnent dans n'importe quel salon. Si vous définissez un salon de musique avec
/saba assign kind:Saba-chan qui chante, vous pouvez y taper des commandes sans le préfixe (ou simplement un terme de recherche), et un écran de lecteur s'affiche. - La musique est activée par défaut ; désactivez-la dans l'application, onglet Serveurs Discord → Saba-chan qui chante. Sur les serveurs où elle est activée, la slash command
/musicest disponible (Commandes, section sur Saba-chan qui chante).
7. Saba-chan qui parle (chat IA)
- Saba-chan qui parle ne fonctionne qu'une fois qu'une clé API est enregistrée dans l'application et qu'elle est activée pour chaque serveur Discord (onglet Saba-chan qui parle de l'écran du serveur Discord ou
/saba settings; désactivée sur un nouveau serveur). La clé n'est connue que de votre PC et du relais, et n'est jamais affichée dans Discord. - Les outils qu'elle peut utiliser (pilotage des serveurs de jeu, recherche web, statistiques LoL, TFT et PUBG, personnage MapleStory, recherche multi-jeux, informations pratiques, génération d'images) s'activent aussi pour chaque serveur Discord. Un outil bloqué par Outils autorisés globalement dans le menu commun de l'application n'est utilisé sur aucun serveur. Si vous n'activez pas l'outil des serveurs de jeu, elle ne touche pas aux serveurs.
- Saba-chan qui parle ne discute que dans les salons affectés avec
/saba assign kind:Saba-chan qui parle. Dans les autres salons, elle ne répond pas, même si on l'appelle. - Saba-chan qui parle ne peut utiliser que les actions qu'un module ou une extension lui ouvre. Tout le reste est refusé.
- Les consultations s'exécutent tout de suite. Les actions qui modifient quelque chose deviennent d'abord un plan, puis passent par un bouton de confirmation selon le réglage de demande de précision (§5 ; au départ, toutes les commandes). Les actions d'administration passent toujours par un bouton de confirmation. Seule la personne qui a demandé peut appuyer sur le bouton.
- Elle n'exécute jamais rien au-delà de la limite de Saba-chan qui parle (§5).
- Lorsque Saba-chan qui parle est activée, une commande de chat que le démon ne reconnaît pas est transformée en commande exacte par Saba-chan qui parle et tentée une nouvelle fois.
- Demandez les journaux à Saba-chan qui parle : il lit les journaux du serveur, y compris les exécutions précédentes. Demandez un fichier et il joint un
.logsans passer par l'IA (jusqu'à 4 Mio, partie la plus récente conservée ; IP, secrets et chemins masqués).
8. Modèle de sécurité
- Le démon envoie le jeton de nœud obtenu à l'appairage (
sbn_{hostId}.{secret}) dans l'en-têteAuthorization: Bearer, en HTTPS. Le relais compare ce jeton à son hachage Argon2 enregistré. - Le serveur relais ne stocke jamais le jeton lui-même ; il le compare à un hachage Argon2.
- Le démon n'accepte aucune connexion entrante. Les mots de passe des serveurs de jeu ne sont pas envoyés au relais.
9. Dépannage
| Symptôme | Cause / Résolution |
|---|---|
| Le bot ne répond pas | Vérifiez le préfixe (par défaut Saba-chan) et la présence d'une espace après celui-ci. Le bot doit être sur le serveur, l'appairage doit être terminé et le Relais de commandes doit être activé dans l'application. Vérifiez aussi que le bot n'a pas été mis en veille avec /saba sleep |
Saba-chan … start → serveur introuvable | Le premier mot est le serveur (nom/alias d'instance ou nom/alias de module) et le second la commande. Si vous faites tourner plusieurs serveurs du même jeu, utilisez le nom d'instance ou un alias de serveur |
| Code d'appairage expiré | Le code est valable 5 minutes et ce délai est écoulé. Obtenez un nouveau code dans l'application |
| L'application reste en attente | Vérifiez que la slash command /saba connect a bien été exécutée et que vous avez la permission Gérer le serveur |
| Les commandes Discord n'arrivent pas au PC | Si vous choisissez ce PC avec Reconnecter lors d'un appairage ailleurs, l'ancienne connexion de ce PC est coupée. Appairez de nouveau ce PC |
Pour des procédures de dépannage plus détaillées, consultez le document Dépannage.