Craft

Tracker field kinds

A tracker is a name and one to 8 fields. Each field is one of the kinds below, and the play screen draws each kind its own way at every size. The keys and limits come from the code that checks trackers, so they are exactly what a save accepts.

Some keys work the same in every kind:

  • label names the field on the card. With more than one field, each needs a different one.
  • hidden: true keeps a field, an item, a record or a link from the players until the GM reveals it.
  • Numbers (count, clock, scale) take tone ("good" fills green, "bad" red) and at, what happens when the value reaches a number: { "6": "The Watch raids the hideout" }. The GM is told when a threshold is reached on the way from where the number started.
  • A ref ({ "name": "Mira Vex" }) names a person, place or file. The game finds the file by the name and shows its picture, so write the name and leave file to the game.
  • show names live values to draw beside each person a field names: a stat from their sheet by its label ("HP") or "where" (where they stand). They are read when the card is drawn, never copied in.
  • each is what a new record or link starts with. The game fills every record or link with the fields it lacks.
  • The game stamps when a tracker started and last changed, and where each number started. Leave those out.

In the tracker form, Add an element offers these: a Number shown as Number, Bar or Dots is a count, shown as Clock a clock, and as Tug of war a scale; Text is text; a List shown as Turn order is an order, as Table or Roster records, and as Checklist a list; Links is links.

Every tracker and template is held to these limits:

Set min or max only when the creator gave that limit.

  • Trackers in a game at once: 10, not counting the time. A full current state starts no other tracker until one ends.
  • A tracker's name: 60 characters.
  • A field's label: 40 characters.
  • A text field, a list item or its note: 160 characters.
  • Fields in a tracker: 1 to 8.
  • Items in a list: 16.
  • People in a turn order: 20.
  • Records in a records field: 12.
  • Pairs in a links field: 12.
  • Fields in one record or link: 4.
  • Live values shown beside each person: 6.
  • Kinds of file a list's entries are: 6.
  • A file type or sheet field a column is read from: 80 characters.
  • Drawn as marks: a count with a range of 10 or less, unless the world picks a look.
  • Most dots drawn: 20; a count with more shows as a bar.
  • A tug of war: at most 21 steps from end to end.
  • A template's key: 60 characters, lowercase letters, digits and hyphens.
  • What updates it (when): 300 characters.
  • What starts it (trigger): 200 characters.
  • A scene check question (watch.question): 400 characters.
  • A scene check answer or reminder (watch.yes, no, remind): 600 characters.
  • A clock's segments: 2 to 12.

Numbers

count

A number: a pool, a tally, days left. The screen draws it as marks, a bar or the number, picked from its range unless the world picks one with display (the world's alone, kept by code across the GM's changes).

Key Type Required What it is
kind "count" yes
label string The field's name on the card.
hidden boolean The GM's alone: the party never sees this field, item or entry.
value number yes The number now.
min number The lowest it can go; unset has no floor.
max number The highest it can go (a clock's segments); unset has no ceiling.
tone "good" | "bad" A count's colour: good fills green, bad red, unset a neutral blue.
at Record<string, string> Thresholds: the value a key names, and what happens when the count reaches it ({"6": "Crossbowmen at the gate"}).
display "number" | "bar" | "pips" How a world shows a count, when it says (display): the number, a bar, or pips to count.

Limits: a label of up to 40 characters. It can also be one of a record's or a link's fields.

{ "kind": "count", "label": "Supplies", "value": 6, "min": 0, "max": 10, "tone": "good" }

With no max it shows as a number. With a range of 10 or less it shows as marks (boxes when its tone is bad), and anything bigger as a bar, unless display says "number", "bar" or "pips". A bar or dots need a max.

clock

Pressure filling toward trouble, 0 to max segments.

Key Type Required What it is
kind "clock" yes
label string The field's name on the card.
hidden boolean The GM's alone: the party never sees this field, item or entry.
value number yes The number now.
min number The lowest it can go; unset has no floor.
max number The highest it can go (a clock's segments); unset has no ceiling.
tone "good" | "bad" A count's colour: good fills green, bad red, unset a neutral blue.
at Record<string, string> Thresholds: the value a key names, and what happens when the count reaches it ({"6": "Crossbowmen at the gate"}).

Limits: a label of up to 40 characters; 2 to 12 segments (max), counted from 0. It can also be one of a record's or a link's fields.

{ "kind": "clock", "label": "Alarm", "value": 0, "min": 0, "max": 6, "tone": "bad", "at": { "6": "The guards are alerted" } }

For pressure building toward one event. A plain number that only counts is a count.

scale

A tug of war between two outcomes: min to max, ends naming them low first ("Caught", "Away").

Key Type Required What it is
kind "scale" yes
label string The field's name on the card.
hidden boolean The GM's alone: the party never sees this field, item or entry.
value number yes The number now.
min number The lowest it can go; unset has no floor.
max number The highest it can go (a clock's segments); unset has no ceiling.
tone "good" | "bad" A count's colour: good fills green, bad red, unset a neutral blue.
at Record<string, string> Thresholds: the value a key names, and what happens when the count reaches it ({"6": "Crossbowmen at the gate"}).
ends [string, string] The two ends' names, low end first ("Caught", "Away").

Limits: a label of up to 40 characters; min below max, at most 21 steps from end to end. It can also be one of a record's or a link's fields.

{ "kind": "scale", "value": 0, "min": -3, "max": 3, "ends": ["Caught", "Away"] }

For a contest pulled either way: a chase, a negotiation, a tug of loyalty.

Words and lists

text

A fact that changes, in a few words: the weather, the next obstacle.

Key Type Required What it is
kind "text" yes
label string The field's name on the card.
hidden boolean The GM's alone: the party never sees this field, item or entry.
text string yes The words now.

Limits: a label of up to 40 characters; 160 characters. It can also be one of a record's or a link's fields.

{ "kind": "text", "label": "Weather", "text": "Clear skies" }

Craft's Time is one text field the GM moves as the story takes time.

list

Steps or items that are open, done or failed: objectives, a plan, clues found.

Key Type Required What it is
kind "list" yes
label string The field's name on the card.
hidden boolean The GM's alone: the party never sees this field, item or entry.
items ({ text, state, note?, ref?, hidden? })[] yes Each item's words, its state (open, done or failed), an optional note and who it is about.

Limits: a label of up to 40 characters; 16 items, each up to 160 characters. It can also be one of a record's or a link's fields.

{ "kind": "list", "label": "Clues", "items": [{ "text": "The ledger is forged", "state": "open" }] }

Each item's state is "open", "done" or "failed". A template usually starts it empty: the GM adds items as the story gives them. In a tracker that outlasts the place, a full list lets its oldest finished item go when the GM adds one.

People and things

order

Who acts in turn: a fight's turn order.

Key Type Required What it is
kind "order" yes
label string The field's name on the card.
hidden boolean The GM's alone: the party never sees this field, item or entry.
entries ({ name, score? })[] yes Who is in the order, highest score first, by the names the current state has.
current string Whose turn it is, by name; unset before the first turn.
round number The round, from 1.
show string[] The live values shown beside each person a field names (a turn order's fighters, the people records are about): the current state's stat labels and "where".
types string[] The kinds of file its entries are (file type slugs): names find files of these kinds first, and the editor offers their fields as columns.
sources Record<string, Record<string, { value, max? }>> Per label in show, per file type slug: where the world says each column comes from ({"HP": {"character": {...}, "creature": {...}}}).

Limits: a label of up to 40 characters; 20 people; 6 live values in show. It can't be one of a record's or a link's fields.

{ "kind": "order", "entries": [], "round": 1, "show": ["HP", "Conditions"] }

A game runs one turn order at a time. Nobody joins it by hand: the GM adds fighters from the story, each with their score (initiative) when the game rolls for the order. Start it empty in a template.

ref

One file or person the tracker points at: the current lead, who holds the key.

Key Type Required What it is
kind "ref" yes
label string The field's name on the card.
hidden boolean The GM's alone: the party never sees this field, item or entry.
ref { name, file? } yes A file or person a tracker points at, by the name the GM says.
show string[] The live values shown beside each person a field names (a turn order's fighters, the people records are about): the current state's stat labels and "where".

Limits: a label of up to 40 characters; 6 live values in show. It can't be one of a record's or a link's fields.

{ "kind": "ref", "label": "Current lead", "ref": { "name": "Brother Aldo" } }

For one person or thing the story points at now. For many, use records.

records

One record per person or file, each with fields of its own: suspects, standing with factions.

Key Type Required What it is
kind "records" yes
label string The field's name on the card.
hidden boolean The GM's alone: the party never sees this field, item or entry.
entries ({ ref, hidden?, fields })[] yes One record per person or file: who it is about (ref) and its own fields.
show string[] The live values shown beside each person a field names (a turn order's fighters, the people records are about): the current state's stat labels and "where".
types string[] The kinds of file its entries are (file type slugs): names find files of these kinds first, and the editor offers their fields as columns.
sources Record<string, Record<string, { value, max? }>> Per label in show, per file type slug: where the world says each column comes from ({"HP": {"character": {...}, "creature": {...}}}).
display "table" | "roster" How it shows: rows with every column (unset or "table") or a roster of pictures.
each field[] The fields a new record starts with (each faction's Standing at 0).

Limits: a label of up to 40 characters; 12 records, each with up to 4 fields; 6 live values in show; 6 kinds of file in types. It can't be one of a record's or a link's fields.

{ "kind": "records", "entries": [], "each": [{ "kind": "scale", "label": "Standing", "value": 0, "min": -3, "max": 3, "ends": ["Enemies", "Allies"] }] }

A row per suspect, faction or companion, each with its own fields. With "display": "roster" it shows as a roster of pictures, each ringed by the first stat it shows (HP) with its numbers under the name, like Craft's Party. A record's fields can be count, clock, scale, list or text, never another list of people.

One entry per pair of people, places or files, with fields between the two: bonds and rivalries, how factions stand with each other, debts, routes between places. A world that means a direction says it in a field's label ("Mira's trust in Kael").

Key Type Required What it is
kind "links" yes
label string The field's name on the card.
hidden boolean The GM's alone: the party never sees this field, item or entry.
entries ({ between, hidden?, fields })[] yes One per pair: the two it links (between) and the fields between them.
types string[] The kinds of file either end of a link is (faction), as records' types.
each field[] The fields a new link starts with (Bond at 0), as records' each.

Limits: a label of up to 40 characters; 12 pairs, each with up to 4 fields; 6 kinds of file in types. It can't be one of a record's or a link's fields.

{ "kind": "links", "label": "Bonds", "entries": [], "each": [{ "kind": "count", "label": "Bond", "value": 0, "min": 0, "max": 5 }] }

A pair is the same pair either way round. When a direction matters, say it in a field's label ("Mira's trust in Kael"). Players can change a link's values or take a pair out, never add one: the GM links them from the story.