Reference

Nations

A nation: a country players can come from, venues can be in and the World Cup can field. Nations are matched by code; a later record for a code (load order) changes the fields it gives. See Nations.

Content type
nations
Files
data/nations.json, data/nations/
Shape
A list of records, each with its own id
Patch target
nation:<id>, for example nation:core.nation.pol
In the base game
65 records
Guide
Nations

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.

FieldTypeRequiredDefaultNotes
ididYesNamespaced id, e.g. "core.player.rory-calder"
codenation codeYesThe 3-letter code players, venues and events use (e.g. "ENG", "NED").
nametext, up to 60 charactersYesThe country's name, e.g. "Netherlands" (translatable with a locale patch).
demonymtext, up to 40 charactersThe people's adjective, e.g. "Dutch": the welcome letter, the feed's home crowd ("the Dutch crowd") and the new-career summary use it; without one they keep their plain wording.
inSentencetext, up to 70 characters
flagfile pathAn image of the flag (a path in the mod, e.g. "assets/flags/xyz.svg"; 3:2 works best). Without one, the game's own flag for the code is drawn, or a plain tile with the code for a country it doesn't know.
marketnumber, 0 to 5Sponsors pay this much more (or less) for a player from here: 1.2 = +20% (default 0.9).
regiontext, up to 40 charactersHome region: players from nations in the same region count as local to each other's venues (travel prices, the crowd, local qualifiers). The core's "uk" is England, Scotland, Wales and Northern Ireland. Pattern: ^[a-zA-Z][a-zA-Z0-9-]*$
circuittext, up to 40 charactersExhibition circuit: bookers pick local pros and cheap trips within it. The core's "homeIsles" is the UK and Ireland. Pattern: ^[a-zA-Z][a-zA-Z0-9-]*$
facesmap (key: value)How often each face-library region is picked for this nation's players (relative weights, e.g. { "northwest-europe": 80, "african": 10 }). Default: England's mix.
avatarone of the optionsPalette for illustrated avatars (default: an even mix). Options: england, celtic, nordic, central, south, newworld, eastasia, seasia.
areatext, up to 40 charactersTravel load: the area (a short hop), the continent and the time zone (hours ahead of UTC). The load settings' areas, continents and timeZones (data/load.json) win over these. Pattern: ^[a-zA-Z][a-zA-Z0-9-]*$
continenttext, up to 40 charactersPattern: ^[a-zA-Z][a-zA-Z0-9-]*$
timeZonenumber, -12 to 14
regionslist, 1 to 60 items
regions[].idtext, up to 40 charactersYesPattern: ^[a-zA-Z][a-zA-Z0-9-]*$
regions[].nametext, up to 60 charactersYes
regions[].nearlist, up to 60 items
regions[].remotetrue or false
regions[].centrelist
popularitynumber, 0 to 100
depthnumber, 0 to 100
floornumber, 0 to 100
citieslist, 1 to 60 items

Example#

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

{
  "id": "core.nation.pol",
  "code": "POL",
  "popularity": 50,
  "floor": 28,
  "cities": [
    "Warsaw",
    "Kraków",
    "Łódź",
    /* … 5 more */
  ],
  "name": "Poland",
  "demonym": "Polish",
  "market": 0.9,
  "faces": {
    "eastern-europe": 92,
    "northwest-europe": 8
  },
  "avatar": "central",
  "area": "central",
  "continent": "europe",
  "regions": [
    {
      "id": "pomerania",
      "name": "Pomerania",
      "near": [
        "greater-poland",
        "masovia"
      ],
      "centre": [
        54.35,
        18.65
      ]
    },
    {
      "id": "greater-poland",
      "name": "Greater Poland",
      "near": [
        "pomerania",
        "lower-silesia",
        /* … 1 more */
      ],
      "centre": [
        52.41,
        16.93
      ]
    },
    {
      "id": "masovia",
      "name": "Masovia",
      "near": [
        "pomerania",
        "central",
        /* … 1 more */
      ],
      "centre": [
        52.23,
        21.01
      ]
    },
    /* … 4 more */
  ]
}

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.