Command Builder

Un Event Slash Command a besoin que sa commande soit d'abord enregistrée auprès de Discord — le Command Builder est l'endroit où tu définis son nom, sa description, et les options (arguments) qu'elle accepte, chacune avec son propre type et son caractère obligatoire ou non.

La fenêtre

Liste : à gauche, la commande puis ses options ou ses sous-commandes, chacune avec son type et si elle est obligatoire ; clique sur l'une pour la régler au centre, glisse-la pour changer son ordre. À droite, l'aperçu de ce que voit un membre qui tape la commande. Arbre : la commande en arbre, avec à côté ses réglages ou l'aperçu, au choix.

La commande elle-même règle :

• Ce qu'elle attend : des options (/ticket sujet: …) ou des sous-commandes (/ticket ouvrir, /ticket fermer). Discord n'accepte pas les deux à la fois ; passer aux sous-commandes range les options existantes dans une première sous-commande.
• Visible par : des permissions qui la cachent aux membres qui ne les ont pas. Un admin du serveur peut changer ça dans Discord.
• Réservée aux salons NSFW.

En bas, l'Event qui l'écoute, avec un lien pour le retrouver sur le canvas, ou un lien pour l'ajouter s'il n'y en a pas.

Une option règle son nom, son type, sa description et si elle est obligatoire. Ses réglages suivants sont repliés, résumés en quelques mots :

• Choix proposés (texte et nombres) : le membre choisit dans une liste au lieu d'écrire. Le libellé est ce qu'il voit, la valeur ce que l'Event reçoit.
• Longueur (texte) ou Valeurs (nombres) : le minimum et le maximum acceptés.
• Salons acceptés (salon) : les types de salons que le membre peut choisir.

Une sous-commande ou un groupe montre ce qu'il contient : clique sur une ligne pour la régler. En bas de chaque formulaire, l'Event qui reçoit l'option ou la sous-commande, et la valeur à insérer pour la lire dans les nodes suivants. Un nom que Discord refuse (majuscules, espaces) est signalé avec celui qu'il accepterait : Utiliser … le remplace. Pendant que tu tapes le nom de la commande, Vérification… puis Disponible disent s'il est libre parmi les commandes déployées du serveur ; deux commandes d'un même Blueprint ne peuvent pas porter le même nom.

Ajouter, en bas, crée une option du type choisi là où tu es, ou une sous-commande : ajoutée parmi les options de la commande, elle les range toutes en elle. Une sous-commande dans laquelle tu en ajoutes une devient un groupe (/ticket admin ajouter) ; ses voisines restent des sous-commandes (/ticket ouvrir). Retirer, en haut du formulaire ou au clic droit dans l'Arbre, supprime l'élément choisi ; la touche Retour arrière ou Suppr aussi, après confirmation. Chaque changement s'enregistre dans le brouillon ; Annuler remet la commande comme à l'ouverture.

(Référence complète de chaque type d'option à venir.)