🟦 Variable

Le bloc Variable matérialise dans le graphe une variable déclarée dans votre projet, afin de pouvoir la brancher sur les autres blocs : soit pour lire sa valeur, soit pour désigner la variable qu'un bloc doit modifier.

C'est un bloc « étiquette » : il ne se place pas sur le chemin du flux, il n'a pas de point ▶. Il se pose à côté des blocs qui en ont besoin, et on tire un fil depuis son point de droite. Un même bloc Variable peut alimenter plusieurs blocs à la fois.

📥 Entrées

• Aucune entrée : ce bloc ne reçoit ni flux, ni valeur. Tout ce qu'il contient est fixé au moment où vous le créez, en choisissant la variable du projet qu'il représente.

📤 Sorties

• (point unique, type Variable) : le seul point du bloc, à sa droite. Son type de valeur est celui de la variable choisie (Texte, Nombre, Booléen, Image, Image de fond, Liste, Fichier, Objet). Ce point ne porte pas de libellé : c'est le nom du bloc — qui reprend automatiquement le nom de la variable — qui l'identifie sur le canevas.

Ce point unique se branche de deux façons :

• sur une entrée de type Variable (le point variable des blocs Assignation, Assignation Multiple, Incrémentation, Décrémentation…) : vous désignez alors quelle variable le bloc doit modifier ;
• sur une entrée de type Valeur dont le type est compatible : vous transmettez alors la valeur courante de la variable (par exemple vers un bloc Condition, Expression ou Formater texte).

💡 Exemple d'utilisation

Scénario : un compteur de points de vie affiché puis décrémenté

1. Dans le navigateur de variables, vous créez une variable PointsDeVie de type Nombre, initialisée à 100.
2. Dans le graphe, clic droit sur le canevas → le menu Ajouter un bloc s'ouvre ; vous faites défiler jusqu'à la section Variables en bas de la liste et vous cliquez sur PointsDeVie. Un petit bloc bleu nommé PointsDeVie apparaît.
3. Vous reliez son point de droite à l'entrée variable d'un bloc Décrémentation, et vous réglez le value de ce bloc sur 10 : chaque passage du flux retirera 10 points de vie.
4. Vous posez un second bloc Variable PointsDeVie à côté d'un bloc Dialogue, et vous branchez son point sur l'entrée créée par {{PointsDeVie}} dans le texte du dialogue : le personnage annoncera la valeur à jour.
5. Le flux continue : le joueur voit « Il te reste 90 points de vie. »

⚙️ Détails Techniques

• Identifiant interne : variable
• Comment l'ajouter (point important) : le bloc Variable n'apparaît pas dans la liste des blocs du menu Ajouter un bloc, et une recherche sur le mot « Variable » ne le fera pas remonter : la liste des blocs l'exclut explicitement. Il s'ajoute depuis la section Variables, en bas de ce même menu, qui liste une entrée par variable du projet (taper le nom de la variable dans le champ de recherche filtre bien cette section). Conséquence : si le projet ne déclare aucune variable, la section est absente et le bloc est inajoutable.
• Autre voie d'ajout : en tirant un fil depuis une entrée de valeur d'un bloc et en lâchant dans le vide, le menu de complétion propose directement les variables du projet dont le type est compatible ; en choisir une crée le bloc Variable déjà relié.
• Les variables de type Graphe sont exclues : elles correspondent aux blackbox et ne sont pas proposées dans la section Variables (elles le sont sous forme de bloc Ouvrir un graphe).
• Impossible par transformation : la commande de changement de type d'un bloc existant (clic droit sur un bloc sélectionné) n'offre jamais la section Variables.
• Un seul bloc, plusieurs fils : contrairement aux points de chemin (▶) qui n'acceptent qu'une seule connexion en sortie, le point d'un bloc Variable peut être relié à autant de blocs que nécessaire.
• Liaison forte avec la variable : le bloc ne stocke que l'identifiant de la variable (variableUid) ; son nom et le type de son point en sont dérivés. Renommer la variable renomme le bloc. Supprimer la variable dans le navigateur de variables supprime tous les blocs Variable qui la représentent, dans tous les graphes du projet, ainsi que leurs connexions.
• Valeur lue à l'exécution : le bloc ne mémorise pas de valeur. À la lecture, il renvoie la valeur courante de la variable dans l'état du lecteur — donc la dernière valeur écrite par les blocs Assignation / Incrémentation qui l'ont précédé dans le flux.
• Rendu spécifique sur le canevas : ce bloc est dessiné en version compacte (une pastille avec le nom et un seul point à droite), sans en-tête ni liste de points comme les blocs ordinaires.

Mis à jour le : 23/09/2026