É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.

1. Version desktop : bouton “Éditeur” sur l'écran d'accueil
2. Version web : menu principal > Éditeur

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 - 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

Affichage > Ouvrir Profil éditeur choisit les champs visibles dans l'inspecteur :

• Simplifié - masque les champs avancés, pour les premiers scénarios
• 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.

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.

Outils > Générer des salles… prépare un parcours parmi six structures. Le résultat s'ouvre dans un onglet séparé : complétez les textes, testez, puis importez les salles souhaitées dans votre scénario. Voir Génération de salles pour les paramètres, directions, choix numérotés et modèles facultatifs.

L'éditeur travaille avec le format .jdrproj (JSON interne). Il peut :

• Importer un fichier .yaml existant (via Fichier > Importer YAML)
• Exporter en .yaml (via Fichier > Exporter YAML)
• Exporter en HTML5 standalone ou PDF livre-jeu

50 niveaux d'annulation. Raccourcis : Ctrl+Z / Ctrl+Shift+Z (ou Ctrl+Y).

La sauvegarde automatique du fichier, lorsqu'elle est activée et qu'un chemin de sauvegarde existe, intervient toutes les cinq minutes. Le brouillon local Web conserve le scénario principal ; sauvegardez séparément les onglets générés en .jdrproj.

L'éditeur utilise ses propres confirmations pour fermer un document ou changer de scénario, sans ajouter la confirmation native du navigateur. Sauvegardez vos onglets avant de quitter ou recharger la page.

L'interface de jeu et l'éditeur disposent de palettes (couleurs) et de styles (mise en forme) combinables indépendamment.

Les palettes portent les couleurs, les styles portent la mise en forme - ils sont combinables librement.

Les groupes permettent d'organiser visuellement les salles dans le graphe (sans effet sur le YAML exporté).

• Menu Affichage > 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

• 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

Les formulaires Web/Desktop prennent en charge les listes, collections et boucles, ainsi que les raccourcis clavier, souris et manette. Les gros projets utilisent pagination et recherche pour limiter le nombre de champs affichés.

Pendant un test, Données du test ouvre les valeurs actuelles dans une fenêtre séparée. Les diagnostics permettent de rejoindre le champ en cause : voir Linter et test auteur.

Dans la définition d'un modèle, l'insertion dans la salle appelante correspond à sur_place: true et exige une seule salle interne. Chaque collection générique peut aussi fournir des valeurs par défaut pour ses propriétés absentes.

Dans les objets, Nom affiché est replié s'il est vide. Objet secret, près du support, allège la fiche en gardant la description et le bouton du meuble. Les champs masqués gardent leurs valeurs. L'effet Renommer un objet, dans la famille Objets, propose l'objet et le nouveau nom affiché sur deux champs distincts ; une valeur vide rétablit l'identifiant.

Chaque encadré HUD propose Effacer en quittant la salle, décoché par défaut. Cela exporte portee: salle ; l'absence de portée conserve le comportement persistant historique. Ces réglages participent à l'annulation/rétablissement et à l'import/export YAML FR/EN.

Les données structurées disposent de descriptions à chaque niveau et de tags sur leurs racines. Les noms, valeurs et descriptions restent regroupés dans la même fiche.