jpmschweitzer/lords-of-ash
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(events): add flavor events registry and update asset/milestone plans

Browse Source 
Create docs/events-registry.md cataloging ~112 proposed flavor events:
- Part A: 17 extensions to existing event chains
- Part B: 32 chain steps across 7 new multi-event arcs
- Part C: 63 one-shot events including 8 artifact acquisition events

Update M7 milestone with task group 7.14 referencing the registry.
Update REQUIRED_ASSETS.md with 21 new modifier icons and 8 new event
backgrounds needed for the flavor events expansion (~53 total modifiers,
16 total event backgrounds).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
jpmschweitzer
2026-02-08 09:19:10 +01:00
co-authored by Claude Opus 4.6
parent 988e752204
commit 2516cc08e3
3 changed files with 506 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/REQUIRED_ASSETS.md
+65 -19
View File
@@ -8,14 +8,14 @@
| Category | Count | Format | First Needed |
|---|---|---|---|
| Trait icons | ~26 | DDS (uncompressed ARGB), 120x120 | M8 |
| Modifier icons | ~20 | DDS (uncompressed ARGB), 60x60 | M4/M8 |
| Modifier icons | ~53 | DDS (uncompressed ARGB), 60x60 | M4/M8 |
| Decision illustrations | ~10 | DDS (DXT1), 1100x440 | M8 |
| Loading screens | 3-5 | DDS (DXT1), 3840x2160 | M8 |
| Bookmark art | 6 | DDS (DXT1/DXT5), 1920x1080 + UI sizes | M8 |
| Coat of Arms emblems | 12-15 | DDS (uncompressed ARGB), 128x128 | M3/M8 |
| Religion icons | 4-5 | DDS (uncompressed ARGB), 100x100 | M3/M8 |
| Men-at-Arms icons | 5 | DDS (DXT5), 60x60 | M8 |
| Event scene backgrounds | 8 | DDS, 1592x848 | M4/M8 |
| Event scene backgrounds | 16 | DDS, 1592x848 | M4/M8 |
| Custom map files | 20+ | PNG/BMP/DDS/CSV (see specs) | M8 |
| Portrait assets | varies | DDS (DXT5), 1024x1024 | M8 |
| Building icons | 5 | DDS (ARGB 32bpp), 60x60 | M3/M8 |
@@ -25,13 +25,13 @@
| Bookmark art | 6 | DDS (DXT1/DXT5), various | M8 |
| Frontend art (optional) | 2 | DDS (DXT1), 3840x2160 | M8 |
| Workshop thumbnail | 1 | PNG, 512x512 | M8 |
| **Total unique assets** | **~200+** | | |
| **Total unique assets** | **~230+** | | |
### Current State: **0 assets exist**
### Current State
The mod references 50+ icon paths in code (traits, modifiers, decisions) but the
`gfx/` directory does not exist. All culture graphics fall back to vanilla
`western_*_gfx` packs. No custom map data exists.
Completed: 26 trait icons, 21 modifier icons, 5 loading screens, 1 bookmark
background. Remaining ~175+ assets still needed. All culture graphics fall back
to vanilla `western_*_gfx` packs. No custom map data exists.
---
@@ -328,6 +328,19 @@ Custom event themes so events don't use vanilla European backdrops. Vanilla has
| `mistborn_battlefield.dds` | DDS | 1592x848 | Battle scene with Koloss, ash |
| `mistborn_mists.dds` | DDS | 1592x848 | Dense mist scene, mysterious |
**Flavor event backgrounds** (needed for M7 task 7.14 — see `docs/events-registry.md`):
| Asset | Format | Resolution | Description |
|---|---|---|---|
| `mistborn_underground.dds` | DDS | 1592x848 | Secret resistance hideout, torchlit underground passage |
| `mistborn_fighting_pit.dds` | DDS | 1592x848 | Underground fighting arena, crowd, torchlight, blood |
| `mistborn_ruins.dds` | DDS | 1592x848 | Pre-Ascension ruins deep underground, alien metalwork |
| `mistborn_plantation.dds` | DDS | 1592x848 | Skaa plantation, ash-covered fields, overseers |
| `mistborn_private_chamber.dds` | DDS | 1592x848 | Noble private study, candlelight, intimate setting |
| `mistborn_market.dds` | DDS | 1592x848 | Trade district or black market, shadowy stalls |
| `mistborn_ashmount_close.dds` | DDS | 1592x848 | Volcanic eruption close-up, glowing lava and ash |
| `mistborn_clear_night.dds` | DDS | 1592x848 | Rare clear night sky with stars — eerie absence of mist |
**Event background definitions** go in `common/event_backgrounds/`:
```
mistborn_court_background = {
@@ -351,7 +364,7 @@ Events reference themes via `theme = mistborn_court_theme`.
**Event type icons** (optional): `gfx/interface/icons/event_types/` — 148x148 DDS
**Count: 8 scene backgrounds + definition files**
**Count: 16 scene backgrounds + definition files**
---
@@ -428,6 +441,39 @@ New decisions from M7 event arcs:
**Count: 3 illustrations**
### 7c. Flavor Event Modifier Icons
New modifiers introduced by the flavor events expansion (task 7.14 — see
`docs/events-registry.md` for full event catalog).
**Directory:** `gfx/interface/icons/modifiers/`
| Asset | Format | Resolution | Description |
|---|---|---|---|
| `modifier_underground_network.dds` | DDS (ARGB 32bpp) | 60x60 | Skaa resistance network — hidden tunnels |
| `modifier_keeper_advisor.dds` | DDS (ARGB 32bpp) | 60x60 | Terris Keeper serving as advisor — metalmind glow |
| `modifier_pewter_gate_champion.dds` | DDS (ARGB 32bpp) | 60x60 | Fighting pit champion — fist and laurel |
| `modifier_mist_scholar.dds` | DDS (ARGB 32bpp) | 60x60 | Scholar studying mist behavior — book and swirl |
| `modifier_mist_warden.dds` | DDS (ARGB 32bpp) | 60x60 | Guardian against mist threats — shield and mist |
| `modifier_mist_denier.dds` | DDS (ARGB 32bpp) | 60x60 | Willful ignorance of mist changes — closed eye |
| `modifier_ruin_pact.dds` | DDS (ARGB 32bpp) | 60x60 | Accepted Ruin's bargain — dark handshake |
| `modifier_ministry_insider.dds` | DDS (ARGB 32bpp) | 60x60 | Obligator informant — Ministry sigil with whisper |
| `modifier_combat_veteran.dds` | DDS (ARGB 32bpp) | 60x60 | Survived the pewter gate — scarred knuckles |
| `modifier_underground_contacts.dds` | DDS (ARGB 32bpp) | 60x60 | Underworld connections — shadowed handshake |
| `modifier_house_rivalry.dds` | DDS (ARGB 32bpp) | 60x60 | Active feud with another house — crossed crests |
| `modifier_cautious_ruler.dds` | DDS (ARGB 32bpp) | 60x60 | Learned caution from Lord Ruler attention — wary eye |
| `modifier_defiant_confidence.dds` | DDS (ARGB 32bpp) | 60x60 | Hardened by defying the Lord Ruler — raised chin |
| `modifier_paranoid_ruler.dds` | DDS (ARGB 32bpp) | 60x60 | Paranoia from attention experience — fractured mirror |
| `modifier_mist_sickness.dds` | DDS (ARGB 32bpp) | 60x60 | Province: mist sickness outbreak — sick figure in fog |
| `modifier_ashfall_crisis.dds` | DDS (ARGB 32bpp) | 60x60 | Province: severe ashfall — buried buildings |
| `modifier_metal_shortage.dds` | DDS (ARGB 32bpp) | 60x60 | Metal supply disrupted — empty scales |
| `modifier_skaa_loyalty.dds` | DDS (ARGB 32bpp) | 60x60 | Skaa population supportive — clasped hands |
| `modifier_skaa_resentment.dds` | DDS (ARGB 32bpp) | 60x60 | Skaa population hostile — clenched fist |
| `modifier_double_agent.dds` | DDS (ARGB 32bpp) | 60x60 | Running a turned spy — two-faced mask |
| `modifier_artifact_corruption.dds` | DDS (ARGB 32bpp) | 60x60 | Ruin-tainted artifact — cracked relic with red glow |
**Count: 21 icons**
---
## M8: The Art of Metals
@@ -646,9 +692,9 @@ Every modifier needs a unique icon. Several currently share placeholder paths.
| `modifier_duel_veteran.dds` | DDS (ARGB 32bpp) | 60x60 | Crossed coin and sword (also in M7) |
| `modifier_atium_contract_holder.dds` | DDS (ARGB 32bpp) | 60x60 | Atium geode with scroll (also in M7) |
(Plus 8 more from M7 — see M7 section above.)
(Plus 12 from M7a and 21 from M7c — see M7 sections above.)
**Count: ~20 base + 12 from M7 = ~32 total modifier icons**
**Count: ~20 base + 12 from M7a + 21 from M7c = ~53 total modifier icons**
> **Note:** Many of these are listed in both the milestone where they're first
> referenced in code (M4/M6/M7) and here in M8 where they're physically created.
@@ -815,11 +861,11 @@ Placed at `lords_of_ash/thumbnail.png`.
| **M1** | 0 | 0 | — |
| **M2** | 0 | 0 | — |
| **M3** | 0 (23 optional) | 0 (23) | CoA emblems, religion icons, building icons |
| **M4** | 0 (90+ optional) | 0 (113+) | Province modifier icons, CB icons, scheme icons, lifestyle assets (~45+), activity assets (~16+), event backgrounds (8) |
| **M5** | 0 | 0 (105) | DNA strings only |
| **M6** | 0 (1 optional) | 0 (106) | 1 modifier icon |
| **M7** | 0 (15 optional) | 0 (121) | 12 modifier icons, 3 decision illustrations |
| **M8** | ~200+ | ~200+ | Everything — map (20+), all icons, loading screens, bookmark (6), portraits, thumbnail |
| **M4** | 0 (98+ optional) | 0 (121+) | Province modifier icons, CB icons, scheme icons, lifestyle assets (~45+), activity assets (~16+), event backgrounds (16) |
| **M5** | 0 | 0 (121+) | DNA strings only |
| **M6** | 0 (1 optional) | 0 (122+) | 1 modifier icon |
| **M7** | 0 (36 optional) | 0 (158+) | 33 modifier icons (12 existing + 21 flavor events), 3 decision illustrations |
| **M8** | ~230+ | ~230+ | Everything — map (20+), all icons, loading screens, bookmark (6), portraits, thumbnail |
> **Strategy:** All visual assets can be deferred to M8 without breaking
> functionality. Icons show as blank/missing-texture in earlier milestones, which
@@ -847,11 +893,11 @@ quality.
### Priority 4 — Decision illustrations (M8.5, ~12 images)
Visible whenever players interact with decisions. Moderate effort, high return.
### Priority 5 — Modifier icons (M8.5, ~32 icons)
### Priority 5 — Modifier icons (M8.5, ~53 icons)
Visible in tooltips and character modifiers. Important but can survive as
placeholders longer.
### Priority 6 — Event backgrounds (M4f, 8 images)
### Priority 6 — Event backgrounds (M4f, 16 images)
Replace vanilla European backdrops. High immersion value for events.
### Priority 7 — Lifestyle assets (M4d, ~45+ assets)
@@ -915,7 +961,7 @@ lords_of_ash/
│ │ │ ├── lifestyle_tree_backgrounds/ # ~15 tree bgs (348x812)
│ │ │ ├── lifestyles/ # 5 lifestyle strips (480x160)
│ │ │ ├── lifestyles_perks/ # perk nodes (180x60)
│ │ │ ├── modifiers/ # ~32 modifier icons (60x60)
│ │ │ ├── modifiers/ # ~53 modifier icons (60x60)
│ │ │ ├── regiments/ # 5 MaA icons
│ │ │ ├── scheme_types/ # 2 scheme icons (120x120)
│ │ │ └── traits/ # 26 trait icons (120x120)
@@ -923,7 +969,7 @@ lords_of_ash/
│ │ ├── activity_header_backgrounds/ # activity headers (1100x440)
│ │ ├── activity_types/ # activity sidebars (460x1100)
│ │ ├── decisions/ # ~12 decision illustrations (1100x440)
│ │ ├── event_scenes/ # 8 event backgrounds (1592x848)
│ │ ├── event_scenes/ # 16 event backgrounds (1592x848)
│ │ ├── frontend/ # 2 optional (menu bg, pause bg; 4K)
│ │ ├── lifestyles_background/ # 5 lifestyle sidebars (608x1552)
│ │ └── loading_screens/ # 3-5 loading screens (4K) + settings
docs/events-registry.md
+354
View File
@@ -0,0 +1,354 @@
# Flavor Events Registry
> Central catalog of all proposed flavor events — extensions to existing chains,
> new multi-event arcs, standalone one-shots, and artifact events. Referenced
> from the milestone plan (M7 task 7.14).
>
> **Status:** Proposed. None implemented yet.
---
## Part A: Extensions to Existing Events
Existing events that end abruptly, set flags nothing checks, or resolve drama
in a single beat. These add follow-up events to close narrative gaps.
### A1. Snapping Aftermath
| ID | Title | Follows | Summary |
|---|---|---|---|
| `mistborn_snapping.0005` | Failed Snapping Shame | .0001 failure | Child faces family disappointment. Stress, opinion with parent. Sets up emotional stakes for late snapping. |
| `mistborn_snapping.0021` | The Weight of Power | .0020 success | New Allomancer grapples with their power. Trait-specific flavor (Coinshot hurts someone, Soother realizes they manipulate). |
| `mistborn_snapping.0011` | Forced Snapping Scars | .0010 injury | Years later the child confronts the parent. Forgive, resent, or intimidate. Real relationship consequences. |
### A2. Ball Consequences
| ID | Title | Follows | Summary |
|---|---|---|---|
| `mistborn_ball.0011` | The Rival's Counteroffer | .0010 any | Rival responds to ball maneuvering — marriage proposal, veiled threat, or genuine alliance. |
| `mistborn_ball.0021` | The Heretic's Choice | .0020.c success | Discovered Survivorist approaches you weeks later. Convert you, beg mercy, or offer intel for silence. |
| `mistborn_ball.0031` | Mistborn Revealed | .0030.c flag | Resolves `mistborn_revealed_at_ball` flag — marriage proposals, Ministry inquiry, rival challenge. |
### A3. Lord Ruler Attention Beats
| ID | Title | Follows | Summary |
|---|---|---|---|
| `mistborn_lord_ruler.0002` | The Obligator Returns | .0001.c refuse | 1-2 years later, the obligator comes back with friends. Options narrower, tone harder. |
| `mistborn_lord_ruler.0012` | Inquisitor Battle Aftermath | .0010.c survival | Word spreads you survived Inquisitors. Hero to some, dead man walking to others. Point of no return. |
| `mistborn_lord_ruler.0031` | Regained Obscurity | .0030 decay to 0 | Relief when attention drops from high. Choose lasting modifier: caution, paranoia, or defiance. |
### A4. Kandra Returns
| ID | Title | Follows | Summary |
|---|---|---|---|
| `mistborn_misc.0002` | Kandra Reports | .0001.a flag | Kandra returns from infiltration with intelligence. Three tiers of intel quality. Each secret creates a decision. |
| `mistborn_misc.0005` | The Kandra's Price | .0002 | The kandra wants something in return — access, protection, information. Refusing damages all kandra relations. |
### A5. Ruin's Deepening Corruption
| ID | Title | Follows | Summary |
|---|---|---|---|
| `mistborn_hemalurgy.0040` | Ruin's Proposition | .0020 repeated | After multiple whispers, Ruin offers concrete knowledge. Real and valuable — but each acceptance deepens the hold. |
| `mistborn_hemalurgy.0041` | The Puppet Realizes | .0040 high influence | You did something you don't remember. A letter sent. A door unlocked. Fight Ruin (stress, possible trait loss) or accept (power, loss of self). |
### A6. Skaa Allomancer Integration
| ID | Title | Follows | Summary |
|---|---|---|---|
| `mistborn_skaa_allomancer.0003` | Loyalty Test | .0001 any | Ministry inspector probes. Prior recruitment method (kind vs. coerced) affects odds. Failure means exposure. |
| `mistborn_skaa_allomancer.0005` | The Double Life | .0003 success | Skaa Allomancer asks to help their people. Support risks exposure. Refusing breeds resentment and eventual betrayal. |
### A7. Hemalurgy Consequences
| ID | Title | Follows | Summary |
|---|---|---|---|
| `mistborn_hemalurgy.0002` | Someone Knows | .0001.a | A courtier saw the spike creation. Bribe, threaten, kill, or confess. Witness becomes co-conspirator or bomb. |
| `mistborn_hemalurgy.0011` | The Inquisitor Awakens | .0010 transform | First experience of Inquisitor senses. See Allomantic pulses, hear Ruin, people recoil. Humanity traded for power. |
---
## Part B: New Event Chains
Multi-event arcs that fire during normal gameplay. Each has escalating stakes,
branching paths, and meaningful consequences.
### B1. The Underground Connection (6 events)
**Trigger:** Own skaa-populated lands, intrigue 12+
| # | ID | Title | Summary |
|---|---|---|---|
| 1 | `mistborn_underground.0001` | Discovery | Find evidence of a skaa resistance cell — burned messages, hidden symbols. |
| 2 | `mistborn_underground.0002` | First Contact | Meet the rebel leader. Suspicious but desperate. Needs supplies or safe house. |
| 3 | `mistborn_underground.0003` | Deepening Involvement | Smuggling weapons, forging documents, hiding fugitives. Each step escalates Ministry detection risk. |
| 4 | `mistborn_underground.0004` | The Informant | Someone in your household reports to the Ministry. Identify and deal with them before the inspection. Tineye/Seeker helps. |
| 5 | `mistborn_underground.0005` | The Reckoning | Ministry arrives in force. Prior choices determine survival. Well-prepared: cell scatters. Unprepared: people die, you're implicated. |
| 6 | `mistborn_underground.0006` | Aftermath | Survived: loyal skaa network modifier, hidden Allomancer recruits. Exposed: Lord Ruler attention spike, title loss risk. |
### B2. The Keeper's Burden (5 events)
**Trigger:** Have a Terris courtier, or hold Terris lands
| # | ID | Title | Summary |
|---|---|---|---|
| 1 | `mistborn_keeper.0001` | The Confession | Your Terris steward reveals they're a Keeper storing forbidden knowledge. They need protection. |
| 2 | `mistborn_keeper.0002` | The Inspection | Ministry audit. Hide your Keeper: secret room, falsified records, bribe. Each path has different failure modes. |
| 3 | `mistborn_keeper.0003` | The Network | Keeper contacts others. Attend secret meeting (risky, reveals lore) or stay distant (safer, learn less). |
| 4 | `mistborn_keeper.0004` | The Betrayal | Informant sells out the network. Hours to act: evacuate, destroy evidence, or fight. Keeper caught = knowledge lost. |
| 5 | `mistborn_keeper.0005` | Resolution | Saved: devoted advisor (learning +4, piety). Final secret about the prophecy. Lost: guilt modifier, partial coppermind survives. |
### B3. The Pewter Gate Circuit (5 events)
**Trigger:** Have a Thug or Mistborn in court, martial 14+
| # | ID | Title | Summary |
|---|---|---|---|
| 1 | `mistborn_pewtergate.0001` | The Invitation | Hear of underground Allomantic fighting pits. Entry costs gold. Brutal and illegal. |
| 2 | `mistborn_pewtergate.0002` | First Bout | Straightforward Thug vs Thug. Prowess check. Win: gold + underground prestige. Lose: injury + shame. |
| 3 | `mistborn_pewtergate.0003` | The Stakes Rise | Organizers want Mistborn vs Mistborn. Prize is atium. Opponent is a killer. "People don't always walk out." |
| 4 | `mistborn_pewtergate.0004` | The Setup | Match is rigged. Inquisitor in the crowd. This was a trap to ID hidden Allomancers. Fight or talk your way out. |
| 5 | `mistborn_pewtergate.0005` | Aftermath | Escaped: combat veteran modifier, contacts, gold. Identified: Ministry attention, imprisonment. Fighter died: grief, vengeance. |
### B4. The Mists Change (4 events)
**Trigger:** Any ruler, after year 3, low random weight
| # | ID | Title | Summary |
|---|---|---|---|
| 1 | `mistborn_mistchange.0001` | Strange Reports | Peasants say mists stay later, move against wind. A worker came back speaking an unknown language. |
| 2 | `mistborn_mistchange.0002` | It's Not Superstition | Tineye confirms it. Mists carry faint non-Allomantic pulses. Animals act erratically. Investigate or seal gates? |
| 3 | `mistborn_mistchange.0003` | The Mist-Touched | Find someone changed by the mists — Allomantic abilities without noble blood. Study, hide, or report? |
| 4 | `mistborn_mistchange.0004` | Understanding | Cosmic truth fragment. Mists are Preservation's body. Choose modifier: Mist Scholar, Mist Warden, or Mist Denier. |
### B5. A Flower in the Ash (3 events)
**Trigger:** Stress > 50 or compassionate/just trait
| # | ID | Title | Summary |
|---|---|---|---|
| 1 | `mistborn_flower.0001` | The Impossible Thing | A flower growing in ash. Or a pre-Ascension painting. Something beautiful in a world that forgot beauty. |
| 2 | `mistborn_flower.0002` | Others Want It | Rival wants it as trophy. Ministry wants it destroyed. Skaa elder weeps and calls it a sign. Choose who gets it. |
| 3 | `mistborn_flower.0003` | What It Means | Kept: stress relief but guilt. Shared with skaa: hope modifier, Ministry suspicion. Given to Ministry: favor, hollow feeling. |
### B6. House Rivalry Escalation (5 events)
**Trigger:** Negative opinion with another Great House
| # | ID | Title | Summary |
|---|---|---|---|
| 1 | `mistborn_rivalry.0001` | The Slight | Small start: trade dispute, ball insult, border issue. Both sides feel justified. |
| 2 | `mistborn_rivalry.0002` | Spy Games | Catch their agent or yours is caught. Exchange prisoners (diplomatic), execute (aggressive), turn double agent (intrigue). |
| 3 | `mistborn_rivalry.0003` | Sabotage | Poisoned metal supplies, burned crops, rumors about bloodline purity. Retaliate or absorb? |
| 4 | `mistborn_rivalry.0004` | The Knife's Edge | Open conflict looms. Intermediary offers terms that favor your rival. Accept humiliation or prepare for war? |
| 5 | `mistborn_rivalry.0005` | Resolution | War: battle, territory, lasting enmity. Diplomacy: marriage/trade but shown weakness. Intrigue: assassination but coalition against you. |
### B7. The Obligator's Doubt (4 events)
**Trigger:** Have an obligator in domain, diplomacy 14+
| # | ID | Title | Summary |
|---|---|---|---|
| 1 | `mistborn_obligator.0001` | A Small Mercy | Local obligator looks the other way on a minor infraction. Strange behavior. |
| 2 | `mistborn_obligator.0002` | The Confidence | They confide doubts about the Ministry. Encourage their doubt, exploit it, or report them? |
| 3 | `mistborn_obligator.0003` | The Test | Ministry audit. Your obligator must pass a loyalty review. Help them or let them burn? |
| 4 | `mistborn_obligator.0004` | Resolution | Survived: Ministry insider (intelligence, reduced attention). Caught: they name you. Reported: Ministry favor, guilt. |
---
## Part C: One-Shot Flavor Events
Standalone events that fire during normal gameplay. No chain — single event
with 2-3 meaningful choices.
### Noble Life (10 events)
| ID | Title | Summary |
|---|---|---|
| `mistborn_noble.0001` | The Dueling Canes | Rival challenges you to formal cane duel at a ball. Win/lose/refuse each has consequences. |
| `mistborn_noble.0002` | The Heir's Rebellion | Your heir refuses obligator schooling, claims Ministry is corrupt. Discipline, allow, or agree? |
| `mistborn_noble.0003` | The Marriage Offer | Lesser house offers their Allomancer child in marriage. Strong bloodline but disgraced house. |
| `mistborn_noble.0004` | Poison at the Table | Someone contaminated your metal vials. Tineye noticed. Three suspects, pick wrong and they try again. |
| `mistborn_noble.0005` | The Bastard's Claim | Skaa appears claiming to be your illegitimate relative. Shows allomantic potential. Acknowledge, deny, or quietly take in? |
| `mistborn_noble.0006` | Ashfall Festival | Nobles want to host a traditional celebration. Sponsor lavishly, attend modestly, or ban as wasteful? |
| `mistborn_noble.0007` | The Forged Will | Deceased vassal's will altered — forgery benefits you. Accept, expose, or blackmail the forger? |
| `mistborn_noble.0008` | The Uncomfortable Truth | Spymaster reveals skaa ancestry in your spouse's bloodline. Stronger allomantic potential, but ruin if public. |
| `mistborn_noble.0009` | The Empty Seat | Vassal absent from court for a year, building fortifications. Investigate, ignore, or threaten? |
| `mistborn_noble.0010` | The Vintage | Cellar contains pre-Ascension wine — impossibly old. Collector, Ministry, and scholar all want it. |
### Allomantic Moments (10 events)
| ID | Title | Summary |
|---|---|---|
| `mistborn_allomantic.0001` | Burning Instinct | Allomancy activates reflexively in danger. Witnesses saw. Silence, bribe, or trust them? |
| `mistborn_allomantic.0002` | The Coppercloud Gap | Your Smoker falls ill. Three days of exposure. Hire replacement, hide everyone, or risk it? |
| `mistborn_allomantic.0003` | Tin Overload | Tineye burns too much tin during a storm. Overwhelmed and incapacitated. Help, dismiss, or study? |
| `mistborn_allomantic.0004` | The Allomantic Echo | Seeker detects Allomancy but no one is burning. Hidden metalminds or a spy? Two investigation paths. |
| `mistborn_allomantic.0005` | Coinshot Accident | Young Coinshot kills bystander during training. Cover up, face justice, or use as teaching moment? |
| `mistborn_allomantic.0006` | The Metal Allergy | Allomancer ingests unknown metal — violent illness. Might be a new allomantic metal. Investigate or destroy? |
| `mistborn_allomantic.0007` | Manipulation Discovered | Courtier realizes your Soother has calmed them in negotiations for years. Furious. Apologize, deny, or double down? |
| `mistborn_allomantic.0008` | The Iron Pull | Lurcher pulls a metal object through a wall, reveals hidden chamber. Old documents, metal cache, or something worse. |
| `mistborn_allomantic.0009` | Atium Flicker | Oracle sees a vision of your death in atium shadows. Change behavior (paranoia), dismiss (fate), or embrace (courage)? |
| `mistborn_allomantic.0010` | The Unburnable Metal | Allomancer swallows a metal that won't burn. Might be aluminum — erases reserves. Weaponize, trade, or study? |
### Steel Ministry Encounters (8 events)
| ID | Title | Summary |
|---|---|---|
| `mistborn_ministry.0001` | Census Day | Annual census. Routine unless you're hiding something. Each hidden person is a detection risk. |
| `mistborn_ministry.0002` | The Canton's Request | Canton of Inquisition wants to station an Inquisitor "for your protection." Refuse, accept, or negotiate terms? |
| `mistborn_ministry.0003` | Obligator Corruption | Catch an obligator taking bribes from your rival. Report, join the scheme, or leverage quietly? |
| `mistborn_ministry.0004` | The Sermon | Ministry preacher declares Allomantic bloodlines must be preserved. Skaa seethe, nobles nod. Endorse, stay silent, or undermine? |
| `mistborn_ministry.0005` | The Inquisitor's Question | Inquisitor asks directly: "Do you know any Feruchemists?" Lie, tell truth, or deflect — all dangerous. |
| `mistborn_ministry.0006` | Tithing Dispute | Ministry claims you underpaid atium tithe. Records wrong — or deliberately altered. Fight, pay, or investigate? |
| `mistborn_ministry.0007` | The Converted | A courtier genuinely converts to Ministry faith. Wants to become an obligator. Losing them weakens your court. |
| `mistborn_ministry.0008` | Ministry Archives | Legitimate access to Ministry records. Spot something you shouldn't: execution lists, hidden registries. Copy, memorize, or ignore? |
### Skaa & The Lower Classes (8 events)
| ID | Title | Summary |
|---|---|---|
| `mistborn_skaa.0011` | The Starving District | Ash blight ruins crops. Feed them (gold, loyalty), ignore (unrest), or conscript healthy ones (efficient, cruel)? |
| `mistborn_skaa.0012` | Skaa Art | Secret art: songs, carvings, stories. Beautiful and illegal. Protect (risky, loved), destroy (safe, hated), or collect privately? |
| `mistborn_skaa.0013` | The Runaway | Skaa servant flees — knows your secrets. Hunt (brutal), let go (merciful, dangerous), or send Soother (kind manipulation)? |
| `mistborn_skaa.0014` | Plantation Uprising | Workers stop working. A Thug protects them. Negotiate, send Hazekillers, or meet the Thug personally? |
| `mistborn_skaa.0015` | The Skaa Healer | Woman with uncanny healing — Feruchemist or just skilled? Protect, report, or recruit? |
| `mistborn_skaa.0016` | Half-breed Child | Noble fathered child with skaa. Shows allomantic potential. By law, child should die. Intervene? |
| `mistborn_skaa.0017` | The Informant Network | Skaa offers to sell intelligence from rival house. Good intel but if caught, Ministry asks why you run skaa agents. |
| `mistborn_skaa.0018` | The Old Skaa | Ancient skaa claims to remember pre-Ascension. Impossible. But some details are oddly specific. Humor, investigate, or dismiss? |
### Environment & Supernatural (8 events)
| ID | Title | Summary |
|---|---|---|
| `mistborn_environ.0001` | Ashfall Intensifies | Heavy ash. Roofs collapse, roads blocked. Protect keep (selfish), send workers (costly, some die), or organize domain response (expensive, loyalty)? |
| `mistborn_environ.0002` | The Ashmount Rumbles | Nearby ashmount shows eruption signs. Evacuate (gold loss, saved), fortify (risky), or do nothing (cheapest, deadliest)? |
| `mistborn_environ.0003` | Mist Sickness | Commoners out in mists fall ill. Some die, others change. Quarantine, study, or blame heresy? |
| `mistborn_environ.0004` | The Night Without Mists | First clear night anyone remembers. People terrified. Keeper goes pale. Something fundamental shifted. Cosmic unease. |
| `mistborn_environ.0005` | Koloss Sighting | Lost koloss band near borders. Avoid (might wander), hunt (glory, casualties), or Soother-control attempt (high risk)? |
| `mistborn_environ.0006` | The Deep Caves | Miners break into pre-Ascension ruins. Strange metalwork, carvings of green world with blue skies. Explore, seal, or report? |
| `mistborn_environ.0007` | The Well Whispers | Near the Well of Ascension — faint rhythmic pulse. Investigate alone (terrifying, lore), send scholars (safer), or wall off? |
| `mistborn_environ.0008` | The Red Sun | Sun turns redder for a week. Crops wilt, mists come early. Obligators preach displeasure. Keeper whispers "Deepness." Province debuff. |
### Economy & Trade (5 events)
| ID | Title | Summary |
|---|---|---|
| `mistborn_trade.0001` | The Metal Shortage | Primary supplier bought out by rival. Find new supplier, raid rival stockpile, or ration? |
| `mistborn_trade.0002` | Black Market Opportunity | Smuggler offers rare metals cheap. Impure metals risk sickness. Buy cheap (risk), premium (safe), or arrest (Ministry favor)? |
| `mistborn_trade.0003` | The Atium Dividend | Larger-than-expected Pits harvest. Fight over your share: aggressive (more, enemies), accept (modest), or trade for favors? |
| `mistborn_trade.0004` | Counterfeit Boxings | Someone mints fake coins. Economy destabilizes. Find counterfeiter, ignore (penalty), or mint your own? |
| `mistborn_trade.0005` | The Trade Caravan | Caravan from Southern Dominance with unusual goods and a sealed chest addressed to no one. Open, deliver, or sell the lot? |
### Artifacts & Items (8 events)
| ID | Title | Summary |
|---|---|---|
| `mistborn_artifact.0050` | The Heirloom Metalmind | Inherit an ancestor's metalmind. It still holds stored attributes — but whose memories are in the coppermind? |
| `mistborn_artifact.0051` | The Corrupted Spike | An acquired hemalurgic spike whispers to you. Ruin's influence is embedded in the metal. Use it (power + corruption) or destroy it (safe, waste)? |
| `mistborn_artifact.0052` | Rival Steals Your Artifact | A prized artifact disappears — and surfaces in a rival's court. Demand return (diplomatic), steal it back (intrigue), or declare it war? |
| `mistborn_artifact.0053` | The Auction | A black market auction offers a legendary item. Other houses are bidding. How high do you go? Outbid risks bankruptcy. Losing risks rival gaining power. |
| `mistborn_artifact.0054` | Artifact Awakens | An artifact you've held for years suddenly activates — glowing, vibrating, warm to the touch. It responds to Allomancy. What is it doing? |
| `mistborn_artifact.0055` | The Forger's Offer | A skilled metalworker claims they can create metalminds for non-Feruchemists. Impossible — or is it? Invest in research (gold, learning), dismiss (safe), or report to Ministry (they're very interested)? |
| `mistborn_artifact.0056` | Grave Goods | Tomb of a pre-Ascension warrior discovered. Contains weapons and metalminds of unknown alloys. Loot it (artifacts, possible curse/attention), study it (learning, slower), or seal it (pious, nothing gained)? |
| `mistborn_artifact.0057` | The Kandra Bones | A kandra offers to sell you a set of True Body bones — their most sacred possession. Immensely valuable. But the other kandra will never forgive the transaction. |
### Personal & Character Moments (6 events)
| ID | Title | Summary |
|---|---|---|
| `mistborn_personal.0001` | The Nightmare | Dream of mists, spikes through your eyes, a voice: "I am free." Seek Keeper counsel (lore), burn tin to stay awake (health), or drink and forget (stress relief, risk)? |
| `mistborn_personal.0002` | The Old Soldier | Veteran Hazekiller aging out. Grant retirement (loyalty, cost), refuse (cruel), or offer training position (mentor modifier)? |
| `mistborn_personal.0003` | The Mirror | See what the Final Empire made you. High stress/cruelty trigger. Double down on ruthlessness or feel something crack? |
| `mistborn_personal.0004` | A Child's Question | Your child asks why the sky is grey. Propaganda answer (safe), honest answer (dangerous truth), or deflect (incurious child)? |
| `mistborn_personal.0005` | The Letter | Anonymous letter with a line from the real Terris prophecy. Keep (flag), burn (safe), or show to obligator (favor, investigation)? |
| `mistborn_personal.0006` | The Good Death | Beloved courtier dies peacefully of old age — remarkable in the Final Empire. Attend funeral (stress relief), memorial ball (prestige), or move on (cold, court notices)? |
---
## Summary
| Category | Count | Type |
|---|---|---|
| A1. Snapping Aftermath | 3 | Extension |
| A2. Ball Consequences | 3 | Extension |
| A3. Lord Ruler Attention Beats | 3 | Extension |
| A4. Kandra Returns | 2 | Extension |
| A5. Ruin's Corruption | 2 | Extension |
| A6. Skaa Allomancer Integration | 2 | Extension |
| A7. Hemalurgy Consequences | 2 | Extension |
| B1. Underground Connection | 6 | Chain |
| B2. Keeper's Burden | 5 | Chain |
| B3. Pewter Gate Circuit | 5 | Chain |
| B4. Mists Change | 4 | Chain |
| B5. Flower in the Ash | 3 | Chain |
| B6. House Rivalry Escalation | 5 | Chain |
| B7. Obligator's Doubt | 4 | Chain |
| C. Noble Life | 10 | One-shot |
| C. Allomantic Moments | 10 | One-shot |
| C. Steel Ministry | 8 | One-shot |
| C. Skaa & Lower Classes | 8 | One-shot |
| C. Environment & Supernatural | 8 | One-shot |
| C. Economy & Trade | 5 | One-shot |
| C. Artifacts & Items | 8 | One-shot |
| C. Personal & Character | 6 | One-shot |
| **Total** | **~112** | |
### New Event Files
| File | Namespaces | Event Count |
|---|---|---|
| `events/flavor_noble_events.txt` | `mistborn_noble` | 10 |
| `events/flavor_allomantic_events.txt` | `mistborn_allomantic` | 10 |
| `events/flavor_ministry_events.txt` | `mistborn_ministry` | 8 |
| `events/flavor_skaa_events.txt` | `mistborn_skaa` (0011+) | 8 |
| `events/flavor_environment_events.txt` | `mistborn_environ` | 8 |
| `events/flavor_trade_events.txt` | `mistborn_trade` | 5 |
| `events/flavor_artifact_events.txt` | `mistborn_artifact` (0050+) | 8 |
| `events/flavor_personal_events.txt` | `mistborn_personal` | 6 |
| `events/underground_events.txt` | `mistborn_underground` | 6 |
| `events/keeper_events.txt` | `mistborn_keeper` | 5 |
| `events/pewtergate_events.txt` | `mistborn_pewtergate` | 5 |
| `events/mistchange_events.txt` | `mistborn_mistchange` | 4 |
| `events/flower_events.txt` | `mistborn_flower` | 3 |
| `events/rivalry_events.txt` | `mistborn_rivalry` | 5 |
| `events/obligator_events.txt` | `mistborn_obligator` | 4 |
| Existing event files (extensions) | Various | 17 |
### New Modifiers Needed
| Modifier | Source | Description |
|---|---|---|
| `modifier_underground_network` | B1 | Skaa resistance network active |
| `modifier_keeper_advisor` | B2 | Keeper serving as advisor |
| `modifier_pewter_gate_champion` | B3 | Fighting pit champion |
| `modifier_mist_scholar` | B4 | Studied the mists' nature |
| `modifier_mist_warden` | B4 | Guards against mist threats |
| `modifier_mist_denier` | B4 | Willfully ignorant of mist changes |
| `modifier_ruin_pact` | A5 | Accepted Ruin's bargain |
| `modifier_ministry_insider` | B7 | Obligator informant in your pocket |
| `modifier_combat_veteran` | B3 | Survived pewter gate circuit |
| `modifier_underground_contacts` | B3 | Underworld connections |
| `modifier_house_rivalry` | B6 | Active feud with another house |
| `modifier_cautious_ruler` | A3 | Learned caution from surviving attention |
| `modifier_defiant_confidence` | A3 | Hardened by defying the Lord Ruler |
| `modifier_paranoid_ruler` | A3 | Paranoid from attention experience |
| `modifier_mist_sickness` | C env | Province: mist sickness outbreak |
| `modifier_ashfall_crisis` | C env | Province: severe ashfall |
| `modifier_metal_shortage` | C trade | Metal supply disrupted |
| `modifier_skaa_loyalty` | C skaa | Skaa population supportive |
| `modifier_skaa_resentment` | C skaa | Skaa population hostile |
| `modifier_double_agent` | B6 | Running a turned spy |
| `modifier_artifact_corruption` | C artifact | Ruin-tainted artifact in possession |
### New Event Backgrounds Needed
| Asset | Resolution | Description |
|---|---|---|
| `mistborn_underground.dds` | 1592x848 | Secret resistance hideout, torchlit underground passage |
| `mistborn_fighting_pit.dds` | 1592x848 | Underground fighting arena, crowd, torchlight, blood |
| `mistborn_ruins.dds` | 1592x848 | Pre-Ascension ruins deep underground, alien metalwork |
| `mistborn_plantation.dds` | 1592x848 | Skaa plantation, ash-covered fields, overseers |
| `mistborn_private_chamber.dds` | 1592x848 | Noble private study, candlelight, intimate setting |
| `mistborn_market.dds` | 1592x848 | Trade district or black market, shadowy stalls |
| `mistborn_ashmount_close.dds` | 1592x848 | Volcanic eruption close-up, glowing lava and ash |
| `mistborn_clear_night.dds` | 1592x848 | Rare clear night sky with stars — eerie absence of mist |
docs/milestones/M7-the-deepness.md
+87 -1
View File
@@ -1033,6 +1033,84 @@ council system as more than a stat screen.
---
### 7.14 -- Flavor Events Expansion
**Context:** The existing event system is mechanics-heavy but narratively thin.
Events resolve in single beats, flags are set but never checked, and dramatic
moments evaporate without consequences. This task group adds ~112 new events:
extensions to existing chains, new multi-event side arcs, standalone one-shots,
and artifact acquisition events. The goal is a world that feels alive between
story beats — continuous sidequests with real payoffs and real risks.
**Full event catalog:** [`docs/events-registry.md`](../events-registry.md)
**Summary:**
| Category | Count | Type |
|---|---|---|
| Extensions to existing events (A1-A7) | 17 | Follow-up events closing narrative gaps |
| New event chains (B1-B7) | 32 | Multi-event arcs with branching outcomes |
| One-shot flavor events (C) | 63 | Standalone events across 8 categories |
| **Total** | **~112** | |
**Steps:**
1. **Extend existing events (Part A).** Add follow-up events to 7 existing
event files. These resolve dangling flags (`mistborn_revealed_at_ball`,
`kandra_infiltrating`, `discovered_skaa_allomancer`) and add narrative
consequences to choices that currently end abruptly. See registry sections
A1-A7 for exact event IDs and which existing events they follow.
2. **Implement new event chains (Part B).** Create 7 new event files for
multi-event arcs:
- `events/underground_events.txt` — The Underground Connection (6 events)
- `events/keeper_events.txt` — The Keeper's Burden (5 events)
- `events/pewtergate_events.txt` — The Pewter Gate Circuit (5 events)
- `events/mistchange_events.txt` — The Mists Change (4 events)
- `events/flower_events.txt` — A Flower in the Ash (3 events)
- `events/rivalry_events.txt` — House Rivalry Escalation (5 events)
- `events/obligator_events.txt` — The Obligator's Doubt (4 events)
3. **Implement one-shot flavor events (Part C).** Create 8 new event files:
- `events/flavor_noble_events.txt` — Noble life (10 events)
- `events/flavor_allomantic_events.txt` — Allomantic moments (10 events)
- `events/flavor_ministry_events.txt` — Steel Ministry encounters (8 events)
- `events/flavor_skaa_events.txt` — Skaa & lower classes (8 events)
- `events/flavor_environment_events.txt` — Environment & supernatural (8 events)
- `events/flavor_trade_events.txt` — Economy & trade (5 events)
- `events/flavor_artifact_events.txt` — Artifacts & items (8 events)
- `events/flavor_personal_events.txt` — Personal & character moments (6 events)
4. **Add new modifiers.** ~21 new modifiers in
`common/modifiers/00_mistborn_modifiers.txt` (see registry for full list).
Key additions: `underground_network`, `keeper_advisor`,
`pewter_gate_champion`, `mist_scholar`, `ministry_insider`,
`house_rivalry`, `ruin_pact`, `artifact_corruption`.
5. **Add on-action hooks.** Wire all new events into
`common/on_action/mistborn_on_actions.txt` with appropriate weight
multipliers. One-shots should use low weights (0.01-0.05). Chain starters
should use moderate weights (0.05-0.15) with cooldown flags.
6. **Add localization.** Estimated ~800-1000 new localization keys across
event titles, descriptions, options, modifier names, and tooltips.
**Files:**
- 7 existing event files — modify (Part A extensions)
- 15 new event files — create (Parts B + C)
- `common/modifiers/00_mistborn_modifiers.txt` — modify (~21 new modifiers)
- `common/on_action/mistborn_on_actions.txt` — modify (new hooks)
- `localization/english/mistborn_events_l_english.yml` — modify (major expansion)
- `localization/english/mistborn_modifiers_l_english.yml` — modify
**References:**
- Full event catalog: `docs/events-registry.md`
- Existing event files: `lords_of_ash/events/` (13 files)
- Existing modifiers: `common/modifiers/00_mistborn_modifiers.txt`
- Art assets needed: `docs/REQUIRED_ASSETS.md` (sections 7c, 4f additions)
---
## Testing Checkpoints
> See [`docs/TESTING.md`](../TESTING.md) for the full testing protocol, debug
@@ -1079,7 +1157,9 @@ council system as more than a stat screen.
Terris Steward with Feruchemist trait — verify Keeper reveal event. Check
`error.log` for council event errors.
- **After 7.13 (Integration):** Full playthrough test: start as Kelsier (Narrative Mode), play through M6 story arcs, then M7 extended arcs, through to the Fall of Kredik Shaw. Verify game rule gating works (Narrative events don't fire in Sandbox). Verify attention system is coherent across all new events. 20-year playthrough with no crashes.
- **After 7.14 (Flavor Events):** Run observer mode for 50 years. Verify one-shot events fire at reasonable frequency (most should fire 0-2 times per decade per ruler). Verify event chains progress correctly (Underground Connection should take 3-5 years to complete). Verify Part A extensions fire after their parent events. Verify new modifiers appear correctly. Verify no event spam from flavor events. Check `error.log` for any event errors. Verify artifact events connect to existing artifact system (M3/M7.10).
- **After 7.13 + 7.14 (Integration):** Full playthrough test: start as Kelsier (Narrative Mode), play through M6 story arcs, then M7 extended arcs, through to the Fall of Kredik Shaw. Verify game rule gating works (Narrative events don't fire in Sandbox). Verify attention system is coherent across all new events. 20-year playthrough with no crashes.
## Acceptance Criteria
@@ -1117,6 +1197,12 @@ council system as more than a stat screen.
- Crew council advanced events fire during M6/M7 story arcs (crew meeting,
role conflict, role evolution)
- ~25 council/court events implemented with full localization
- ~112 flavor events implemented across 15 new event files and 7 existing file extensions (per `docs/events-registry.md`)
- All 7 event chains (Underground Connection, Keeper's Burden, Pewter Gate, Mists Change, Flower in the Ash, House Rivalry, Obligator's Doubt) play through from start to resolution
- All dangling flags from existing events (`mistborn_revealed_at_ball`, `kandra_infiltrating`, `discovered_skaa_allomancer`) are resolved by Part A extension events
- One-shot flavor events fire at appropriate frequencies without spam (0-2 per decade per ruler category)
- ~21 new modifiers defined and referenced by flavor events
- 8 new event backgrounds created for flavor event settings (underground, fighting pit, ruins, plantation, private chamber, market, ashmount, clear night)
- All new modifiers, triggers, and effects are properly defined and referenced
- Localization is complete for all new content (estimated 400-600 new localization keys)
- A complete Narrative Mode playthrough from crew assembly through Fall of Kredik Shaw is possible