Devouring and Digesting - BG3 Vore Mod
=======================================
Version: bigger-bouncier branch (2026-03-22)
Requires: BG3 Script Extender + Mod Configuration Menu

OVERVIEW
--------
Four custom playable races with a full vore pipeline: swallow, digest,
struggle, regurgitate, and earn Vore Points. Two predator races, two
supernatural prey support races.

RACES
-----

  DIRE WOLF (Predator)
    Player: Dusk
    Size: Large | Movement: 12m | Casting: Strength
    Stats: STR 13, DEX 10, CON 15, INT 8, WIS 8, CHA 8
    Role: Endurance predator. Tanky (CON-based AC), fire immune,
          heals on digestion kills via Devourer's Sustenance.
    Unique: Rump Dump / Shit Swamp (waste AoE, friendly fire!),
            Fire Breath, DireDevour (oral + cock), Savage Bite,
            WasteCoated (4 tiers scaling by level), Death Clench.
    Vore: Oral + Cock. Corpse dissolution in 3 ticks.
    VP: Earned from dissolution. DW cap 20 (scales with tier).

  HYENA (Predator)
    Player: Pierce
    Size: Medium | Movement: 9m | Casting: Strength
    Stats: STR 15, DEX 11, CON 13, INT 8, WIS 8, CHA 8
    Role: Brute predator. Highest STR, Bulk Up (STR/AC/carry per prey),
          multi-swallow via Gorge, gas attacks (DeepBelch, FartBlast).
    Unique: Burning Burp (Fire+Thunder), Pressure Bomb (Thunder+Fire+Force),
            Bulk Up temp HP, Active Digest, Toggle Digestion.
    Vore: Oral + Anal + Cock. VP earned on regurgitate (not dissolution).
    VP: Earned from regurgitate. HY cap 50.

  RED CAT (Prey Support)
    Player: Neltas
    Size: Tiny | Movement: 9m | Casting: Intelligence
    Stats: INT 20, WIS 20, DEX 16, CHA 14, CON 8, STR 8
    Role: Supernatural caster. All 6 save proficiencies.
          Multi-concentration via Flower Point system.
          Weapons use highest ability score (INT/WIS = +5).
    Classes: Monk (Shadow) + Rogue (Assassin/Thief) + Bard +
             Sorcerer (Draconic White) + Cleric (Life) + Archfey Warlock
    Unique: Everything Is Nothing (multi-concentration + Mind Sanctuary),
            Soothing Purr (Mind Sanctuary for pred while inside),
            Knead Biscuits (paralyze all prey in a belly),
            Flower Points (FP) — custom resource for concentration upkeep.
            Shadow Blade, Moonbeam, Wall of Fire, Phantasmal Killer,
            Sunbeam, Harm, Blade Barrier, Arcane Gate, and more.
    Prowess: Minimum scores guaranteed (INT 20, WIS 20, CHA 20, DEX 18).
    FP System: Concentration spells cost 1 FP instead of spell slots.
               Each active concentration drains 1 FP per turn.
               Half recharge on short rest, full on long rest.
               22 FP at level 11.

  COCONUT CREAM (Prey Support)
    Player: (new character)
    Size: Medium | Movement: 12m | Casting: Charisma
    Model: Scratch (white dog from the game)
    Stats: CHA 20, DEX 12, CON 8, STR 8, INT 8, WIS 8
    Role: Seductive sacrifice. Dives into pred's cock, then
          detonates via Apotheosis for massive pred buffs.
    Classes: Ranger (Beast Master/Gloom Stalker/Hunter) +
             Rogue (Arcane Trickster/Thief) +
             Bard (Glamour/Valour)
    Unique: Eat Me (teleport into pred's cock, AoE Web+Prone),
            Apotheosis (sacrifice CC for godhood buffs):
              - Full HP heal
              - Full VP replenish (Good Boy buff)
              - Haste, Bless, Heroism, Enlarge, Mirror Image,
                Heroes' Feast, Protection from Evil, scaled Aid
              - Full status cleanse
              - Afterglow (1-3 turns total immunity)
              - Forced Lethargy (1 turn unblockable sleep)
              - Post-Nut Clarity (2 turns Mind Sanctuary)
    Prowess: Same minimums as RC (INT 20, WIS 20, CHA 20, DEX 18).
    Starts with: Scratch's Ball (Find Familiar: Scratch).

RESOURCE SYSTEMS
----------------
  Vore Points (VP)
    Predator-only. Earned from digestion kills (DW) or regurgitation (HY).
    Never replenishes from rest. Scales by prey size (Tiny=1 to Gargantuan=10).
    Spent on T1 (3 VP) and T2 (15 VP) vore/churned spells.
    DW cap: 20. HY cap: 50.

  Flower Points (FP)
    Red Cat only. Fuels multi-concentration.
    1 FP to cast a concentration spell (replaces spell slot cost).
    1 FP per turn per active concentration (upkeep).
    Half recharge on short rest, full on long rest.
    Scales: 2 (L1) to 22 (L11).

APOTHEOSIS TIMELINE
-------------------
  1. CC uses "Eat Me" on any predator (teleports into cock locus)
  2. Pred uses "Apotheosis" (free action, granted when CC enters)
  3. CC dies. Pred receives:
     - Full HP heal
     - Full VP replenish + "Good Boy" status
     - 7+ buff statuses (Haste, Bless, Heroism, etc.)
     - Full status cleanse
     - Afterglow (1-3 turns immunity to all status effects)
  4. Afterglow expires:
     - Forced Lethargy (1 turn unblockable sleep)
     - Post-Nut Clarity (2 turns Mind Sanctuary)
  5. Pred wakes with 1 turn of Mind Sanctuary still active

WASTE SPELL WARNING
-------------------
  Rump Dump and Shit Swamp hit ALL creatures in range except the caster.
  This includes party members, allies, and friendly NPCs!
  Effects: WasteCoated (scaling Necrotic), Poisoned, Mired in Filth
  (unblockable -6m movement + DEX save disadvantage).
  Position your wolf carefully.

KNOWN LIMITATIONS
-----------------
  - Belly visuals (mesh overrides) not yet implemented for any race
  - StomachBag (inventory inside stomach) has a bug with TemplateAddTo
  - CC dog model uses wolf fur color palette (may look wrong)
  - Scratch's Ball may not appear if template UUID is wrong
  - RC FP system: concentration spell list is hardcoded (~40 spells)
  - UnlockSpellVariant for RC concentration has unverified syntax
    (Lua fallback handles it if stats layer fails)

INSTALL
-------
  See INSTALL.txt in this zip for step-by-step instructions.
  Requires BG3 Script Extender: https://github.com/Norbyte/bg3se/releases

DEBUG COMMANDS (SE Console)
---------------------------
  !ResetVore      — reset all vore state
  !DebugVore      — set party to level 6
  !GiveDebugItems — spawn test potions
  !DWCheck        — audit Dire Wolf stats
  !RegistryCheck  — show registered races
