RiftForge

A smart character builder and interactive character sheet for the Rifts® TTRPG (Palladium Books, Rifts Ultimate Edition) — think "D&D Beyond, but for Rifts."

Two halves:

1. Guided builder — a step-by-step wizard that walks you from a blank slate to a rules-legal character, enforcing the rules as you go.
2. Live character sheet — roll saves, attacks, skill checks, and damage with every modifier already derived from the build.

Architecture

The hard part isn't the web app — it's encoding the game rules. Those live in a standalone, framework-agnostic package so they can be validated and tested in isolation:

packages/rules/
  src/content/   rules as page-stamped JSON (transcribed from the rulebook)
  src/schema/    Zod schemas that validate the content at load
  src/engine/    pure TypeScript that derives every number (no backend, no UI)

A Convex backend (planned) will seed and serve the validated content; the runtime never parses the source book.

Current status

First vertical slice — the Ley Line Walker O.C.C. — end to end: attributes → O.C.C. → P.P.E. → combat/HP → skills. Magic + spells and the Convex backend are next.

Development

Tooling is Vite+ (vp) over a pnpm workspace.

vp install            # install dependencies
vp run rules#test     # run the rules-engine tests
vp run rules#check    # format + lint + typecheck
vp run ready          # check + test + build across the workspace

Source material

The Rifts Ultimate Edition rulebook PDF is not committed (it's copyrighted by Palladium Books); it lives locally under docs/rules/ and is git-ignored. docs/rules/PAGE_MAP.md indexes where each rule is transcribed from.

License & intellectual property

The RiftForge software — the code, schemas, and engine — is licensed under the MIT License.

The Rifts® game rules content transcribed from Rifts® Ultimate Edition (the data under packages/rules/src/content/ and docs/) is © Palladium Books Inc. and is not covered by the MIT license. Rifts® is a registered trademark of Kevin Siembieda and Palladium Books Inc. That content is included here for personal reference only and is not licensed for redistribution. RiftForge is an unofficial, fan-made project and is not affiliated with or endorsed by Palladium Books.