Code frameworks
Receta: gastar un recurso
Escribe una acción que no hace nada cuando se acaba un recurso, y prueba los dos casos.
Objetivo
Deja que un Keeper encienda tres chispas. Una cuarta no hace nada.
El cambio
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);
}
}- Línea 2 Lee el recurso.
- Líneas 3-5 Gasta uno solo mientras quede alguno. Si no, la acción no escribe nada.
Declara la acción en el esquema.
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" }
],- Línea 13 La acción nueva.
El constructor devuelve charges con un valor inicial de 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 };
}- Líneas 5-6 charges es un campo guardado con un valor inicial de 3.
Añade un alias de la acción al dataContract del Frame y un botón que lo use, o los jugadores no podrán usarla desde la hoja.
layouts/keeper.json
{ "name": "spark", "functionRef": "spark" }- Línea 20 El alias de la acción.
layouts/keeper.json
{ "kind": "button", "label": "Strike a spark", "actionRef": "spark" }- Línea 34 El botón que la llama.
Pruébalo
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": [] }
]
}- Líneas 7-27 Tres chispas gastan una carga cada una.
- Línea 28 La cuarta no encuentra cargas, así que espera cero escrituras.
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"
]
}- Línea 12 El archivo de escenario nuevo.
Enumera el archivo de escenario nuevo en el manifiesto. Añade charges a los valores esperados de los otros dos escenarios.