Aperçu, visualisation, analyse et test du jeu pour les scénarios Donjon FI (fichiers *.djn), directement dans VS Code.
Fonctionnalités
Analyse : liste des erreurs, problèmes et conseils de compilation, avec badge de comptage et lien vers la ligne du fichier source (inclure résolu)
Jeu : test du scénario en direct dans une webview — l'onglet est sélectionné automatiquement après chaque compilation réussie
Visualisation : exploration interactive du monde compilé (lieux, objets, classes, règles, actions)
Aperçu : vue d'ensemble du monde compilé (résumé textuel)
Bouton « Analyser » (baguette magique, identique à donjon-creer) : (re)compile le scénario depuis la version sur disque, à la demande. La sauvegarde du fichier ne déclenche pas de recompilation automatique. Disponible dans la barre d'onglets du compagnon et dans la barre de titre de l'éditeur VS Code (icône ▶)
Sélection auto de l'onglet après chaque compilation : Analyse s'il y a des erreurs, Jeu sinon
Diagnostics VS Code : les messages de compilation sont remontés dans le panneau « Problèmes »
Utilisation
Ouvrir un fichier .djn
Lancer la commande « Ouvrir le compagnon Donjon FI » (Ctrl+F5, ou via le menu de l'éditeur)
Le compagnon s'ouvre en panneau latéral et compile une première fois automatiquement
Après modification du .djn, sauvegarder puis cliquer sur Analyser (baguette magique dans la webview, ou ▶ dans la barre de titre de l'éditeur) pour recompiler
Fichier actions.djn
Le compagnon résout actions.djn dans cet ordre :
actions.djn à côté du .djn édité (mêmes répertoire que le scénario)
Paramètre donjon.actionsFile — chemin absolu ou relatif au workspace
Version par défaut livrée avec l'extension — automatiquement utilisée si aucune des deux premières sources n'est disponible
La version livrée avec l'extension est synchronisée à chaque build depuis le dossier canonique ressources/scenarios/actions.djn du repo, donc les utilisateurs profitent toujours de la dernière version stable.
Position du panneau compagnon
Par défaut, le compagnon s'ouvre dans un nouvel onglet du même groupe que le .djn actif (paramètre donjon.compagnonViewColumn = "active"). Pour le faire s'ouvrir en vue côte-à-côte (groupe à droite), passer ce paramètre à "beside".