Haven's Birthright

Unreleased: Lifecycle hardening pass — config setting-change handlers now unsubscribe on teardown to avoid duplicate callbacks after reload cycles; added expected-teardown lifecycle logging and extra debug diagnostics for runtime time/season/HP fallback reads.

Version 2.2.0 — Unique racial bonuses, active abilities, drawbacks, and conditional synergies for all 12 playable races in Sun Haven. Celestial Bloodlines: Font of Light (Angel) and Soul Harvest (Demon). Correctly resets when switching saves. Optional [BonusTransfers] (off by default): copy passive table bonuses between races via TargetRace|SourceRace|BonusType rules in the main Birthright config.

2.0.1: Config file now uses BepInEx/config/HavensBirthright.cfg (auto-migrates values from the legacy GUID-named config on first load).

Features

• 12 Unique Races - Each race has distinct gameplay advantages
• Active Abilities - Fire and Water Elementals have special triggered abilities
• Configurable Bonuses - Adjust values to your preference
• Balanced Gameplay - Designed to enhance without breaking the game

Races

Core Races

• Human - Jack of all trades with XP and relationship bonuses
• Elf - Nature's guardian with farming and foraging bonuses

Celestial Races

• Angel - Divine blessed with mana and magic bonuses
• Demon - Infernal warrior with melee and critical bonuses

Elemental Races

• Fire Elemental - Blazing fury with combat bonuses + Infernal Forge ability
• Water Elemental - Flowing tide with defense and fishing bonuses + Tidal Blessing ability

Amari Variants

• Amari Cat - Feline Grace (movement), Predator's Strike (crit), Keen Senses (foraging), and Nine Lives (passive: chance to survive lethal damage and heal)
• Amari Dog - Loyal guardian with friendship bonuses
• Amari Bird - Sky dancer with movement bonuses
• Amari Aquatic - Water dweller with fishing bonuses
• Amari Reptile - Scaled survivor with defense bonuses

Serpent Race

• Naga - Serpent kin with fishing and swimming bonuses

Installation

1. Install BepInEx 5.x
2. Place HavensBirthright.dll in BepInEx/plugins/HavensBirthright/
3. Launch the game

Configuration

Edit BepInEx/config/HavensBirthright.cfg to customize bonuses.

F9 (or ToggleKey under Active Abilities): Infernal Forge, Tidal Blessing, Font of Light, and Soul Harvest start OFF each session or after switching character. Press the key any time to turn them ON or OFF — as often as you like (not limited to a single press).

Bonus transfers (optional)

Section [BonusTransfers]:

• EnableBonusTransfers — default false. When true, Rules apply.
• Rules — semicolon-separated entries: TargetRace|SourceRace|BonusType. Each rule adds the same passive percentage the source race gets for that bonus type (from the usual Birthright tables in config). Does not copy active abilities, drawbacks, or conditional synergies.

Example (HavensBirthright.cfg):

[BonusTransfers]
EnableBonusTransfers = true
Rules = Human|WaterElemental|Defense; Elf|Human|ExperienceGain

That gives Humans Water Elemental’s Defense passive (same % as [Water Elemental] → Defense in your cfg) and gives Elves the ExperienceGain bonus Humans get from [Human]. Add more grants by chaining with ; (no line breaks inside the value).

Changelog

v2.0.0

Changing saves or characters—and Fire/Water Elemental behavior after loads and F9—is more reliable. The code was reorganized for upkeep, and the mod keeps its hidden runner alive with shared SceneRootSurvivor instead of a third-party Keep Alive mod.

Links

• Nexus Mods
• Documentation
• Report Bugs on Discord