Différences

Ci-dessous, les différences entre deux révisions de la page.

--- reference:debogage:deboguer_element_jeu [2023/01/08 10:26] – jonathan
+++ reference:debogage:deboguer_element_jeu [2026/06/16 21:50] (Version actuelle) – modification externe 127.0.0.1
@@ Ligne 1: / Ligne 1: @@
 ====== Déboguer un élément du jeu ======
-Vous pouvez obtenir des informations précises sur un élément du jeu (objet ou lieu) durant votre partie avec la commande ''déboguer''.
+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.
-Cette commande vous affichera l’emplacement de l’objet, ses états et propriétés, les objets contenus dans celui-ci, …
+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]].
-exemple:
+===== Inspecter un élément =====
-''déboguer pomme''
+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}}