daggerheart-system
By rjroy
Daggerheart RPG mechanics for Adventure Engine adventures. Provides character creation with constrained Experiences, Hope/Fear token economy, spotlight-based combat, domain cards, adversary management, and SRD rule lookups. Uses Duality Dice (2d12) for narrative tension between player success and GM opportunity.
Component Overview
Install
npx claudepluginhub rjroy/adventure-engine-corvran --plugin daggerheart-systemComponent Details
Skills (6)
This skill should be used when creating Daggerheart adversaries, building stat blocks, designing encounters, or determining enemy difficulty. Invoke when the GM needs to create enemies, generate adversary stat blocks, calculate Battle Points for encounter balance, or reference adversary types (Bruiser, Horde, Leader, Minion, Ranged, Skulk, Social, Solo, Standard, Support).
This skill should be used when the GM needs to handle Daggerheart combat, including action roll resolution, Hope/Fear token economy, spotlight flow, damage tracking, reaction rolls, and managing combat encounters. Provides action outcome tables, encounter tracking templates, and condition references.
This skill should be used when handling domain cards and magical abilities in Daggerheart, including looking up domain card effects, understanding Recall costs, making Spellcast Rolls, selecting domain cards during character creation or advancement, or when players want to use domain-based abilities. Covers all 9 SRD domains (Arcana, Blade, Bone, Codex, Grace, Midnight, Sage, Splendor, Valor) and their associated cards.
This skill should be used when creating a new Daggerheart campaign, establishing world tone and themes, selecting or building a campaign frame, or reframing an existing adventure. Campaign frames provide pitch, tone, themes, community/ancestry/class guidance, principles, distinctions, inciting incidents, and special mechanics for a particular type of story.
This skill should be used when the GM needs to help players create Daggerheart characters, select a class/ancestry/community, define Experiences with bounded constraints, choose domain cards, or handle level advancement (1-10). Provides templates for character sheets, session state, and Experience definitions to prevent semantic drift during gameplay.
This skill should be used when the GM needs to look up Daggerheart rules, reference what the SRD says, find official rules, get exact wording, check RAW (rules as written), verify rules references, or understand how mechanics work in Daggerheart. Provides authoritative rule clarification from the Daggerheart System Reference Document 1.0.
README
Adventure Engine of Corvran
A space for collaborative storytelling. A human and an AI sit down together and make up a story, the way kids do.
TTRPGs are shared narrative. At their core, it's kids playing make-believe but with rules. The AI is one of the kids who also happens to maintain the rules. The rules create stakes, not authority. The story belongs to everyone at the table.
The ambition is not an AI that runs a simulation. It's an AI that plays with you.
Getting Started
Prerequisites
- Bun (runtime and package manager)
- An Anthropic API key (
ANTHROPIC_API_KEYenvironment variable)
Install
git clone --recurse-submodules https://github.com/rjroy/adventure-engine-corvran.git
cd adventure-engine-corvran
bun install
If you already cloned without --recurse-submodules:
git submodule update --init --recursive
Development
bun run dev # starts daemon + Next.js dev server
Production
bun run build # typecheck + build web
bun run start # starts daemon + built web app
Architecture
The application is a monorepo with three packages:
| Package | Path | Purpose |
|---|---|---|
@corvran/shared | packages/shared/ | Zod schemas and types for API contracts |
@corvran/backend | packages/backend/ | Hono daemon on Unix socket |
@corvran/web | packages/web/ | Next.js App Router client |
The backend is the application. The web client is just that, a client. All AI interaction uses the Claude Agent SDK. Game state lives in markdown files, readable by humans and AI alike.
Plugins
RPG systems are content, not architecture. Each plugin teaches the AI how to run a game system through reference material and instructions, not application code.
| Plugin | Description |
|---|---|
plugins/corvran | The world of Corvran (setting) |
plugins/d20-system | d20/5e system rules |
plugins/daggerheart-system | Daggerheart system rules |
Runtime Data
The daemon stores runtime data in ~/.corvran/ (override with CORVRAN_HOME). Adventures, socket files, and session state live here, not in the repo.
Design Principles
- The Story is the Product — everything serves the narrative
- Markdown is Memory — all game state lives in markdown, readable by AI, developer, and player
- Teach, Don't Code — RPG mechanics are documents the AI reads, not logic the system executes
- Player Agency is Sacred — the AI never decides what the player does
- Progressive Simplification — if the AI can do it with standard tools, remove the custom tool
- System-Agnostic Core — the engine knows stories and participants, not d20s and spell slots
Reference Material
This project includes third-party SRD (System Reference Document) content as git submodules for AI reference during gameplay:
| Submodule | Source | Content |
|---|---|---|
docs/research/daggerheart-srd | seansbox/daggerheart-srd | Daggerheart SRD |
docs/research/dndsrd5.2_markdown | springbov/dndsrd5.2_markdown | D&D 5.2e SRD in Markdown |
These submodules contain reference material used by the AI during gameplay. They are not included in the application build.
License
This project is licensed under the MIT License. See LICENSE for details.
Uses Daggerheart compatible rules
Similar Plugins
caveman
Ultra-compressed communication mode. Cuts ~75% of tokens while keeping full technical accuracy by speaking like a caveman.