Différences

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

--- reference:routines:action:start [2022/10/11 17:57] – jonathan
+++ reference:routines:action:start [2024/10/12 22:14] (Version actuelle) – modification externe 127.0.0.1
@@ Ligne 1: / Ligne 1: @@
-====== Action (personnalisées) ======
+====== Action (personnalisée) ======
 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 =====
@@ Ligne 52: / Ligne 52: @@
 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é.
-===== Définition des compléments =====
+===== Définition des compléments variables d'une action =====
+Il est possible de spécifier 1 ou 2 compléments pour une action.
+Par convention, le premier sera toujours nommé « ''ceci'' » et le second « ''cela'' ».
+Si vous n'écrivez pas de définition pour les compléments, il leur sera attribué une définition par défaut « ''ceci est un objet visible et accessible.'' »
+==== Action sans complément ====
+<code donjon>
+action sauter:
+  dire "Vous sautez.".
+fin action
+</code>
+==== Action avec 1 complément (ceci) ====
+<code donjon>
+action sauter sur ceci:
+  définition:
+    ceci est un support.
+  phase épilogue:
+    dire "vous sautez sur [intitulé ceci].".
+fin action
+</code>
+==== Action avec 2 complément (ceci et cela) ====
+<code donjon>
+action combiner ceci avec cela:
+  définition:
+    ceci est un objet visible et accessible.
+    cela est un objet visible et accessible.
+  phase épilogue:
+    dire "Ça n'a rien donné.".
+fin action
+</code>
+==== Priorité (prioritairement) ====
+Si vous souhaitez donner la priorité à certains objets par rapport à d’autres vous pouvez utiliser le mot clé « ''prioritairement'' ».
+__Exemple concret__
+En cours de jeu, le joueur possède une pomme dans son inventaire tandis qu’une autre pomme se trouve encore sur la table.
+Voici 2 commandes que le joueur pourrait entrer:
+) ''prendre la pomme'': l’action //prendre// donne la priorité à la pomme qui est encore //disponible// sur la table (contrairement à celle qui est déjà //possédée// par le joueur).
+<code donjon>
+action prendre ceci:
+  définitions:
+    ceci est un objet visible et accessible prioritairement disponible.
+(...)
+fin action
+</code>
+) ''lâcher la pomme'': l’action //lâcher// donne la priorité à la pomme est est //possédée// par le joueur (contrairement à celle qui est encore //disponible// sur la table).
+<code donjon>
+action lâcher ceci:
+  définitions:
+    ceci est prioritairement possédé.
+(...)
+fin action
+</code>
+Plus d’informations : [[reference:memoire:etats:etats_de_base|]].
+===== Définition d'une action qui déplace le joueur =====
+En ajoutant la phrase ''L’action déplace le joueur vers ceci.'' vous aurez accès aux variables ''source'' et ''destination'' dans vos règles.
+<code donjon>
+action aller vers ceci:
+  définitions:
+    Ceci est un lieu.
+    L’action déplace le joueur vers ceci.
+  phase prérequis:
+    si le joueur se trouve dans ceci, refuser "Vous y êtes déjà.".
+  phase exécution
+    déplacer le joueur vers ceci.
+  phase épilogue:
+    exécuter l’action regarder.
+fin action
+-- modifier l’action « aller »
+--   remarque: avec une action qui déplace le joueur (aller), on peut utiliser les
+--   variables « origine », « destination » et « orientation ».
+règle avant aller vers un lieu:
+  -- si le joueur tente d’aller là où il se trouve déjà
+  si le joueur se trouve dans destination:
+    dire "Vous y êtes déjà !".
+  -- sinon déplacer le joueur vers la destination.
+  sinon
+    dire "{/Vous disparaissez de [intitulé origine]… et vous apparaissez dans [intitulé destination] !/}".
+    changer le joueur se trouve dans destination.
+    -- décrire le nouveau lieu où se trouve le joueur
+    dire "{p}{_{*[titre ici]*}_}".
+    dire "{n}[description ici][décrire objets ici]".
+  fin si
+  arrêter l’action.
+fin règle
+</code>