====== 2. Le poids des bagages ======

Le passager du compartiment sept a laissé trois bagages : une **valise de cuir**, un **sac de toile**, une **malle en bois**. Chacun a un poids, et c’est cette idée — //attacher un nombre à un objet// — qui ouvre la porte à mille mécaniques de jeu : limites de portage, prix, distances, dégâts, attributs de PNJ.

===== Déclarer une propriété numérique =====

La syntaxe lit comme une affirmation : « Le poids de X vaut N. ». Une fois posée, la propriété est attachée à l’objet et accessible partout dans le scénario.

<code donjon>
La valise de cuir est un objet dans le compartiment sept.
Sa description est "Une valise de cuir patinée. Étiquette manuscrite : ''[poids ceci] kilos''.".
Le poids de la valise de cuir vaut 12.

Le sac de toile est un objet dans le compartiment sept.
Sa description est "Un sac de toile léger, presque vide. Étiquette : ''[poids ceci] kilos''.".
Le poids du sac de toile vaut 2.

La malle en bois est un objet dans le compartiment sept.
Sa description est "Une malle en bois cerclée de fer. L’étiquette indique ''[poids ceci] kilos''.".
Le poids de la malle en bois vaut 28.
</code>

[[djnc>wiki_tuto-train_02_a_propriete_simple|tester cet exemple]]

La balise ''[poids ceci]'' lit la valeur de la propriété ''poids'' de l’objet courant et l’affiche en clair. Dans la phrase « Étiquette manuscrite : ''12 kilos'' », le « 12 » est généré dynamiquement — changez le poids dans le scénario, l’étiquette suit.

📝 **Note** : la forme courte ''[poids ceci]'' suffit dans 99 % des cas. Si jamais un mot-clé du moteur entre en collision avec le nom de votre propriété, vous pouvez forcer la lecture avec la forme longue ''[p poids ceci]'' — c’est un secours, pas la norme.

===== Accumuler un total =====

Une propriété, c’est une valeur. Pour suivre un //total// qui évolue avec les actions du joueur (poids transporté, score, points de vie), on utilise plutôt un **compteur**. Et on peut l’incrémenter d’une valeur fixe, ou bien //de la propriété d’un autre objet// :

<code donjon>
Le poids transporté est un compteur initialisé à 0 avec l’unité kilos.

règle après prendre un objet:
  changer le poids transporté augmente du poids de ceci.
  dire "Vous soulevez [le ceci]. Poids transporté : [poids transporté] kilos.".
fin règle

règle après laisser un objet:
  changer le poids transporté diminue du poids de ceci.
  dire "Vous reposez [le ceci]. Poids transporté : [poids transporté] kilos.".
fin règle
</code>

[[djnc>wiki_tuto-train_02_b_propriete_calculee|tester cet exemple]]

Quelques détails :

  * ''augmente du poids de ceci'' (et symétriquement ''diminue du poids de ceci'') lit la propriété ''poids'' de l’objet pris/reposé et l’ajoute/retranche au compteur.
  * L’unité ''kilos'' attachée au compteur est utilisée par le cartouche (chapitre suivant). Dans une chaîne ''dire'', en revanche, on écrit l’unité à la main — ce qui laisse le contrôle sur la formulation.
  * ''[le ceci]'' produit l’article correct (''le'', ''la'', ''l’'', ''les'') devant le nom de l’objet — vous verrez ça en détail au chapitre 7.

===== À retenir =====

  * **Propriété numérique** : ''Le <nom> de X vaut N.''. Lecture via ''[<nom> ceci]''.
  * **Compteur** : ''Le X est un compteur initialisé à N avec l’unité U.''. Lecture via ''[X]'' (forme courte ''[X]'', forme longue ''[c X]'' en secours).
  * Pour cumuler : ''changer le X augmente de N.'' ou ''changer le X augmente de la <propriété> de ceci.''.

Suite : [[tutoriels:train:partie3_cartouche|3. Le tableau de bord]]