# Fieldbook

A polished, local-first tabletop player companion. Fieldbook combines guided D&D 5e and Pathfinder 2e character builders, live character sheets, integrated dice, a searchable rules compendium, and a local MCP server for Codex.

## Run it

Requires Node.js 20 or newer. There are no package dependencies to install.

```bash
npm start
```

Open <http://127.0.0.1:4173>. Character data is stored in `data/user-data.json`. The browser also keeps a fallback copy in local storage.

## Included in this release

- Pathfinder 2e Remastered Player Core support through level 3: Bard, Cleric, Druid, Fighter, Ranger, Rogue, Witch, and Wizard
- Eight common Pathfinder ancestries with selectable heritages: Dwarf, Elf, Gnome, Goblin, Halfling, Human, Leshy, and Orc
- PF2e ancestry-plus-class HP, level-based proficiency, AC, Perception, Fortitude/Reflex/Will, class DC, Hero Points, recovery state, valued conditions, spell ranks, daily preparations, and Refocus
- Complete D&D level 1–3 progression for all 12 core classes, including each SRD subclass at level 3
- 10 species with selectable lineages and correctly level-gated traits through level 3
- Guided level 1–3 character creation, Quick Build, and step-by-step advancement for existing sheets
- Standard Array, 27-point buy, 4d6-drop-lowest, and manual ability scores
- Live HP, temporary HP, conditions, rests, inventory, spell slots, notes, and automatic modifiers
- Print or Save as PDF, standalone printable HTML, and per-character JSON export
- Click-to-roll abilities, skills, initiative, and spell attacks
- Normal, Advantage, and Disadvantage d20 modes; quick polyhedral dice; custom expressions
- Searchable compendium and JSON backup/restore
- Local STDIO MCP server sharing the same character data
- Responsive light/dark interface with no external assets or tracking

Maps and VTT are deliberately reserved for a later release.

## Codex MCP connection

This repository includes `.codex/config.toml`. In a trusted project, restart Codex and inspect `/mcp`; the `fieldbook` server should appear. You can also add it manually from this directory:

```bash
codex mcp add fieldbook -- node mcp/server.mjs
```

Available tools let Codex list and inspect characters, create, advance, or update a character, adjust HP, add inventory, search included rules, and roll dice. Read tools are marked read-only; writes use approval-aware annotations and the project config prompts on writes.

## Validation

```bash
npm test
npm run check
```

## Standalone HTML

Build a single offline HTML file containing the interface, rules, and current character data:

```bash
npm run build:standalone
```

The result is written to `dist/fieldbook-standalone.html`. It stores subsequent edits in that browser and supports JSON backup/restore.

See [ATTRIBUTION.md](./ATTRIBUTION.md) for the SRD 5.2.1 Creative Commons attribution and [PATHFINDER_ATTRIBUTION.md](./PATHFINDER_ATTRIBUTION.md) for the Pathfinder ORC notice and trademark disclaimer.