📖

Haven's Almanac

Unified Mod Dashboard|

v1.0.4

Haven's Almanac brings supported Sun Haven mods together in one place: a compact HUD for at-a-glance lines, a full dashboard for detail, and a daily briefing for birthdays, tasks, museum progress, and more. It soft-depends on each integration — only installed mods appear.

On startup the mod can check for updates (toggle in config). HUD, dashboard, and briefing share a configurable UI scale (0.5–2.5×). On the main menu the Almanac hides its UI until you load into the world.

Quick Controls

Ctrl + F5
Toggle Dashboard (default: F5 with Ctrl required)
F4
Toggle HUD
Esc
Dismiss Briefing

Core Features

📊

Compact HUD

An always-visible, draggable widget showing a one-line status summary for each installed mod. Position it anywhere — your placement is saved across sessions.

📋

Full Dashboard

A comprehensive scrollable window with collapsible sections for every mod. Toggle with Ctrl+F5 for a detailed view of all your mod data in one place.

☀️

Daily Briefing

Summary popup after you load in as the player owner, and again when a new day starts (sleep / day roll). Shows birthdays, tasks, museum progress, and more. Dismiss with the button or Esc.

🔗

Soft Dependencies

No hard requirements on any mod. The Almanac detects which mods are installed and only shows sections for the ones you have. At least one is needed.

🔄

Auto-Refresh

Data refreshes automatically every few seconds. Switch characters and the Almanac updates. Sleep overnight and the briefing re-triggers with fresh data.

🎨

Themed UI

Warm parchment and gold aesthetic that fits Sun Haven's cozy atmosphere. All windows are draggable and remember their position.

Supported Mods

Haven's Almanac reads from these mods and displays their data. Install any combination.

📝

Sun Haven Todo

Active tasks, completion percentage, and task counts by category.

🎂

Birthday Reminder

Today's NPC birthdays, ungifted count, and gift suggestions.

🏛

S.M.U.T.

Museum donation progress across all three halls with completion percentage.

📦

Senpai's Chest

Number of configured smart chests and their active rule counts.

🔒

The Vault

Stored currency types and their counts from your secure vault.

⚔️

Haven's Birthright

Current race, active racial bonuses, and ability status.

🛠️

HavenDevTools

Dev tools authorization status and current player name.

Not integrated yet: Faster Races and Trinket Fortune do not expose Almanac panels; other mods above register automatically when their plugins are present.

How It Works

1

Install Your Mods

Install Haven's Almanac alongside any combination of supported mods. At least one is required for content to display.

2

Load Into the Game

The Almanac detects installed mods on startup and initializes data providers for each one. The HUD appears automatically.

3

Check Your Briefing

After load-in, the briefing can appear with a fresh summary. After you sleep and the game advances to a new day, it can show again. Dismiss with the button or Esc (or set an auto-dismiss timer in config).

4

Open the Dashboard

Press Ctrl + F5 anytime for the full dashboard with detailed sections from every installed mod.

Configuration

Setting Default Description
Hotkeys → DashboardToggleKey F5 Key to toggle the full dashboard (with Ctrl if required below)
Hotkeys → DashboardRequireCtrl true When true, hold Ctrl while pressing the dashboard key (default Ctrl+F5)
Hotkeys → HUDToggleKey F4 Toggle HUD visibility
HUD → Enabled true Show the compact HUD
HUD → PositionX / PositionY -1 / -1 Saved HUD position (-1 = use default until you drag)
DailyBriefing → Enabled true Show the daily briefing
DailyBriefing → AutoDismissSeconds 0 Auto-close briefing after N seconds (0 = manual only)
Updates → CheckForUpdates true Check for a newer Almanac release on startup
Display → UIScale 1.0 Scale HUD, dashboard, and briefing (allowed range 0.5–2.5)

Configuration file: BepInEx/config/com.azraelgodking.havensalmanac.cfg