Doc Donjon FI (v3)

Éditeur de fictions interactives avec interpréteur

Outils pour utilisateurs

Outils du site

Vous êtes ici : Accueil » Référence » Actions (prédéfinies) » Action (personnalisée)
reference:routines:action:start

Différences

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

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision		Révision précédente
reference:routines:action:start [2022/10/19 17:40] – jonathanreference:routines:action:start [2026/06/16 21:50] (Version actuelle) – modification externe 127.0.0.1
Ligne 3: Ligne 3:
 Une action est une [[reference:routines:start|routine]] qui s’exécute lorsque le joueur entre une commande durant une partie. Une action est une [[reference:routines:start|routine]] qui s’exécute lorsque le joueur entre une commande durant une partie.
  
-💡 Si vous souhaitez consulter les //actions de base//, voir [[reference:actions:start|cette page]].+💡 Si vous souhaitez consulter les //actions de base//, voir [[reference:routines:actions_predefinies:start|cette page]].
  
 ===== Exemple d’action simple ===== ===== Exemple d’action simple =====
Ligne 12: Ligne 12:
 <code donjon> <code donjon>
 action sauter: action sauter:
-  dire "Vous sautez sur place.";+  dire "Vous sautez sur place.".
 fin action fin action
 </code> </code>
Ligne 38: Ligne 38:
 ===== Les phases d’une action ===== ===== Les phases d’une action =====
  
-Ainsi que vous pouvez le voir dans l’exemple ci-dessus, une action se compose de 3 phases : refus, exécution et épilogue.+Ainsi que vous pouvez le voir dans l’exemple ci-dessus, une action se compose de 3 phases : prérequis, exécution et épilogue. Elles s’exécutent dans cet ordre. **Si la phase prérequis refuse l’action, les phases suivantes (exécution et épilogue) ne sont pas exécutées.**
  
 ==== Phase prérequis ==== ==== Phase prérequis ====
Ligne 51: Ligne 51:
  
 Cette phase permet d’informer le joueur du résultat de l’action qui s’est exécutée. Par exemple on décrit au joueur le lieu dans lequel il s’est déplacé. Cette phase permet d’informer le joueur du résultat de l’action qui s’est exécutée. Par exemple on décrit au joueur le lieu dans lequel il s’est déplacé.
 +
 +===== Refuser une action =====
 +
 +Vous pouvez interrompre une action depuis la phase prérequis (ou depuis une [[reference:routines:regle:start|règle avant]]). Deux formes :
 +
 +==== refuser "message" ====
 +
 +Affiche le message au joueur et stoppe l’action :
 +
 +<code donjon>
 +si ceci n’est pas accessible, refuser "Je n’y ai pas accès.".
 +</code>
 +
 +==== refuser l’action ====
 +
 +Stoppe l’action **sans** afficher de message — utile quand vous avez déjà affiché un texte contextuel avec ''dire'' juste avant :
 +
 +<code donjon>
 +règle avant prendre le vase Ming:
 +  dire "Le gardien lève les yeux et vous regarde fixement.".
 +  refuser l’action.
 +fin règle
 +</code>
 +
 +<WRAP info>Un refus stoppe l’action **complètement** : les phases ''exécution'' et ''épilogue'' ne sont pas exécutées.</WRAP>
  
 ===== Définition des compléments variables d'une action ===== ===== Définition des compléments variables d'une action =====
Ligne 78: Ligne 103:
 </code> </code>
  
-==== Action avec 2 complément (ceci et cela) ====+==== Action avec 2 compléments (ceci et cela) ====
  
 <code donjon> <code donjon>
 action combiner ceci avec cela: action combiner ceci avec cela:
-  définition:+  définitions:
     ceci est un objet visible et accessible.     ceci est un objet visible et accessible.
     cela est un objet visible et accessible.     cela est un objet visible et accessible.
Ligne 88: Ligne 113:
     dire "Ça n'a rien donné.".     dire "Ça n'a rien donné.".
 fin action fin action
 +</code>
 +
 +==== Types de cibles ====
 +
 +À l’intérieur de ''définition'' (ou ''définitions'' au pluriel quand il y a deux compléments), vous précisez ce que le moteur doit chercher pour identifier ''ceci'' / ''cela'' :
 +
 +<code donjon>
 +ceci est un objet.                       -- n'importe quel objet
 +ceci est un objet visible.               -- objet présent et visible
 +ceci est un objet vu et visible.         -- objet déjà vu au moins une fois
 +ceci est un support.                     -- objet sur lequel on peut poser
 +ceci est un contenant.                   -- objet dans lequel on peut mettre
 +ceci est une personne.                   -- élément vivant
 +ceci est un lieu.                        -- pour une action de déplacement
 +ceci est une direction.                  -- nord, sud, en haut, …
 +ceci est un intitulé.                    -- n'importe quel élément ou direction
 +</code>
 +
 +Les épithètes se combinent ; l’ordre n’a pas d’importance :
 +
 +<code donjon>
 +ceci est un objet vu, visible et accessible.
 +cela est une personne visible.
 </code> </code>
  
Ligne 118: Ligne 166:
 </code> </code>
  
-Plus d’informations : [[reference:memoire:etats:etats_de_base|]].+Plus d’informations : [[reference:definitions:etats_personnalises|États personnalisés]] et [[reference:definitions:visibilite|Visibilité et accessibilité]].
  
 ===== Définition d'une action qui déplace le joueur ===== ===== Définition d'une action qui déplace le joueur =====
Ligne 134: Ligne 182:
     si le joueur se trouve dans ceci, refuser "Vous y êtes déjà.".     si le joueur se trouve dans ceci, refuser "Vous y êtes déjà.".
  
-  phase exécution+  phase exécution:
     déplacer le joueur vers ceci.     déplacer le joueur vers ceci.
  
Ligne 160: Ligne 208:
  
 </code> </code>
 +
 +===== Aide contextuelle =====
 +
 +Vous pouvez fournir une aide affichée quand le joueur tape ''aide nomAction'' :
 +
 +<code donjon>
 +L’aide pour l’action mélanger est "{*mélanger X avec Y*}{n}Verse une potion dans une autre. Les deux potions doivent être des potions distinctes.".
 +</code>
 +
 +===== Remplacer une action existante =====
 +
 +→ **Page dédiée : [[reference:routines:regle:remplacer|Règle remplacer]]** (syntaxe, correspondance par signature, exemples testables).
 +
 +Pour **écraser** une action déjà définie (par exemple une [[reference:routines:actions_predefinies:start|action de base]] héritée du moteur), utilisez un bloc ''règle remplacer <signature>:''. Le bloc remplace **intégralement** l’action d’origine : description, phases, balises d’aide, etc. Les synonymes ne sont pas hérités — recopiez-les si vous voulez les conserver. Le bloc se ferme par ''fin règle''. Le mot ''action'' est facultatif après ''remplacer'' : ''règle remplacer sauter'' et ''règle remplacer action sauter'' sont équivalents.
 +
 +<code donjon>
 +règle remplacer sauter:
 +  phase épilogue:
 +    dire "Vous bondissez comme un cabri.".
 +fin règle
 +</code>
 +
 +==== Correspondance par signature ====
 +
 +La signature doit correspondre exactement à l’action ciblée : verbe, prépositions et présence de ''ceci'' / ''cela''. Un bloc ''règle remplacer sauter'' ne touche pas ''action sauter sur ceci'' et vice-versa.
 +
 +<code donjon>
 +règle remplacer sauter sur ceci:
 +  phase épilogue:
 +    dire "Hop, vous voilà perché sur [le ceci].".
 +fin règle
 +</code>
 +
 +==== Désambiguïsation par définitions ====
 +
 +Plusieurs actions du moteur partagent le même infinitif et la même arité. Le fichier ''actions.djn'' définit par exemple **quatre** ''action examiner ceci'' distinctes, une pour chaque type de cible : direction, lieu, objet, spécial.
 +
 +Pour cibler la bonne version, reproduisez le bloc ''définitions'' de la version visée — seul le **type** de la cible (''objet'', ''lieu'', ''direction''…) est utilisé pour identifier l’action ; les épithètes (''visible'', ''vu'', ''prioritairement…'') n’interviennent pas dans la sélection.
 +
 +<code donjon>
 +règle remplacer examiner ceci:
 +  définitions:
 +    ceci est un objet prioritairement visible et mentionné.
 +  phase épilogue:
 +    dire "Rien d’intéressant à signaler sur [le ceci].".
 +fin règle
 +</code>
 +
 +<WRAP info>
 +Recopiez tout de même les épithètes et la priorité de l’action originale (ici ''prioritairement visible et mentionné''). Comme le remplacement est **total**, ces critères sont aussi remplacés ; si vous les omettez, le résolveur de commandes peut ne plus sélectionner votre version au profit d’une autre action concurrente.
 +</WRAP>
 +
 +Si plusieurs actions correspondent à la signature fournie sans pouvoir être désambiguïsées, une erreur de compilation est émise. Si aucune action existante ne correspond, un avertissement non bloquant est affiché dans l’éditeur Donjon FI et la règle crée une nouvelle action.
 +
 +==== Doublons d’actions ====
 +
 +Deux blocs ''action <signature>:'' avec **exactement** la même signature (même infinitif, même arité ceci/cela, mêmes prépositions, même type de cible via ''définitions:'') sont refusés. Le compilateur émet une erreur et vous invite à utiliser ''règle remplacer'' si l’intention était de modifier le comportement existant. De même, deux blocs ''règle remplacer'' qui ciblent la même action sont refusés : une seule règle de remplacement est autorisée par action.
 +
 +===== Voir aussi =====
 +
 +  * [[reference:routines:action:exemples|Exemples d’actions personnalisées]] — mini-scénarios complets à tester
 +  * [[reference:routines:regle:start|Règles avant / après]] — pour intercepter une action existante sans la réécrire
 +  * [[reference:routines:actions_predefinies:start|Actions de base]] — la liste des actions déjà fournies par le moteur
 +  * [[reference:divers:synonymes|Synonymes d’actions]] — pour rediriger ''regarder'' vers ''examiner'', etc.
 +
 +{{tag>action actions action_personnalisée action_personnalisee verbe commande routine routines phase phases prérequis prerequis exécution execution épilogue epilogue ceci cela complément complement définition definition refuser prioritairement remplacer aide}}
  
reference/routines/action/start.1666194011.txt.gz · Dernière modification : (modification externe)