====== Ressources (objets quantifiables) ======

Une **ressource** est un type d’objet que l’on **accumule en quantité variable** : argent, bois, essence, fruits, points de vie matérialisés… Elle hérite d’[[reference:definitions:objets|objet]] : on la prend, la pose, la donne, la consomme comme un objet ordinaire, mais en **quantités** plutôt qu’à l’unité.

Chaque ressource possède une **unité** de comptage (« pièce », « litre », « unité »…), explicite ou par défaut.

===== Définir une ressource =====

On déclare une ressource comme une classe d’objet, puis on en place une quantité avec ''Il y a N … '' :

<file donjon wiki_ressources_definir>
-- Trois façons de déclarer une ressource, puis on la place en quantité.
L'atelier est un lieu.

-- ressource « massive » : sans unité déclarée, l'unité par défaut est « unité »
Le bois est une ressource.
Il y a 30 unités de bois ici.

-- ressource avec une unité explicite
L'argent est une ressource exprimée en pièces.
Il y a 5 pièces d'argent ici.

-- ressource déclarée au pluriel : comptée par son propre nom
Les fruits sont une ressource.
Il y a 4 fruits dans l'atelier.
</file>

[[djnc>wiki_ressources_definir|tester cet exemple]] — tapez ''regarder'' : le moteur affiche « 30 unités de bois », « 5 pièces d’argent » et « 4 fruits ».

==== Unité de comptage ====

Selon la déclaration, **sans** unité explicite :

  * ressource déclarée **au pluriel** (« Les fruits ») → comptée par son nom : « 5 fruits » ;
  * ressource déclarée **au singulier** / nom massif (« Le bois ») → unité par défaut « unité(s) » : « 30 unités de bois ».

Trois façons de déclarer une unité **explicite** (le moteur en dérive automatiquement le singulier et le pluriel) :

<code donjon>
L'argent est une ressource exprimée en pièces.   -- unité donnée au pluriel
L'eau est une ressource avec l'unité litre.        -- unité donnée au singulier
Le sable est une ressource.
Son unité est le grain.                            -- séparément, après la définition
</code>

==== Placer des quantités ====

Les nombres s’écrivent en **chiffres**. Les emplacements possibles sont ''ici'', ''dans …'', ''sur …'', ''sous …'' :

<code donjon>
Il y a 30 unités de bois ici.
Il y a 5 pièces d'argent dans le coffre.
Il y a 3 unités d'essence sous la table.
</code>

Une même ressource peut former **plusieurs piles indépendantes** :

<code donjon>
Il y a 5 pièces d'argent dans le coffre.
Il y a 3 pièces d'argent sur la table.   -- deux piles distinctes : 5 et 3
</code>

<WRAP info>Une ressource déclarée mais **jamais placée** vaut **0** : le type existe, mais il n’y en a aucune dans le monde tant qu’on n’en place ou n’en crée pas.</WRAP>

===== Commandes du joueur =====

Les commandes habituelles acceptent une **quantité** et l’**unité**. Le joueur désigne la ressource par son unité (« les pièces ») ou par « unité de ressource » (« les pièces d’argent ») pour lever une ambiguïté.

<file donjon wiki_ressources_commandes>
-- Les commandes habituelles fonctionnent avec des quantités et l'unité.
Le marché est un lieu.
Le marchand est une personne ici.

L'argent est une ressource exprimée en pièces.
Il y a 10 pièces d'argent ici.

Les fruits sont une ressource mangeable.
Il y a 5 fruits dans le marché.
</file>

[[djnc>wiki_ressources_commandes|tester cet exemple]] — après ''regarder'', essayez :

  * ''prendre les pièces'' — prend toute la pile
  * ''donner 3 pièces d’argent au marchand''
  * ''prendre les fruits'' puis ''manger 2 fruits''

''déposer'' est un synonyme de ''poser'' (« déposer 2 fruits sur la table »).

===== Manipuler les ressources dans les règles =====

À l’intérieur des règles, réactions et actions personnalisées, trois instructions agissent sur les ressources :

  * ''créer N <unité> de X dans/sur/sous <cible>'' — fait apparaître N unités à un emplacement (''dans l’inventaire'', un contenant, un support, un lieu) ;
  * ''consommer N <unité> de X'' — retire N unités possédées (elles disparaissent) ;
  * ''déplacer [les | N] <unité> de X depuis <source> vers <destination>'' — transfère une pile d’un emplacement à un autre.

Les emplacements reconnus sont ''l’inventaire'', ''l’intérieur du <contenant>'', ''le dessus du <support>'', ''le dessous du <support>'', ou un lieu/contenant/support nommé.

<file donjon wiki_ressources_instructions>
-- Manipuler une ressource par script dans des règles (ici, des actions personnalisées).
Le sanctuaire est un lieu.
Le coffre est un contenant ouvert ici.

L'or est une ressource exprimée en pépites.
Il y a 8 pépites d'or dans le coffre.

-- créer : fait apparaître de nouvelles unités à un emplacement
action invoquer:
  phase exécution:
    créer 3 pépites d'or dans l'inventaire.
  phase épilogue:
    dire "Trois pépites d'or se matérialisent dans votre main.".
fin action

-- déplacer … depuis … vers … : transfère une pile d'un emplacement à un autre
action piller:
  phase exécution:
    déplacer les pépites d'or depuis l'intérieur du coffre vers l'inventaire.
  phase épilogue:
    dire "Vous raflez l'or du coffre.".
fin action

-- consommer : retire des unités possédées (elles disparaissent)
action dépenser:
  phase exécution:
    consommer 5 pépites d'or.
  phase épilogue:
    dire "Vous dépensez 5 pépites d'or.".
fin action
</file>

[[djnc>wiki_ressources_instructions|tester cet exemple]] — tapez ''invoquer'' (crée 3 pépites), ''piller'' (vide le coffre vers l’inventaire), puis ''dépenser'' (en retire 5).

===== Désambiguïsation par emplacement =====

Quand plusieurs piles de la **même** ressource ont été aperçues, une commande non qualifiée (« prendre les pièces ») demande au joueur de préciser, en listant l’**emplacement** de chaque pile (« sur la table », « dans le coffre », « dans votre inventaire »).

Seules les piles **déjà mentionnées** au joueur sont proposées : on ne révèle pas les piles encore inconnues. S’il n’en reste qu’une après ce filtre, elle est choisie sans poser de question.

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

Un petit campement combinant les trois styles de ressources, l’affichage, les commandes et les instructions :

<file donjon wiki_ressources_campement>
-- ============================================================
--  Exemple complet : « Le campement »
-- ============================================================

Le titre du jeu est "Le campement".

Le campement est un lieu.
Sa description est "Un campement au pied de la montagne : un feu de camp à entretenir, et de quoi tenir la nuit.".

Le feu est un objet ici.

-- de l'or, exprimé en pièces
L'or est une ressource exprimée en pièces.
Il y a 12 pièces d'or ici.

-- du bois (massif) : unité par défaut « unité »
Le bois est une ressource.
Il y a 20 unités de bois ici.

-- des rations, comptées par leur nom, que l'on peut manger
Les rations sont une ressource mangeable.
Il y a 4 rations dans le campement.

-- entretenir le feu consomme 5 unités de bois
action alimenter ceci:
  définitions:
    ceci est un objet.
  phase exécution:
    consommer 5 unités de bois.
  phase épilogue:
    dire "Vous jetez 5 unités de bois dans le feu, qui crépite de plus belle.".
fin action

-- une prière fait apparaître quelques pièces d'or dans votre bourse
action invoquer:
  phase exécution:
    créer 3 pièces d'or dans l'inventaire.
  phase épilogue:
    dire "Trois pièces d'or tintent dans votre bourse.".
fin action
</file>

[[djnc>wiki_ressources_campement|tester cet exemple]] — essayez ''regarder'', ''alimenter le feu'' (il reste 15 unités de bois), ''invoquer'', ''prendre les rations'' puis ''manger 2 rations''.

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

  * [[reference:definitions:objets|Objets]] — le type de base dont héritent les ressources
  * [[reference:definitions:classes|Classes et états]]
  * [[reference:instructions:deplacer|Instruction déplacer]]