D&D Encounter Balancer

Balancing a D&D encounter is not a simple arithmetic problem. The official guidelines give a framework, but the actual difficulty of a fight depends on what the characters can do, their action economy, their resource pools, their class features at a given level. None of that math works if the characters going into the encounter are not built correctly. That dependency is why the character sheet generator is the first milestone rather than an afterthought, and why getting it right before building anything on top of it is the correct sequencing. This project is a D&D encounter balancing simulator built against the full 2014 and 2024 SRD rulesets, 5e and 5.5e respectively. The goal is a tool that can model encounters with mechanical accuracy, which requires correctly built characters as its foundation before anything else is attempted.

Current Focus

Milestone one is the character sheet generator, and it is actively in progress. It is currently doing double duty — temporarily integrated as the content layer for a separate API showcase project while being built to SRD spec. Once that showcase is complete, the generator returns here permanently as the foundation the rest of the simulator builds on. Building it correctly now means it arrives at its permanent home already validated rather than needing to be rebuilt.

Current State

The character sheet generator is under active development. The 2014 and 2024 SRD rulesets are both in scope, and implementation is working through full class coverage across all 20 levels.

Milestone One — Character Sheet Generator

Character generation follows real SRD ruleset logic. Class features, spell slots, cantrips, and equipment are accumulated correctly across all 20 levels rather than approximated or hardcoded. Each class is fully implemented to the SRD specification, meaning the output is structurally valid for encounter math, not just aesthetically plausible as a character sheet. A correct character sheet is the atomic unit everything else in the simulator depends on.

What's Planned

Once character generation is stable and validated against both rulesets, the encounter layer builds on top of it. Monster stat blocks, action economy modeling, resource tracking across encounter rounds, and the difficulty math the official guidelines approximate but do not always get right. The full roadmap is long and will be documented here as each milestone takes shape.

How It's Built

Python. Both the 2014 and 2024 SRD rulesets are in scope from the start rather than retrofitted later, which informs how the ruleset logic is structured from the ground up. Stack details will be filled in as implementation progresses and decisions are made.