The Vault
Secure Currency Storage for Sun Haven
Account Summary: 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.
Access Controls
Vault Services
Auto-Deposit
Tokens and keys automatically go to your vault when picked up from the ground or received as rewards - no manual action needed. Use the Sweep Inventory button to move all vault currencies from inventory at once. 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 & Crafting
Shops, vendors, and crafting tables automatically see your vault balance. Purchase items or craft recipes that require 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.
In-Game Settings
Change keybinds, HUD scale, and options directly from the vault UI via the ⚙ Settings tab. Changes save automatically to the config file — no restart needed.
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.
Asset Ledger
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
Transaction Guide
Check the Dashboard
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).
Access Your Vault
Press Ctrl + V (or F8 on Steam Deck) to open the vault interface. Press Escape or click Close to exit.
Review Holdings
Switch between tabs (Seasonal, Keys, Special, ⚙ Settings) to see stored amounts or edit config. Each currency shows a toggle button to enable/disable auto-deposit. Use Sweep Inventory to move all vault currencies from your bag into the vault.
Automatic Deposits
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.
Spend 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.
Make Withdrawals
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.
System Architecture
📥 Deposit Pipeline
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.
🛒 Payment Gateway
The Vault patches the game's inventory check system. When a shop or crafting table checks if you have enough tokens or keys, it automatically includes your vault balance. When you buy or craft, the vault is deducted first before your inventory. Crafting tables with "use nearby chests" correctly show your total (player + vault + chests).
🗝 Access Control
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.
💾 Data Protection
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.
Account Setup
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. Open for Business!
Launch Sun Haven and press Ctrl+V to access your vault.
Vault Parameters
| 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) |
| HUD Scale | 1.0 | Scale factor for HUD bar (0.5–3.0, configurable in ⚙ Settings tab) |
| 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