Reference

Kit items

Content type: equipment
Files: data/equipment.json, data/equipment/
Shape: A list of records, each with its own id
Patch target: equipment:<id>, for example equipment:core.equipment.sovereign-regent-22
In the base game: 154 records
Guide: Equipment, kit and signature development

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"
`kind`	text	Yes		The slot it fills: a kitSlots id (core: darts, points, flights, stems, grip, shirt, footwear, eyewear, charm, board, tech, case). Names a kit slot record. Pattern: `^[a-z][a-z0-9-]*$`
`name`	text	Yes
`brandId`	id			Sponsor id of the brand, if it's a sponsor's product. Names a sponsor record.
`price`	whole number, at least 0	Yes
`tier`	one of the options			Shop tier, for display (worked out from the price when left out). Options: `budget`, `club`, `pro`, `elite`, `signature`.
`description`	text, up to 300 characters			A line of shop copy.
`stats`	object		`{}`
`stats.weight`	number, 10 to 40
`stats.grip`	number, 0 to 1
`stats.length`	number, 15 to 60			mm: a barrel's, a point's, a stem's, or an integrated flight's moulded shaft.
`stats.profile`	one of the options			Options: `straight`, `torpedo`, `bomb`, `scallop`.
`stats.shape`	one of the options			Flights: their shape sets the setup's balance. Options: `standard`, `slim`, `kite`, `pear`, `fantail`, `vortex`.
`stats.material`	text, up to 24 characters			Stems, points, footwear…: what it's made of (free text, used by rules).
`stats.texture`	one of the options			Points: surface. Options: `smooth`, `grooved`, `knurled`, `diamond`.
`stats.system`	one of the options			Darts and points: fixed or movable points (they must match). Options: `fixed`, `movable`.
`stats.spin`	true or false			Stems: spinning tops.
`stats.integrated`	true or false			Flights: an integrated flight, moulded in one piece with its shaft (its `length`). It screws straight into the barrel and takes the place of a stem: the core rules take any stem off while it is fitted.
`stats.finish`	text, up to 24 characters			Finish or colour name, for display (and rules).
`effects`	object		`{}`	What it does at full familiarity (see KitStats).
`effects.scoring`	number, -100 to 100			% tighter on trebles and singles.
`effects.doubles`	number, -100 to 100			% tighter on doubles and the bull.
`effects.consistency`	number, -100 to 100			% steadier day-to-day form and fewer cold streaks.
`effects.bounce`	number, -100 to 100			% fewer bounce-outs.
`effects.stamina`	number, -100 to 100			% slower fatigue build-up in a match.
`effects.grip`	number, -100 to 100			% less loosening from fatigue and sweaty hands (doubled under TV lights).
`effects.eyesight`	number, -100 to 100			Eyesight points on the oche (up to the ceiling in kitSettings).
`effects.composure`	number, -100 to 100			Composure points on the oche.
`effects.training`	number, -100 to 100			% more training gains.
`effects.practice`	number, -100 to 100			% faster familiarity with new kit.
`effects.insight`	number, 0 to 1			0–1: reads fit like a (weaker) kit technician.
`effects.travel`	number, -100 to 100			% lighter travel load.
`effects.protect`	number, -100 to 100			% less chance of kit damage or loss on the road.
`effects.followers`	number, -100 to 100			% more follower growth from events.
`availability`	object			Who can buy it. Leave out for anyone.
`availability.tierMax`	whole number, 1 to 5			Only players at this tier or better (1 = World Series).
`availability.reputationMin`	number, 0 to 100			Reputation (0–100) at least this.
`availability.followersMin`	whole number, at least 0
`availability.sponsorOnly`	true or false			Never in the shop: the brand's sponsored players are sent it.
`availability.limited`	true or false			A limited edition: in the shop only for a few weeks when it drops, once a career.
`availability.signature`	true or false			A signature blank: never sold. Its art and finish are what your own signature item looks like when you choose this finish in the workshop.
`life`	whole number, 1 to 520			Weeks of use before it's worn out (the slot's `wear.weeks` when left out).
`look`	object			How it looks, so renders match the item's picture: flights' print colours and pattern, a stem's or point's colour, a barrel's coating.
`look.primary`	colour, `#rrggbb`	Yes		Main colour, "#rrggbb".
`look.secondary`	colour, `#rrggbb`			Second colour (a flight's print, a stem's top).
`look.pattern`	one of the options			Flights: how the two colours are laid out. Options: `solid`, `stripe`, `chevron`, `sash`, `target`, `split`, `ring`.
`look.metal`	true or false			Bare metal (steel, aluminium, tungsten) rather than a coating or plastic.
`look.model`	text
`design`	object			Shirts: a design the shirt renderer draws (shown instead of `asset`, which stays the fallback). See Equipment, kit and signature development.
`design.base`	colour, `#rrggbb`	Yes		Body colour.
`design.trim`	colour, `#rrggbb`	Yes		Trim: the default for collar, cuffs, pattern, side panels and piping.
`design.sleeve`	colour, `#rrggbb`			Sleeve colour (default: the body).
`design.pattern`	text, up to 80 characters			A shirtPatterns id (or one of its aliases). Default: plain. Names a shirt pattern record.
`design.patternColour`	colour, `#rrggbb`			Pattern colour (default: the trim).
`design.patternOpacity`	number, 0 to 1			Pattern strength 0–1 (default: the pattern's own).
`design.patternScale`	number, 0.5 to 2			Pattern size multiplier.
`design.patternSleeves`	true or false			Pattern on the sleeves too (default: the pattern's own choice).
`design.collar`	text, up to 40 characters			A designer collar id (core: crew, polo, button, vneck); it picks the cut. Default: the first. Names a kit setting record.
`design.collarColour`	colour, `#rrggbb`
`design.cuffColour`	colour, `#rrggbb`
`design.sidePanels`	true or false			Side panels and piping in the trim colour.
`design.piping`	true or false
`design.crest`	true or false			A crest on the chest (default off), with up to 3 letters in it.
`design.crestText`	text, up to 3 characters
`design.autograph`	text, up to 32 characters			A signature embroidered on the chest (a signature-range shirt: the player's name).
`design.mesh`	true or false			Cooling mesh side panels (drawn as a fine perforated mesh).
`design.font`	text, up to 40 characters			A designer font id for the lettering (default: the first). Names a kit setting record.
`design.backName`	text, up to 14 characters			Lettering across the back.
`design.number`	text			Up to two digits on the back. Pattern: `^\d{0,2}$`
`dartDesign`	object			Darts: the full design the 3D renders draw (signature darts carry one).
`dartDesign.profile`	one of the options	Yes		Options: `straight`, `torpedo`, `bomb`, `scallop`, `front`, `pencil`.
`dartDesign.tungsten`	number, 80 to 97	Yes		Tungsten content, %: more is slimmer for the weight, and dearer.
`dartDesign.cut`	one of the options	Yes		Options: `ring`, `micro`, `shark`, `knurl`, `pixel`.
`dartDesign.zones`	one of the options	Yes		Options: `full`, `front`, `centre`, `rear`, `split`.
`dartDesign.finish`	one of the options	Yes		Options: `tungsten`, `black`, `gold`, `pvd`, `twotone`.
`dartDesign.colour`	text	Yes		The coating's colour (PVD; two-tone's front half). Pattern: `^#[0-9a-fA-F]{6}$`
`dartDesign.colour2`	text	Yes		Two-tone's back half. Pattern: `^#[0-9a-fA-F]{6}$`
`dartDesign.bands`	list, up to 3 items	Yes		Accent rings: where along the barrel (0 front … 1 back) and their colour.
`dartDesign.bands[].at`	number, 0 to 1	Yes
`dartDesign.bands[].colour`	text	Yes		Pattern: `^#[0-9a-fA-F]{6}$`
`dartDesign.engraving`	text, up to 14 characters	Yes		Engraved along a smooth zone (letters, digits, spaces, . ' & -). Pattern: `^[A-Za-z0-9 .'&-]*$`
`dartDesign.flight`	object	Yes
`dartDesign.flight.shape`	one of the options	Yes		Options: `standard`, `slim`, `kite`, `pear`, `fantail`, `vortex`.
`dartDesign.flight.colour`	text	Yes		Pattern: `^#[0-9a-fA-F]{6}$`
`dartDesign.flight.colour2`	text	Yes		Pattern: `^#[0-9a-fA-F]{6}$`
`dartDesign.flight.pattern`	one of the options	Yes		Options: `solid`, `stripe`, `chevron`, `sash`, `target`, `split`, `ring`.
`dartDesign.flight.text`	text, up to 12 characters	Yes		Printed on the flights (a nickname). Pattern: `^[A-Za-z0-9 .'&-]*$`
`dartDesign.flight.onYours`	true or false	Yes		Print it on whatever flights you fit (cosmetic).
`dartDesign.stem`	object	Yes
`dartDesign.stem.material`	one of the options	Yes		Options: `nylon`, `aluminium`, `carbon`, `titanium`.
`dartDesign.stem.colour`	text	Yes		Pattern: `^#[0-9a-fA-F]{6}$`
`dartDesign.stem.length`	number, 15 to 52	Yes		mm (an integrated flight's moulded shaft: 19–41).
`dartDesign.stem.integrated`	true or false			Integrated flights: flight and shaft moulded as one piece, in the flight's colour, instead of a separate stem and flight.
`dartDesign.point`	object	Yes
`dartDesign.point.style`	one of the options	Yes		Options: `grooved`, `smooth`.
`dartDesign.point.length`	number, 24 to 44	Yes		mm.
`dartDesign.point.colour`	text	Yes		Pattern: `^#[0-9a-fA-F]{6}$`
`flightDesign`	object			Flights: the full design the 3D renders draw (signature flights carry one).
`flightDesign.shape`	one of the options	Yes		Options: `standard`, `slim`, `kite`, `pear`, `fantail`, `vortex`.
`flightDesign.integrated`	true or false	Yes		Moulded in one piece with its own shaft (it takes a stem's place).
`flightDesign.shaft`	number, 15 to 45	Yes		Integrated: the moulded shaft's length, mm (19, 26, 33 or 41).
`flightDesign.material`	one of the options	Yes		Options: `standard`, `thick`, `nylon`, `moulded`.
`flightDesign.colour`	text	Yes		Pattern: `^#[0-9a-fA-F]{6}$`
`flightDesign.colour2`	text	Yes		Pattern: `^#[0-9a-fA-F]{6}$`
`flightDesign.pattern`	one of the options	Yes		Options: `solid`, `stripe`, `chevron`, `sash`, `target`, `split`, `ring`.
`flightDesign.text`	text, up to 12 characters	Yes		Printed along the vane: a nickname or a logo word (letters, digits, spaces, . ' & -). Pattern: `^[A-Za-z0-9 .'&-]*$`
`flightDesign.sides`	one of the options	Yes		Printed on one face of each vane, or both. Options: `one`, `both`.
`flightDesign.logo`	text
`asset`	file path			A file in your pack: see Images, sound and models.

Example#

A record from the base game’s data/equipment.json.

{
  "id": "core.equipment.sovereign-regent-22",
  "kind": "darts",
  "name": "Sovereign Regent 22g",
  "brandId": "core.sponsor.sovereign-tungsten",
  "price": 180,
  "tier": "pro",
  "description": "Sovereign’s best-seller: a slim torpedo that sits forward in the hand.",
  "stats": {
    "weight": 22,
    "profile": "torpedo",
    "grip": 0.65,
    "length": 52,
    "system": "fixed"
  },
  "effects": {
    "scoring": 1.2,
    "doubles": 1.1,
    "consistency": 3
  },
  "look": {
    "primary": "#716f6a",
    "metal": true
  },
  "dartDesign": {
    "profile": "torpedo",
    "tungsten": 90,
    "cut": "ring",
    "zones": "front",
    "finish": "tungsten",
    "colour": "#8e949b",
    "colour2": "#1f2126",
    "bands": [
      {
        "at": 0.72,
        "colour": "#c9a227"
      }
    ],
    "engraving": "REGENT",
    "flight": {
      "shape": "standard",
      "colour": "#f1ead6",
      "colour2": "#c9a227",
      "pattern": "sash",
      "text": "",
      "onYours": false
    },
    "stem": {
      "material": "nylon",
      "colour": "#15171c",
      "length": 35
    },
    "point": {
      "style": "smooth",
      "length": 32,
      "colour": "#c9ced4"
    }
  },
  "asset": "assets/equipment/core.equipment.sovereign-regent-22.webp"
}

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.