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:
labelnames the field on the card. With more than one field, each needs a different one.hidden: truekeeps a field, an item, a record or a link from the players until the GM reveals it.- Numbers (
count,clock,scale) taketone("good"fills green,"bad"red) andat, 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 leavefileto the game. shownames 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.eachis 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.
links
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.