====== Position du joueur ======

Le joueur démarre par défaut dans le **premier lieu** déclaré du scénario. Vous pouvez modifier cette position de départ et téléporter le joueur en cours de partie.

===== Position de départ =====

==== Par défaut ====

Le joueur est placé dans le premier lieu défini :

<code donjon>
Le salon est un lieu.
Le jardin est un lieu à l'ouest du salon.
-- → Le joueur démarre dans le salon.
</code>

==== Définir explicitement le lieu de départ ====

Si vous voulez démarrer ailleurs que dans le premier lieu déclaré :

<file donjon wiki_position_joueur_demarre>
L'entrée est un lieu.
Sa description est "L'entrée d'un manoir. Au nord, le salon.".

Le salon est un lieu au nord de l'entrée.
Sa description est "Un salon richement décoré. Vous démarrez ici, pas dans l'entrée.".

Le joueur se trouve dans le salon.
</file>

[[djnc>wiki_position_joueur_demarre|tester cet exemple]]

Deux formes équivalentes acceptées :

<code donjon>
Le joueur se trouve dans le salon.
Le joueur est dans le salon.
</code>

===== Téléporter le joueur en cours de partie =====

L'instruction ''changer le joueur se trouve dans X'' déplace le joueur **immédiatement**, sans déclencher l'action ''aller''. Pratique pour :

  * un effet narratif (« vous tombez dans un piège, vous vous réveillez ailleurs ») ;
  * un raccourci (ascenseur, portail magique, fast-travel) ;
  * une commande de débogage perso.

<file donjon wiki_position_teleporter_joueur>
Le hall est un lieu.
Le grenier est un lieu.
La cave est un lieu.

action monter:
  changer le joueur se trouve dans le grenier.
fin action

action descendre:
  changer le joueur se trouve dans la cave.
fin action

action revenir:
  changer le joueur se trouve dans le hall.
fin action

règle avant commencer le jeu:
  dire "Essayez : {/monter/}, {/descendre/}, {/revenir/} — pas de sorties classiques, téléportation directe.".
fin règle
</file>

[[djnc>wiki_position_teleporter_joueur|tester cet exemple]]

===== Aller vs téléporter =====

  * **''aller au nord''** (commande joueur) déclenche l'action ''aller'' du moteur : vérifie les sorties, gère les obstacles, traite les règles avant/après ''aller''.
  * **''changer le joueur se trouve dans X''** (instruction scénario) déplace **sans** vérification ni déclenchement d'action ''aller''. Le joueur arrive directement dans le lieu cible, indépendamment des connexions de la carte.

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

  * [[reference:definitions:lieux|Lieux]] — déclarer les lieux et leurs connexions.
  * [[reference:routines:action:start|Actions personnalisées]] — pour créer des verbes de téléportation custom.
  * [[reference:instructions:changer|Instruction « changer »]] — vue d'ensemble.
  * [[reference:divers:configurations:cartouche|Cartouche]] — afficher le lieu courant côté UI.