Code frameworks

Receita: gastar um recurso

Escreva uma ação que não faz nada quando um recurso acaba e teste os dois casos.

Objetivo

Deixe um Keeper acender três faíscas. A quarta não faz nada.

A mudança

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);
  }
}

Linha 2 Leia o recurso.
Linhas 3-5 Gaste um só enquanto ainda houver. Senão, a ação não escreve nada.

Declare a ação no 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" }
  ],

Linha 13 A nova ação.

O construtor devolve charges com valor inicial 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 };
}

Linhas 5-6 charges é um campo guardado com valor inicial 3.

Adicione um alias da ação ao dataContract do Frame e um botão que o use, ou os jogadores não poderão usá-la na ficha.

layouts/keeper.json

      { "name": "spark", "functionRef": "spark" }

Linha 20 O alias da ação.

layouts/keeper.json

      { "kind": "button", "label": "Strike a spark", "actionRef": "spark" }

Linha 34 O botão que a chama.

Teste

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": [] }
  ]
}

Linhas 7-27 Três faíscas gastam uma carga cada.
Linha 28 A quarta não encontra cargas, então espera nenhuma escrita.

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"
  ]
}

Linha 12 O novo arquivo de cenário.

Liste o novo arquivo de cenário no manifesto. Adicione charges aos valores esperados dos outros dois cenários.

Próximos passos

Solução de problemasO que fazer quando uma verificação falha.Grow LanternCrie um ciclo completo passo a passo.