dazed-mods/worldbox-observer-mod
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
worldbox-observer-mod/docs/life-saga.md
DazedAnon 6fb62c47d6 feat(saga): turn panel into a story card and snap hover restore 
- Drop Evidence stats and Open Lore; keep lens as a quiet eyebrow
- Wrap stake/Cast/Legacy under the portrait; stack Legacy as lines
- End glyph hover immediately without panel-dwell keep-alive
- Re-apply dossier reason/traits/history on exit so the tip does not lag
2026-07-22 03:57:31 -05:00

5.6 KiB
Raw Blame History

Life-saga roster

Dynamic top-10 cast of interesting lives (MCs). Owns the dossier rail and soft camera bias. Chronicle stays a history book and never drives the camera. Short combat/love/war arcs stay in StoryPlanner as chapter beats. Durable observed facts live in LifeSagaMemory and survive roster churn.

Ownership

Concern Owner
Top-10 MCs, diversity, Prefer LifeSagaRoster
Durable observed facts LifeSagaMemory
Adaptive presentation LifeSagaPresentation
Dossier / Saga tabs + hover preview LifeSagaViewController
Saga body UI LifeSagaPanel
Rail icons / Prefer click LifeSagaRail
Camera read-pause lease InterestDirector
Short climax → aftermath → epilogue StoryPlanner (thinned)
Spine under tip StoryPlanner.FormatSpineLabel
Full history Chronicle / Lore

Admission

Live discovery (no tip-string allowlists):

  • Game favorite, king, city leader, kills/renown floors (InterestScoring.IsNotable)
  • Pack alpha, clan chief, army captain, active plot author, founder, species singleton

Standing is recomputed from live roles each refill. Heat comes from chapter stamps / featured tips and decays with idle time. Each slot keeps its original admission reason even when its live role later changes. Hard-arc admissions also retain the arc kind and chapter context that brought the life onto the roster.

Dynamic top-10

  • Cap stays 10; order follows Effective = Standing + Heat + pin bonuses.
  • Prefer and WorldBox favorites are hard pins and fully count toward Cap.
  • Admission-role units always compete on the periodic scan.
  • Non-admission "nobodies" challenge Cap only via hard-arc chapter stamps (Combat / War / Plot / Love / Grief).
  • Soft NoteFeatured heats existing MCs only.
  • Newcomers need a small challenger margin over the weakest non-pin so the rail does not thrash.

Camera (soft)

  • No rail camera lock. Prefer is a toggle soft-favorite for idle scoring.
  • Score ladder: crisis ownership > active short-arc ownership > Prefer soft > MC soft > CausalHeat.
  • Near-ties prefer Prefer'd MCs, then any MC.
  • Ambient fill prefers roster MCs over random villagers.
  • Glyph hover acquires a camera read-pause lease: feeds/story/roster continue, but selection and focus repair are deferred until release.

Rail UX

  • Up to 10 slots with live inspect-UI sprites (refreshed ~3x/sec for animation frames).
  • Egg forms and tiny/blank atlas crops fall back to the species icon (letter last).
  • Active chrome = camera follow only; Prefer uses a star pip / distinct border.
  • Click toggles saga Prefer (does not mutate WorldBox unit favorite).
  • While on the Saga tab, click also pins that life as the persistent Saga subject.
  • Tabs sit above the cast rail; the rail is a horizontal strip under the tabs so Dossier↔Saga body swaps cannot move the glyphs.
  • Dossier shows the watched unit dossier; Saga shows the adaptive saga panel for the watched MC when on the roster.
  • If the watched unit is not an MC and nothing is pinned, Saga shows an empty Pick a life from the rail state (never a stale first-roster filler).
  • Hovering a glyph temporarily previews that life in the Saga body and pauses camera switching.
  • Leaving the glyph restores the prior tab (usually Dossier) immediately and releases the pause lease.
  • Hover-exit re-applies dossier reason/traits/status/history so the orange tip does not wait for a tip change.
  • Moving onto the panel or empty rail chrome does not keep the preview - only glyph hover does.
  • Relayout / glyph-to-glyph exits are ignored while the pointer is still over a glyph.
  • Clicking a tab during hover cancels the preview immediately and applies that tab.
  • Tabbed chrome locks a constant outer width so Dossier↔Saga hover cannot slide glyphs.
  • Saga body is a story card: lens eyebrow + name + title beside the portrait; stake, Cast, and Legacy wrap full-width under it.
  • No Evidence stats dump (kills/realm live on Dossier). No Open Lore button (press L).
  • Body height sizes to content up to a cap; Legacy beats stack as separate lines (no · soup).
  • Dossier story spine (Kind · Phase) is hidden when the orange reason already names the same kind and phase is Climax.
  • Never show live task/status/trait rows or call a live attack target a rival.
  • Earned rivals require memory evidence (repeated encounters, kin kills, war/plot opposition).
  • Likely succession is omitted unless a game-authored heir API probe succeeds.
  • Pack / kin lenses fill remaining Cast slots with live family peers (Packmate / Kin) after lover/friend/parents/children/heir/rival.

Soft-fill quiet (AFK hygiene)

After hard story/crisis closers, soft-fill quiet suppresses soft-life crumbs and short interrupt FX (stunned / invincible). FamilyPack does not break quiet (ambient cluster fill). Combat / war / plot / outbreak / earthquake / story beats / epic strength still cut in. Quiet can refresh briefly when a soft crumb ends (bounded).

Session

  • StoryPlanner.Clear does not wipe the roster or saga memory.
  • Lore browse / brief idle-off keeps the roster and memory.
  • World replacement, harness batch end, and interest_saga_clear wipe roster + memory.

Harness

  • saga_roster_diversity
  • saga_camera_prefers_mc
  • saga_prefer_soft_bias
  • saga_overview_has_mc
  • saga_adaptive_dossier
  • saga_memory_survives
  • saga_hover_read_pause
  • saga_replace_on_death
  • saga_admit_roles
  • saga_replace_weaker
  • saga_rail_active_highlight
  • saga_rail_prefer_click
  • saga_soft_fill_no_pack

See also: story-planner.md.