Фреймворки на коде

Рецепт: потратьте ресурс

Напишите действие, которое ничего не делает, когда ресурс закончился, и проверьте оба случая.

Цель

Пусть Keeper выпускает три искры. Четвёртая ничего не делает.

Что менять

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

Строка 2 Прочитайте ресурс.
Строки 3-5 Тратьте один, только пока он есть. Иначе действие ничего не записывает.

Объявите действие в схеме.

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

Строка 13 Новое действие.

Конструктор возвращает charges с начальным значением 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 };
}

Строки 5-6 charges это хранимое поле с начальным значением 3.

Добавьте псевдоним действия в dataContract Frame и кнопку, которая его использует, иначе игроки не смогут вызвать его с листа.

layouts/keeper.json

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

Строка 20 Псевдоним действия.

layouts/keeper.json

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

Строка 34 Кнопка, которая его вызывает.

Проверьте

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

Строки 7-27 Три искры тратят по одному заряду.
Строка 28 Четвёртая не находит зарядов, поэтому ожидает отсутствие записей.

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

Строка 12 Новый файл сценария.

Перечислите новый файл сценария в манифесте. Добавьте charges в ожидаемые значения двух других сценариев.

Дальше

Устранение неполадокЧто делать, если проверка не проходит.Вырастим LanternПостройте целый цикл шаг за шагом.