Regelwerk-Tabellen

Was eine Tabelle ist

Eine Regelwerk-Tabelle sind feste Daten, die deine Regeln lesen, zum Beispiel ein Bonus für jede Berufung. Sie gehört nicht zum Spielzustand, und Spieler ändern sie nie. Wer eine Zeile ändert, erzeugt eine neue Version deines Spiels, wie bei jeder anderen Änderung an der Quelle.

Eine Tabelle deklarieren

Eine Tabelle ist eine JSON-Datei in tables/. Liste sie im Manifest auf.

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

Ein Framework listet die ids der Tabellen auf, die es liest.

  "tables": ["callings"]

Eine Tabelle in einer Regel lesen

table.find nimmt die Tabellen-id, die Spalten zum Abgleich mit den gesuchten Werten und die Spalten für das Ergebnis, jeweils mit einem Standardwert. Es gibt die Spalten zurück, die du nennst, aus der ersten Zeile, deren Abgleich-Spalten alle gleich deinen Werten sind. Passt keine Zeile, gibt es deine Standardwerte zurück.

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

Die Tabellen-id ist ein String, der im Code steht, und das Framework muss die Tabelle auflisten. Jede Spalte, die du nennst, muss existieren, und nur die genannten Spalten kommen zurück. Ein Konstruktor liest eine Tabelle auf diese Weise. Die Werte zum Abgleichen müssen eine Variable, ein Feld oder ein Literal sein, kein berechneter Wert.

Diese Fehler fängt die Prüfung des Projekts ab:

  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

Eine Tabelle als Auswahl nutzen

Eine Text-Eingabe kann ihre Auswahl aus einer Spalte einer Tabelle nehmen. Die Auswahl besteht aus den verschiedenen Werten der Spalte, in der Reihenfolge der Zeilen.

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

is not one of this Framework's tables

Eine Aktions-Eingabe vom Typ text kann dasselbe mit einem optionsFrom-Eintrag in der Deklaration der Aktion tun. Eine Quelle muss mindestens 2 Optionen bieten.

Weiter