Fonctionnalités
Flux
Assemble dans le tableau de bord des blocs qui réagissent à des événements dans Minecraft et Discord.
Un flux commence par un événement, comme « Quand quelqu'un rejoint le serveur », suivi des blocs à exécuter. Tu le construis dans le tableau de bord sous « Flux ». Les événements et actions Minecraft nécessitent un serveur connecté, voir Synchro du chat.
Les flux sont encore en bêta.
Configurer
- Dans le tableau de bord, ouvre « Flux ».
- Clique sur « Nouveau flux » et choisis un modèle ou « Partir de zéro ».
- Fais glisser un événement en haut et accroche les actions en dessous. Clique sur un bloc pour voir ce qu'il fait.
- Remplis les listes déroulantes, comme le salon ou le serveur.
- Clique sur « Enregistrer ». Un nouveau flux est inactif ; active-le avec « Activer ».
Trois boutons au-dessus du canevas t'aident à l'essayer :
| Bouton | Effet |
|---|---|
| « Vérifier » | Vérifie le flux sans l'enregistrer |
| « Essai à blanc » | Enregistre le flux et le déroule sans rien faire réellement |
| « Exécuter maintenant » | Enregistre le flux et le lance tout de suite. Saisis les champs de l'événement sous « Valeurs de test ». |
« Essai à blanc » et « Exécuter maintenant » ne fonctionnent que si le flux est actif.
« Dernières exécutions » liste chaque exécution avec son état, ses étapes et son journal.
Exemple : message de bienvenue
Chaque personne qui rejoint le serveur Minecraft reçoit un message d'accueil dans #welcome.
- Clique sur « Nouveau flux » et choisis « Message de bienvenue ».
- Le canevas montre « Quand quelqu'un rejoint le serveur » avec « Message vers Discord » en dessous. Le texte assemble le joueur « de l'événement » avec « a rejoint le serveur. ».
- Dans « Message vers Discord », choisis le salon
#welcome. - Dans l'événement, choisis le serveur
Survival. Laissé vide, il s'applique à tous les serveurs connectés. - Clique sur « Enregistrer », puis sur « Activer ».
Quand Notch se connecte, #welcome affiche « Notch a rejoint le serveur. ».
Déclencheurs
| Groupe | Événements |
|---|---|
| Minecraft | « Quand quelqu'un écrit dans Minecraft », « Quand quelqu'un rejoint le serveur », « Quand quelqu'un quitte le serveur », « Quand un joueur meurt », « Quand quelqu'un obtient un progrès », « Quand le serveur Minecraft démarre », « Quand le serveur Minecraft s'arrête », « Quand une ligne de console arrive », « Quand la commande Minecraft est exécutée » |
| Discord | « Quand quelqu'un écrit dans Discord », « Quand quelqu'un rejoint le serveur Discord », « Quand quelqu'un quitte le serveur Discord », « Quand quelqu'un reçoit un rôle », « Quand un rôle est retiré à quelqu'un », « Quand la commande Discord est exécutée » |
| Temps | « Chaque jour à » avec heure, fuseau horaire et jours de la semaine, « Toutes les quelques minutes » |
| Manuel | « Quand je le lance », « Quand une requête API arrive » |
- Les messages du chat, de la console et de Discord peuvent être limités à un mot avec « contient » sur l'événement. Le flux ne démarre alors que pour les messages correspondants.
- « Quand la commande Discord est exécutée » crée une commande slash sur ton serveur Discord. « Quand la commande Minecraft est exécutée » crée une commande sur le serveur Minecraft et y nécessite MC-Sync 2.2.0 sur Spigot, Paper ou Folia. Configure les arguments sous le canevas.
- « Quand une requête API arrive » affiche une « URL de déclenchement » sous le canevas. L'appeler lance le flux.
Actions
| Bloc | Effet |
|---|---|
| « Exécuter une commande Minecraft » | Exécute une commande comme si elle était tapée dans la console. Que le serveur l'accepte dépend de commands.mode. |
| « Écrire dans le chat Minecraft » | Écrit une ligne dans le chat du jeu |
| « Requête HTTP via le serveur Minecraft » | Nécessite MC-Sync 2.2.0 et http.mode: "allow", voir Config |
| « Message vers Discord », « Embed vers Discord » | Publie dans un salon. Les mentions dans le texte ne pinguent pas ; utilise pour cela le bloc « mention ». |
| « Donner un rôle », « Retirer un rôle » | Pour un membre, par ID ou par nom |
| « Ajouter à la whitelist », « Retirer de la whitelist » | Pour un joueur sur un serveur |
| « Définir une variable », « Augmenter une variable » | Stocke une valeur pour « ce flux » ou « tout le serveur » |
| « Attends » | Fait une pause, jusqu'à 30 secondes à la fois |
| « Écrire dans le journal » | Une ligne sous « Dernières exécutions » |
| « Arrêter le flux », « Lancer un autre flux » | Termine ce flux, ou en lance un autre avec les mêmes champs d'événement |
Conditions et valeurs
- Contrôle : « Si » (avec et sans « sinon »), « Répète », « Répète tant que », « Pour chaque élément », « Compter » et « Quitter la boucle ».
- Valeurs : « de l'événement » lit des champs comme le joueur, le message ou le salon. « variable » lit une valeur stockée. « joueurs sur », « est joignable » et « liste des joueurs de » interrogent un serveur Minecraft.
- Logique, maths, texte, listes : comparaisons, « et », « ou », « non », « assemble », « contient » et d'autres. Le texte est comparé sans tenir compte de la casse.
Droits et limites
Un flux nécessite les droits d'accès de chacun de ses blocs : « Console » pour les commandes Minecraft, le chat et HTTP, « Réglages » pour les messages vers Discord, « Droits » pour les rôles, « Whitelist » pour la whitelist. S'il t'en manque un, tu ne peux pas ouvrir le flux.
| Limite | Valeur |
|---|---|
| Flux par serveur Discord | 30 |
| Durée par exécution, attente comprise | 60 secondes |
| Étapes par exécution | 10 000 |
| Passages par boucle | 1 000 |
| Exécutions simultanées par serveur Discord | 2, jusqu'à 50 de plus en attente |
| Démarrages par minute et par serveur Discord | 60 |
| Variables | 200 par serveur Discord, 50 par flux |
Un flux qui échoue cinq fois d'affilée se désactive. Il affiche alors « Désactivé automatiquement » et la dernière erreur.
Problèmes
L'enregistrement indique « Il manque un champ obligatoire à un bloc. »
Une liste déroulante est vide, en général le salon ou le serveur. Après un modèle ou un import, ces champs sont vides.
Le flux ne s'exécute pas
- Vérifie dans la liste qu'il est « actif ». Un nouveau flux est inactif, et tant qu'il l'est, « Essai à blanc » et « Exécuter maintenant » ne le lancent pas non plus.
- Vérifie le filtre « contient » sur l'événement.
- Si « Dernières exécutions » indique « non démarré », trop de flux tournaient en même temps sur le serveur Discord.
La commande Minecraft est refusée
Le serveur Minecraft n'accepte que ce que commands.mode et commands.allow autorisent. Par défaut, seulement la whitelist. Voir Config.
Le flux s'est désactivé
Il a échoué cinq fois d'affilée. « Dernières exécutions » montre pourquoi. Corrige le problème et clique sur « Réactiver ».
Contexte : les flux sur le serveur Minecraft
Les flux tournent chez le bot. Avec flows.mode: "on" dans la config, le serveur Minecraft exécute lui-même les flux quand l'événement et toutes les actions ne concernent que ce serveur : un événement Minecraft ou de temps, un seul serveur, rien avec Discord, la whitelist ou des variables partagées entre serveurs. Le bot décide quels flux sont concernés quand ils sont enregistrés. Leurs exécutions apparaissent quand même sous « Dernières exécutions ».