Tables du livre de règles

Ce qu'est une table

Une table du livre de règles est une donnée fixe que vos règles lisent, comme un bonus pour chaque Calling. Ce n'est pas un état de jeu, et les joueurs ne la changent jamais. Changer une ligne crée une nouvelle version de votre jeu, comme toute autre modification de la source.

Déclarer une table

Une table est un fichier JSON dans tables/. Listez-la dans le manifeste.

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

Un Framework liste les ids des tables qu'il lit.

  "tables": ["callings"]

Lire une table dans une règle

table.find prend l'id de la table, les colonnes à comparer avec les valeurs à chercher, et les colonnes à retourner avec une valeur par défaut pour chacune. Il retourne les colonnes que vous nommez, depuis la première ligne dont les colonnes de comparaison sont toutes égales à vos valeurs. Quand aucune ligne ne correspond, il retourne vos valeurs par défaut.

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

L'id de la table est un texte écrit dans le code, et le Framework doit lister la table. Chaque colonne que vous nommez doit exister, et seules les colonnes que vous nommez reviennent. Un constructeur lit une table de cette façon. Les valeurs à comparer doivent être une variable, un champ ou un littéral, pas une valeur calculée.

Ces erreurs sont détectées quand vous vérifiez le projet :

  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

Utiliser une table pour des choix

Une entrée de texte peut prendre ses choix dans une colonne d'une table. Les choix sont les valeurs distinctes de la colonne, dans l'ordre des lignes.

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

is not one of this Framework's tables

Une entrée d'action de type texte peut faire pareil avec une entrée optionsFrom dans la déclaration de l'action. Une source doit proposer au moins 2 choix.

Suite