Haldor Expansion

Current version: 1.2.2

Haldor Expansion is a Valheim mod for BepInEx + Jotunn that expands Haldor's trading and adds unique risk-reward equipment with custom combat mechanics.

The mod is designed for multiplayer and dedicated servers, supports English and Russian localization, and keeps shop prices and progression settings synchronized from the server.

What's new in 1.2.0

Version 1.2.0 adds three major items built around new survival and archer playstyles:

• Hel's Oath — a high-risk bow centered around sacrificing health for stamina, building Hel's Touch, and unleashing Hel's Embrace;
• Pelt of Helheim — a dark archer cloak that completes the Fenris + Hel's Oath setup and grants Very Resistant to Pierce while the full synergy is active;
• Thread of the Norns — a one-use trinket that breaks to prevent lethal damage and briefly protects the wearer afterward.

The update also expands custom visuals, embedded icons, multiplayer handling, and item-specific mechanics.

Features

• unique combat items sold by Haldor;
• configurable prices for all custom HaldorExpansion items;
• configurable world progression requirements for shop items;
• additional resources and crafting materials sold by Haldor;
• configurable trophy sell prices;
• configurable sell prices for SurtlingCore, BlackCore, and MoltenCore;
• server-synchronized shop prices and progression requirements;
• trophy selling, including Deep North trophies;
• custom active abilities and build-specific item synergies;
• risk-reward armor, cloaks, bows, crossbows, trinkets, and cestus;
• embedded item icons — no separate PNG files are required;
• English and Russian localization;
• multiplayer / dedicated server support via NetworkCompatibility(EveryoneMustHaveMod, Minor).

Unique items sold by Haldor

The prices below are the default values. Shop prices can be changed in the configuration and are synchronized from the server in multiplayer.

Unique item mechanics

Hel's Oath

A bow built around a glass-cannon stamina playstyle.

Hel's Sacrifice

While Hel's Oath is equipped:

• 50% of maximum health is converted into maximum stamina;
• grants +20 Bows skill;
• the bow favors extreme stamina investment over safe health stacking.

Fenris — Hel's Touch

Wearing the full Fenris set allows bow damage from Hel's Oath to awaken Hel's Touch.

• builds up to five stages;
• each stage improves movement speed and reduces stamina costs;
• at Touch V the total bonus reaches +25% movement speed and -20% stamina cost for all actions;
• taking a combat hit removes one stage;
• removing Hel's Oath or breaking the full Fenris set disables the bonuses immediately;
• stored Touch stages survive for a short grace period, then decay one by one if the required loadout is not restored.

Hel's Embrace

Bow damage charges Hel's Embrace. When the charge reaches 100%, the ability is ready to use.

• press the middle mouse button (Mouse2) to activate Hel's Embrace;
• the next arrow fired becomes empowered;
• the activation key can be changed in the configuration;
• the empowered arrow deals increased direct damage;
• the impact creates a large explosion with 80% Lightning / 20% Frost damage;
• explosion damage does not fall off with distance inside its radius;
• damage scales heavily with stamina investment and the glass-cannon health/stamina ratio;
• the lower maximum health and the higher maximum stamina, the stronger Hel's Embrace becomes;
• activating Hel's Embrace at Hel's Touch V greatly increases its splash damage.

With the full Fenris set, Hel's Touch creates a tactical choice: you can maintain Hel's Touch V for its full passive bonuses, or unleash it through Hel's Embrace for a much stronger burst of damage, then build Hel's Touch back up again.

The charge requirement scales with world boss progression. Normal shots contribute their outgoing damage before the target's armor and damage resistances are applied, so resistant enemies do not make the ability charge artificially slower. The special shot itself never charges the next Hel's Embrace.

Hel's Embrace charge is stored on the individual bow, so accumulated charge survives unequipping, location changes, dropping the bow, and transferring it to another player.

Pelt of Helheim

A blackened cloak designed as the final piece of the Hel / Fenris archer setup.

Helheim's Ward becomes active only while all of the following are true:

• Pelt of Helheim is equipped;
• the full Fenris set is equipped;
• Hel's Oath is currently wielded;
• Hel's Touch V is active.

While the full synergy is active, the wearer becomes Very Resistant to Pierce damage.

Breaking any of the conditions removes the resistance immediately.

Thread of the Norns

A one-use survival trinket worn in the trinket slot.

When an equipped Thread of the Norns receives a lethal hit for its wearer:

• the trinket is consumed instead of allowing the player to die;
• health is restored to 50% of the health held before the lethal hit;
• the wearer receives 1.5 seconds of protection from health loss;
• the thread is permanently destroyed after activation.

Bone Crushers

Cestus weapon for aggressive close combat.

Main mechanics:

• taking damage builds a custom battle-fervor charge;
• the active ability becomes available when the charge is full;
• when the battle-fervor charge is full, press the middle mouse button (Mouse2) to activate the ability;
• the activation key can be changed in the configuration;
• creates a brief protective barrier;
• releases a shockwave around the player;
• grants bonus maximum health and very high attack speed;
• reduces armor while equipped.

Pit King's Cuirass

Aggressive armor designed around Bone Crushers.

• increases maximum health;
• works with Bone Crushers as part of the Steel Heart set bonus;
• the set improves the cestus active ability with stronger barrier strength and shockwave damage.

Cuirass of Silent Reckoning

Armor for surviving dangerous burst damage.

• when a post-armor hit would remove more than half of maximum health, only part of the damage is taken immediately;
• the remaining damage returns as delayed pain over the following seconds;
• gives the player time to react, but does not remove the eventual punishment.

Cloak of the Wounded Beast

Risky regeneration cloak.

• increases incoming damage;
• restores health every second;
• regeneration becomes stronger at lower health;
• fire, poison, and spirit damage suppress regeneration for a short time;
• healing is reduced when used together with the Cuirass of Silent Reckoning.

Cloak of Burned Resolve

Stamina-based defensive cloak.

• redirects 25% of incoming damage into stamina loss;
• the stamina cost is harsher than the redirected damage amount;
• if stamina is insufficient, the missing portion returns to health with increased damage.

Corrupted Brisingamen

A trinket-slot accessory that increases maximum carry weight.

Crossbow of the Shadow Hunt

Heavy crossbow designed for deliberate opening shots.

• high pierce damage;
• strong opening / backstab potential;
• heavy movement penalty;
• intended for slow, high-impact ranged combat.

Resource goods sold by Haldor

Haldor also sells additional resources and crafting materials. The prices below are defaults and can be changed in the server configuration.

Each item can optionally require a world progression key before it appears in the shop.

Metals

Stone and building materials

These are sold as full stacks based on the item's vanilla maximum stack size.

Wood materials

These are sold as full stacks based on the item's vanilla maximum stack size.

Cloth and crafting materials

Items that can be sold to Haldor

The mod allows selling trophies and selected rare materials. Sell prices are configurable and synchronized from the server.

Rare materials

Trophies

Supported trophy groups include:

• Meadows;
• Black Forest;
• Ocean;
• Swamp;
• Mountains;
• Plains;
• Mistlands;
• Ashlands;
• Deep North;
• boss trophies.

Each supported trophy can have its own sell value.

Unlisted trophies can also use a configurable fallback sell value, allowing trophies introduced by other mods or future game updates to remain sellable.

Configuration

The configuration file is created automatically after the mod is started.

Shop prices, shop progression requirements, trophy sell prices, core sell prices, and synchronized Hel's Oath gameplay settings are controlled by the server in multiplayer.

Shop prices

The purchase price of every item added by Haldor Expansion can be changed independently.

Example:

Hel Oath Price = 2500
Pelt of Helheim Price = 2500
Thread of the Norns Price = 6666
Iron Price = 225
Silver Price = 550

World progression requirements

Every item added to Haldor's shop can optionally require a Valheim world global key.

Example:

Hel Oath RequiredGlobalKey = defeated_queen
Silver RequiredGlobalKey = defeated_gdking

Leave the value empty to keep an item available without a progression requirement:

Hel Oath RequiredGlobalKey =

Common boss progression keys:

defeated_eikthyr     - Eikthyr
defeated_gdking      - The Elder
defeated_bonemass    - Bonemass
defeated_dragon      - Moder
defeated_goblinking  - Yagluth
defeated_queen       - The Queen
defeated_fader       - Fader
defeated_frozenking  - Kall Fimbulbringer

Hel's Oath settings

Hel's Oath exposes synchronized balance settings including:

• base damage required for a full Hel's Embrace charge;
• explosion radius;
• normal Hel's Embrace coefficient;
• Hel's Touch V Embrace coefficient;
• Hel's Touch stack interval.

The active ability key is configurable and uses the middle mouse button by default:

Ability Key = Mouse2

The base charge requirement is automatically scaled by world boss progression. Enemy armor and resistance do not reduce charge gain from a valid normal shot.

Trophy sell prices

Supported trophies have individual configurable sell values.

Example:

Eikthyr Trophy Price = 70
Bonemass Trophy Price = 150
Fader Trophy Price = 1000

Setting a trophy sell price to 0 disables selling that trophy.

A configurable fallback is also available:

Unlisted Trophy Price = 10

Core sell prices

Surtling Core Price = 50
Black Core Price = 100
Molten Core Price = 150

Setting a sell price to 0 disables selling that item.

Multiplayer configuration

The server configuration is authoritative while connected to a multiplayer server.

Clients use the server's synchronized values while connected; their local configuration is not permanently overwritten.

Recommended playstyle

The custom equipment is intentionally built around strong benefits paired with meaningful drawbacks or build requirements.

The mod works especially well on higher difficulty settings and can be combined with mods such as:

• Smoothbrain-CreatureLevelAndLootControl;
• warpalicious-Monster_Modifiers;
• ASharpPen-Custom_Raids.

These are optional and are not required dependencies.

Requirements

Required dependencies:

• BepInEx 5;
• Jotunn.

When installed through a mod manager, dependencies are handled by the package manifest.

Multiplayer / dedicated server

Haldor Expansion changes gameplay and adds networked mechanics.

For dedicated servers, install the same version on:

• the server;
• every client / player.

The server configuration is authoritative for synchronized settings.

Using different versions between server and clients is not recommended.

Manual installation

Place:

HaldorExpansion.dll

into:

BepInEx/plugins/aveasura-HaldorExpansion/

Item icons are embedded inside HaldorExpansion.dll; players do not need to copy PNG files separately.

Compatibility

The mod has been tested in local and dedicated-server environments together with other gameplay mods, including:

• Smoothbrain-CreatureLevelAndLootControl;
• warpalicious-Monster_Modifiers;
• ASharpPen-Custom_Raids;
• Azumatt-AzuExtendedPlayerInventory;
• Azumatt-AzuSkillTweaks;
• rendl0449-CraftFromContainers;
• Advize-PlantEverything;
• Marf-FuelEternal.

Full compatibility with every version of third-party mods is not guaranteed, but no conflicts were found in the tested setup.

Localization

Supported languages:

• English;
• Russian.

Source code

The source code is available on GitHub:

https://github.com/aveasura/HaldorExpansion

Status

Current version: 1.2.2

The mod supports Valheim 1.0 and has been tested in both local and dedicated-server environments.

Balance and configuration options may continue to evolve in future releases.

1.3.2

• Improved overall performance and optimization.
• Improved the drop mechanics of Haldor's Idols and Adamantine Haldor's Idols in chests, including support for world loot multipliers.
• Added Bloodgold, Timberwood, and Ice to Haldor's shop.
• Frostcores can now be sold to Haldor.
• Fixed an issue where Facebreaker's ability range indicator would sometimes fail to appear in multiplayer.
• The descriptions for certain items have been improved.

1.3.1

• Fixed Haldor's Idol drop compatibility with the latest Valheim update.
• No other gameplay or balance changes.

1.3.0

Added

• Berserker Equipment: Introduced the Berserker Greataxe, Helmet, and Cloak — a new combat-focused equipment set built around relentless aggression, growing power, and high-risk gameplay.

• Wrath System: A stacking combat mechanic that rewards aggressive play with increasingly powerful offensive and defensive bonuses.

• Blood Debt: A new combat resource that fuels the Berserker's devastating abilities, featuring a dedicated HUD indicator.

• Customizable Blood Debt HUD: Added client-side controls for visibility, positioning, scaling, and dimensions.

• Reckoning: A powerful secondary attack that unleashes accumulated Blood Debt against enemies while restoring health.

• Ragnarök: A devastating meteor storm that scales with accumulated Blood Debt, featuring cinematic visuals, darkened skies, and destructive impact effects.

• Exhaustion: A temporary penalty following Ragnarök, adding an element of risk to the Berserker's ultimate ability.

• Berserker Trading: New equipment available from Haldor, with configurable prices and progression requirements.

• Forge of Possibilities: Added upgrade support for 12 unique HaldorExpansion artifacts. Equipment can be upgraded beyond quality level 10, allowing players to continue strengthening their gear.

• Awakened Potential: Introduced unique awakened abilities and passive bonuses for 11 of the 12 upgradeable artifacts upon reaching quality level 10. Awakened powers remain active at all subsequent upgrade levels. The awakened ability for Hel's Oath (bow) is still in development and will be added in a future update.

• Haldor Idol: Introduced a new upgrade resource obtainable from eligible loot sources alongside existing idols, without replacing their original drops.

• Adamantine Haldor Idol: Introduced a new upgrade resource that protects equipment from destruction when an upgrade fails, though failure may still reduce its quality.

• Idol Trading: Haldor now buys and sells all 16 vanilla idols and both custom HaldorExpansion idols, with individually configurable prices and availability.

• Facebreaker: Introduced a new active ability for Bone Crushers that pulls enemies together, slowing them and staggering those caught on opposite sides.

• Custom Facebreaker Animation: Added a unique casting animation with directional character positioning, synchronized enemy pulling, impact, and knockback.

• Facebreaker Sound Effects: Added custom impact sounds synchronized with the casting animation, including distinct audio for staggered and non-staggered targets.

• Haldor's Shop Categories: Added category tabs for easier navigation through Haldor's inventory.

• Scrollable Item Tooltips: Added scrolling support for long item descriptions, improving accessibility on smaller screens.

• Artifact Lore: Added original Norse-inspired stories and interconnected sagas for 12 relics, fully localized in English and Russian.

• Interconnected Idol Lore: Added two emotional, interconnected stories for Haldor's idols, featuring hidden connections to existing artifact lore and subtle clues about their mysterious origins.

• New Trading Resources: Added Sap, Refined Eitr, Soft Tissue, Linen Thread, and Black Metal to Haldor's inventory.

• In-Game Configuration: Added optional BepInEx ConfigurationManager support, allowing players to manage mod settings directly in-game.

• Live Configuration Reloading: Configuration changes are automatically detected and applied without restarting the game.

Changed

• Bone Crushers: Improved charge generation scaling based on health lost, increased attack speed, and removed hit-stop interruptions for faster, smoother combat.

• Pit King's Mantle: Adjusted its health bonuses and synergy with Bone Crushers.

• Retribution (formerly Nova): Increased the area of effect to improve crowd control and combat effectiveness.

• Cloak of the Wounded Beast: Adjusted passive healing interactions with damage-over-time effects.

• Cuirass of Silent Reckoning: Improved its damage-delaying effect to also activate on potentially lethal hits, even below the normal damage threshold.

• Thread of the Norns: Improved its protection against lethal hits and interaction with the Cuirass of Silent Reckoning.

• Haldor's Shop: Item previews now feature atmospheric lore, while inventory tooltips retain detailed gameplay information.

• Configuration System: Reorganized settings into general.cfg, balance.cfg, and trading.yml for easier customization.

• Trading Configuration: Expanded customization options for Haldor's inventory, including item availability, quantities, pricing, and progression requirements.

• Equipment Descriptions: Improved readability, formatting, and localization across existing equipment.

Fixed

• Fixed equipped HaldorExpansion items occasionally appearing invisible after loading into the game.
• Fixed equipment preview and item icon issues in Haldor's shop.
• Fixed damage calculation inconsistencies involving the Cuirass of Silent Reckoning and other equipment effects.

Performance

• Significantly improved Haldor's shop responsiveness and category switching.
• Optimized item loading, filtering, and UI updates.
• Reduced unnecessary configuration file operations.
• Improved overall efficiency of configuration monitoring and live reloading.

Internal

• Improved configuration migration and compatibility with existing settings.
• Improved item registration and equipment repair handling.
• Refined combat effect processing and Harmony patch compatibility.
• Removed temporary debugging and profiling code.

1.2.2

• Updated README version references.
• No gameplay changes.

1.2.1

• Updated README and package description.
• Added clearer activation instructions for Hel's Embrace and Bone Crushers.
• Expanded documentation for the Fenris / Hel's Touch playstyle.
• No gameplay changes.

1.2.0

New items

• Added Hel's Oath, a unique endgame bow built around a high-risk stamina-focused playstyle.
• Added Pelt of Helheim, a cloak designed around the full Fenris + Hel's Oath archer build.
• Added Norn Thread, a one-use survival trinket that breaks when its death-prevention effect is triggered.

Hel's Oath

• Added Hel's Sacrifice:
  • converts 50% of maximum health into maximum stamina;
  • grants +20 Bows skill.
• Added Hel's Touch synergy with the full Fenris set.
• Hel's Touch builds up to five stages and improves mobility.
• Hel's Touch stages are temporarily preserved when swapping equipment and then gradually decay.
• Added Hel's Embrace, a charged active ability that empowers the next arrow and creates a powerful area explosion.
• Hel's Embrace scales heavily with stamina-focused glass-cannon builds.
• Hel's Embrace splash damage uses Lightning and Frost damage.
• Charge requirements now scale with world boss progression.
• Enemy resistances no longer reduce Hel's Embrace charge gain.
• Hel's Embrace charge is stored on the individual bow and survives unequipping, location changes and item transfers.

Pelt of Helheim

• Designed as the final piece of the Fenris / Hel's Oath archer setup.
• Grants Very Resistant to Pierce while:
  • Pelt of Helheim is equipped;
  • the full Fenris set is equipped;
  • Hel's Oath is in use;
  • Hel's Touch V is active.

Norn Thread

• Added a new one-use defensive trinket.
• The thread breaks when its survival effect is triggered.
• Added custom visual and sound effects for activation.

Other

• Added custom icons and RU/EN localization for the new items.
• Improved Hel's Oath visual and audio effects.
• Fixed Hel's Touch particle-system warnings.
• Various multiplayer, balance and presentation improvements.

1.1.0

• Added configurable world progression requirements for all HaldorExpansion shop items.
• Added configurable buy prices for all HaldorExpansion shop items.
• Added server synchronization for shop progression and prices.
• Added configurable trophy sell prices.
• Added configurable sell prices for Surtling Core, Black Core and Molten Core.
• Added Deep North trophy support.
• Updated default sell values for cores and Deep North trophies.

1.0.1

• Fixed compatibility with Valheim 1.0.
• Fixed StoreGui.FillList NullReferenceException when opening Haldor's shop or selling items.