🔒

The Vault

Secure Currency Storage for Sun Haven

The Vault is a powerful quality-of-life mod that automatically stores your seasonal tokens, community tokens, and keys in a secure digital vault. No more cluttered inventories or manual currency management - your currencies are safely stored, automatically deposited when picked up, and seamlessly spent at shops and locked doors without ever touching your inventory.

Key Features

📥

Auto-Deposit

Tokens and keys automatically go to your vault when picked up from the ground or received as rewards - no manual action needed. Toggle auto-deposit on/off per currency type.

📊

Persistent HUD Bar

A sleek always-visible HUD bar displays all your vault currencies at a glance. Shows seasonal tokens, keys, and special currencies with their actual game icons. Large numbers display as compact K/M format (e.g., 50K, 1.5M).

🎨

Native Game Icons

The vault loads actual item icons directly from the game's database. See the real Spring Token, Iron Key, or Mana Shard icons - not just text placeholders.

🛒

Seamless Shopping

Shops and vendors automatically see your vault balance. Purchase items that cost seasonal tokens, community tokens, or keys without withdrawing first - the vault handles everything.

🗝

Door & Chest Integration

Keys stored in your vault work automatically with locked doors and treasure chests throughout Sun Haven. No need to carry keys in your inventory.

👤

Per-Character Vaults

Each character has their own separate vault tied to their save file. Your currencies stay organized between different playthroughs and characters.

🔄

Auto-Save Protection

Vault data saves automatically every 5 minutes and whenever the game saves. Your currencies are protected even if the game crashes.

🎮

Steam Deck Ready

Full Steam Deck support with F8 as an alternative toggle key (no modifier required). The HUD and vault UI work great with controller input.

Supported Currencies

The Vault supports all major collectible currencies in Sun Haven. Each currency can have auto-deposit toggled individually.

Seasonal Tokens

Earned from seasonal events and festivals. Used to purchase seasonal items and decorations.

  • Spring Token
  • Summer Token
  • 🍂 Fall Token
  • Winter Token
🗝

Keys

Found in mines and as drops. Used to unlock treasure chests and special doors throughout the world.

  • Copper Key
  • Iron Key
  • Adamant Key
  • Mithril Key
  • Sunite Key
  • Glorite Key
  • King's Lost Mine Key

Special

Special currencies earned from events, activities, and community tasks throughout Sun Haven.

  • Community Token
  • Doubloon
  • Black Bottle Cap
  • Red Carnival Ticket
  • 🍬 Candy Corn Pieces
  • 💎 Mana Shard

How to Use

1

Check the HUD

A persistent HUD bar at the top of your screen shows all your vault currencies at a glance with their actual game icons. Large values display in compact format (1K, 50K, 1M).

2

Open the Vault

Press Ctrl + V (or F8 on Steam Deck) to open the vault interface. Press Escape or click Close to exit.

3

Browse Your Currencies

Switch between tabs (Seasonal, Keys, Special) to see stored amounts. Each currency shows a toggle button to enable/disable auto-deposit for that specific item.

4

Automatic Collection

Just play normally! When you pick up tokens or keys, they're automatically deposited to your vault (if auto-deposit is enabled). You'll still see the pickup notification.

5

Shop & Unlock Seamlessly

Visit any shop or locked door - The Vault automatically uses your stored currencies. No need to withdraw first; purchases and unlocks work directly from the vault.

6

Withdraw When Needed

Use the quick -1, -5, or -10 buttons next to each currency, or select a row and enter a custom amount to withdraw items back to your inventory.

How It Works

📥 Pickup Interception

When you pick up a supported currency, The Vault intercepts the item after it enters your inventory, removes it, and deposits it directly to your vault. You still see the normal pickup notification so you know what you collected.

🛒 Shop Integration

The Vault patches the game's inventory check system. When a shop checks if you have enough tokens or keys to make a purchase, it automatically includes your vault balance. When you buy, the vault is deducted first before your inventory.

🗝 Door & Chest Integration

Similarly, locked doors and treasure chests that require keys will check your vault. If you have the right key in your vault, the door or chest will unlock and the key will be consumed from your vault automatically.

💾 Save System

Vault data is stored separately from your game save in the BepInEx config folder, tied to your character name. Auto-save runs every 5 minutes, plus saves trigger when the game saves or when you quit.

Installation

📦

1. Install BepInEx

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

📥

2. Download The Vault

Get TheVault.dll from Nexus Mods.

📁

3. Install the Mod

Place TheVault.dll in your BepInEx/plugins/TheVault folder.

🎮

4. Play!

Launch Sun Haven and press Ctrl+V to access your vault.

Configuration

Setting Default Description
ToggleKey V Key to open/close the vault UI
RequireCtrlModifier true Require Ctrl key when pressing toggle key
AltToggleKey F8 Alternative key for Steam Deck (no modifier required)
EnableHUD true Show the persistent HUD bar with vault currencies
HUDPosition TopLeft HUD position (TopLeft, TopCenter, TopRight, BottomLeft, BottomCenter, BottomRight)
EnableAutoSave true Automatically save vault data periodically
AutoSaveInterval 300 Auto-save interval in seconds (5 minutes)

Configuration file located at: BepInEx/config/com.azraelgodking.thevault.cfg