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