====== Déboguer un élément du jeu ======

La commande ''déboguer'' (raccourci ''deb'') vous permet d’inspecter en détail un élément de votre jeu — objet, lieu, concept, compteur ou liste — pendant que vous jouez, sans interrompre votre partie. C’est l’outil de référence pour vérifier l’état exact de votre monde quand un comportement vous surprend.

Pour //modifier// l’état du jeu (déplacer le joueur, vider l’inventaire, évaluer une condition, etc.), reportez-vous plutôt à [[reference:debogage:modifier_etat_jeu_et_position_joueur|Modifier l’état du jeu]].

===== Inspecter un élément =====

Tapez ''deb'' suivi de l’intitulé de l’élément à inspecter :

  * ''deb pomme''
  * ''deb la salle bleue''
  * ''deb porte rouge''

{{:reference:debogage:exemple_deboguer_pomme.png?500|}}

Si plusieurs éléments du jeu correspondent à l’intitulé que vous tapez, ils sont **tous listés**, précédés du compte total (« 3 éléments trouvés : », « 2 concepts trouvés : », etc.).

===== Cas particuliers =====

Deux formes spéciales écrivent leur résultat dans la **console du navigateur** (ouvrez-la avec la touche ''F12'') plutôt que dans la fenêtre de jeu. Elles servent surtout au développement du moteur, mais peuvent dépanner en cas de doute :

  * ''deb ici'' — affiche l’objet //lieu// courant en entier.
  * ''deb états'' — affiche la liste complète des états déclarés dans le jeu.

===== Exemple à essayer =====

Chargez ce petit modèle dans l’éditeur puis essayez les commandes de débogage proposées au lancement (''deb pomme'', ''deb coffre'', ''si le coffre est ouvert'', ''cd jardin''…) :

<file donjon wiki_debogage_terrain_essai>
La cabane est un lieu.
Sa description est "Une cabane de jardinier. Le jardin est au nord.".
Le jardin est un lieu au nord de la cabane.
Sa description est "Un petit jardin en friche.".
La pomme est un objet mangeable dans la cabane.
Sa description est "Une belle pomme rouge.".
Le coffre est un contenant fermé et ouvrable dans la cabane.
La bille est un objet dans le coffre.

règle avant commencer le jeu:
  dire "Commandes de débogage à essayer : {/deb pomme/}, {/deb coffre/}, {/si le coffre est ouvert/}, {/deb changer le coffre est ouvert/}, {/cd jardin/}, {/mv pomme vers jardin/}, {/deb effacer la bille/}.".
fin règle
</file>

[[djnc>wiki_debogage_terrain_essai|tester cet exemple]]

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

  * [[reference:debogage:modifier_etat_jeu_et_position_joueur|Modifier l’état du jeu en cours de partie]] — déplacer le joueur, vider l’inventaire, évaluer une condition.
  * [[reference:debogage:mode_triche|Fichier solution et mode triche]]
  * [[reference:debogage:magneto|Magnétoscope (enregistrement d’une partie)]]

{{tag>debogage débogage deboguer déboguer deb inspecter inspection element élément elements éléments console f12 etats états outils_de_test}}