ImmersiveTrader

ImmersiveTrader turns trading into a full progression system for Valheim.

BETA: ImmersiveTrader works in multiplayer, but bugs and unexpected behaviour may still occur. Please report issues directly on ** Discord** Discord HypnoMODS server.

Instead of relying on a single merchant, the world contains 14 regular traders — two in every biome from Meadows to Ashlands — plus the roaming Legendary Mieteg. Trade coins for useful resources, hunt creatures through contracts, transport physical cargo, build reputation, unlock new stock and use custom scrolls and navigation items.

The goal is to make coins, trading and exploration useful throughout an entire playthrough while reducing repetitive resource grinding without turning Valheim into a creative-mode item shop.

At a glance

• 14 regular traders + Legendary Mieteg
• 70 regular hunting contracts + 9 Legendary contracts
• 70 cargo shipments
• 5 reputation levels per regular trader
• 17 Enhancement Scrolls + 9 Ward Scrolls
• 3 magical navigation shells
• Personal boss progression, reputation, contracts, cargo and cooldowns
• Contract Boards, Lox Caravans, custom camps and trader inventories
• Single-player, host/client and dedicated-server gameplay
• 47 story quests from eight traders (Meadows, Black Forest, Swamp, Mountains), more on the way
• Optional companion mod Roots & Remedies: food, herbs, potions and farming

Traders & progression

Biome	Traders	Story quests
Meadows	Midka & Troldad	Midka 5, Troldad 6
Black Forest	Grimvald & Rudy Warg	Grimvald 6, Rudy Warg 6
Swamp	Mokra Dzika & Encek	Mokra Dzika 6, Encek 6
Mountains	Hrothgar & Ylva Frost	Hrothgar 6, Ylva Frost 6
Plains	Bjarki Goldtooth & Ragnar Turnipson	in progress, working on it
Mistlands	Tyrron & Grelka	in progress, working on it
Ashlands	Spalony Zenek & Skjold Cinderborn	in progress, working on it

Later-biome traders are locked until your character has participated in defeating the previous biome boss. Progression is personal, so joining an advanced multiplayer world does not automatically unlock every trader. Legendary Mieteg is the exception: if you find him, you can trade with him.

Every trader has a distinct role, appearance, equipment, stock, contracts, cargo routes and reputation progression. Their locations use custom camps and buildings intended to feel like part of the world rather than simple shop markers. The ground under each camp is levelled and cleared of trees, bushes and rocks (the three camps that stand at the water's edge keep their natural ground). A big camp now levels and clears only the ground it really needs, and its no-monster area and no-fighting zone cover exactly the same ground.

Resting in a trader's house gives a comfort level that grows with the biome: Meadows 2, Black Forest 3, Swamp 4, Mountains 5, and 6 from the Plains to the Ashlands.

Meet all 14 traders — artwork & stock cards

Meadows

Black Forest

Swamp

Mountains

Plains

Mistlands

Ashlands

Camps on the map

A trader's camp gets a small white scroll on the map as soon as somebody comes within a few hundred metres of it, the way Hildir's camp shows up. Every player on the server sees it, and it stays. (Older versions put a named dot on the map from 35 m; those dots are removed.)

The notice board, the Lox caravan and the wagon stand on level ground at the height of the camp, also beside a shore or on a slope.

Contracts

Every regular camp has a Contract Board. Press E to open a radial menu with that trader's five hunting contracts — 70 regular contracts in total.

Carry the physical contract while hunting. Completing a regular contract grants reputation and +2 levels to its associated Valheim skill. In multiplayer, nearby players with matching active contracts can progress their own contracts from the same kill.

Cargo & Lox Caravans

Every regular trader also has a Lox Caravan. The Lox is a functional caravan, not a normal tameable creature: interacting with it opens a radial cargo menu.

Each trader offers 5 shipments, for 70 cargo routes in total. Cargo costs 10 coins, is heavy and cannot pass through portals. You must physically move it to the destination trader to receive the reward and reputation.

Contracts and cargo are personal in multiplayer and are protected from other players taking over your active task.

Talking to traders

• E — the trader's shop. You can also hand in cargo and physical contracts the same way.
• Shift+E — the quest panel: the story quests of that trader (see below). Also used to hand in quest items.

Quests can be handed in to a trader even while their shop is still locked by boss progression.

Story quests

Eight traders (Meadows, Black Forest, Swamp and Mountains) tell their own stories through 47 quests, in chains of five or six. Each quest has its own objectives, places in the world, people, and a few surprises: searches, trails, hunts, dungeons, a sea monster, stone creatures and a good deal of gossip. The quests are part of ImmersiveTrader, no companion mod is needed.

• Quests are offered from reputation level 2 with the trader and have no upper limit. Each quest of a chain starts when the previous one is done. The sixth quest of a trader (Troldad, Grimvald, Rudy Warg, Encek, Mokra Dzika, Hrothgar, Ylva Frost) needs reputation level 4: until then the trader tells you why they do not trust you with it yet. Every sixth quest pays 999 coins on top of its other rewards.
• The sixth quests are the roads between the biomes: they send you to a trader of the next one. Meadows → Black Forest (Troldad's recipe for Grimvald), Black Forest → Swamp (Grimvald's rations for Encek, a salve from Mokra Dzika for Rudy Warg), Swamp → Mountains (Encek's order for Hrothgar, a shard of obsidian from Ylva Frost for Mokra Dzika) and Mountains → Plains (Ragnar's moonshine for Hrothgar, Bjarki's calming herbs for Ylva Frost).
• When the first step of a quest is a long journey, the red search circle is on the map at once, however far away it is.
• Rewards are coins, biome upgrade idols and, when Roots & Remedies is installed, items of that mod (seeds, clay, herbs and more).
• Quest progress is saved on the character, per world. Several quests can run at the same time; track the ones you like with the Track button.

Trader	Quests
Midka	For a Darker Day · Ninety to One · Someone Who Can Still Use Them · Midka's Matcha · Medicine for the Dead
Troldad	Jackie's Supper · The Dog Knows · What Remains of the Clan · Jackie's Lost Toy · Where Troldad Once Lived · A Dish Worth Carrying
Grimvald	A Recipe Worth Stealing · Barrels of the Deep · The Ink-Stained Shoal · A Tale Come True · A Smaller Favor · Rations for the Swamp
Rudy Warg	Cutting the Nests · The Broken Trail · The Bait · No Arrow Wasted · The Hunter Becomes the Hunted · A Salve From the Swamp
Encek	The Man Who Came Back · The Stolen Standard · Arm the Living · The Name on the Stone · Proof of Worth · Arrows for the Siege
Mokra Dzika	Something That Stinks · A Very Juicy Rumor · Who Was Sleeping With Whom? · The Beautiful Smell · The Gossip of the Dead · Mountain Glass
Hrothgar	Eyes in the Walls · Paper Cuts Deeper · The Egg Goes Home · Firewood for a Coward · A Thief Dresses Warm · One for the Road
Ylva Frost	The Fire That Should Not Burn · What the Scent Wakes · The Words for Calm · Roots for the Rite · What the Mountain Answered · To Mend What I Woke
Bjarki, Ragnar, Tyrron, Grelka, Spalony Zenek, Skjold Cinderborn	in progress, working on it

The Mountains. Hrothgar is sure somebody watches his fortress through the stone, and he is not entirely wrong: Fenrings at night, a cultists' library in a frost cave, a drake egg that has to go back to its nest, a cabin he would rather not visit himself, and a bottle of moonshine that belongs to somebody else. Ylva Frost has woken something on the mountain and wants to put it back to sleep: a Fuling signal fire in the snow, rite herbs that have to cross the sea (the sea notices), an old parchment in a ruined tower, and an answer from the summit that comes with wings, teeth and a great many bats.

Quests with friends

• A quest belongs to the player who took it, and that player's game brings its creatures into the world. Two players on the same quest get two sets of creatures, each at their own place on the map.
• Anyone may do the killing. A kill counts for the quest's owner while they stand within 100 m; they do not have to land a hit. A creature that dies while the owner is further away does not count and comes back. A boss is the exception: the owner must have damaged it.
• What quest creatures drop for the quest (the Serpent Trophy, the ghosts' Ectoplasm) can be picked up only by a player who has that quest.
• Birds and nests of the hunting quests count for every player with that objective within 100 m.

The quests are still being tested, so expect rough edges and tell us what you find.

Roots & Remedies and the items of the quests

Roots & Remedies has its own setting Items/ItemSource:

• Auto (default): with ImmersiveTrader installed the items of Roots & Remedies come from the quests; without it they come from the world.
• Quests, World, Both to choose it yourself. With the world as a source, rare seeds also grow in the open world and the items turn up in the chests of houses and ruins.
• ImmersiveTrader alone never gives items of Roots & Remedies: the quests simply pay their other rewards.
• Installed Roots & Remedies after you had already finished quests? Talk to the trader: the Roots & Remedies rewards of the quests you finished there are handed over then.

Reputation

Each regular trader has an independent five-level relationship:

Level	Reputation	Main unlocks
L1	0	Basic stock
L2	12	New stock + biome upgrade idol
L3	28	New stock + Reef-Crusted Shell
L4	44	New stock + Ward Scroll + Deep Sea Shell
L5 — Trusted	64	High-tier stock + Enhancement Scroll + Pearl-Bearing Shell + one-time Trusted reward

Reputation comes mainly from contracts and cargo deliveries. Each trader has their own Trusted reward, giving a reason to build relationships with more than one NPC.

Scrolls & navigation

ImmersiveTrader adds 17 Enhancement Scrolls for temporary bonuses such as elemental damage, health, stamina, Eitr, carry weight, mining, woodcutting, tools, running, jumping and bow use. Using the same Enhancement Scroll again refreshes its duration rather than stacking it.

There are also 9 Ward Scrolls providing temporary protection against Slash, Pierce, Blunt, Fire, Frost, Lightning, Poison, Spirit or Fall damage.

Three reputation-locked shells help track something unusual in the world:

• Reef-Crusted Shell — direction
• Deep Sea Shell — direction + biome
• Pearl-Bearing Shell — direction + biome + approximate distance

Legendary Mieteg

Legendary Mieteg has no permanent home. He rotates between 16 possible locations, remaining at one for roughly 2 Valheim days before moving again.

Mieteg has no normal Board or Lox Caravan. His shop carries special content, including scrolls and 9 Legendary contracts. These contracts can involve multiple objectives and rare enemies, with treasure rewards worth far more than ordinary jobs.

Finding him is intentionally part of the experience.

Multiplayer

ImmersiveTrader supports single-player and multiplayer. Purchases, contracts, cargo, reputation, cooldowns and progression are designed around personal player state and server validation.

For multiplayer:

• Every player should use the same ImmersiveTrader version.
• Dedicated servers need ImmersiveTrader and its dependencies installed server-side.
• Clients/server should use matching camp, board and blueprint configuration files.

Full documentation

This README is intentionally a quick overview. Exact offers, prices, limits, cooldowns, contracts, cargo rewards, scroll effects, progression rules, items, prefabs and assets are documented in control_tableIT.html, included with the mod and also available separately.

Requirements

• BepInExPack Valheim
• Jötunn — The Valheim Library

Optional companion: Roots & Remedies — smoked and dried food, herbs, farming and improved potions; its items also appear as rewards of the story quests.

Installation

r2modman

Install r2modman, select Valheim, find ImmersiveTrader, choose Download with dependencies, then launch with Start modded.

Manual

1. Install BepInExPack Valheim and Jötunn.
2. Extract ImmersiveTrader according to the package folder structure so the plugin is available under Valheim/BepInEx/plugins/.
3. Do not install multiple copies of ImmersiveTrader.dll.
4. If loading fails, check BepInEx/LogOutput.log.

Installation on existing world

1. Install BepInExPack Valheim and Jötunn.
2. Extract ImmersiveTrader according to the package folder structure so the plugin is available under Valheim/BepInEx/plugins/.
3. Do not install multiple copies of ImmersiveTrader.dll.
4. If loading fails, check BepInEx/LogOutput.log.
5. Use devcommands > it camps force (it will take about 10 minutes to check whole map) > it camps status
6. What we expect is 14/14 camps, Mieteg sites at least 10/16. Report it on Discord HypnoMODS if somehow it doesnt work for you.
7. Trees or grass inside a camp's building? Updated mods clear them automatically when the camp loads. To do it on the spot, stand near the camp and use it camps clear (vegetation only) or it camps refresh (vegetation, buildings, trader position and terrain under the houses). Both need admin rights on a dedicated server.

Camp commands (admin)

Open the console with devcommands enabled; on a dedicated server you need to be an admin (adminlist.txt).

• it camps status — how many camps and Mieteg sites this world has
• it camps generate — add the missing camps in unexplored zones
• it camps force — place every remaining camp, levelling rough ground
• it camps clear — remove trees, bushes and rocks around every loaded camp
• it camps refresh — clear, reload the camp layout and blueprints, put the trader, board and caravan back and reapply the ground under the houses (run it near the camp)
• it findall, it goto <traderId> — list camps / teleport to one

Quest commands (admin)

• it quest list | open <trader> | step | complete <quest> | reset [quest] | goto <quest> — look at, advance, finish or restart quests (it quest shows all options)
• it spawn quest [1-10] — puts every quest item in front of you
• it ground [5-60] — levels a square of ground around you, paints it dirt and clears trees and rocks

Quest configuration

In BepInEx/config/p0kahontazz.immersivetrader.cfg, section [Quests]:

• MinReputationLevel (default 2) — trader reputation level (1–5) from which a trader offers quests.
• The Brinewyrm encounter has its own section [Quests: Brinewyrm] (size, health, poison interval, fish in the shoal).

Ward and Scroll configuration

1. Close Valheim or stop the server.
2. Open BepInEx/config/p0kahontazz.immersivetrader.cfg in the local Valheim folder or dedicated server folder. the plugin is available under Valheim/BepInEx/plugins/.
3. Under [TraderStock], set EnhancementOffers to:

• ScrollsAndWards — both.
• ScrollsOnly — scrolls only.
• WardsOnly — wards only.
• None — neither.

1. Save and restart the game/server.
2. In multiplayer, the host/server setting applies to everyone.

Feedback & Bug Reports

BETA: Bugs may occur, especially in multiplayer.

Join Discord HypnoMODS to report bugs, share balance feedback and suggestions, or reach p0kahotnaz directly. If possible, include your ImmersiveTrader/Valheim versions and BepInEx/LogOutput.log.

Credits

Owner / Developer: P0KAHONTAZZ Author Me and everysingle Valheimians User sharing thier work on a page

ImmersiveTrader started as a project for playing Valheim with friends and grew into a larger gameplay expansion. Development has been heavily AI-assisted in programming, debugging and prototyping.

ImmersiveTrader is built with Jötunn. Huge thanks to its developers and contributors.

Building credits — Valheimians

Trader buildings and blueprints were created and freely shared by members of the Valheimians community. The original designs remain the work and property of their respective creators.

A sincere and generous thank you to the Valheimians builders who share their work for free. Without them, the trader settlements in ImmersiveTrader would not exist.

Permissions & Usage

ImmersiveTrader code is All Rights Reserved unless explicitly stated otherwise.

The released mod may be used for personal, private and non-commercial gameplay, including playing alone or with friends. Redistribution, re-uploading, repackaging, distributing modified versions, reuse of the source code/systems, derivative releases, commercial use or monetization requires prior written permission from P0KAHONTAZZ.

Third-party assets remain subject to the rights and licences of their respective owners.

Upcoming project — Children of the Ancient Heart

A separate upcoming project built around a huge castle/dungeon and an ancient power worshipped by a cult. The current concept includes 7 types of stone creatures, 3 Cultist mini-bosses, the Ancient Heart, a final boss encounter, treasure systems, new rewards and environmental storytelling.

The project is still in development and its final scope may change.