Différences

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

--- reference:debogage:modifier_etat_jeu_et_position_joueur [2023/01/08 10:48] – jonathan
+++ reference:debogage:modifier_etat_jeu_et_position_joueur [2026/06/16 21:50] (Version actuelle) – modification externe 127.0.0.1
@@ Ligne 3: / Ligne 3: @@
 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.
-===== Déplacer le joueur =====
+Vous pouvez utiliser la commande ''déboguer'' avec les instructions suivantes : ''changer'', ''déplacer'', ''dire'', ''effacer'' et ''vider''.
-Pour déplacer un objet vers un lieu : ''deb déplacer le joueur dans le salon''
+ℹ️ 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 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 :
+  * 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 =====
-''deb dire "[description bille]"''
+  * [[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)]]
-''déboguer dire "[texte magazine]"''
+{{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}}