> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://documentation.celestory.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Injecter une variable dans un texte : les doubles accolades

# 🧩 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 :

```plain text
Bonjour {{Prenom}} ! Vous avez {{Score}} points.
```

1. **Vous écrivez.** Deux entrées apparaissent sur le bloc : `Prenom` et `Score`.
1. **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.
1. **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.

```plain text
{{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

```plain text
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** ou un **Booléen**, 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 — pratique pour déboguer, rarement élégant pour un joueur.

---

## 🧱 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.
