Reference
Tours
- Content type
tours- Files
data/tours.json,data/tours/- Shape
- A list of records, each with its own
id - Patch target
tour:<id>, for exampletour:core.tour.continental- In the base game
- 107 records
- Guide
- Scenes: a country's own darts, Tours and the Tour Card
Fields#
Indented fields belong to the field above them. [] marks the items of a list. A field that is not required may be left out; the default is used.
| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
id | id | Yes | Namespaced id, e.g. "core.player.rory-calder" | |
tier | whole number, 1 to 5 | Yes | 1 = World Series … 5 = County & Open Circuit | |
name | text | Yes | ||
shortName | text, up to 16 characters | Yes | ||
tierLabel | text, up to 20 characters | What a player at this tier is called on badges (e.g. "Pro Tour"). Defaults to the game's labels. | ||
colour | colour, #rrggbb | Yes | ||
logo | file path | A file in your pack: see Images, sound and models. | ||
broadcast | id | Namespaced id, e.g. "core.player.rory-calder" | ||
badge | true or false | Set to false for a grouping of events rather than a tour of its own (the Elite Series): its events carry no tour badge on the calendar, the event pages, the lobby or the cards. Shown when left out. | ||
press | true or false | |||
description | text | |||
board | one of the options | steel or soft: the boards the tour's events are played on, unless an event says otherwise. Steel when left out. Options: steel, soft. | ||
role | one of the options | Options: pro, feeder, junior, veterans. | ||
organisation | id | Namespaced id, e.g. "core.player.rory-calder" | ||
rung | object | |||
rung.scene | id | Yes | Namespaced id, e.g. "core.player.rory-calder" | |
rung.role | one of the options | Yes | Options: local, youth, ranking, development, national. | |
rung.entry | one of the options | "residents" | Options: residents, open. | |
rung.of | list, 1 to 64 items | |||
rung.locals | true or false | |||
rung.stagedForOf | true or false | |||
rules | object | Yes | ||
rules.requiresTourCard | true or false | false | ||
rules.closedToTourCard | true or false | false | ||
rules.openToTourCard | true or false | false | ||
rules.closedToOomTop | whole number, 1 to 9999 | |||
rules.cardsAwarded | whole number, at least 0 | 0 | Tour Cards handed out from this tour's Order of Merit each season. | |
rules.cardYears | whole number, 1 to 4 | 2 | Years a Tour Card lasts once earned. | |
rules.orderOfMerit | one of the options | "season" | Options: rolling2y, season, none. | |
rules.minAge | whole number, 0 to 99 | |||
rules.countsTowards | id | Namespaced id, e.g. "core.player.rory-calder" | ||
rules.phases | list, 1 to 11 items | |||
rules.cards | list, 1 to 8 items | |||
rules.cards[].key | text | Yes | Pattern: ^[a-z0-9-]+$ | |
rules.cards[].name | text, up to 80 characters | Yes | ||
rules.cards[].top | whole number, 1 to 64 | Yes | ||
rules.cards[].months | whole number, 1 to 36 | 12 | ||
rules.cards[].into | id | Yes | Namespaced id, e.g. "core.player.rory-calder" | |
rules.cards[].benefit | one of the options | "place" | Options: place, seed. | |
rules.cards[].free | true or false | false | ||
rules.replyToInvitations | true or false | false | ||
rules.preQualifiedLossUncredited | true or false | false | ||
rules.rollingList | object | |||
rules.rollingList.name | text, up to 80 characters | Yes | ||
rules.rollingList.shortName | text, up to 40 characters | |||
rules.rollingList.adds | list, up to 16 items | |||
rules.rollingList.windowDays | whole number, 28 to 1461 | 365 | ||
rules.rollingList.seeds | true or false | false | ||
rules.rollingList.meritCut | true or false | false |
Example#
A record from the base game’s data/tours.json, shortened.
{
"id": "core.tour.continental",
"broadcast": "core.broadcast.continental",
"organisation": "core.org.dso",
"tier": 1,
"name": "Continental Series",
"shortName": "Continental",
"colour": "#2f6fd6",
"logo": "assets/tours/core.tour.continental.webp",
"description": "Ranked three-day events in cities across the continent, live on TV: 48 players, the Order of Merit's top 16 straight into round two. The money counts on the Order of Merit, and the season's own table …",
"rules": {
"requiresTourCard": true,
"cardsAwarded": 0,
"cardYears": 2,
"orderOfMerit": "season",
"minAge": 16,
"preQualifiedLossUncredited": true
}
}In your pack the record’s id starts with your pack’s id instead of core, unless you mean to replace this one.