Injecter une variable dans un texte : les doubles accolades

Le mécanisme tient en une phrase : tout mot écrit entre doubles accolades dans un champ de texte fait apparaître un nouveau point d'entrée sur le bloc. Vous posez un trou dans votre phrase, et Celestory fabrique la prise qui va le remplir. 🪄

✍️ Le principe en trois temps

Dans un bloc Dialogue, vous tapez :

Bonjour {{Prenom}} ! Vous avez {{Score}} points.

1. Vous écrivez. Deux entrées apparaissent sur le bloc : Prenom et Score.
2. Vous reliez. Ce sont des points comme les autres : branchez-y une variable, la sortie d'un autre bloc, ou saisissez une valeur en dur.
3. Celestory remplace. À l'exécution, chaque référence cède la place à la valeur reçue.

🔺 Une seule accolade ne déclenche rien. {Prenom} s'affichera tel quel, littéralement.

🔺 Créer le point ne suffit pas, il faut le câbler. Une entrée laissée en l'air est remplacée par du vide : votre phrase devient « Bonjour ! Vous avez points. », sans le moindre message d'erreur.

🔤 Ce que vous avez le droit d'écrire entre les accolades

Le nom n'accepte que les lettres non accentuées, les chiffres et le tiret bas _. Tout le reste casse la détection en silence : aucune entrée n'est créée.

{{Prenom}}        ✅ détecté
{{Score_2}}       ✅ détecté
{{Prénom}}        ❌ l'accent bloque tout
{{mon-score}}     ❌ le tiret n'est pas accepté
{{ Prenom }}      ❌ les espaces non plus

🔺 Non, vous ne pouvez pas écrire {{Prénom}}. Mettez les accents dans le reste de la phrase, jamais dans l'accolade.

🔺 La casse compte : {{Score}} et {{score}} créent deux entrées différentes.

🔁 La même variable citée plusieurs fois

Bravo {{Prenom}} ! Vraiment, {{Prenom}}, quelle partie.

Celestory ne crée qu'un seul point Prenom, pas deux. Vous le branchez une fois, et toutes les occurrences sont remplacées. ✅

🎚️ Quel type pour le point créé ?

Le point n'est pas figé sur « Texte ». Il accepte indifféremment du Texte, un Nombre, un Booléen, une Date, une Sélection unique ou une Sélection multiple, et la valeur est convertie en texte à l'affichage.

Deux blocs acceptent en plus un Objet : Formater texte et le Dialogue du template Chatbot. L'objet y est inséré sous sa forme brute, ce qui est pratique pour déboguer mais rarement élégant pour un joueur.

Le bloc HTML5, lui, accepte deux types que les autres n'ont pas : une Couleur (insérée sous sa forme #1f5fd0) et une Unité CSS (insérée avec son unité, 12px). Il n'accepte en revanche ni l'Objet, ni la Date, ni les sélections (les nouveautés de cette page valent pour les neuf autres blocs). Voir Paramétrer une app HTML5 depuis le Graphe.

🏷️ Une sélection s'écrit avec le libellé de l'option

Branchez une variable Sélection unique ou Sélection multiple sur le point : le texte affiche le libellé de l'option choisie, dans la langue du joueur si vous avez traduit les options. Pour une sélection multiple, ce sont les libellés des options cochées, séparés par une virgule et une espace (« Livre, Arc »), dans l'ordre de la liste d'options. Voir Variables de sélection (unique et multiple).

📅 Une date s'écrit en toutes lettres

Branchez une Date (variable ou bloc de date) : le texte affiche la date et l'heure, avec le mois en toutes lettres, dans la langue du joueur, sinon dans la langue du projet, sinon dans celle de l'appareil, et à l'heure de l'appareil du joueur. Pour un autre format (jour de la semaine seul, format court, motif personnalisé), passez d'abord par le bloc Formater une date et branchez son texte.

🧱 Les blocs concernés

Le mécanisme n'est pas universel : il vit dans dix blocs.

Quel que soit le template : Formater texte (le bloc dédié, qui ne fait que ça et renvoie le texte assemblé), Notification, et HTML5, où les accolades se posent dans le code, pas dans un champ de texte.

Template Chatbot : Dialogue, Choix avec dialogue, Narrateur, Alerte.

Template Visual Novel : Dialogue, Alerte, Slide.

🔺 Partout ailleurs, {{...}} n'est que du texte ordinaire. Besoin d'une phrase dynamique dans un autre bloc ? Fabriquez-la avec Formater texte et branchez sa sortie là où il faut.

⚠️ Renommer une référence, c'est perdre son câble

Un point n'est reconnu que par son nom exact. Si vous corrigez {{Prenom}} en {{PrenomJoueur}}, Celestory considère que l'ancien point n'existe plus : il le supprime, et supprime le lien qui y était branché. Le nouveau point apparaît vierge. De même, effacer {{Score}} de la phrase fait disparaître l'entrée Score.

Vérifiez donc vos branchements après chaque retouche de texte, surtout sur un bloc qui compte cinq ou six références.

→ Prochaine étape : ouvrez un bloc Formater texte, écrivez Bonjour {{Prenom}}, vous avez {{Score}} points., reliez les deux entrées à vos variables et branchez la sortie sur un bloc Dialogue. Vous tenez la brique de base de toute personnalisation dans Celestory.