L'éditeur
Créer un Blueprint
- Clique sur Nouveau Blueprint, depuis la page Blueprints, l'accueil du serveur ou le menu du logo de l'éditeur. Une fenêtre s'ouvre par-dessus la page Blueprints.
- Donne-lui un nom, et une description si tu veux.
- Choisis par quoi commencer : un canvas vide, ou un Event déjà posé (une commande, un message, une arrivée, une réaction, un horaire).
- Clique sur Créer : l'éditeur s'ouvre sur ton Blueprint. Échap annule : rien n'est créé avant.
Le brouillon s'enregistre ensuite tout seul, à chaque modification.
Ajouter et relier des Nodes
Ouvre une famille dans la barre d'outils (Commande, Event, Discord, Données, Logique), clique sur un Node puis pose-le sur le canvas, ou glisse-le directement.
Pour relier deux Nodes, tire depuis une sortie de l'un jusqu'à l'entrée de l'autre. Lâche le lien dans le vide pour choisir le Node suivant : il est créé là, déjà relié. Un clic droit sur le canvas ajoute un Node à cet endroit ; sur un Node, il le copie, le duplique, ajoute sa suite ou le supprime.
Un Node tourne à chaque chemin qui y arrive. Si deux liens d'une même sortie mènent au même Node, directement ou plus loin, il tourne deux fois, avec tout ce qui le suit. L'éditeur le signale sur le Node, avec le nombre de passages possibles. C'est utile pour écrire dans un salon de logs depuis deux branches ; pour un récapitulatif à envoyer une seule fois, relie-le en chaîne après les autres Nodes.
Régler un Node
Clique sur un Node : le panneau Propriétés l'affiche, à côté du canvas. Pour l'élargir, tire l'espace entre lui et le canvas ; un double-clic lui rend sa taille. Le panneau du bas, qu'ouvre la barre d'état, se redimensionne de la même façon ; son titre ▾ passe d'une section à l'autre.
- En tête, son type (survole-le pour lire ce qu'il fait), son numéro, son coût et un lien vers sa page de la référence. Son menu
⋯copie son identifiant ou le supprime. - Réglages : ses problèmes d'abord, chacun avec un lien pour le corriger (« Aller au champ », « Voir sur le canvas »…). Puis les champs, et Options et Avancé (replié) pour les réglages moins courants. Certains n'apparaissent que quand ils servent : le débit audio pour un salon vocal, les réglages Forum pour un forum.
- Sortie liste ce que le Node écrit, sortie par sortie. Clique sur une valeur pour copier sa référence, puis colle-la dans un Node suivant.
- Activité montre le Node sur sept jours (ses passages, ses échecs, sa durée moyenne) et ses dernières exécutions. Une exécution en échec se rouvre sur le canvas. L'onglet demande le droit de voir les analytics ou les exécutions.
Un champ texte accepte des données d'un Node précédent, écrites {{ … }} : voir Expressions. Un sélecteur (salon, rôle, nombre, oui/non, liste) passe en formule avec le bouton ƒ, pour écrire une expression à la place d'un choix.
Modifier ce qui existe
Sur une Action qui modifie quelque chose qui existe (Modifier le salon, Modifier un message…), chaque champ a un menu à côté de son nom :
| Choix | Ce qui se passe |
|---|---|
| Ne pas modifier | Le champ reste tel qu'il est sur Discord. |
| Modifier en | Le champ prend la valeur donnée. Si elle est vide au moment de l'exécution, l'Action échoue plutôt que de ne rien faire sans le dire. |
| Effacer | Le champ est vidé (le sujet d'un salon, sa catégorie…), seulement là où Discord le permet. |
Pour les permissions d'un salon et les tags d'un forum, Ajouter ou modifier ne touche que ce qui est listé, et Tout remplacer remplace toute la liste.
Quand une Action échoue, la trace de l'exécution renvoie vers l'explication de son erreur dans la référence des erreurs.
Comparer deux versions
Dans Historique (dans la barre d'état, en bas), choisis une version : son détail montre ce qu'elle a changé, et Comparer la confronte au brouillon. Le canvas montre ce qui a été ajouté (vert), modifié (orange) ou supprimé (rouge en pointillés) depuis, et Propriétés affiche l'avant et l'après du Node que tu cliques. Tu peux changer les deux versions comparées, passer d'un changement à l'autre et faire pâlir ce qui n'a pas changé. Quitter, à droite de la barre, ou Échap, revient à l'éditeur.
Raccourcis
| Raccourci | Ce qu'il fait |
|---|---|
| K | Ajouter un Node, aller à un Node du Blueprint ou lancer une action |
| = / - | Zoomer, dézoomer |
| ⇧ 1 / 0 | Ajuster la vue, zoom à 100 % |
| . | Masquer ou afficher l'interface, pour ne garder que le canvas |
| ? | Afficher tous les raccourcis |
| , | Ouvrir tes paramètres |
| / | Aller à la recherche de la page, partout dans le dashboard |
| G puis une lettre | Ouvrir une page du serveur : G B les Blueprints, G E les Exécutions… |
L'icône de recherche de la barre d'outils ouvre la même palette que K. Au clavier, Tab passe d'un Node à l'autre sur le canvas, celui qui a le focus entouré comme une sélection ; avant eux, un lien Aller aux propriétés (ou Passer le canvas) saute directement au panneau.
Tu peux changer les raccourcis de l'éditeur dans tes paramètres, deux par action au plus.