====== Débogage : modifier l’état de votre jeu en cours de partie (position joueur, inventaire, …) ======

La commande déboguer vous permet d’écrire des instructions durant votre partie afin de pouvoir tester un chapitre précis de votre jeu sans avoir à recommencer du début à chaque fois.

Vous pouvez utiliser la commande ''déboguer'' avec les instructions suivantes : ''changer'', ''déplacer'', ''dire'', ''effacer'' et ''vider''.

ℹ️ Ces instructions ne fonctionnent que lorsque le débogueur est actif, c’est-à-dire dans l’**éditeur** — pas dans le jeu publié. L’[[reference:debogage:deboguer_element_jeu|inspection d’un élément]] (''deb pomme''), elle, fonctionne partout.

Pour les opérations les plus fréquentes, Donjon FI propose aussi des **raccourcis** plus courts à taper (''mv'', ''dp'', ''cd'', ''lc'', ''si'', ''vf''). Ils sont présentés dans chaque section et résumés en [[#recapitulatif_des_raccourcis|fin de page]].

===== Déplacer un objet, le joueur =====

  * Pour déplacer un objet vers un lieu : ''deb déplacer le joueur dans le salon''
  * Pour déplacer un objet dans le lieu où se trouve le joueur : ''déboguer changer la pièce se trouve ici''

==== Raccourcis ====

  * **Téléporter le joueur** dans un lieu — ''cd <lieu>'' (ou ''lc <lieu>'')\\ Exemples — ''cd salon'', ''lc cuisine''
  * **Déplacer un objet** vers un lieu — ''mv <objet> vers <lieu>'' (ou ''dp <objet> vers <lieu>'')\\ Exemples — ''mv balle vers cuisine'', ''dp clé rouge vers salon''
  * Le mot ''to'' est accepté en remplacement de ''vers'' (par exemple ''mv balle to cuisine'').
  * Le déterminant (''le'', ''la'', ''l’'') est inféré automatiquement à partir des objets et lieux de votre scénario, il est inutile de l’écrire.

===== Modifier l’inventaire =====

  * Pour déplacer un objet vers l’inventaire : ''deb déplacer la bille dans l’inventaire''
  * Pour déplacer un objet hors de l’inventaire : ''déboguer changer la bille se trouve ici''
  * Pour effacer un objet : ''deb effacer l’épée'' (remarque: l’objet effacé n’existera plus.)
  * Pour vider l’inventaire: ''deb vider l’inventaire'' (remarque: les objets qui étaient contenus dans l’inventaire existeront toujours mais ne seront plus positionnés dans le jeu.)

==== Raccourcis ====

  * Déplacer un objet vers ou hors de l’inventaire avec ''mv'' / ''dp''. Exemples — ''mv bille vers inventaire'' (équivalent de ''deb déplacer la bille dans l’inventaire'') ou ''mv bille vers ici'' (sort la bille de l’inventaire vers le lieu courant).

===== Afficher un propriété d’un objet =====

  * Pour afficher la description d’un objet : ''deb dire "[description bille]"''
  * Pour afficher le texte d’un objet : ''déboguer dire "[texte magazine]"''

===== Évaluer une condition =====

Pendant la partie, vous pouvez tester si une condition de votre scénario est //vraie// ou //fausse//. La commande complète passe par ''déboguer dire'' avec un bloc conditionnel, par exemple — ''déboguer dire "[si le chien est dans la niche]vrai[sinon]faux[fin]"''.

==== Raccourcis ====

  * ''si <condition>''\\ Exemple — ''si le chien est dans la niche''
  * ''vf <condition>'' — équivalent de ''si''\\ Exemple — ''vf le joueur se trouve dans le salon''
  * ''vf si <condition>'' — le ''si'' est ignoré, utile si vous recopiez une condition depuis votre code\\ Exemple — ''vf si le coffre est ouvert''

La réponse du jeu sera ''vrai'' ou ''faux''.

===== Récapitulatif des raccourcis =====

^ Raccourci ^ Équivalent ''déboguer'' complet ^
| ''cd <lieu>'' \\ ''lc <lieu>'' | ''déboguer changer le joueur se trouve dans <lieu>'' |
| ''mv <objet> vers <lieu>'' \\ ''dp <objet> vers <lieu>'' \\ (''to'' aussi accepté) | ''déboguer changer <objet> se trouve dans <lieu>'' |
| ''si <condition>'' \\ ''vf <condition>'' \\ ''vf si <condition>'' | ''déboguer dire "[si <condition>]vrai[sinon]faux[fin]"'' |

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

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

[[djnc>wiki_debogage_terrain_essai|tester cet exemple]]

(Le scénario complet est affiché sur la page [[reference:debogage:deboguer_element_jeu|Déboguer un élément du jeu]].)

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

  * [[reference:debogage:deboguer_element_jeu|Déboguer un élément du jeu]] — inspecter un objet, un lieu, un compteur…
  * [[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 raccourci raccourcis teleporter téléporter deplacer déplacer changer effacer vider inventaire position_joueur evaluer_condition évaluer_condition cd mv si vf}}