3. Discord

Connecter le bot officiel Saba-chan, puis choisir les serveurs et les droits de commande de chaque serveur Discord.

3. Discord

Le bot Discord de Saba-chan est un bot officiel qui tourne dans le cloud Saba-chan. Vous n'avez ni bot à créer ni jeton à gérer, et vous n'avez pas besoin de redirection de ports (un réglage du routeur qui transmet les connexions extérieures à votre PC) sur votre box. Le Saba-chan de votre PC se connecte au cloud et y récupère les commandes Discord.

La mise en place se fait en trois étapes : connecter le bot (association), choisir les serveurs utilisables par chaque serveur Discord, puis décider qui peut utiliser quelles commandes.


Étape 1 : connecter le bot (association)

Saba-chan
ServeursDiscordParamètres
DémonBot désactivé
ConnexionNon connecté
Serveurs Discord
Général
Se connecter à DiscordObtenez un code et saisissez-le sur votre serveur Discord. Une fois connecté, vous pourrez démarrer et arrêter vos serveurs de jeu depuis ce serveur via le bot.
Connecter un serveur DiscordInviter le bot
#généralNotre serveur
kimchi12:00
Bot invité !
Envoyer un message dans #général
  1. Sur l'écran Discord en haut de l'app, ouvrez Connexion et appuyez sur Connecter un serveur Discord.
  2. Si le bot Saba-chan n'est pas encore sur votre serveur Discord, invitez-le d'abord avec Inviter le bot.
  3. Quand le code et la commande à saisir (/saba connect code:…) apparaissent, appuyez sur Copier.
  4. Collez-la dans un salon Discord et envoyez-la. Seules les personnes ayant le droit Gérer le serveur sur ce serveur Discord peuvent utiliser cette commande.
  5. Pour un compte Discord qui utilise Saba-chan pour la première fois, le bot vous guide d'abord vers l'inscription. Appuyez sur S'inscrire, consultez les conditions sur le site web et inscrivez-vous ; la réponse devient alors la confirmation de connexion. Le code attend pendant ce temps.
  6. Si le bot demande s'il faut se connecter, appuyez sur Connecter. N'appuyez que si le code vient directement de votre application Saba-chan : avec le code d'une autre personne, c'est son PC qui serait relié à votre compte.
  7. Le bot annonce que la connexion est faite et l'app passe à Connecté.

Un code est valable 5 minutes. Ensuite, appuyez sur Obtenir un nouveau code. Si votre compte Discord a déjà été connecté, il suffit d'envoyer /saba connect sans code sur un autre serveur Discord : tous les PC de votre compte y sont reliés aussitôt. Il faut là aussi l'autorisation Gérer le serveur sur ce serveur Discord. Un serveur Discord relié ainsi n'affiche d'abord aucun serveur de jeu : choisissez dans l'app les serveurs à ouvrir (étape 2 ci-dessous). Un serveur Discord connecté avec un code suit le réglage Ouvrir d'emblée mes serveurs aux nouveaux serveurs Discord de l'écran Discord → Connexion de l'app.

Vous pouvez relier plusieurs PC à un compte Discord. Si vous envoyez un nouveau code depuis un compte qui a déjà un PC, le bot affiche les boutons Relier comme nouveau PC et Reconnecter <nom du PC>. Choisissez Relier comme nouveau PC pour un PC que vous reliez pour la première fois, ou choisissez le PC si vous reconnectez un PC déjà relié (son ancienne connexion cesse de fonctionner). Voyez vos PC, renommez-les ou retirez-les avec /mysaba my-pcs.

Un serveur Discord peut aussi avoir plusieurs PC. Quand un ami relie son propre PC au même serveur Discord, les serveurs des deux PC s'affichent ensemble, et chaque commande va au PC qui possède ce serveur. Si des noms de serveur se répètent, le serveur du PC arrivé en second reçoit -nomDuPC à la fin de son nom. Les réglages communs comme la langue, le préfixe, la musique et l'attribution des salons sont modifiés par le propriétaire du premier PC relié et le propriétaire du serveur Discord. Les serveurs et les droits de chaque PC sont fixés par le propriétaire de ce PC.


Étape 2 : choisir les serveurs de chaque serveur Discord

Les serveurs Discord connectés sont listés dans Discord → Serveurs Discord. Choisissez-en un et ses onglets s'ouvrent.

Saba-chan
ServeursDiscordParamètres
DémonBot en ligne
ConnexionConnecté
Serveurs Discord
GNotre serveur
Général
Notre serveur
InstancesMembresCommandesMotsSalonsParamètres du bot
Instances utilisables par ce serveur Discord
Toutes les instances
Les nouvelles instances apparaissent immédiatement
Seulement celles que je choisis
Seules les instances activées sont visibles sur Discord

Dans l'onglet Instances, vous choisissez les serveurs de jeu que ce serveur Discord peut utiliser. Une instance est un serveur de jeu enregistré dans Saba-chan.

  • Toutes les instances : tous les serveurs, actuels et futurs, sont visibles.
  • Seulement celles que je choisis : seuls les serveurs que vous activez sont visibles et utilisables depuis ce serveur Discord. Pratique pour donner des serveurs différents à des groupes d'amis différents.

Un serveur non autorisé n'apparaît nulle part sur ce serveur Discord : ni dans les commandes, ni dans les listes, ni dans les commandes slash.


Étape 3 : régler les droits de commande

Il y a cinq niveaux de droits. Les niveaux sont cumulatifs : un niveau supérieur peut utiliser toutes les commandes des niveaux inférieurs.

NiveauQui
Propriétaire (3)La personne qui a connecté ce serveur Discord. Peut tout utiliser et ne peut pas être rétrogradée
Admin (2)Les personnes à qui vous confiez même les commandes dangereuses
Utilisateur (1)Les personnes qui peuvent démarrer et arrêter les serveurs. C'est au départ le niveau par défaut de tous les membres
Saba-chan qui parle (0)Ne peut utiliser que les commandes sûres de consultation. C'est aussi la limite par défaut des demandes passées par Saba-chan qui parle
Banni (-1)Ne peut utiliser aucune fonction du bot, Saba-chan qui chante et Saba-chan qui parle compris

Les droits s'ouvrent dans l'onglet Instances en appuyant sur un serveur (une instance). Droits de toutes les instances affiche tous les serveurs d'un coup. Il y a deux écrans.

  • Commandes par niveau : une échelle où les commandes sont des puces. Chaque puce se place au niveau le plus bas qui peut utiliser la commande. Faites glisser une puce vers un autre échelon, ou appuyez dessus, pour changer le niveau requis. Le Préréglage des commandes en haut (Souple · Par défaut · Strict) place d'un coup les commandes selon leur risque (Sûre, Prudence, Dangereuse). Le préréglage par défaut est Sûre = Saba-chan qui parle, Prudence = Utilisateur, Dangereuse = Admin. Changer de préréglage ramène aussi les puces déplacées à la main à leur place du préréglage. La Limite de Saba-chan qui parle en bas est le niveau que les demandes passées par Saba-chan qui parle ne peuvent pas dépasser (au départ, Saba-chan qui parle).
  • Niveaux par membre : définissez le niveau par défaut (celui que suivent les membres sans niveau propre) et donnez un niveau à chaque membre. Avec Modifier les niveaux, vous pouvez renommer les niveaux, en ajouter et changer leur ordre.

Les niveaux des membres et les préréglages s'appliquent à tous les serveurs de ce serveur Discord. Si vous déplacez une commande globale (qui n'est liée à aucun serveur), le changement apparaît dans l'écran des droits de tous les serveurs. L'aide et la liste sont ouvertes à tous, sauf aux Bannis.

  • Dans la fenêtre qui s'ouvre en appuyant sur une puce, vous pouvez aussi changer, pour chaque commande, le niveau de demande de précision Discord (Sûre, Prudence, Dangereuse). Ce niveau ne sert qu'à la comparaison avec le réglage de demande de précision ci-dessous ; il ne change ni le niveau requis ni les confirmations de l'app et de la CLI.
  • Dans Discord, le propriétaire peut modifier les niveaux des membres et le niveau par défaut avec /saba permission. Si vous choisissez un membre, c'est son niveau (choisir Retirer dans la liste des niveaux le ramène au niveau par défaut) ; sans membre, c'est le niveau par défaut. Le préréglage, la limite de Saba-chan qui parle et les niveaux par commande se changent seulement dans l'app.

Demander confirmation avant d'exécuter

Le réglage qui décide si l'on redemande confirmation par un bouton avant d'exécuter une commande demandée dans Discord se trouve dans l'onglet Paramètres du bot du serveur Discord, carte Demande de précision. Seule la personne qui a fait la demande peut appuyer sur le bouton.

ÉlémentNiveaux au choixValeur initiale
Demande directe au bot (commande à préfixe · slash command)Toutes les commandes · Prudence et plus · Seulement les dangereuses · Aucune confirmationSeulement les dangereuses
Saba-chan qui parleToutes les commandes · Prudence et plus · Seulement les dangereuses · Aucune confirmationToutes les commandes
  • Les actions d'administration choisies par Saba-chan qui parle et les demandes mêlant plusieurs personnes sont toujours confirmées, quel que soit ce réglage.
  • L'app, le web et la CLI redemandent confirmation pour les commandes dangereuses ainsi que pour l'arrêt et le redémarrage, quel que soit ce réglage.
  • Avec la CLI, voyez et modifiez-le avec saba-chan-cli bot confirm.

Essayer dans Discord

#généralNotre serveur

Les commandes par message s'écrivent préfixe serveur commande. Le préfixe est le mot qui commence une commande. Le préfixe par défaut d'un serveur Discord où le bot répond en français est Saba-chan ; dans l'onglet Paramètres du bot du serveur Discord, section Préfixe de commande, vous pouvez le changer ou en ajouter pour chaque serveur Discord.

Ce que vous voulezCe que vous envoyez
Liste des serveurs et étatSaba-chan list
Démarrer / arrêter / étatSaba-chan mc start · Saba-chan mc stop · Saba-chan mc status
Afficher l'aideSaba-chan help

Pour désigner un serveur, utilisez son nom, un mot défini dans l'onglet Discord de l'écran du serveur et, si c'est le seul serveur de ce jeu, le nom du jeu (par exemple mc ou minecraft). Si vous avez plusieurs serveurs du même jeu, appelez-les par leur nom ou par le mot défini pour chacun. Les commandes dangereuses ne s'exécutent pas avec le nom du jeu, utilisez donc le nom du serveur ou un mot défini. Chaque serveur a aussi sa propre commande slash /nom-du-serveur.

Dans la section Slash commands du même onglet Paramètres du bot, vous décidez si les commandes portent Saba-chan devant, comme /saba status (désactivé, elles s'affichent directement, comme /status), si le nom des commandes de serveur est le nom du serveur ou le premier mot d'appel, et si les résultats de consultation ne sont visibles que par la personne qui les a demandés.

Pour en faire plus avec des boutons depuis votre téléphone, ouvrez Saba-chan web avec /saba web.