@alpaca-software/40kdc-data

Published by Alpaca Software.

The 40kdc Warhammer 40,000 dataset behind a linked, typed API. Find a unit, then walk straight to its weapons, abilities, the game phases those abilities act in, and its faction — all strongly typed, all resolved for you.

The full dataset is embedded in the package, so there is no network call, no database, and no filesystem access at runtime. It works the same in Node, bundlers, and the browser.

import { units } from "@alpaca-software/40kdc-data";

units.find("Kharn")!.abilities
  .filter(a => a.phases.includes("fight"))
  .map(a => a.id); // ["legendary-killer", "berzerker-frenzy"]

Install

npm install @alpaca-software/40kdc-data

The shape

Top-level collections (units, weapons, factions, abilities, detachments, stratagems, …) are accessors over a single embedded Dataset. Each collection is iterable and offers:

| Method | Returns | | --- | --- | | .all | every record (deduplicated) | | .get(id) | one record by exact id | | .find(nameOrId) | first match by id or name | | .findAll(nameOrId) | every match (surfaces names shared across factions) | | .byFaction(id) | records belonging to a faction |

Records resolve their links lazily:

• unit.faction, unit.weapons, unit.abilities
• ability.phases (joined from phase-mappings), ability.units
• weapon.units
• faction.units, faction.abilities, faction.weapons

The full underlying record is always available via .raw.

Name matching is built for a global player base

Warhammer 40,000 is played worldwide, and many names carry diacritics or punctuation — "Khârn the Betrayer", "T'au", "Be'lakor". find/findAll are diacritic- and punctuation-insensitive, so find("Kharn") resolves "Khârn the Betrayer" and find("Belakor") resolves "Be'lakor". The exact rule is exported as normalizeName so you can reproduce it in your own search UI.

API reference

Auto-generated from the source: docs/api/.

See it in action

Open-source example apps built on this package:

• List Builder — build an army list and export to ListForge / NewRecruit.
• Salvo — damage calculator over the cruncher and abilities-resolver.
• Mission Matrix — the 11th-edition Force Disposition matchup grid.
• Layout Editor — author terrain layouts on a board; exports terrain-layout JSON.
• Hull Tracer — trace a model's collision hull from a top-down photo; exports geometry-only hull-shape JSON.

Also: schema validation

This package also ships the canonical JSON Schemas and an AJV-based validator (createValidator, listSchemaIds, and the 40kdc-validate CLI) for checking data against them. See the repository root for schema details.

Licensing & attribution

• Code (tools/): MIT + attribution requirement — see LICENSE-TOOLS.
• Embedded enrichment data (data/enrichment/): CC BY 4.0 — attribution: Alpaca Software and the 40kdc community contributors (https://github.com/wn-mitch/40kdc-data).
• JSON Schemas: CC0.

Public deployment requirement: Any publicly accessible application or service that ships this package as part of its end-user product must display a visible credit containing the text "Powered by 40kdc-data" and a link to https://40kdc.alpacasoft.dev in a user-accessible location (footer, about page, or credits section). Private use and library redistribution are exempt.

Stat lines and points are numerical facts. Ability and rules text are never stored — abilities are community-authored structured mechanics (the Ability DSL), not reproductions of copyrighted text.