PawHammer

A Warhammer 40,000 11th edition army list builder that runs entirely in the browser. Unit stats, points, wargear options, leaders, detachments, enhancements and stratagems come straight from the community 40kdc-data dataset, so the builder stays current as the data is updated. The UI is built with Bootstrap 5; the rules engine is plain JavaScript (ES modules, no build step, no dependencies).

PawHammer originally read BSData/wh40k-11e, which has been taken offline. The app now translates 40kdc-data into the same model its engine uses (see Data below); BattleScribe JSON files can still be loaded from disk under Data Source.

Running

npm start            # serves the app at http://localhost:8080

Any static file server works; ES modules just need to be served over HTTP, not opened as a file:// URL.

Features

• Pick any faction in the data source, including Space Marine chapters (which add their own units, detachments and enhancements to the Adeptus Astartes ones).
• Add units from a searchable list grouped by battlefield role. Mandatory models and default wargear are selected for you.
• Edit options: unit size, model loadouts, weapon swaps, enhancements, Warlord, and the army configuration (Battle Size, Detachment, Force Disposition).
• Live validation of the data's own rules: minimum and maximum selections, per-army limits (epic heroes, enhancements), category requirements, and points limits.
• Datasheet view with unit stats, weapon tables (with equipped quantities, e.g. "Bolt pistol ×10"), abilities, rules and keywords.
• Leaders and support characters: attach a character to an eligible unit (as defined by the data). The builder enforces limits such as one Leader per unit and required attachments, and unlocks rules that depend on the attachment (e.g. a Technomancer granting Feel No Pain).
• Play Mode: a read-only view for the table. Each unit shows with its attached characters, and tapping one opens its datacard with equipped weapon counts, abilities, Warlord and enhancements, plus the detachment rules.
• Rosters auto-save to browser storage. You can export them as text, JSON or a BattleScribe roster (.ros, which also opens in New Recruit), re-import them, and print them as datasheets.
• Unit Lookup (home page): pick a faction and start typing a unit name. Matching units appear as you type, and picking one (or pressing Search) opens its datasheet with default wargear and points.
• Share by QR code: Export → Share (QR code) shows a QR code and link that contain the whole roster in compressed form, so nothing is uploaded and codes never expire. Scanning with a phone camera opens PawHammer with an import prompt. Scan QR / Enter Code on the home screen reads a code with the camera, or from a pasted link. The receiver saves their own editable copy.
• Import from text: paste a list exported from the official Warhammer 40,000 app. The importer sets Battle Size, Detachment and Force Disposition, and picks the model variants and wargear that match the listed weapons. It also sets enhancements, the Warlord and Leader/Support attachments, then reports anything it couldn't match and any points that changed since the export.
• Tabletop Simulator: Export → Get Yellowscribe code uploads the roster to Yellowscribe and shows the code for the Yellowscribe v2 mod.
• Data files are cached in IndexedDB and re-downloaded only when the repository changes.
• A fork or branch of 40kdc-data, or local BattleScribe JSON files, can be selected under Data Source.
• Dark and light themes, and a responsive layout.

Yellowscribe setup

Yellowscribe's server doesn't send CORS headers, so a web page can only read the code it returns through a CORS proxy. The proxy URL is set under Data Source and defaults to Corsfix (https://proxy.corsfix.com/?{url}):

• Running locally (npm start): works as-is. Corsfix allows localhost without an account.
• Live site (e.g. GitHub Pages): create a free Corsfix account and add the site's domain (for example frbfli.github.io). The free plan allows 60 requests per minute and 100 MB a month.

Other proxies work too. {url} is replaced with the Yellowscribe address, and {encodedUrl} with a URL-encoded one. For corsproxy.io, for example: https://corsproxy.io/?key=YOUR_KEY&url={encodedUrl}.

If the proxy is empty or fails, the dialog offers to download the .ros file and open Yellowscribe, so you can upload the file there yourself.

Architecture

js/
  engine/
    gamedata.js   Indexes a game system + catalogues and resolves entry links into EntryDefs
    roster.js     Roster / Force / Selection model
    engine.js     RosterEngine: modifiers, conditions, repeats, constraints, costs,
                  validation, auto-selection, datasheet info, text/JSON export
  data/
    dc-repository.js 40kdc-data source: file listing, downloads, faction list
    dc-translate.js  40kdc-data -> the engine's (BattleScribe-shaped) game data
    repository.js    BattleScribe JSON files (local), catalogue-link resolution
    cache.js         IndexedDB cache
  ui/             Bootstrap views (home, editor, play), templating helpers, storage
  main.js         App controller and routing

Data

dc-translate.js turns a 40kdc-data faction into the structures the engine reads:

This is the beginning of the README. Read the rest at the original. Read the full README ↗