Framework in codice
Ricetta: spendere una risorsa
Scrivi un'azione che non fa nulla quando la risorsa è finita, e testa entrambi i casi.
Obiettivo
Lascia che un Keeper lanci tre scintille. La quarta non fa nulla.
La modifica
rules/spark.ts
export function spark(self: ElementRef): void {
const charges: number = element.var(self, "charges") as number;
if (charges > 0) {
ledger.add(self, "charges", -1);
}
}- Riga 2 Leggi la risorsa.
- Righe 3-5 Spendine una solo finché ne resta. Altrimenti l'azione non scrive nulla.
Dichiara l'azione nello schema.
schemas/keeper.json
"actions": [
{ "id": "hurt", "name": "Take damage", "source": "rules/hurt.ts" },
{ "id": "heal", "name": "Heal", "source": "rules/heal.ts" },
{ "id": "spark", "name": "Strike a spark", "source": "rules/spark.ts" }
],- Riga 13 La nuova azione.
Il costruttore restituisce charges con valore iniziale 3.
rules/keeper.ts
export function construct(
name: string,
max_hp: number,
): { name: string; max_hp: number; hp: number; charges: number } {
return { name: name, max_hp: max_hp, hp: max_hp, charges: 3 };
}- Righe 5-6 charges è un campo salvato con valore iniziale 3.
Aggiungi un alias per l'azione al dataContract del Frame e un pulsante che lo usa, altrimenti i giocatori non possono usarla dalla scheda.
layouts/keeper.json
{ "name": "spark", "functionRef": "spark" }- Riga 20 L'alias per l'azione.
layouts/keeper.json
{ "kind": "button", "label": "Strike a spark", "actionRef": "spark" }- Riga 34 Il pulsante che la chiama.
Provalo
scenarios/spark.json
{
"id": "spend-all-charges",
"framework": "keeper",
"parameters": { "name": "Mira", "max_hp": 10 },
"expectedValues": { "name": "Mira", "max_hp": 10, "hp": 10, "charges": 3 },
"actions": [
{
"action": "spark",
"parameters": {},
"expectedWrites": [
{ "op": "ledger.add", "key": "charges", "value": -1 }
]
},
{
"action": "spark",
"parameters": {},
"expectedWrites": [
{ "op": "ledger.add", "key": "charges", "value": -1 }
]
},
{
"action": "spark",
"parameters": {},
"expectedWrites": [
{ "op": "ledger.add", "key": "charges", "value": -1 }
]
},
{ "action": "spark", "parameters": {}, "expectedWrites": [] }
]
}- Righe 7-27 Tre scintille spendono una carica ciascuna.
- Riga 28 La quarta non trova cariche, quindi si aspetta nessuna scrittura.
manifest/project.json
{
"formatVersion": "fabled.game-project/v1",
"projectId": "game-your-game-id",
"projectKind": "GAME",
"compilerProfile": "native-game-v1",
"name": "Lantern Keepers",
"entryFramework": "keeper",
"frameworks": ["schemas/keeper.json"],
"scenarios": [
"scenarios/new-keeper.json",
"scenarios/heal.json",
"scenarios/spark.json"
]
}- Riga 12 Il nuovo file di scenario.
Elenca il nuovo file di scenario nel manifest. Aggiungi charges ai valori attesi degli altri due scenari.