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’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.

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

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.

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

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) :

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

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

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.

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

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

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é.

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é.

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 »).

À 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é.

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

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

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.

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

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

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

• Objets — le type de base dont héritent les ressources
• Classes et états
• Instruction déplacer