Campaign Codex

Open-source · MIT (source) · OGL/CC/ORC (data)

A Pathfinder 1e rules engine
you can read, run, and trust.

Campaign Codex is a Rust + Tauri replacement effort for PCGen. It parses the heritage PCGen corpus, computes character state deterministically, and ships a buildable Linux desktop workbench — every step of the pipeline is covered by a test.

View on GitHub Install & build

What works today

The corpus-ingest pipeline, the deterministic compute chassis, the boundary contract, and every persistence store are real, tested, and exercised end to end by cargo test --locked and npm test.

  • PCGen .pcc/.lst parsing into canonical source-IR
  • Pilot compute + boundary contract — deterministic, fail-honest
  • Per-domain engines: spellbook, skill allocation, feat prerequisites, equipment effects, level-up
  • Desktop workbench: create, load, clone, export, recompute
  • Campaign manager (local) with on-disk persistence and conflict detection
  • Self-update chain + browser-handoff feedback to GitHub issues

Full status report →

What it isn't (yet)

Codex today is a developer proof harness plus a buildable desktop workbench surface, not a finished end-user product. The honest single-class path is Fighter, levels 1-3, for any race — every other class/level combination returns real claim-blocking diagnostics rather than fabricated output. The desktop UI surface is bounded and demo-oriented, not a general character builder.

We say so up front rather than pretending. That posture is the project's central engineering commitment.

Install & build

Verified on Ubuntu 24.04. Other platforms: repeat the proof before assuming parity.

1. Linux system dependencies

sudo apt update
sudo apt install libwebkit2gtk-4.1-dev \
  build-essential curl wget file libxdo-dev \
  libssl-dev libayatana-appindicator3-dev \
  librsvg2-dev pkg-config

2. Rust toolchain

curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh
. "$HOME/.cargo/env"
cargo --version

3. Node.js LTS

Install via your normal bootstrap path, then verify with node --version and npm --version.

4. Repo-local dependencies

cd apps/desktop
npm ci
npm run typecheck
npm run build
npm run tauri:check
npx tauri build --debug

5. Run the proof harness

cargo test                 # full suite
cargo test ge06_           # bounded pilot compute surface
cargo test ge08_           # bounded Guard Stance homebrew surface

6. Launch the desktop shell (graphical Linux only)

cd apps/desktop
npx tauri dev

Full onboarding and troubleshooting lives in README.md.

Project

Repository: github.com/electricm0nk/codex

Owner: electricm0nk (Todd Hintzmann)

License (source code): MIT — see LICENSE.

License (game rules data): NOT MIT-licensed. Each dataset carries its own license — Open Game License v1.0a, Creative Commons, or ORC. See LICENSING.md in the repo for the full attribution and notice obligations.

Trademark: Pathfinder and related marks are trademarks of Paizo Inc. This project is not affiliated with or endorsed by Paizo.

Documentation

  • README — onboarding, build, demo, troubleshooting
  • Architecture docs — system map, module boundaries, conventions, real-vs-stubbed status
  • Release docs — every SD-N bundle, including release notes
  • Releases — release-notes index for v0.6, v0.7, and in-flight bundles
  • Issue tracker — bug reports and enhancement requests