🎁

A Daily Gifting Routine

Gifting AssistantPlan Your Daily Gift Run

Pick your NPCs, see the perfect gift, never miss a day

v1.0.0
Thunderstore Nexus Mods Combined

Gifting Assistant turns daily gift-giving into a simple routine. Add the NPCs you care about to a per-character roster, and the in-game window shows each one's loved and liked gifts with item icons, how many you're carrying, and a priority you choose. Mark people gifted as you go — gifted NPCs sink to the bottom and the list resets each new day, so you always know who's left.

Quick Controls

Ctrl + G
Open / Close the Gifting window

📝 Sun Haven Todo Integration

When Sun Haven Todo is installed, Gifting Assistant defaults to Push to Todo mode. Use the per-row +Todo button to push a “Gift {NPC} today” task (gift icon and suggested gifts in the description). Tasks auto-complete when you gift that NPC in-game; the row Gifted checkbox tracks your roster only and does not add todos. Every new in-game day, gift tasks from the daily refresh are cleared and re-added for the current roster.

No Sun Haven Todo? Gifting Assistant falls back to its own internal daily roster — everything still works, just inside the Gifting window.

🎂 Birthday Reminder

With Birthday Reminder installed, NPCs celebrating a birthday today are highlighted on your roster so you can prioritize them.

📖 Integration with Haven’s Almanac

When Haven’s Almanac is installed, Gifting Assistant can share roster progress (enabled by default via Integrations > UseAlmanacIntegration in GiftingAssistant.cfg):

  • HUD line — pending vs roster count (e.g. 3 pending / 8 roster), or “Integration disabled” when opted out.
  • Dashboard panel — roster and pending counts; each not-yet-gifted NPC with priority and gifted status.
  • Daily briefing — when NPCs are still waiting, how many remain plus high- and urgent-priority breakdowns.

What’s Inside

📋

Daily Gift Roster

Add any NPC to a per-character routine list. Open the window each day to see exactly who you planned to gift.

🎁

Loved & Liked Suggestions

Shows each NPC's loved and liked gifts pulled from live game data, each with its item icon so you know what to look for.

🎒

Inventory Hints

Optionally shows how many of each suggested gift you're currently carrying, so you can tell at a glance what you can deliver right now.

Preferred Gift Picks

Use the Gifts button on a row to choose preferred gifts per NPC. Your picks drive both the icons in the window and the gift shown on the Todo task — less clutter, more focus.

🔥

Priority Sorting

Mark each NPC Low, Normal, High, or Urgent. The roster sorts by priority and gifted NPCs drop to the bottom.

Gifted-Today Tracking

Reads the game's own "gave a gift today" flag and lets you mark gifts manually. Everything resets cleanly on a new day.

👤

Per-Character Saves

Each character keeps its own roster, priorities, and preferred-gift picks. Switch characters and your routine is always saved correctly.

How the Roster Works

🎁

Suggestions

Each row shows what the NPC wants.

  • 💕 Loved gifts — the biggest friendship boost
  • 👍 Liked gifts — solid alternatives
  • 🖼 Item icons for quick recognition
  • Your preferred picks shown first
🔥

Order & Status

Stay on top of the day's plan.

  • 🔼 Priority drives the sort order
  • 🎒 Bag counts for suggested gifts
  • Gifted NPCs sink to the bottom
  • 🌅 Roster resets each new day
🔗

Stays in Sync

Works with your other mods.

  • 📝 Pushes daily tasks to Sun Haven Todo
  • Todo tasks auto-complete when you gift in-game (+Todo to add reminders)
  • 🎂 Birthday NPCs highlighted today
  • 📖 Progress shared with Haven's Almanac

Gift Preference Levels

Loved
Liked

Priority Levels

Low
Normal
High
Urgent

Your Daily Gifting Routine

1

Open the Window

Press Ctrl + G to open the Gifting Assistant window at any time.

2

Build Your Roster

Add the NPCs you want to gift regularly. Each row shows their loved and liked gifts with icons, and (optionally) how many you're carrying.

3

Set Priorities & Picks

Choose a priority (Low / Normal / High / Urgent) for each NPC, and use the Gifts button to pick preferred gifts so the row and Todo task show only what you care about.

4

Deliver & Mark Gifted

Give an NPC one of their preferred gifts in-game, or click Mark Gifted in the window. Gifted NPCs drop to the bottom — and any matching Sun Haven Todo task completes automatically.

5

Start Fresh Tomorrow

Each new in-game day the roster resets and (with Sun Haven Todo) the gift tasks are cleared and re-added for the current roster.

Installation

📦

1. Install BepInEx

Download and install BepInEx 5.x for Unity games if you haven't already.

📥

2. Download Gifting Assistant

Get GiftingAssistant.dll from the releases page.

📁

3. Install the Mod

Place the DLL in your BepInEx/plugins/ folder.

🎮

4. Start Gifting!

Launch Sun Haven and press Ctrl+G to build your roster.

Settings

Setting Default Description
Enabled true Enable the mod
ToggleKey G Key to open/close the Gifting window
RequireCtrl true Require Ctrl with the toggle key
ShowInventoryPossession true Show bag counts for suggested gifts
UIScale 1.0 Window scale
AutoSave true Periodically save changes
AutoSaveInterval 60 Auto-save interval in seconds
ReminderMode PushToTodo* RosterOnly = built-in daily roster only. PushToTodo = roster plus per-row +Todo when Sun Haven Todo is installed.
UseAlmanacIntegration true Share gift roster progress with Haven's Almanac when installed

*ReminderMode defaults to PushToTodo when Sun Haven Todo is installed, otherwise the roster runs on its own. Configuration file: BepInEx/config/GiftingAssistant.cfg · per-character rosters save to BepInEx/config/com.azraelgodking.giftingassistant/