Ceci est une ancienne révision du document !
Table des matières
Language / Langue : FR | EN
Éditeur graphique - Présentation
L'éditeur graphique de JDR-Bot permet de créer et éditer des scénarios sans écrire une ligne de YAML. Il est intégré à la version desktop (Windows/Mac/Linux) et accessible depuis la version web.
Lancer l'éditeur
- Version desktop : bouton « Éditeur » sur l'écran d'accueil
- Version web : menu principal → Éditeur
Interface principale
L'éditeur est divisé en plusieurs zones :
- Graphe (zone centrale) - représentation visuelle de toutes les salles et leurs connexions
- Inspecteur (panneau droite) - édition détaillée de la salle sélectionnée
- Panneau Globaux (icône ⚙️) - variables, événements globaux, timers permanents, aliases
- Barre d'outils (haut) - boutons Tester, Linter, Export, Undo/Redo, Sauvegarder
Deux fenêtres s'ouvrent à la demande depuis le menu Affichage :
- Mise en page (
Ctrl+M) - insère les syntaxes de texte dans le champ en cours d'édition - Recherche rapide (
Ctrl+K) - atteint une salle, un événement, un objet ou lance une action
Profils d'affichage
Le bouton en haut à droite choisit ce que l'inspecteur affiche :
- Simplifié - masque les champs avancés, idéal pour débuter
- Essentiel - les fonctions courantes, sans les réglages rares
- Expert - tous les champs visibles, pour les scénarios complexes
- Personnalisé - vous choisissez les familles affichées
- Discord et Terminal - ne laissent que ce que ce support sait réellement afficher
Les deux profils de support masquent par exemple les vidéos et les boutons d'image sur Terminal, ou la vidéo sur Discord. Changer de profil ne modifie jamais le scénario : les fonctions incompatibles déjà présentes sont conservées, et la fenêtre du profil les recense avec leur emplacement.
Fenêtre Mise en page
Elle rassemble toutes les syntaxes de texte du moteur, classées en cinq groupes : mise en forme, variables et style, médias, éléments interactifs et blocs narratifs. Chaque bouton affiche le nom de la fonction et un aperçu de ce qui sera inséré.
Le comportement dépend de votre sélection :
- Du texte sélectionné est encadré par la syntaxe. Sélectionnez un mot, cliquez sur Variable, vous obtenez
v_mot_v. Collez une adresse, cliquez sur Image, elle est encadrée. - Sans sélection, la syntaxe apparaît autour d'un mot d'exemple, lui-même sélectionné pour être remplacé aussitôt.
- Quand vous avez fourni le texte, c'est le paramètre restant qui est présélectionné : l'identifiant d'un événement, le découpage d'une tuile.
Les espaces situés aux bords d'une sélection approximative restent hors de la syntaxe, et un bloc narratif part toujours d'une ligne propre. La fenêtre reste ouverte pendant que vous écrivez : elle suit le champ actif.
Formats de fichier
L'éditeur travaille avec le format .jdrproj (JSON interne). Il peut :
- Importer un fichier
.yamlexistant (viaFichier → Importer YAML) - Exporter en
.yaml(viaFichier → Exporter YAML) - Exporter en HTML5 standalone ou PDF livre-jeu
Undo / Redo
50 niveaux d'annulation. Raccourcis : Ctrl+Z / Ctrl+Shift+Z (ou Ctrl+Y).
La sauvegarde automatique est activée par défaut (toutes les 30 secondes).
Palettes et styles visuels (v4.10)
L'interface de jeu et l'éditeur disposent de palettes (couleurs) et de styles (mise en forme) combinables indépendamment.
| Palette | Description |
|---|---|
sombre | Fond sombre, contraste élevé (défaut) |
neutre | Gris neutre, sans dominante de couleur |
clair | Fond clair, lecture de jour |
bonbons | Colorée et douce, pensée pour les enfants et les yeux sensibles |
reverie | Pastel calme bleu/menthe/rose, ambiance apaisante |
| Style | Description |
|---|---|
classique | Rendu propre et lisible, typographie sobre |
rpg | Atmosphère fantasy |
terminal | Monospace, ambiance terminal |
aventure | Typographie narrative, mise en page roman |
bonbons-s | Style enfant arrondi et ludique |
reverie-s | Livre-jeu doux, aérien |
Les palettes portent les couleurs, les styles portent la mise en forme - ils sont combinables librement.
Gestion des groupes de salles (v4.10)
Les groupes permettent d'organiser visuellement les salles dans le graphe (sans effet sur le YAML exporté).
- Menu Vue → Gérer les groupes… : liste tous les groupes, avec le nombre de salles de chacun
- Renommer un groupe vers un nom existant propose de fusionner les deux groupes
- Les groupes sont purement visuels - aucun impact sur le gameplay ou l'export
Ordre des salles et numérotation (v4.10)
- La liste des salles affiche le numéro exporté à côté de l'identifiant (
1 - debut,2 - couloir…) - Glisser-déposer dans la liste → modifie l'ordre d'export YAML
- Saisir un numéro dans le champ Position déplace la salle et renumérote les autres de façon cohérente
Retrouvez nous sur le discord Make&Play
