Haldor Trading Overhaul

A comprehensive Valheim mod that transforms Haldor the Trader into a full-featured merchant with configurable buy AND sell functionality, balanced progression-based pricing, and complete controller support.

Table of Contents

1. Features
2. Requirements
3. Installation
4. Configuration
5. Price Generator Script
6. Pricing System
7. Customization Guide
8. Troubleshooting

Features

Core Functionality

• Full Buy & Sell System - Trade both ways with Haldor using JSON-driven configs
• Custom Sell Panel - Professional UI cloned from vanilla store, positioned alongside the buy panel
• Progression Gating - Items unlock based on defeated bosses

Search & Filter

• Search Boxes - Both buy and sell panels have search input fields
• Real-time Filtering - Type to instantly filter items by name
• Persistent Focus - Search boxes maintain proper input focus when navigating

Category Tabs

• Organized Browsing - Items sorted into logical categories
• Quick Navigation - Jump between Weapons, Armor, Materials, Food, and more
• Visual Clarity - Easy to find what you're looking for

Controller Support

• Full Gamepad Navigation - Complete controller support for the entire trader UI
• Seamless Switching - Switch between keyboard/mouse and controller at any time

Technical Features

• Reflection-based implementation for resilience across Valheim updates
• No hard dependencies on internal UI types
• Automatic config generation on first run
• Hot-reloadable JSON configurations

Balanced Economy

• 580+ items available for trading
• Recipe-based pricing ensures fair values
• Biome-tier progression (Meadows through Deep North)
• Category and rarity multipliers for fine-tuned balance

Requirements

Recommended Mods

Installation

Manual Installation

1. Install BepInEx for Valheim
2. Download the latest release
3. Extract contents to BepInEx/plugins/HaldorOverhaul/
4. Launch Valheim - default configs will generate automatically

File Structure

BepInEx/
├── plugins/
│   └── HaldorOverhaul/
│       ├── HaldorOverhaul.dll
│       ├── manifest.json
│       └── README.md
└── config/
    ├── HaldorOverhaul.haldor.buy.json
    └── HaldorOverhaul.haldor.sell.json

Configuration

Config File Locations

BepInEx/config/HaldorOverhaul.haldor.buy.json   - Items Haldor sells
BepInEx/config/HaldorOverhaul.haldor.sell.json  - Items Haldor buys from you

Entry Format

{
  "item_prefab": "SwordIron",
  "item_quantity": 1,
  "item_price": 4234,
  "must_defeated_boss": "defeated_gdking"
}

Boss Keys

Price Generator Script

The included Python script (generate.py) automatically generates balanced buy/sell configurations by fetching live item and recipe data from Jotunn documentation.

Quick Start

# Basic usage - outputs to Steam Valheim config folder
python generate.py

# Custom output directory
python generate.py "C:\path\to\output"

# Using environment variable
set HALDOR_CONFIG_PATH=C:\custom\path
python generate.py

How It Works

┌─────────────────────────────────────────────────────────────────┐
│                      DATA SOURCES                               │
├─────────────────────────────────────────────────────────────────┤
│  Jotunn Item List ──────► Parse HTML ──────► Raw Items          │
│  Jotunn Recipe List ────► Parse HTML ──────► Recipes            │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                    ITEM DATABASE                                │
├─────────────────────────────────────────────────────────────────┤
│  Each item defined with:                                        │
│  • Biome tier (determines base multiplier & boss key)           │
│  • Base price (raw value before multipliers)                    │
│  • Stack size (quantity sold per purchase)                      │
│  • Sell-only flag (treasure items like Amber, Coins)            │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                   PRICE CALCULATION                             │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  For RAW materials (ores, wood, drops):                         │
│  ┌────────────────────────────────────────────────────────┐     │
│  │ Price = base_price x biome_mult x category_mult        │     │
│  │                    x rarity_mult                        │     │
│  └────────────────────────────────────────────────────────┘     │
│                                                                 │
│  For CRAFTABLE items (weapons, armor, food, ammo):              │
│  ┌────────────────────────────────────────────────────────┐     │
│  │ ingredient_cost = Sum(ingredient_base_price x qty)     │     │
│  │ recipe_price = ingredient_cost x CRAFTING_MARKUP       │     │
│  │              x biome_mult x category_mult x rarity_mult│     │
│  │                                                         │     │
│  │ Final Price = max(base_price, recipe_price)            │     │
│  └────────────────────────────────────────────────────────┘     │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                      OUTPUT FILES                               │
├─────────────────────────────────────────────────────────────────┤
│  HaldorOverhaul.haldor.buy.json   (579 buyable items)           │
│  HaldorOverhaul.haldor.sell.json  (593 sellable items)          │
└─────────────────────────────────────────────────────────────────┘

Output Locations (Priority Order)

1. Command-line argument
2. HALDOR_CONFIG_PATH environment variable
3. Default Steam path: C:\Program Files (x86)\Steam\steamapps\common\Valheim\BepInEx\config
4. Local ./output folder

Pricing System

Biome Multipliers

Items are assigned to biome tiers based on where they're obtained. Higher tiers = higher prices and later boss requirements.

Category Multipliers

Different item types have value modifiers reflecting their utility and rarity.

Rarity Overrides

Special multipliers for particularly rare or valuable items:

Key Constants

SELL_MULTIPLIER = 0.30      # Sell price = 30% of buy price
CRAFTING_MARKUP = 1.15      # 15% markup on crafted items
MIN_PRICE = 5               # Minimum item price
MAX_PRICE = 99999           # Maximum item price

Example Price Calculations

Raw Material: Iron Ore

Base price: 18
x Biome (Swamp 4.5x)
x Category (material_common 0.8x)
= 18 x 4.5 x 0.8 = 64 coins

Crafted: Bronze Bar

Recipe: 2 Copper + 1 Tin
Ingredient costs: (2 x 14) + (1 x 14) = 42
x Markup (1.15x) = 48.3
x Biome (Black Forest 2.75x) = 132.8
x Category (material_common 0.8x) = 106 coins

Crafted: Iron Sword

Recipe: 2 Wood + 4 Iron + 3 Leather Scraps
Ingredient costs: (2x2) + (4x40) + (3x5) = 179
x Markup (1.15x) = 205.85
x Biome (Swamp 4.5x) = 926.3
x Category (weapon_1h 1.0x) = 926+ coins

Ammo: Iron Arrows (Stack of 20)

Recipe: 8 Wood + 1 Iron + 2 Feathers -> 20 arrows
Ingredient costs: (8x2) + (1x40) + (2x3) = 62
x Markup (1.15x) = 71.3
x Biome (Swamp 4.5x) = 320.85
x Category (ammo 1.0x) = 320 coins for 20 arrows

Sample Prices

Materials by Tier

Weapons Progression

Boss Drops

Customization Guide

Adding New Items

1. Open generate.py
2. Find ITEM_DATABASE section
3. Add entry in format:

'ItemPrefab': (Biome.TIER, base_price, stack_size, sell_only),

Adjusting Prices

Modify the multipliers in generate.py:

# Global adjustments
SELL_MULTIPLIER = 0.30      # Change sell ratio
CRAFTING_MARKUP = 1.15      # Change crafting fee

# Biome multipliers in Biome enum
MEADOWS = ("Meadows", 1.5, "", 1)  # (name, mult, boss_key, order)

# Category multipliers in CATEGORY_MULTIPLIERS dict
'weapon_2h': 1.3,  # Adjust weapon values

# Rarity overrides in RARITY_OVERRIDES dict
'Chain': 1.8,  # Adjust specific item values

Excluding Items

Add patterns to exclusion lists:

# Hilda-exclusive items (capes, dresses)
HILDA_EXCLUSIVES = {'CapeDeerHide', 'CapeTrollHide', ...}

# Pattern exclusions
EXCLUDED_PATTERNS = [r'^Bow_projectile', r'^fx_', ...]

Troubleshooting

Common Issues

Items not appearing in trader:

• Verify item_prefab matches the game's internal name exactly
• Check that required boss has been defeated
• Ensure JSON syntax is valid

Prices seem wrong:

• Re-run generate.py to regenerate configs
• Check for missing ingredients in NAME_TO_PREFAB mapping
• Verify item is in ITEM_DATABASE

Script errors:

• Ensure Python 3.x is installed
• Check internet connection (script fetches from Jotunn docs)
• Try running with custom output path

Validation Warnings

The generator script automatically warns about:

• Price inversions: Higher-tier items cheaper than lower-tier
• Suspiciously cheap: High-tier items under 10 coins
• Very expensive: Items over 50,000 coins

Version History

Credits

• HaldorOverhaul Mod - Custom trader overhaul for Valheim
• Price Generator - Python script using Jotunn documentation data
• Jotunn - Valheim modding library (data source)

License

This mod is provided as-is for personal use with Valheim.

Changelog

1.0.19

• Added shared bank balance sync with HildirOverhaul (both traders now read/write the same bank balance)
• Internal bank persistence now migrates and mirrors legacy Haldor/Hildir keys into a shared key

1.0.18

• Fixed custom trader UI so it only applies to Haldor
• Other traders (Hildir and modded NPCs) now use the vanilla StoreGui
• Improved compatibility with mods that add their own traders

1.0.17

• Improved trader UI layout and visual polish

1.0.16

• Removed boss progression gates from treasure sell items (Amber, AmberPearl, Ruby, SilverNecklace, GoldRuby)
• Players can now sell treasure to Haldor at any point in progression

1.0.15

• Added custom UI sprites for search bar and category buttons (SearchBarBackground.png, CategoryBackground.png)
• Fixed item category classification to use enum comparison instead of string matching
• Fixed panel tinting so panels use a clean grey tint instead of brownish sprite-based coloring
• Fixed TMP font warnings by deferring TextMeshProUGUI initialization until a font is assigned
• Updated category button icons (bronze axe, troll leather helmet, wooden shield, stamina mead, bronze)
• Added a grey tint overlay on the Buy/Sell action button to match panel styling

1.0.14

• Added BowsBeforeHoes mod support
• Added 10 BowsBeforeHoes items to buy/sell configs (3 bows, 4 quivers, 3 arrows) with recipe-based pricing
• Doubled list panel scroll speed

1.0.13

• Fixed standalone bank UI cursor being locked when opened with the Z key
• Fixed bank UI registration so it behaves as a store UI (camera and input now work correctly)
• Removed Z key shortcut for bank; bank access now happens through the trader UI
• Added full controller support to the standalone bank panel

1.0.12

• Bug fixes and stability improvements

1.0.11

• Removed CurrencyPocket dependency requirement

1.0.10

• Bug fixes and internal maintenance updates

1.0.9

• Added Haldor's Bank system; bank balance funds purchases and selling deposits directly into the bank
• Added Bank tab to the trader UI and a standalone bank panel (Z key)
• Added setbankbalance console command (fixed registration so it now works in-game)
• Reverted bank panel to a clean text layout
• Additional bug fixes and performance improvements

1.0.8

• Fixed controller navigation issues with item list scrolling and selection highlighting
• Fixed controller inability to select category headers for expand/collapse
• Fixed scroll position not resetting when switching tabs
• Fixed multiple UI bugs and layout issues
• Suppressed Haldor talk bubbles while the trading UI is open
• Added setcoins console command for testing
• Updated UI design

1.0.7

• Updated trader UI visuals
• Bug fixes and interaction improvements

1.0.6

• Updated UI design
• Updated price generator script
• Updated config files
• Various bug fixes

1.0.5

• Added JsonDotNET and CurrencyPocket as required dependencies

1.0.4

• Updated dependency configuration and packaging metadata

1.0.3

• Added capes to the buy menu

1.0.2

• Documentation updates in README.md

1.0.1

• Documentation updates in README.md

1.0.0

• Initial release