Example packs

Replaces the game's own mark with a mod's pictures. Switch it on in Mods and go back to the main menu: the title is the mod's wordmark picture, and the game's shirt in the character creator carries the mod's logo on the chest and the back.

• data/brand.json replaces the record core.brand.game (same id, so it takes the core pack's place).
• assets/logo.png: the mark on a transparent ground (the shirt's back).
• assets/logo-chest.png: the mark at 70 % inside a clear margin, so it sits inside a shirt's piping on the chest.
• assets/wordmark.png: a wide title picture for the main menu, drawn as tall as the game's own title.

To change only one picture, patch the record instead: data/patches/brand.json with { "target": "brand:core.brand.game", "patch": { "wordmark": "assets/wordmark.png" } }. The league's mark is core.brand.league. The credits are not content and cannot be changed.

See Images in mods. The pictures here are flat shapes and the game's display font; use any picture of your own.

Four dart part models shipped by a mod, and a shop item drawn with each. The contract (the part frame, how parts join, material names, file rules) is in Dart part models.

mod.json
data/dart-parts.json      the four parts: a barrel, a stem, a flight and a point
data/equipment.json       four shop items; each names its part in "look.model"
darts/models/*.glb        the models

The four .glb files here are copies of the game's own parts, so the example has something to load: workshop-barrel.glb is the bomb barrel with the aggressive grip, workshop-stem.glb the machined aluminium stem, workshop-flight.glb the kite flight and workshop-point.glb the diamond-cut point. Replace them with your own and change node, lods, length and stretch in data/dart-parts.json to match.

The items are given numbers that would pick a different part by themselves (a straight barrel, a nylon stem, a smooth point), so that what you see in the game is the model the item names, not the game's own pick.

Try it#

1. Copy this folder into the game's mods folder and enable it on the Mods screen.
2. Start a career. The four Workshop items are in the equipment shop at club level.
3. Buy and fit them: the dart in Your setup, in the hand and in the board is drawn with these models.

When something is wrong#

• A model that is missing, is not a .glb or is over 20 MB is refused when the mod loads; the Mods screen names the file and the reason, and the part is not used.
• A model that loads but cannot be read when the dart is first drawn (Draco or meshopt compression, a node that is not in the file, no normals) is listed on the Mods screen with what was drawn instead; the game draws its own generated part.

None of these stops the game.

A post-match interview pack made of nothing but JSON. Copy this folder into your mods folder (Mods → Open mods folder) and press Reload mods. Interviews are flavour, so existing careers pick the pack up the next time they're opened.

• mod.json: the manifest. New ids start with the mod id (example.interviews.).
• data/media/interviews/pub-talk.json: two new questions. One comes up after a win in front of a home crowd; the other after a defeat despite a big average and plenty of 180s, and only analysts and veterans ask it. Field reference: the interviews field reference.
• data/media/interview-answers/core-extras.json: this file changes the core pack's questions without copying them.
  • It adds a thank-your-sponsor answer to two of them.
  • It tones down the cocky answer to one.
  • It switches off the kebab joke ("replaces" with "weight": 0).
• data/patches/interviews.patch.json: switches a core question off ("disabled": true) and lengthens another's cooldown.
• locale/de/patches/interviews.json: the German text for everything above. Questions are translated with interview:<id>, and answers inside a question are matched by their id. An added answer is translated with interviewAnswer:<id>.

The full format is in Interviews.

Check it on the Mods screen: it lists any problem with its file and field.

A nations and economy pack made of JSON and one hand-drawn SVG. Copy this folder into your mods folder (Mods → Open mods folder) and press Reload mods. Nations and the economy are copied into a career's save, so start a new career to meet the Faroese (a career you load also picks up the installed packs' nations and rules).

• mod.json: the manifest. New ids start with the mod id (example.nations.).
• data/nations.json: a new nation, the Faroe Islands (FRO). It has a name, a demonym for the welcome letter, its own flag image, a sponsor market a little under the core's big darting nations, a face mix and avatar palette, and its travel geography (the Nordic area, Europe, UTC+0). See Nations.
• assets/flags/fro.svg: the flag, drawn by hand on a 30×20 canvas (3:2 suits the game's flag tiles). Any image works; SVG stays sharp at every size.
• data/names/fro.json: a name pool, so Faroese players turn up in new worlds (and a Faroese team at the Nations Cup once there are enough of them).
• data/patches/nations.patch.json: a patch on a core nation. Dutch sponsors pay a quarter more than the game's baseline (market 1.25 instead of 1.15).
• data/career-rules.json: a kinder economy. The day job pays 320 a week instead of 280, comfort travel costs 1.5 times the standard fare instead of 1.6, and sponsors' offers stay open for 35 days instead of 28. Fields left out keep the game's numbers. See the economy.
• locale/de/patches/nations.json: the nation's German name, Färöer.

Check it on the Mods screen: it lists any problem with its file and field.

Mod panels on the career hub, from a script and from data. See UI panels.

• mod.json: the manifest, with "entry": "scripts/main.js".
• scripts/main.js: the panels hook builds a Form guide on Home (this season's numbers, your last five matches, each opening your opponent's profile, and a sparkline of your averages) and a Rivals table on your profile, with the head-to-head.
• data/ui/panels/season-card.json: a panel with no script at all. It sits at the top of Rankings, and its {placeholders} fill in from your career: record, average, titles, confidence, your next event and your rival (a link to their profile).
• locale/de/patches/panels.json: the data panel in German. Like any content, a panel is translated with a patch.

Check it on the Mods screen. Panels follow the installed mods: switch the mod off on the Mods screen and they leave the hub. Each panel can also be hidden on its own, from the × on the panel or the Mods screen.

Four players for the county circuit, added with nothing but JSON. Copy this folder into your mods folder (Mods → Open mods folder), press Reload mods, then start a new career.

• mod.json: the manifest. Every new record's id starts with the mod id (example.players.).
• data/players/county.json: the players. Field reference: the players field reference.

No portraits are included, so the game gives each player a face from its library. To add your own, put a 512×512 image in assets/portraits/ and set "portrait": "assets/portraits/dot-hargreaves.webp".

Check it on the Mods screen: it lists any problem with its file and field.

A rules pack made of nothing but JSON: it changes the season awards, the Tour Card ladder, training and the match commentary. Copy this folder into your mods folder (Mods → Open mods folder) and press Reload mods. Rules are copied into a career's save, so start a new career to play with them (a career you load also picks up the installed packs' rules).

• mod.json: the manifest. New ids start with the mod id (example.rules.).
• data/awards.json: two new season awards. Most Titles goes to whoever won the most titles, and mints its own card (cards). Sharpshooter of the Year is the best checkout rate over at least 200 attempts at a double, for players who won £5,000 or more. ceremony places them in the awards night. See Awards.
• data/cards.json: the card Most Titles prints. Because the award lists it in cards, it mints for that award only; no conditions needed.
• data/career-rules.json: a harder ladder. Trial Week hands out at most 24 cards, and you keep your card inside the top 72. See Tours and the Tour Card.
• data/training.json: training 20% faster (rate 0.036 instead of 0.03), and bull practice now helps composure a little. Fields left out keep the game's numbers. See Training.
• data/commentary/more-lines.json: 59 more lines of match commentary, for every moment the match calls. See Commentary.
• data/patches/rules.patch.json: patches on core records.
  • It retitles Player of the Year.
  • It raises Best Newcomer's prize-money bar.
  • The Contender Tour hands out three cards instead of two.
  • One core commentary line is switched off ("weight": 0).
• locale/de/patches/rules.json: the German text for the new awards, the card, the retitled award and every new commentary line.

Check it on the Mods screen: it lists any problem with its file and field.

A story fired from a script. Before an event you've entered, scripts/main.js may pick a local rival (someone from your country near you in the rankings) and fire the Derby Day story. If you then meet that rival, the result makes the news, the winner's confidence goes up, and your post-match interview gets an extra answer.

• mod.json: the manifest, with "entry": "scripts/main.js".
• data/events/narrative/derby.json: the story. Its trigger is followUp, so it never fires on its own: only the script fires it, filling {derbyRival} and {derbyEvent}.
• scripts/main.js: the hooks it uses are narrativeCheck, matchEnd, beforeInterview and seasonStart.

The script API is in Scripts. Scripts apply to new careers, like the rest of a mod's content; the Mods screen shows each script's log and any error for the loaded career.

Adds a stage and names it on an event. Switch it on in Mods, then play (or watch) The Emerald Gauntlet: the match is in a plain studio hall instead of the game's arena.

• data/stages.json: the record example.stage.studio with its model and its layout.
• assets/stages/studio.glb: the hall, in millimetres with the origin at the bull and the players' floor at y = -1730. Nine meshes, each with one of the game's material names (arena_carpet, arena_ledwall, arena_screen, arena_led and so on), so the set takes the event's colour, backdrop and name.
• assets/stages/studio.json: the layout: where the deck, the steps and the walkway are, and a seat for each of the 450 spectators.
• data/patches/events.patch.json: sets the event's stage field to the record's id.

The board, the oche, the players, the cameras and the lights are the game's and stay where they are; a stage is built around them.

If the stage cannot be used (the model does not load, or the layout fails its checks), the match plays on the game's own stage and the Mods screen says why on this mod.

See Stage models. The hall is a simple made-up model; use any model of your own, with a layout to match.

Snooker-hall green with cream text and a brass accent.

Copy this folder into your mods folder, switch the mod on, then choose Baize & Brass in Mods > Themes or Settings > Display > Theme. The theme is the one file data/ui/themes/baize.json; Themes lists every colour a theme can set.

Pure black surfaces, white text and a hard red accent.

Copy this folder into your mods folder, switch the mod on, then choose Black & Red in Mods > Themes or Settings > Display > Theme. The theme is the one file data/ui/themes/blackout.json; Themes lists every colour a theme can set.

A theme mod is a mod with one or more theme files in data/ui/themes/. This one has daylight.json.

To use it: copy this folder into your mods folder (Mods > Open mods folder), switch the mod on, then choose Daylight in Mods > Themes or Settings > Display > Theme.

To make your own: in the game go to Mods > Themes, pick a theme to start from and press New theme from this. The game makes a mod folder for it and opens the editor; every colour changes the game as you edit.

A theme file sets a colour for each token. A token you leave out keeps the game's own colour. The full list, with what each one paints, is in Themes.

Dark teal water with an aqua accent.

Copy this folder into your mods folder, switch the mod on, then choose Deep Sea in Mods > Themes or Settings > Display > Theme. The theme is the one file data/ui/themes/deep-sea.json; Themes lists every colour a theme can set.

Navy surfaces with an electric blue accent.

Copy this folder into your mods folder, switch the mod on, then choose Midnight Blue in Mods > Themes or Settings > Display > Theme. The theme is the one file data/ui/themes/midnight.json; Themes lists every colour a theme can set.

Deep purple with a bright yellow accent, after Luke Littler's colours.

Copy this folder into your mods folder, switch the mod on, then choose Nuke Purple in Mods > Themes or Settings > Display > Theme. The theme is the one file data/ui/themes/nuke.json; Themes lists every colour a theme can set.

A warm light theme: cream paper, brown ink and a deep red accent.

Copy this folder into your mods folder, switch the mod on, then choose Paper & Ink in Mods > Themes or Settings > Display > Theme. The theme is the one file data/ui/themes/paper.json; Themes lists every colour a theme can set.

Adds a trophy and names it on an event. Switch it on in Mods, then play (or watch) The Golden Mile Showdown on its televised stage: the gold cup stands on the pedestal at stage right.

• data/trophies.json: the record example.trophy.cup with its model.
• assets/trophies/cup.glb: the model, in metres, standing on y = 0 with the origin at the centre of its foot (0.38 m tall, 0.22 m wide, 1,728 triangles, one gold material).
• data/patches/events.patch.json: sets the event's trophy field to the record's id.

To replace one of the game's own trophies everywhere it is used, give your record its id instead (core.trophy.world-championship); no patch is needed then.

If the model cannot be used (not a .glb, over 20 MB, over 100,000 triangles, or larger than 0.6 x 0.6 x 0.8 m after units and scale), the match plays with the game's own trophy for that event, or none, and the Mods screen says why on this mod.

See Trophy models. The cup is a simple made-up model; use any model of your own.

A tour of what a mod can do today, in one pack. It's set on a fictional stretch of coast: a lighthouse keeper's daughter, a ferryman with a grudge, a Dutch metronome, a teenage prodigy, a Scottish fog and a Welsh landlord. They have their own four-stop series, a newspaper, a storyline, sponsors and kit. A script ties it together every week.

Mod id showcase, so every new record's id starts with showcase.. To try it, copy this folder into your mods folder (Mods → Open mods folder), press Reload mods and start a new career. Stories, interviews, the press and the social feed also reach existing saves. Players, events, sponsors, kit and the script only reach careers started after the mod is installed.

Import it on the Mods screen and start a new career; the Mods screen lists any problem with its file and field.

What each part shows, and where to see it#

The script#

scripts/main.js uses script API 3. It shows up on the home screen's Inbox and Latest news panels, on its own panels (Home, your profile and Rankings), in your card collection and in your finances. Every word it writes comes from locale/en.json or locale/de.json through dtj.t, so it reads in German when you play in German. Money is written as {money:N}, so it shows in your currency.

• **weekTick**
  • Week one: a welcome letter in the inbox.
  • Every week: Pundit's Corner, a column from Wilf Trevaskis built from real queries, credited to him at the Saltmarsh Gazette (byline):
    • the week's biggest climber in the top 100 (it keeps last week's table in dtj.state);
    • which of the mod's players is in form;
    • your next event, or the next Coastal Classic you could enter;
    • the ranking milestone you're chasing, and how much money it would take;
    • your season so far (dtj.query.seasonStats).
  • Every eight weeks: The Gazette wants a column, an inbox message with three choices. The choices carry their own effects (morale and reputation for writing it straight; confidence, a little morale and some image for stirring things up), shown as chips before you choose.
• **inboxChoice**: runs your column in the news. Stir things up also fires up one of the coast regulars and sharpens your rivalry with them (dtj.effects.rivalry). Too busy just logs.
• **matchEnd**: reacts to your matches, at most two stories a match and one of each kind an event:
  • giant-killings and shocks by Order of Merit rank (from ctx.ranks), with confidence and morale nudges;
  • ton-plus averages, and personal bests;
  • meetings with the mod's six players, with the head-to-head from dtj.query.headToHead and their own reactions.
• **beforeInterview**: adds one answer that knows the context: something about the specific character you just played, your big average, or the sea air after a Coastal Classic match.
• **narrativeCheck**: fires The Keeper's Darts with ctx.fire, passing {coastalEvent} into the story text. It fires once per career, after you've played a Coastal Classic match, or in August if you never do.
• **seasonStart**: a news story listing the new season's Coastal Classic dates.
• **eventEnd: after each Coastal Classic stop you play, a round-up by Nia Pengelly with your placing and the winner. Win it and you make the front page: a Front Page** card (dtj.effects.mintCard, the mod's own script design) and supper money from the fish bar (dtj.effects.money). Reach the semi-finals and the Gull & Anchor Fish Bar makes you a sponsorship offer (dtj.effects.sponsorOffer, once a season, if your tier suits it).
• **sponsorSigned**: the Gazette reports it when you sign with the fish bar.
• **awards**: Wilf's take on the Player of the Year.
• **seasonEnd**: Wilf's verdict on your season, in the news and kept for the Rankings panel.
• **panels**:
  • Home: this week's Pundit's Corner, with links to the players and events it mentions.
  • Your profile: Form on the coast: your season's record, average and 180s, your last six matches, your record against each coast regular you've met, and your rivals (seasonStats, matches, headToHead, rivals).
  • Rankings: Wilf's review of last season, until April.

The Mods screen shows the script's log for the loaded career: column answers, interview answers added, meetings with the cast, the front-page card, the fish bar's offer and when the story fired.

Room to grow#

• Mod icon. Another change is adding mod icons, banners and images. When it lands, the icon goes in assets/ (e.g. assets/icon.webp) and is named in mod.json as that feature documents. Nothing else in the mod needs to change.