Lover's Ledger

Because someone has to remember what your Dragonborn’s been up to… and with whom.

Dev Note: This is a backend utility / framework mod.

It tracks stats and relationships for adult frameworks (OStim, needs integration with  + basic SexLab) so other mods can react intelligently.

If you just want “more scenes”, you probably don’t need this.

What is Lover's Ledger?

Lover's Ledger is a lightweight SKSE plugin + Papyrus library that:

• []Listens to OStim (opportunity for integration with SexLab) runtime scenes[/]

  []Collects detailed per-thread and per-actor info (who did what to whom and how often)[/]

  []Stores the results in a persistent "relationship + encounter ledger"[/]

  []Exposes everything through a clean Papyrus API you can query from your own mods[/]

  In plain English: it keeps score so your mods can stop guessing and start reacting based on real in-game history.

  ------------------------------------------------------------

  High-Level Architecture

  1. Runtime Thread Collector – `ThreadsCollector`

  Temporarily tracks what’s happening in an active OStim scene:

  • []Per-thread actors[/]

    []Actions performed (did/got)[/]

    []Orgasms and internal climax counts[/]

    []Excitement contribution data (who’s driving the scene)[/]

    When the thread ends, you call ApplyThreadToLedger() to turn that ephemeral runtime info into persistent stats.

    2. Persistent Ledger – `LoversLedgerService`

    Keeps long-term stats in memory and persists via SKSE serialization:

    • []Per-NPC encounter stats (exclusive/group/solo, same-sex, last encounter time)[/]

      []Per-NPC action stats (actions_did / actions_got by normalized action name)[/]

      []Per-lover relationship data:

      []exclusiveSex[/]

      []partOfSameGroupSex[/]

      []lastTime[/]

      []orgasms[/]

      []internalClimax (did/got)[/]

    [/]

    Think of it as "Skyrim Relationship Analytics Pro" for your scripting layer.

    ------------------------------------------------------------

    Papyrus API – `TTLL_Store` (Core Ledger API)

    Key functions (simplified):

    ; Per-NPC values

    Int  Function GetNpcInt(Actor npc, String propName)

    Float Function GetNpcFlt(Actor npc, String propName)

    Function SetNpcInt(Actor npc, String propName, Int