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.

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.