Reference

Scenarios

Content type: scenarios
Files: data/scenarios.json, data/scenarios/
Shape: A list of records, each with its own id
Patch target: scenario:<id>, for example scenario:core.scenario.champions-slide
In the base game: 3 records
Guide: Scenario starts

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"
`name`	text, up to 40 characters	Yes
`pitch`	text, up to 140 characters	Yes
`story`	text, up to 900 characters		`""`
`difficulty`	one of the options		`"medium"`	Options: `easy`, `medium`, `hard`.
`order`	whole number, 0 to 10,000		`100`
`facts`	list, up to 2 items		`[]`
`facts[].label`	text, up to 24 characters	Yes
`facts[].value`	text, up to 80 characters	Yes
`choices`	object		see example
`choices.gender`	true or false		`true`
`choices.nationality`	true or false		`true`
`choices.hand`	true or false		`true`
`choices.style`	true or false		`true`
`player`	object	Yes
`player.age`	whole number, 10 to 50	Yes
`player.gender`	one of the options			Options: `m`, `f`.
`player.nationality`	nation code			3-letter nationality code
`player.level`	number, 20 to 99
`player.potential`	number, 20 to 100
`player.tier`	whole number, 1 to 5
`player.tourCardSeasons`	whole number, 0 to 5
`player.oomRank`	whole number, 1 to 1000
`player.cash`	number, 0 to 50,000,000
`player.followers`	whole number, 0 to 50,000,000
`player.reputation`	number, 0 to 100
`player.difficulty`	one of the options			Options: `easy`, `normal`, `hard`.
`goal`	object
`goal.kind`	one of the options	Yes		Options: `tourCard`, `oomRank`, `winEvent`.
`goal.title`	text, up to 80 characters	Yes
`goal.text`	text, up to 200 characters		`""`
`goal.seasons`	whole number, 1 to 30	Yes
`goal.forSeason`	whole number, 0 to 10		`0`
`goal.graceMonths`	whole number, 0 to 11		`0`
`goal.top`	whole number, 1 to 1000
`goal.tier`	whole number, 1 to 5
`goal.major`	true or false		`false`

Example#

A record from the base game’s data/scenarios.json, shortened.

{
  "id": "core.scenario.champions-slide",
  "name": "The Champion's Slide",
  "pitch": "Two world titles, and now the ranking only goes one way.",
  "story": "You were the best in the world twice. Now you are thirty-seven, the averages are slipping and the young players are not afraid of you any more. The money is there and so is the name. What is left is t…",
  "difficulty": "medium",
  "order": 30,
  "facts": [
    {
      "label": "History",
      "value": "Two world titles, the last six years ago"
    }
  ],
  "player": {
    "age": 37,
    "level": 87,
    "potential": 88,
    "tier": 1,
    "tourCardSeasons": 2,
    "oomRank": 11,
    "cash": 1200000,
    "followers": 400000,
    "reputation": 80
  },
  "goal": {
    "kind": "oomRank",
    "title": "Finish a season back in the world's top 16",
    "text": "Judged on the Order of Merit at the end of each of the next three seasons.",
    "seasons": 3,
    "top": 16
  }
}

In your pack the record’s id starts with your pack’s id instead of core, unless you mean to replace this one.

Written for Darts Player Simulator 0.50.32. Built from the game's own schemas and its base pack.