Opening Story Quest — DB Build Spec¶

This document is the DB-ready content spec for the opening story quest, based on the narrative structure proposed in docs/copilot/opening-story-assessment-claude-opus-46.md, not on the current five-panel seeded version.

The key change is structural: the opening should be seeded as an 8-panel orientation sequence that tells the official institutional lie first, lets cracks appear visually, and ends at the point of faction selection.

Quest Record¶

Use a single QuestTemplate record with these top-level values:

Field	Value
`Id`	`C0000001-0000-0000-0000-000000000001`
`AssetId`	`7000`
`Name`	`Authorized Orientation`
`Description`	`An eight-panel institutional orientation that introduces the official history of the Aevum Collapse, the Reality Bleed, and the five Houses before faction selection.`
`RealmCount`	`0`
`DifficultyTier`	`0`
`QuestType`	`QuestType.OpeningStory`
`Status`	`ContentStatus.Published`
`LineageId`	`C0000001-0000-0000-0000-000000000001`
`FactionId`	`null`
`SortOrder`	`0`
`RunPresets`	`null`
`AuthoredContent`	`null`
`CompletionReward`	`null`

Design Rules For The Seeded Version¶

These are the constraints that matter when writing the DB payload:

The opening is an orientation briefing, not a documentary.
The opening uses the official institutional account, not the true history.
Kaelen must not be framed as the savior here.
Kaelen's identity must remain hidden; the player should leave with suspicion, not answers.
The Salvari must be treated as an unrecognized maintenance collective, not as a polished fifth House.
The sequence should end at the threshold of faction choice.

Panel Mapping¶

The assessment's recommended production format is 8 illustrated panels:

Layer 1 — Orientation
Layer 2 — The Machine
Layer 3 — The Deviation
Layer 4a — The Silence
Layer 4b — The Flicker
Layer 5 — The Bleed
Layer 6 — The Houses
Layer 7 — The Threshold

Those should map to the current asset files under:

assets/ui/screens/opening-story/

Order	Layer	Heading	Asset Path
1	Layer 1	Orientation	`assets/ui/screens/opening-story/orientation.png`
2	Layer 2	The Machine	`assets/ui/screens/opening-story/the-machine.png`
3	Layer 3	The Deviation	`assets/ui/screens/opening-story/the-deviation.png`
4	Layer 4a	The Silence	`assets/ui/screens/opening-story/the-silence-a.png`
5	Layer 4b	The Flicker	`assets/ui/screens/opening-story/the-silence-b.png`
6	Layer 5	The Bleed	`assets/ui/screens/opening-story/the-bleed.png`
7	Layer 6	The Houses	`assets/ui/screens/opening-story/the-houses.png`
8	Layer 7	The Threshold	`assets/ui/screens/opening-story/the-threshold.png`

Exact StoryPanels Payload¶

Seed StoryPanels with these 8 records.

Panel 1¶

Field	Value
`Order`	`1`
`Heading`	`Orientation`
`NarrativeText`	`Welcome to the EchoSpire.\n\nBefore you proceed to sector assignment, you are required to complete this orientation.\n\nWhat follows is the authorized historical account of the Aevum Collapse and the founding of the Great Houses.\n\nPlease remain in the designated viewing area.`
`ImageAssetPath`	`assets/ui/screens/opening-story/orientation.png`
`AiGenerativeDescription`	`First-person perspective inside a transit arrival corridor of a massive institutional facility. Photorealistic, cinematic, bureaucratic, precise, and uncomfortably institutional. The viewer has just arrived and is being processed by the EchoSpire orientation system. Include an orientation terminal on the left wall and a closed maintenance access panel on the right wall.`

Panel 2¶

Field	Value
`Order`	`2`
`Heading`	`The Machine`
`NarrativeText`	`The Aevum Spire was the gravitational and temporal anchor of the known universe.\n\nMaintained by the Aevum Sentinels, the Spire's cosmic engine attracted and fixed the highest-probability outcome of every event in existence, holding reality to a single stable shape.\n\nWhile the Spire endured, the universe was singular. Consistent. Safe.`
`ImageAssetPath`	`assets/ui/screens/opening-story/the-machine.png`
`AiGenerativeDescription`	`Interior of the Aevum Spire at operational peak, shown from a human-scale interior concourse looking upward through a cathedral-industrial transit atrium. Warm golden conduit, dark basalt, maintenance workers, engineered grandeur, and earned awe. The reverence is for the machine, not for a deity.`

Panel 3¶

Field	Value
`Order`	`3`
`Heading`	`The Deviation`
`NarrativeText`	`The Aevum Spire operated without interruption for millennia.\n\nIts failure was caused by a single unauthorized override of the core safety systems, executed by the Chief of Maintenance Diagnostics: a man named Kaelen.\n\nThe resulting cascade shattered the Spire's gravitational engine and destabilized the dimensional anchor that held reality together.\n\nThe Sentinels contained the damage. The Spire survived. The engine did not.`
`ImageAssetPath`	`assets/ui/screens/opening-story/the-deviation.png`
`AiGenerativeDescription`	`Official commemorative mural of the Aevum Spire core failure. Photorealistic propaganda composition. Kaelen is a small anonymous maintenance figure at the bottom with a pulled emergency lever, while the four founders are rendered above him as heroic saviors containing the catastrophe. The visual hierarchy itself should communicate the lie.`

Panel 4¶

Field	Value
`Order`	`4`
`Heading`	`The Silence`
`NarrativeText`	`Following the Deviation, the Sentinels entered a period of managed stabilization.\n\nThe damaged core was sealed. The surviving leadership coordinated containment efforts across all sectors. Public access to the core was restricted for safety.\n\nThis period lasted approximately one hundred years.`
`ImageAssetPath`	`assets/ui/screens/opening-story/the-silence-a.png`
`AiGenerativeDescription`	`Wide interior shot of the post-Deviation Spire under institutional lockdown. Cold retrofitted lighting, darkened conduit veins, processing checkpoints, administrative masks, sealed blast doors, barriers, and bureaucratic suppression. This is what a successful cover-up looks like when it becomes infrastructure.`

Panel 5¶

Field	Value
`Order`	`5`
`Heading`	`The Flicker`
`NarrativeText`	`The EchoSpire remained habitable. Recovery protocols continued. Sector governance adapted to long-term containment.\n\nDuring orientation, some arrivals report transient environmental distortion events. These do not require response unless instructed otherwise.\n\nPlease remain in the designated viewing area.`
`ImageAssetPath`	`assets/ui/screens/opening-story/the-silence-b.png`
`AiGenerativeDescription`	`Return to the same arrival corridor from the opening, but now a hairline fracture in the wall reveals a parallel version of the corridor overtaken by pale green bioluminescent growth. The institutional corridor remains steady and operational. The wrongness is subtle, ignored, and quietly impossible.`

Panel 6¶

Field	Value
`Order`	`6`
`Heading`	`The Bleed`
`NarrativeText`	`Approximately one hundred years after the Deviation, the containment systems experienced a cascading failure.\n\nAlternate timelines, parallel dimensional states, and temporally displaced environments began manifesting within the Spire's physical structure.\n\nThis phenomenon is ongoing.\n\nIt is designated the Reality Bleed.`
`ImageAssetPath`	`assets/ui/screens/opening-story/the-bleed.png`
`AiGenerativeDescription`	`Grand transit hall torn open by a Reality Rift, with three incompatible realities coexisting in one frame: the original abandoned hall, a submerged version with luminescent data-shards, and a desert-ruin version visible as a double exposure. Photorealistic, overwhelming, beautiful, and structurally wrong.`

Panel 7¶

Field	Value
`Order`	`7`
`Heading`	`The Houses`
`NarrativeText`	In response to the Reality Bleed, the surviving Sentinel leadership reorganized into five autonomous governing bodies.\n\nEach House maintains a stabilized territorial sector within the EchoSpire. Each House offers residency, protection, and purpose to those who accept its governance.\n\nThe Valerii defend structural stability.\nThe Syntacta pursue systemic order.\nThe Aethari refine and trade dimensional resources.\nThe Annalis preserve the continuity of verified history.\nThe Salvari are classified as a decentralized maintenance collective operating outside House jurisdiction.
`ImageAssetPath`	`assets/ui/screens/opening-story/the-houses.png`
`AiGenerativeDescription`	`A five-part official orientation composition: monumental Valerii fortress gate, clinical Syntacta threshold, opulent Aethari exchange hall, funerary Annalis archive corridor, and instead of a faction portrait for the Salvari, only a small maintenance access panel in a grey wall with warm light leaking through. Four recruitment images and one omission.`

Panel 8¶

Field	Value
`Order`	`8`
`Heading`	`The Threshold`
`NarrativeText`	`This concludes the authorized orientation.\n\nBeyond the observation gallery, you will enter the EchoSpire common zone.\n\nYour House affiliation selection will determine your sector assignment, your commanding authority, and your operational mandate.\n\nChoose carefully. Reassignment is not guaranteed.`
`ImageAssetPath`	`assets/ui/screens/opening-story/the-threshold.png`
`AiGenerativeDescription`	`Wide shot from behind a player silhouette at the threshold between the clean institutional corridor and the vast damaged interior of the living EchoSpire. Show the visible borders of the four recognized factions, common-zone life, Rift damage, a wrong sky, and a slightly open maintenance panel with a ring of keys resting on its lip.`

Recommended Seeder Shape¶

If you want to update the seeded record in code, the current CreateOpeningStoryQuest() implementation in src/EchoSpire.API/Data/GameDataSeeder.cs should be replaced conceptually with this shape:

public static QuestTemplate CreateOpeningStoryQuest() =>
   new()
   {
      Id = OpeningStoryQuestId,
      AssetId = 7000,
      Name = "Authorized Orientation",
      Description = "An eight-panel institutional orientation that introduces the official history of the Aevum Collapse, the Reality Bleed, and the five Houses before faction selection.",
      RealmCount = 0,
      DifficultyTier = 0,
      QuestType = QuestType.OpeningStory,
      Status = ContentStatus.Published,
      LineageId = OpeningStoryQuestId,
      StoryPanels =
      [
         // 8 panels from the table above
      ],
   };

What Should Change From The Current Seed¶

The currently seeded version should not be treated as the desired content target.

Replace these assumptions:

Replace the current 5-act structure with the 8-layer structure above.
Replace The Shattered Engine as the player-facing quest title with Authorized Orientation.
Replace the true-history framing with the institutional cover-story framing.
Replace the existing act-1.png through act-5.png asset mapping with the root assets now present in the opening-story folder.
Replace the explicit heroic framing of Kaelen as the savior with the official accusation that he caused the failure.
Replace the current faction-neutral Houses beat with the asymmetrical version where the Salvari are intentionally not treated as a proper House.

Canon-Safety Notes¶

This DB content is intentionally incomplete and institutionally biased. That is correct.

The opening should not reveal that Kaelen saved existence.
The opening should not reveal that the Custodian is Kaelen.
The opening should not explain the four simultaneous founder commands.
The opening should present those truths only as hints embedded in visual detail.

That is the point of this version: players should enter faction selection believing the official story, while attentive players notice that something about the official story does not fit.