====== Référence ======

//L’**aide complète** du langage Donjon FI : tous les concepts, les instructions et les outils, organisés par thème.//

Vous cherchez plutôt à apprendre par la pratique ? Démarrez par les [[tutoriels:start|tutoriels]] ou parcourez les [[exemples:start|exemples pratiques]]. Une question concrète ? Consultez la [[faq:start|FAQ]].

===== Par thème =====

==== Description du monde ====

//Les **briques de base** d’un scénario : lieux, objets, personnages, classes, états, propriétés.//
<nspages reference:definitions -tree -r -exclude:start -subns -pagesInNs -h1 -textNs="">

==== Routines ====

//Les **morceaux de logique** déclenchés pendant la partie : actions personnalisées, règles avant/après, réactions de personnages, routines simples.//
<nspages reference:routines -tree -r -exclude:start -subns -pagesInNs -h1 -textNs="">

==== Instructions ====

//Les **commandes** disponibles à l’intérieur d’une routine pour modifier l’état du jeu, afficher du texte, déplacer des objets, etc.//
<nspages reference:instructions -tree -r -exclude:start -subns -pagesInNs -h1 -textNs="">

==== Texte ====

//Tout ce qui concerne le **texte affiché au joueur** : balises dynamiques, accord automatique, mise en forme, conditions textuelles.//
<nspages reference:texte -tree -r -exclude:start -subns -pagesInNs -h1 -textNs="">

==== Mémoire ====

//Comment **garder une trace** des événements : compteurs, listes, historique de la partie.//
<nspages reference:memoire -tree -r -exclude:start -subns -pagesInNs -h1 -textNs="">

==== Temps ====

//**Programmer** l’exécution d’une routine dans N secondes, gérer une horloge ou un calendrier.//
<nspages reference:temps -tree -r -exclude:start -subns -pagesInNs -h1 -textNs="">

==== Débogage ====

//Outils pour **tester et déboguer** votre scénario : mode triche, magnétoscope, messages d’erreur du compilateur.//
<nspages reference:debogage -tree -r -exclude:start -subns -pagesInNs -h1 -textNs="">

==== Divers ====

//Conventions et **détails pratiques** : caractères réservés, format des sauvegardes, informations sur le jeu, objets spéciaux.//
<nspages reference:divers -tree -r -exclude:start -subns -pagesInNs -h1 -textNs="">

===== Par niveau =====

==== Débutant ====

Tout ce qu’il faut pour écrire son premier scénario.

  * [[reference:definitions:lieux|Créer des lieux]] et les relier entre eux
  * [[reference:definitions:objets|Placer des objets]] dans le monde
  * [[reference:definitions:description_et_apercu|Décrire ce que le joueur voit]]
  * [[reference:divers:commencer_le_jeu|Lancer la partie]] et [[reference:instructions:terminer|la terminer]]
  * [[reference:instructions:dire|Afficher du texte au joueur]]

==== Intermédiaire ====

Donner de la profondeur à votre scénario.

  * [[reference:definitions:classes|Classes]] et états personnalisés
  * [[reference:routines:action:start|Actions personnalisées]] (« couper », « peindre », …)
  * [[reference:routines:regle:start|Règles avant/après]] pour intercepter des actions
  * [[reference:instructions:changer|Changer]] l’état d’un objet ou [[reference:instructions:deplacer|déplacer]] des éléments
  * [[reference:instructions:controle:si:start|Conditions]] (si / sinonsi / sinon)
  * [[reference:memoire:start|Compteurs, listes, historique]]

==== Avancé ====

Les fonctions qui font la différence entre un petit jeu et un vrai jeu.

  * [[reference:temps:programmer_routine|Routines programmées]] dans le temps
  * Réactions de PNJ ([[reference:routines:start|routines]] basiques + concernant un sujet)
  * [[reference:texte:start|Balises dynamiques]] et mise en forme du texte
  * [[reference:debogage:magneto|Magnétoscope]] et [[reference:debogage:mode_triche|mode triche]]
  * [[reference:divers:format_fichier_solution|Format des sauvegardes]] (.sol)

===== Par cas d’usage =====

  * **Créer un nouveau lieu** → [[reference:definitions:lieux]]
  * **Placer un objet sur/dans/sous quelque chose** → [[reference:definitions:objets]]
  * **Gérer une quantité (argent, bois, vies, points…)** → [[reference:definitions:ressources]]
  * **Ajouter une porte ou un obstacle** → [[exemples:obstacles:start|exemples d’obstacles]]
  * **Définir une action personnalisée** → [[reference:routines:action:start]]
  * **Intercepter une action existante** → [[reference:routines:regle:start]]
  * **Écrire un personnage qui parle** → [[reference:routines:start|réactions]]
  * **Compter des points ou des objets ramassés** → [[reference:memoire:start|compteurs]]
  * **Retenir ce que le joueur a déjà fait** → [[reference:memoire:historique]]
  * **Déclencher un événement après N secondes** → [[reference:temps:programmer_routine]]
  * **Faire varier un texte (hasard, première fois, condition)** → [[reference:texte:start]]
  * **Jouer un son ou afficher une image** → [[reference:instructions:jouer|sons]] · [[reference:instructions:afficher|images]]
  * **Découper un gros scénario en plusieurs fichiers** → [[reference:divers:start|inclure un fichier]]
  * **Tester et rejouer une partie** → [[reference:debogage:start|outils de débogage]]

===== Voir aussi =====

  * [[exemples:start|Exemples pratiques]] — petits scénarios complets à réutiliser
  * [[faq:start|Foire aux questions]] — réponses aux questions courantes
  * [[tutoriels:start|Tutoriels]] — apprendre pas à pas

{{tag>reference référence documentation sommaire aide langage dsl donjon donjon_fi index concepts instructions theme thème}}