Tabele podręcznika

Czym jest tabela

Tabela podręcznika to stałe dane, które czytają Twoje reguły, na przykład premia dla każdego powołania. To nie jest stan gry i gracze nigdy jej nie zmieniają. Zmiana wiersza tworzy nową wersję Twojej gry, jak każda inna zmiana źródła.

Zadeklaruj tabelę

Tabela to plik JSON w tables/. Wymień go w manifeście.

  "tables": ["tables/callings.json"]

{
  "id": "callings",
  "name": "Callings",
  "columns": [
    { "key": "calling", "label": "Calling", "type": "string" },
    { "key": "bonus", "label": "Watch bonus", "type": "number" }
  ],
  "rows": [
    { "calling": "Guard", "bonus": 30 },
    { "calling": "Scout", "bonus": 10 }
  ]
}

Framework wymienia id tabel, które czyta.

  "tables": ["callings"]

Czytaj tabelę w regule

table.find przyjmuje id tabeli, kolumny do dopasowania wraz z szukanymi wartościami oraz kolumny do zwrócenia z wartością domyślną dla każdej. Zwraca kolumny, które nazwiesz, z pierwszego wiersza, w którym wszystkie kolumny dopasowania równają się Twoim wartościom. Gdy żaden wiersz nie pasuje, zwraca Twoje wartości domyślne.

export function construct(
  name: string,
  max_hp: number,
  calling: string,
): { name: string; max_hp: number; hp: number; calling: string; watch: number } {
  const row = table.find("callings", { calling: calling }, { bonus: 0 });
  const bonus: number = row.bonus;
  return {
    name: name,
    max_hp: max_hp,
    hp: max_hp,
    calling: calling,
    watch: 20 + bonus,
  };
}

Id tabeli to tekst zapisany w kodzie, a framework musi wymieniać tę tabelę. Każda kolumna, którą nazwiesz, musi istnieć, a wracają tylko kolumny, które nazwiesz. Konstruktor czyta tabelę w ten sam sposób. Wartości do dopasowania muszą być zmienną, polem lub literałem, a nie wartością obliczaną.

Te błędy zostaną wychwycone przy sprawdzaniu projektu:

  const row = table.find("callings", { calling: calling }, { boost: 0 });

has no column 'boost'

which manifest.tables does not declare

  const row = table.find("callings", { calling: calling + "!" }, { bonus: 0 });

table.find match values must be a variable, a field or a literal

Użyj tabeli jako wyborów

Dane wejściowe tekstowe mogą brać wybory z jednej kolumny tabeli. Wyborami są różne wartości kolumny, w kolejności wierszy.

    "calling": {
      "label": "Calling",
      "optionsFrom": { "table": "callings", "column": "calling" },
      "defaultValue": "Guard"
    }

is not one of this Framework's tables

Dane wejściowe akcji typu tekst mogą zrobić to samo przez wpis optionsFrom w deklaracji akcji. Źródło musi oferować co najmniej 2 wybory.

Dalej