# Lords of Ash

A Crusader Kings III total conversion mod set in Brandon Sanderson's Mistborn
universe during the Final Empire era. CK3 version 1.18.*.

## Structure

```
lords_of_ash/              # CK3 mod directory
  common/                  # Game data: traits, cultures, religions, decisions, etc.
  events/                  # Event chains (snapping, balls, Lord Ruler, hemalurgy, etc.)
  history/                 # Starting characters, provinces, title holders
  localization/english/    # All display strings (l_english.yml)
lords-of-ash.mod           # Outer mod descriptor
docs/
  lore/                    # Mistborn universe reference (metallic arts, factions, setting)
  bookmarks/               # Story arc planning
  ck3-modding/             # CK3 modding reference
.claude/skills/            # Claude Code skills (commit, orient, ck3-game-install, etc.)
CLAUDE.md                  # Full conventions, naming rules, and system details
```

## Core Systems

- **Allomancy** — Genetic trait system. Dormant potential activates via "snapping" into Misting types or full Mistborn.
- **Lord Ruler Attention** — Variable (0–100) tracking defiance; escalating consequences.
- **Compounding** — Allomantic + Feruchemical overlap triggers on yearly pulse.
- **Hemalurgy** — Spike-based power transfer system.

## Key References

| What | Where |
|------|-------|
| Modding conventions | `CLAUDE.md` |
| Lore reference | `docs/lore/mistborn-universe.md` |
| Known issues | `lords_of_ash/REVIEW_NOTES.txt` |
| Game install / logs | `/orient` or `/ck3-game-install` skills |