worldbox-observer-mod/docs/scoring-model.md
DazedAnon ba58a9ff38 feat(saga): deepen session cast stakes and cut idle hitch spikes
- Keep LifeSagaSession across Clear; wipe on map load/clear with bind key
- Soft-bias Prefer/cross-MC/cast and prefer roster MCs in aftermath/recover/park
- Resolve war/plot principals plus discrete/WorldLog labels from live libraries
- Amortize roster world scans, gate Relayout, and add hitch probe/save-slot helpers
2026-07-22 14:37:36 -05:00

46 lines
2.4 KiB
Markdown

# Scoring model
**Global formula:** [`IdleSpectator/scoring-model.json`](../IdleSpectator/scoring-model.json)
**Per-event inventory (strength + prose):** [`IdleSpectator/event-catalog.json`](../IdleSpectator/event-catalog.json)
**Story commitment (arcs / aftermath / ledger):** [`story-planner.md`](story-planner.md)
- `scoring-model.json` - margins, multipliers, rarity caps, soft-Duel / variety valve knobs
- `event-catalog.json` - every authored event id (`happiness`, `status`, `worldLog`, `plots`, `decisions`, …)
- Decisions use `action` (clause after "decides to …")
- Most other domains use `label`
- Happiness uses `variantsWithRelated` / `variantsWithoutRelated`
- Optional `species` / `character` bonuses
**Visual tracker (open beside chat):** [scoring-model canvas](/home/dazed/.cursor/projects/home-dazed-Projects-worldbox-mods-idle-mode/canvases/scoring-model.canvas.tsx)
## Variety policy (0.28.28)
`TotalScore = EventStrength + scaleBonus + char*w + visual*w + novelty*w`.
Hard sticky combat (margin 50, MaxWatch 60) is only for Skirmish+ or notable-pair Duels.
Anonymous / single-notable Duels are soft sticky: MaxWatch 24, variety valve at 8s, yield to Story peers after 8s.
Founding tips come from `new_city` / `new_kingdom` meta outcomes, not decision intent.
Consecutive shows of the same variety arc (e.g. duel → duel) subtract `repeatArcPenaltyPer` from TotalScore (capped), resetting when a different arc is shown.
A rolling tip window also adjusts score by frequency: over-shown arcs lose up to `arcOverSharePenaltyMax`, rare/absent arcs gain up to `arcUnderShareBoostMax`, with an extra combat monopoly penalty above `arcCombatShareTarget`.
Fruit-bush foraging is fill-band strength so it does not crowd the camera.
Live combat holds the camera until the scrap goes cold (see who wins); variety peers cut after the fight ends.
Edit the `weights` block in scoring-model.json to change live scoring formula knobs.
Edit the `story` block for StoryPlanner / life-saga soft bias:
- `nearTieEpsilon` / `sagaNearTieEpsilon` - ordinary vs Prefer/MC/cast pick bands
- `sagaMcWeight` / `sagaPreferWeight` / `sagaCastWeight` / `sagaCrossMcBonus` - tip score soft bias (CrossMC bonus ~11; SoftBias Prefer > CrossMC > MC > cast)
- `sagaRivalEncounterThreshold` - living rematches before EarnRival
Edit event-catalog.json to change what each event is worth and what it says.
See also: [life-saga.md](life-saga.md), [story-planner.md](story-planner.md).