lords-of-ash/CHANGELOG.md

# Changelog

## [Unreleased]

### Added
- Flavor events registry (`docs/events-registry.md`) cataloging ~112 proposed events: 17 chain extensions, 32 new arc steps across 7 multi-event chains, 63 one-shot flavor events, and 8 artifact acquisition events
- M7 task group 7.14 (Flavor Events Expansion) referencing the central events registry
- 21 new flavor event modifier icons planned in REQUIRED_ASSETS.md (underground network, keeper advisor, pewter gate champion, mist scholar, and more)
- 8 new event scene backgrounds planned in REQUIRED_ASSETS.md (underground hideout, fighting pit, ruins, plantation, private chamber, market, ashmount close-up, clear night)
- 21 custom modifier icons (60x60 DDS, hammered-metal coin style) covering compounding, Lord Ruler attention tiers, Steel Ministry, ash blight, koloss, metal reserves, and future M4-M8 modifiers
- Feruchemy activation event chain for Terris characters (discovery + first metalmind)
- Allomantic training system: decisions and events for mentoring family Allomancers
- Metal supply management: acquire metals, black market, wartime scarcity events
- Savant acquisition and consequences events for long-term Allomancers
- Late snapping event for characters age 17-30 (triggered by imprisonment/trauma)
- Hemalurgy expansion: Inquisitor transformation, Ruin's whispers, Ministry discovery events
- Sandbox mode decision to test for metallic arts potential (any culture)
- Men-at-arms recruitment restrictions (culture, rank, Allomancer requirements)
- Metal reserve modifiers (abundant/low/depleted) affecting Allomancer effectiveness
- Feruchemy modifiers: Keeper of Terris, first metalmind variants (pewter/copper/gold)
- Savant power surge modifier for uncontrolled metal-burning episodes
- Atium reserve and brutal repression modifiers
- Opinion modifiers for parent reactions to snapping outcomes
- has_multiple_spikes_trigger for Inquisitor transformation eligibility
- On-imprison hook for late snapping
- Game start metal supply grants for starting Allomancers

### Fixed
- Game crash on bookmark character select caused by cascading mod load failures
- UTF-8 BOM encoding added to all .txt files (CK3 requires BOM for reliable parsing)
- Trait groups without level field (CK3 unset the group, breaking mutual exclusivity)
- genetic + inherit_chance conflict on all Allomantic/Feruchemical traits (CK3 1.18 error)
- Doubled trait icon paths (gfx/interface/icons/traits/ prepended twice)
- on_game_start effect block overriding vanilla (moved to event-based initialization)
- Missing head_determination culture pillar on all three Scadrian cultures
- Non-existent event background references (corridor.dds, battlefield.dds)
- Missing localization keys for trait groups, trait_ prefix lookups, and Terris faith custom loc
- Invalid event themes (skulduggery, mystery, learning_skill) replaced with valid CK3 themes
- Loc key hash collision (mistborn_feruchemy.0010.c → opt_c)
- county_opinion → county_opinion_add in brutal_repression modifier
- Skaa allomancer recruitment now uses random Misting type instead of hardcoded Coinshot
- Atium events use decrease_lord_ruler_attention_effect for consistency
- Snapping effect redirected to event chain as single source of truth
- Duralumin and nicroburst added to compounding check triggers

### Changed
- Men-at-arms rebalanced: Koloss max reduced (300→150), costs increased; Mistborn Agent damage reduced (100→80); Hazekiller counter multiplier doubled; Skaa Levy max halved
- Narrative/Sandbox game mode toggle on the game setup screen
- 34 vanilla decision suppression files — only Mistborn decisions appear
- Bookmark group (bm_group_1020) and placeholder bookmark portraits
- Bookmark background art for "End of an Empire" scenario
- Vanilla bookmark suppression — all base-game bookmarks hidden for total conversion
- 5 custom loading screen illustrations: Vin in the Mists, Luthadel Skyline, Kredik Shaw, Ashmounts, and Kelsier Overlooking — 1024x1024 DDS
- Asset-gen skill (`.claude/skills/asset-gen/`) for AI-powered visual asset generation using Nano Banana (Gemini 2.5 Flash Image) MCP tool — includes style guide, category prompt templates, and DDS conversion reference
- 26 trait icons for the full metallic arts system: 12 Misting types, Mistborn, 3 Allomantic strength tiers, 2 Allomantic potential tiers, Feruchemist + potential, and 6 Hemalurgy variants — dark fantasy painterly style at 120x120 uncompressed ARGB DDS
- Visual asset requirements document (`docs/REQUIRED_ASSETS.md`) cataloguing all ~200+ assets needed across M1-M8: trait icons, modifier icons, decision illustrations, custom map files, loading screens, bookmark art, CoA emblems, religion icons, lifestyle assets, activity assets, event backgrounds, portraits, and workshop thumbnail — with verified specs from CK3 v1.18 game files

### Fixed
- Province history now uses correct vanilla map IDs (was 1-105, now 2030-3107)
- Scripted triggers correctly distinguish active vs dormant Allomancers/Feruchemists
- Lord Ruler attention unified on variable-based system with automatic tiered modifiers
- Language pillars now have required color property
- Vanilla bookmark suppression entries include required start_date field
- Replaced 14 invalid negative add_gold calls with remove_short_term_gold
- Synced project documentation with codebase: added missing directories to CLAUDE.md structure tree, removed resolved M1 item from MASTERPLAN, corrected stale cross-reference in REVIEW_NOTES

### Added
- Gender doctrine system planned for M3: male preference (Steel Ministry), equal (Survivorism, Terris), with full female participation in politics, council, and Allomancy
- Gender preference on government types planned for M4: male preference under Imperial rule, equal post-rebellion
- Custom education system (5 tracks mapped to lifestyles, 20 traits, snapping during Allomantic Training) planned for M3
- Dynasty legacies (5 universal × 5 tiers + 10 house-specific × 3 tiers) planned for M3
- Custom death reasons (12) and character nicknames (~15) planned for M3
- Custom government types (Imperial Appointment, Theocratic Ministry, Post-Rebellion Elective) planned for M4
- Custom factions (Skaa Rebellion, Ministry Loyalist, Noble Reform, Keeper Underground, Cult of Ruin) planned for M4
- Custom vassal contracts (6 Mistborn-specific terms including Atium Tithe and Inquisition Access) planned for M4
- Custom secret types (8) and hooks (3) planned for M4
- Custom court types (Noble Keep, Ministry Canton, Underground Hideout) planned for M4
- Portrait modifier system (10 triggers for M8 art) planned for M4
- Testing protocol document (`docs/TESTING.md`) with debug decisions, log analysis, validation scripts, and Claude Code testing workflow
- Testing protocol cross-reference added to all milestone docs (M1-M8)
- ck3-tiger static analysis via Makefile (`make setup`, `make lint`) with auto-download of platform binary
- Pre-commit lint step in commit skill
- Custom religion system planned for M3: 12 custom tenets, 2 custom doctrine groups (Allomantic Stance, Caste Doctrine), expanded and faith-differentiated holy sites with conditional activation
- Steel Inquisitor holy order and individual Inquisitor request mechanic planned for M3
- Keeper Network secret society with progression, coppermind sharing, and Ministry discovery risk planned for M3
- Full council retheme (5 positions, 10 custom tasks) and 7 court positions (Royal Court) planned for M4
- Caste law system (Strict/Relaxed/Abolished) with cross-caste consequence events planned for M4
- Cultural innovation system (Age of the Lord Ruler + Age of Liberation) planned for M4
- Band council with 7 crew roles, vacancy penalties, and role-specific events planned for M5
- Advanced council interaction events (kandra replacement, Smoker vs Seeker, Obligator betrayal, Keeper reveal) planned for M7
- Post-endgame choice: seize the Lord Ruler's throne or release the kingdoms planned for M7
- Legend system suppression added to M4 vanilla suppression pass
- Detailed milestone implementation documents (M1-M8) with tasks, acceptance criteria, and testing checkpoints
- Milestone document template for consistent structure
- Metal supply and scarcity system planned for M2
- Royal Court artifact system (9 core types) planned for M3
- 5 custom Mistborn lifestyles replacing vanilla planned for M5
- 8 Mistborn-specific activities and rethemed vanilla activities planned for M5/M7
- Orient skill (`/orient`) for lightweight context bootstrapping in new sessions
- Project README.md as a lean entry point for orientation
- "The End of an Empire" bookmark scenario with event planning
- Province history for all Scadrian provinces
- Bookmark localization
- CK3 game install skill for log analysis and vanilla comparison
- Commit skill for structured commit messages
- Project masterplan and design ideas documents

### Fixed
- Fixed decision `picture` fields, `add_opinion` syntax, and `stress` cost placement
- Used correct vanilla trait names in AI decision weights (`callous` not `cruel`, etc.)
- Renamed deprecated modifier fields across traditions, modifiers, and events (`monthly_dynasty_prestige_mult`, `county_opinion_add`, `owned_personal_scheme_success_chance_add`)
- Removed deprecated `hostile_scheme_power_mult` and `hostile_scheme_resistance_mult` modifiers
- Moved opinion modifier (`disapproves_skaa_mercy`) to `common/opinion_modifiers/`
- Fixed all doctrine keys to match CK3 1.18 (`doctrine_monogamy`, gender-split adultery, `doctrine_theocracy_lay_clergy`, etc.)
- Fixed tenet keys (`tenet_legalism`, `tenet_religious_legal_pronouncements`, `tenet_unrelenting_faith`)
- Removed invalid `reformed_icon` from non-pagan faiths
- Created missing `rf_scadrial` religion family definition
- Fixed holy site `is_active` from block to value syntax
- Fixed `has_modifier`/`add_modifier` → `has_character_modifier`/`add_character_modifier` in events and on_actions
- Moved bookmarks to `common/bookmarks/bookmarks/` subdirectory (CK3 1.18 path)
- Removed no-op `ai_primary_priority` block from empire title
- Moved `cultural_acceptance_gain_mult` to `culture_modifier` block in Terris tradition
- Removed invalid `index` fields from all trait files (CK3 1.18 auto-assigns indices)
- Fixed `opposite` → `opposites` keyword on allomantic strength traits
- Fixed decision `picture` to use `reference` block syntax
- Changed deprecated `beautiful` trait to `beauty_good_3` on characters
- Removed redundant `male = yes` from character history (CK3 defaults to male)
- Game crash on load caused by `@#` comment prefix in mod files
- Game crash caused by missing `ethnicities` block on all three cultures
- Cultures not appearing in-game due to empty pillar definitions (heritage and language missing required `type`, `is_shown`, and `ai_will_do` fields)
- Stray province errors from map cleaner due to invalid province IDs

### Changed
- Expanded MASTERPLAN scope: added education, legacies, governments, factions, vassal contracts, secrets, court types, and portrait modifiers
- Expanded MASTERPLAN scope: added council, religion, caste, innovation, and holy order systems
- Standardized post-endgame flag to `lord_ruler_fallen` across all milestone docs
- Expanded MASTERPLAN scope: added metal supply, artifacts, lifestyles, and activities across milestones
- Added Royal Court DLC as a dependency
- Bumped supported CK3 version from 1.12 to 1.18 (Crane)
- Added Roads to Power DLC as a mod dependency
- Added commit skill instructions to CLAUDE.md
- Renamed mod directory from `mistborn_final_empire` to `lords_of_ash` and mod descriptor to `lords-of-ash.mod`
- Province IDs remapped from placeholders (1-105) to vanilla CK3 provinces centered on Switzerland (Kredik Shaw = Bern)
- Updated review notes to reflect current mod status
- Added missing modifier definitions