Ceci est une ancienne révision du document !
Table des matières
Texte et formatage (YAML)
Retours à la ligne et continuité
Dans un bloc YAML texte: |, les retours à la ligne du fichier sont respectés tels quels.
Pour un retour à la ligne affiché dans Discord (dans les formats qui ne supportent pas les vraies nouvelles lignes) : utiliser +n+.
Sons
Entourez l'URL avec << et >> pour jouer un son :
texte: | Le dragon rugit ! <<https://exemple.com/sons/rugissement.mp3>> Vous subissez 10 dégâts.
Formats supportés : .mp3, .ogg, .wav
Pour jouer le son N fois (ou en boucle) :
<<3:https://exemple.com/sons/alarme.mp3>> # joue 3 fois <<0:https://exemple.com/sons/musique.mp3>> # boucle infinie
Pour stopper tous les sons :
<<stop>>
Images
Entourez l'URL avec [[ et ]] :
texte: | [[https://exemple.com/images/chateau.png]]
Formats supportés : .png, .jpg, .gif, .webp
Vidéos (v4.10)
Entourez l'URL avec (( et )) :
texte: | ((https://exemple.com/videos/intro.mp4))
Formats supportés : .mp4, .webm
Options disponibles (séparées par ;, avant le : de l'URL) :
| Option | Effet |
|---|---|
loop | Lecture en boucle |
autoplay | Lecture automatique (muted requis par les navigateurs) |
muted | Son coupé |
controls=false | Masque la barre de contrôles |
((loop;muted:https://exemple.com/videos/ambiance.mp4)) ((autoplay;muted:https://exemple.com/videos/intro.mp4))
Sur Discord, l'URL est postée telle quelle — Discord gère l'aperçu.
Variables dans les URLs (v4.10)
Dans les URLs d'image, son et vidéo, utilisez {nom_variable} (accolades) pour interpoler une variable :
texte: | [[https://monsite.fr/images/{zone}.png]] <<https://monsite.fr/sons/{ambiance}.mp3>>
Fonctionne avec les variables numériques et textuelles. Si la variable est inconnue, {nom} reste tel quel dans l'URL.
⚠ La syntaxe v_nom_v reste réservée au texte narratif. Les {} n'ont aucun sens dans une URL — aucune ambiguïté.
Bloc texte encadré
Quand le contenu entre [[ et ]] n'est pas une URL d'image, il s'affiche dans un encart (bloc code sur Discord, boîte sur web/desktop) :
texte: "[[Mémo : la clé se trouve dans la bibliothèque.]]"
Formatage Markdown inline
Ces styles fonctionnent dans tous les modes (quel que soit markdown: global) :
| Syntaxe | Rendu |
|---|---|
**texte** | Gras |
*texte* | Italique |
__texte__ | Souligné |
~~texte~~ | ~~Barré~~ |
| ``texte`` | Code inline |
||texte|| | Spoiler (cliquer pour révéler) |
> texte (sur sa propre ligne) | Citation blockquote |
Blocs de code colorés
texte: | ```diff - ancienne règle + nouvelle règle ``` ```python def lancer_de(faces): return random.randint(1, faces) ```
Langages supportés : diff, yaml, python, js, json, bash, et tous ceux supportés par highlight.js (web/desktop). Sur Discord, rendu en bloc code générique.
Blocs sémantiques (markdown: story)
En ajoutant markdown: story dans l'en-tête du scénario, cinq types de blocs narratifs sont disponibles, chacun avec son rendu visuel distinct selon le style UI du joueur :
texte: | ```narration La brume s'épaissit entre les arbres. Quelque chose vous observe. ``` ```dialogue **L'inconnu** : Vous n'auriez pas dû venir ici. ``` ```pensee *Il ment. Ses mains tremblent légèrement.* ``` ```systeme **Objectif mis à jour** : Trouver l'origine de la cloche. ``` ```journal Nuit du 14 octobre. Troisième nuit sans sommeil. ```
Cinq types : narration · dialogue · pensee · systeme · journal
Le rendu visuel dépend du style UI choisi par le joueur (classique, rpg, terminal, aventure) — pas une clé YAML auteur.
Styles par bloc (v4.9)
Dans une liste texte:, chaque bloc peut avoir son propre style (web/desktop uniquement — ignoré sur Discord et terminal) :
texte: - "Texte normal sans style" - taille: 28 police: Georgia texte: "Titre en Georgia 28 px" - taille: 14 police: monospace fond: "#111827" couleur-texte: "#facc15" texte: "Badge en monospace avec fond sombre" - taille: 18 si: "v_score_v > 0" texte: "Affiché seulement si score > 0 : v_score_v pts"
| Clé | Valeur |
|---|---|
taille: | Taille en pixels (ex: 18, 24) |
police: | Famille CSS (ex: Georgia, monospace, cursive) |
fond: | Couleur de fond CSS (ex: “#111827”) |
couleur-texte: | Couleur du texte CSS (ex: “#facc15”) |
⚠ Ces clés s'appliquent au bloc entier. Pour styler un seul mot, utiliser le Markdown inline.
Couleur de fond d'une salle
La clé fond: sur une salle définit la couleur d'arrière-plan pour cette salle uniquement (web/desktop) :
- id: salle_nuit fond: "#0d1117" texte: "Il fait nuit noire."
Champ markdown: global
Défini en en-tête du scénario, il enveloppe tout le texte des salles :
| Valeur | Rendu |
|---|---|
fix | Bloc monospace (défaut) |
none | Texte brut |
bold | Gras |
italic | Italique |
quote | Citation blockquote |
story | Blocs sémantiques actifs |
py / yaml / js / … | Bloc code coloré |
Images cliquables (v4.9)
Sur web : cliquer sur une image ouvre l'URL dans un nouvel onglet.
Sur desktop : clic → lightbox plein écran avec zoom (molette, 0.5×–8×), fermeture par clic ou Échap.
Aucune syntaxe supplémentaire — toute image [[url]] est automatiquement cliquable.
Retrouvez nous sur le discord Make&Play
