Reference
Kit rules
- Content type
kitRules- Files
data/kit/rules.json,data/kit/rules/- Shape
- A list of records, each with its own
id - Patch target
kitRule:<id>, for examplekitRule:core.kitrule.top-end-parts- In the base game
- 22 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" | |
name | text, up to 40 characters | Yes | ||
kind | one of the options | Yes | block: can't be used together (equipping one takes the other off); clash: works badly; synergy: works well. Options: block, clash, synergy. | |
text | text, up to 200 characters | Yes | The reason, shown in the setup readout. | |
when | list, 1 to 8 items | Yes | All must hold. | |
when[] | one of several shapes | Yes | ||
Shape 1 (with slot, field, value) | ||||
when[].slot | text | Yes | Kit slot id, e.g. "darts", "flights", "footwear" Names a kit slot record. Pattern: ^[a-z][a-z0-9-]*$ | |
when[].field | one of the options | Yes | Options: weight, grip, length, profile, shape, material, texture, system, spin, integrated, finish, brand, item, tier. | |
when[].op | one of the options | "eq" | Options: eq, ne, in, notIn, gte, lte, gt, lt. | |
when[].value | one of several shapes | Yes | ||
| Shape 1: text | ||||
| Shape 2: number | ||||
| Shape 3: true or false | ||||
| Shape 4: list, at least 1 item | ||||
Shape 2 (with slot, equipped) | ||||
when[].slot | text | Yes | Kit slot id, e.g. "darts", "flights", "footwear" Names a kit slot record. Pattern: ^[a-z][a-z0-9-]*$ | |
when[].equipped | true or false | Yes | ||
Shape 3 (with sameBrand) | ||||
when[].sameBrand | list, at least 2 items | Yes | ||
Shape 4 (with balance) | ||||
when[].balance | one of the options | Yes | Options: balanced, noseHeavy, tailHeavy, unstable. | |
Shape 5 (with sponsored) | ||||
when[].sponsored | text | Yes | Kit slot id, e.g. "darts", "flights", "footwear" Names a kit slot record. Pattern: ^[a-z][a-z0-9-]*$ | |
Shape 6 (with signature) | ||||
when[].signature | text | Yes | Kit slot id, e.g. "darts", "flights", "footwear" Names a kit slot record. Pattern: ^[a-z][a-z0-9-]*$ | |
effects | object | {} | What an item (or a rule) does, per lever. Leave out what it doesn't touch. | |
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. | ||
order | whole number | 0 | ||
Example#
A record from the base game’s data/kit/rules.json, shortened.
{
"id": "core.kitrule.top-end-parts",
"name": "Top-end parts",
"kind": "synergy",
"text": "An elite barrel with pro-grade flights and stems: nothing lets it down.",
"when": [
{
"slot": "darts",
"field": "tier",
"op": "in",
"value": [
"elite",
"signature"
]
},
{
"slot": "flights",
"field": "tier",
"op": "in",
"value": [
"pro",
"elite",
/* … 1 more */
]
},
{
"slot": "stems",
"field": "tier",
"op": "in",
"value": [
"pro",
"elite",
/* … 1 more */
]
}
],
"effects": {
"consistency": 1
},
"order": 25
}In your pack the record’s id starts with your pack’s id instead of core, unless you mean to replace this one.