neon-sprawl/docs/decomposition/modules/E2_M3_MasteryAndPerkUnlocks.md

44 lines
1.2 KiB
Markdown

# E2.M3 — MasteryAndPerkUnlocks
## Summary
| Field | Value |
|--------|--------|
| **Module ID** | E2.M3 |
| **Epic** | [Epic 2 — Classless Progression](../epics/epic_02_classless_progression.md) |
| **Stage target** | Pre-production |
| **Status** | Planned (see [dependency register](module_dependency_register.md)) |
## Purpose
Mastery tracks and perk unlock state so classless builds have expressive identity beyond raw level curves.
## Responsibilities
- Progress `MasteryTrack` data; emit `PerkUnlockEvent` and persist `PerkState`.
## Key contracts
| Contract | Role |
|----------|------|
| `MasteryTrack` | Branch progress per design. |
| `PerkUnlockEvent` | Unlocks for UI and combat/craft hooks. |
| `PerkState` | Current unlocked perks per character. |
## Module dependencies
- **E2.M2** — XpAwardAndLevelEngine.
## Dependents (by design)
- Gameplay systems that gate abilities or recipes on perks (integration per content).
## Related implementation slices
Epic 2 **Slice 4** — at least one mastery path unlocks a perk without blocking other skills.
## Source anchors
- Master plan: [`neon_sprawl_vision.plan.md`](../../../neon_sprawl_vision.plan.md) — Epic 2.
- [Module dependency register](module_dependency_register.md)