encounter-balancer

What problem does it solve?

Balances D&D 5e encounters by validating XP budgets against party tier and size to ensure fair action economy and meaningful tactical options.

Core Features & Use Cases

• XP budget validation: computes base XP, applies per-enemy multipliers, and compares to party budget to classify difficulty.
• Instakill and action-economy checks: flags high-risk threats and assesses swarm vs. solo imbalances.
• Use Case: during dungeon-smith, validate a Tier 2 encounter and output a balance report to encounters/<slug>-balance.md.
• Tactical richness and balance reporting: ensures meaningful choices and outputs a structured balance report to encounters/<slug>-balance.md.

Quick Start

Provide the path to an encounter file under encounters/<slug>.md and run the balance check to generate encounters/<slug>-balance.md.