Reference

Travel fare settings

Travel fares by distance: what getting to an event and back costs, by how far the venue is from where the player lives. A journey's step is found in this order: inside the country lived in, an exact pair, the first group that holds both countries, the rule for their two continents, the same continent, anywhere else. Every field is optional; records apply in load order, later fields winning. See Travel fares.

Content type: travel
Files: data/travel.json
Shape: One settings object (a file may hold the object itself)
Patch target: travel:<id>, for example travel:core.travel
In the base game: 1 record
Guide: The organisations of the darts world, Travel fares

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"
`steps`	list, up to 40 items			The steps of distance, nearest first: how you travel, the fare there and back, a night away, and what a move of house over that distance counts as.
`steps[].id`	text, up to 40 characters	Yes		Pattern: `^[a-z0-9][a-z0-9-]*$`
`steps[].mode`	text, up to 24 characters	Yes		How you travel: road, rail, ferry or flight, or a pack's own (the Finances page words the fare by the text home.finances.trip.<mode>) Pattern: `^[a-z0-9][a-z0-9-]*$`
`steps[].fare`	whole number, 0 to 100,000,000	Yes		There and back
`steps[].perDay`	whole number, 0 to 100,000,000	Yes		Each night away (the hotel and meals)
`steps[].move`	one of the options	Yes		What a move of house over this distance counts as, for the arrival costs of the housing market moved to Options: `country`, `region`, `abroad`.
`sameCountry`	object			A venue in the country you live in: one of `smallKinds` (venue kinds) is the step `small`, any other `other`.
`sameCountry.small`	text, up to 40 characters			Pattern: `^[a-z0-9][a-z0-9-]*$`
`sameCountry.other`	text, up to 40 characters			Pattern: `^[a-z0-9][a-z0-9-]*$`
`sameCountry.smallKinds`	list, up to 20 items
`sameCountry.far`	text, up to 40 characters			Pattern: `^[a-z0-9][a-z0-9-]*$`
`sameCountry.remote`	text, up to 40 characters			Pattern: `^[a-z0-9][a-z0-9-]*$`
`sameCountry.nearSmall`	text, up to 40 characters			Pattern: `^[a-z0-9][a-z0-9-]*$`
`sameCountry.bands`	list, up to 20 items
`sameCountry.bands[].upTo`	number, 0 to 40,000	Yes
`sameCountry.bands[].step`	text, up to 40 characters	Yes		Pattern: `^[a-z0-9][a-z0-9-]*$`
`pairs`	list, up to 2000 items			The step between two countries, either way, whatever the groups say.
`pairs[].from`	nation code	Yes		3-letter nationality code
`pairs[].to`	nation code	Yes		3-letter nationality code
`pairs[].step`	text, up to 40 characters	Yes		Pattern: `^[a-z0-9][a-z0-9-]*$`
`groups`	list, up to 200 items			Countries one step apart from each other. Checked in order: put the nearer step's groups first. A record that gives groups replaces the whole list.
`groups[].step`	text, up to 40 characters	Yes		Pattern: `^[a-z0-9][a-z0-9-]*$`
`groups[].nations`	list, 2 to 120 items	Yes
`homeGroups`	list, up to 50 items
`homeGroups[]`	list, up to 200 items	Yes
`continents`	list, up to 200 items			The step between two continents, either way.
`continents[].between`	list	Yes
`continents[].step`	text, up to 40 characters	Yes		Pattern: `^[a-z0-9][a-z0-9-]*$`
`sameContinent`	text, up to 40 characters			The step between two countries on one continent that no pair, group or continent rule names. Pattern: `^[a-z0-9][a-z0-9-]*$`
`otherwise`	text, up to 40 characters			The step of every other journey. Pattern: `^[a-z0-9][a-z0-9-]*$`
`from`	list, up to 200 items			A step's own figures for journeys that start in the countries named.
`from[].nations`	list, 1 to 120 items	Yes
`from[].steps`	list, 1 to 40 items	Yes
`from[].steps[].step`	text, up to 40 characters	Yes		Pattern: `^[a-z0-9][a-z0-9-]*$`
`from[].steps[].mode`	text, up to 24 characters			Pattern: `^[a-z0-9][a-z0-9-]*$`
`from[].steps[].fare`	whole number, 0 to 100,000,000
`from[].steps[].perDay`	whole number, 0 to 100,000,000
`moveFares`	number, 0 to 100			The fare of a move of house is the journey's fare times this
`visas`	object			Visas for playing and living abroad. Only the human player needs them: the computer's players travel as before.
`visas.tripFree`	list, up to 50 items		`[]`	Groups of countries (by code) whose nationals need no visa for a short trip to each other.
`visas.tripFree[]`	list, up to 200 items	Yes
`visas.liveFree`	list, up to 50 items		`[]`	Groups whose nationals may live in each other's countries without a residence permit.
`visas.liveFree[]`	list, up to 200 items	Yes
`visas.trip`	object	Yes		A trip visa to play in a country: fee, weeks to issue, weeks it lasts.
`visas.trip.fee`	number, 0 to 100,000	Yes		What it costs.
`visas.trip.weeks`	whole number, 0 to 104	Yes		Weeks to issue.
`visas.trip.validWeeks`	whole number, 1 to 520		`26`	A trip visa: weeks it lasts once issued.
`visas.residence`	object	Yes		A residence permit to move to a country: fee and weeks to issue.
`visas.residence.fee`	number, 0 to 100,000	Yes		What it costs.
`visas.residence.weeks`	whole number, 0 to 104	Yes		Weeks to issue.
`visas.residence.validWeeks`	whole number, 1 to 520		`26`	A trip visa: weeks it lasts once issued.
`visas.overrides`	list, up to 200 items		`[]`	A country's own terms, by the countries in `to`.
`visas.overrides[].to`	list, 1 to 200 items	Yes		The countries (by code) these terms are for.
`visas.overrides[].trip`	object
`visas.overrides[].trip.fee`	number, 0 to 100,000	Yes		What it costs.
`visas.overrides[].trip.weeks`	whole number, 0 to 104	Yes		Weeks to issue.
`visas.overrides[].trip.validWeeks`	whole number, 1 to 520		`26`	A trip visa: weeks it lasts once issued.
`visas.overrides[].residence`	object
`visas.overrides[].residence.fee`	number, 0 to 100,000	Yes		What it costs.
`visas.overrides[].residence.weeks`	whole number, 0 to 104	Yes		Weeks to issue.
`visas.overrides[].residence.validWeeks`	whole number, 1 to 520		`26`	A trip visa: weeks it lasts once issued.
`visas.delayChance`	number, 0 to 1		`0`	The chance a visa is late.
`visas.delayWeeks`	pair [whole number, 0 to 52, whole number, 0 to 52]		`[1, 4]`	How late, in weeks: [min, max].
`visas.tourCardWeeks`	whole number, 0 to 52		`0`	Weeks off the wait with a Tour Card.
`visas.agentWeeks`	whole number, 0 to 52		`0`	Weeks off the wait with a registered agent.
`appeal`	object
`appeal.times`	map (key: value)	Yes
`appeal.power`	number, 0 to 10	Yes
`appeal.floor`	number, 0 to 1	Yes
`appeal.never`	number, 0 to 1	Yes		Under this appeal a player does not come at all: an open event far from anyone plays with the field it has
`appeal.autoplay`	number, 0 to 1	Yes		The computer-played career does not enter an event abroad whose appeal is under this

Example#

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

{
  "id": "core.travel",
  "steps": [
    {
      "id": "local",
      "mode": "road",
      "fare": 15,
      "perDay": 45,
      "move": "country"
    },
    {
      "id": "country",
      "mode": "rail",
      "fare": 60,
      "perDay": 45,
      "move": "country"
    },
    {
      "id": "neighbour",
      "mode": "rail",
      "fare": 75,
      "perDay": 45,
      "move": "region"
    },
    /* … 9 more */
  ],
  "sameCountry": {
    "small": "local",
    "other": "country",
    "smallKinds": [
      "pub",
      "club"
    ],
    "far": "far",
    "remote": "remote",
    "nearSmall": "local",
    "bands": [
      {
        "upTo": 600,
        "step": "country"
      },
      {
        "upTo": 1500,
        "step": "far"
      },
      /* … 2 more */
    ]
  },
  "groups": [
    {
      "step": "neighbour",
      "nations": [
        "ENG",
        "SCO",
        /* … 1 more */
      ]
    },
    {
      "step": "neighbour",
      "nations": [
        "NIR",
        "IRL"
      ]
    },
    {
      "step": "neighbour",
      "nations": [
        "NED",
        "BEL",
        /* … 8 more */
      ]
    },
    /* … 4 more */
  ],
  "homeGroups": [
    [
      "ENG",
      "SCO",
      /* … 3 more */
    ]
  ],
  "continents": [
    {
      "between": [
        "europe",
        "oceania"
      ],
      "step": "far-haul"
    }
  ],
  "sameContinent": "continent",
  "otherwise": "long-haul",
  "from": [
    {
      "nations": [
        "USA",
        "CAN",
        /* … 1 more */
      ],
      "steps": [
        {
          "step": "country",
          "mode": "road",
          "fare": 120,
          "perDay": 60
        },
        {
          "step": "far",
          "mode": "flight",
          "fare": 300,
          "perDay": 110
        },
        /* … 3 more */
      ]
    }
  ],
  "moveFares": 2,
  "appeal": {
    "times": {
      "1": 40,
      "2": 20,
      "3": 8,
      "4": 4,
      "5": 3
    },
    "power": 1,
    "floor": 0.02,
    "never": 0.05,
    "autoplay": 0.5
  },
  "visas": {
    "tripFree": [
      [
        "ENG",
        "SCO",
        /* … 33 more */
      ],
      [
        "AUS",
        "NZL"
      ],
      /* … 1 more */
    ],
    "liveFree": [
      [
        "ENG",
        "SCO",
        /* … 4 more */
      ],
      [
        "IRL",
        "NED",
        /* … 28 more */
      ],
      /* … 1 more */
    ],
    "trip": {
      "fee": 90,
      "weeks": 3,
      "validWeeks": 26
    },
    "residence": {
      "fee": 900,
      "weeks": 10
    },
    "overrides": [
      {
        "to": [
          "AUS",
          "NZL"
        ],
        "trip": {
          "fee": 30,
          "weeks": 1,
          "validWeeks": 52
        },
        "residence": {
          "fee": 1500,
          "weeks": 16
        }
      },
      {
        "to": [
          "USA",
          "CAN"
        ],
        "trip": {
          "fee": 150,
          "weeks": 6,
          "validWeeks": 52
        },
        "residence": {
          "fee": 2000,
          "weeks": 20
        }
      },
      /* … 1 more */
    ],
    "delayChance": 0.1,
    "delayWeeks": [
      1,
      4
    ],
    "tourCardWeeks": 1,
    "agentWeeks": 1
  }
}

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