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.

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.

Related MCP server: DM20 Protocol

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:

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

npm test
npm run check

Standalone HTML

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

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 for the SRD 5.2.1 Creative Commons attribution and PATHFINDER_ATTRIBUTION.md for the Pathfinder ORC notice and trademark disclaimer.