Une règle remplacer écrase intégralement une action existante : description, phases (prérequis, exécution, épilogue), balises d’aide… Tout le bloc d’origine est remplacé par le vôtre. C’est l’outil à utiliser quand on veut réécrire une action (souvent une action de base héritée du moteur) plutôt que de simplement la conditionner (règle avant) ou y ajouter une réaction (règle après).

règle remplacer <action>:
  -- phases qui remplacent intégralement l’action d’origine
fin règle

Le bloc se ferme par fin règle — c’est bien une règle qui s’applique sur une action.

Le mot action après remplacer est facultatif. Les deux formes sont équivalentes :

règle remplacer sauter:        -- forme courte
règle remplacer action sauter: -- forme explicite

Une règle remplacer ne touche que l’action dont la signature correspond exactement. La signature combine :

• l’infinitif (sauter, examiner, ouvrir…)
• l’arité : sans complément / avec ceci / avec ceci et cela
• les prépositions (sauter sur ceci, mettre ceci dans cela…)
• le type de ceci et cela donné dans définitions: (objet, lieu, direction, personne, vivant…)

Si une seule de ces dimensions diffère, l’action n’est pas remplacée.

wiki_regles_remplacer_sauter

Le belvédère est un lieu.
Le joueur se trouve dans le belvédère.
 
règle remplacer sauter:
  phase épilogue:
    dire "Vous bondissez sur place. Quelle vue !".
fin règle

tester cet exemple — testez avec la commande sauter.

sauter et sauter sur ceci sont deux signatures distinctes. Une règle qui cible l’une ne touche pas l’autre.

wiki_regles_remplacer_sauter_sur

Le belvédère est un lieu.
Le joueur se trouve dans le belvédère.
Le banc est un support ici.
 
règle remplacer sauter:
  phase épilogue:
    dire "Vous bondissez sur place.".
fin règle
 
règle remplacer sauter sur ceci:
  phase épilogue:
    dire "Vous voilà perché sur [le ceci].".
fin règle

tester cet exemple — essayez sauter puis sauter sur le banc.

Plusieurs actions du moteur partagent le même infinitif et la même arité, mais ciblent des types différents. Le fichier actions.djn définit par exemple quatre examiner ceci (direction, lieu, objet, spécial). Pour cibler la bonne version, reproduisez le bloc définitions de la version visée :

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

Si plusieurs actions correspondent sans pouvoir être désambiguïsées → erreur de compilation. Si aucune n’est trouvée → avertissement non bloquant dans l’éditeur et création d’une nouvelle action.

wiki_regles_remplacer_montrer

Le salon est un lieu.
Le joueur se trouve dans le salon.
La gemme est un objet ici.
L’elfe est un vivant ici.
 
règle remplacer montrer ceci à cela:
  définitions:
    ceci est un objet.
    cela est un vivant.
  phase épilogue:
    dire "[Intitulé cela] examine [le ceci] avec curiosité.".
fin règle

tester cet exemple — essayez montrer la gemme à l’elfe.

Deux blocs règle remplacer qui ciblent la même signature sont refusés par le compilateur — une seule règle de remplacement est autorisée par action. De même, deux blocs action <signature>: identiques sont refusés ; le compilateur invite alors à utiliser règle remplacer.

• Règles (avant / après / remplacer) — index
• Règle avant — pour conditionner ou bloquer
• Règle après — pour ajouter une réaction
• Actions personnalisées — créer un nouveau verbe (à distinguer)
• Actions de base — la liste des actions du moteur