====== Historique ======

Vous pouvez utiliser une ou plusieurs listes pour vous souvenir quelles étapes ont déjà été réalisées par le joueur ou encore quels événements ont déjà été déclenchés ou résolus.

===== Définir la liste qui sera l’historique =====

<code donjon>
L’historique est une liste.
</code>

===== Ajouter et retirer des éléments à l’historique =====

<code donjon>
changer l’historique contient "carte au trésor retrouvée".
changer l’historique ne contient plus "sortie grotte bloquée".
</code>

===== Vérifier un élément de l’historique =====

<code donjon>
si l’historique contient "sortie grotte bloquée":
  dire "Pas moyen de sortir de la grotte pour le moment.".
sinon
  dire "On pourrait sortir de la grotte.".
fin si
</code>

Dans un texte dynamique :
<code donjon>
sa description est "[si l'historique contient "sortie grotte bloquée"]Pas moyen de sortir pour le moment.[sinon]On pourrait sortir.[fin si]".
</code>

===== Exemple complet =====

Un levier dont l’état (abaissé ou non) est mémorisé dans l’historique. L’historique sert à la fois dans une condition ''si'' et dans une balise dynamique de description.

<file donjon wiki_memoire_historique_levier>
Le hall est un lieu.
Le levier est un objet ici.
Sa description est "Un gros levier de fer. [si l'historique contient "levier actionné"]Il est à présent abaissé.[sinon]Il est en position haute.[fin si]".

L'historique est une liste.

action actionner le levier:
  changer l'historique contient "levier actionné".
  dire "Le levier bascule avec un grincement.".
fin action

action vérifier:
  si l'historique contient "levier actionné":
    dire "Le mécanisme est enclenché.".
  sinon
    dire "Aucun événement enregistré pour le moment.".
  fin si
fin action

règle avant commencer le jeu:
  dire "Essayez : {/examiner le levier/}, {/actionner le levier/}, puis {/vérifier/}.".
fin règle
</file>

[[djnc>wiki_memoire_historique_levier|tester cet exemple]]

===== Pourquoi pas un état personnalisé ? =====

L’**historique** est pratique pour des **événements globaux** ou ponctuels (« le boss est vaincu », « le joueur a parlé au roi », « la trappe a été ouverte ») qui ne sont pas naturellement liés à un objet précis. Pour des informations attachées à un élément, préférez :

  * un [[reference:definitions:etats_personnalises|état personnalisé]] sur l’objet concerné (''féroce'', ''cueillie'', ''mélangée''…) — plus lisible et auto-documenté
  * une [[reference:definitions:proprietes_personnalisees|propriété personnalisée]] pour une valeur numérique ou textuelle

L’historique reste le bon outil quand l’événement transcende un objet unique.

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

  * [[reference:memoire:listes|Listes]] — la syntaxe générale (l’historique est une liste de textes)
  * [[reference:memoire:compteurs|Compteurs]] — pour une valeur numérique
  * [[reference:definitions:etats_personnalises|États personnalisés]] — souvent plus naturel quand l’info colle à un objet

{{tag>historique événement événements evenement etape étape étapes liste mémoire memoire souvenir trace contient mémoriser memoriser}}