ValheimMarket

Valheim Marketplace

A marketplace for Valheim. Build a Market Stall to trade with other players, and find Edda's regional trading stalls while exploring to sell gathered goods for coins and buy supplies. The mod is a BepInEx plugin and does not require Jötunn.

Install

1. Install a compatible BepInEx 5 build for Valheim on the host or dedicated server and every client.
2. Copy ValheimMarket.dll into BepInEx/plugins/ValheimMarket/ on each installation.
3. Start the game with BepInEx enabled. Build a player Market Stall from the hammer's Furniture category. Edda's stalls appear automatically in suitable parts of the world.

Use the same mod version on the server and every client. The server rejects market requests with a different protocol version.

How shops work

• A player shop belongs to the character who built its stalls. Only that character may post or cancel listings at those stalls. Only the builder may dismantle a player stall; stalls do not take damage.
• All stalls belonging to the same character show the same listings, offers, and uncollected goods. These records live in the server's market save, not in the physical stall.
• Every stall shows a directory of available shops. You can browse from any stall, but you must visit a stall belonging to the seller to buy, offer, or collect from that seller's shop.
• Posting an item or making an item offer removes the chosen stack from inventory and holds it in market escrow. Buying removes the listed coin price. The seller may accept or reject an offer later, even when the buyer is offline.
• Successful trades, canceled listings, and returned offers are delivered to your inventory while you are at the seller's stall. If delivery is interrupted or your inventory is full, the goods remain under Collect at any stall belonging to that seller. If every player stall is dismantled, the shop disappears from the directory; all records return when that character builds another stall.
• Listings have no fees or expiry. A shop may have 20 active listings; a listing may have 10 pending offers. This version is intended for trusted private groups and vanilla items.

Edda the Trader

Edda is enabled by default. To disable her, set [NPC Merchant] Enabled = false in the server's BepInEx/config/dev.monokaijs.valheimmarket.cfg. Existing regional stalls remain, while Edda disappears and trading stops until the setting is re-enabled.

The server targets 20 permanent trader sites per world across large inner and outer map regions, plus a dedicated trader within 800 meters of the starting stones. It uses the world seed, terrain height, and biome to find land with a level surface, and saves each stall and character with the world. Traders appear in the Meadows, Black Forest, Swamp, Mountain, Plains, and Mistlands. Exploring within 90 meters of a stall adds a named trader pin to your map, using the game's trader icon when available. Saved trader pins and the explored area can be shared through the cartography table. The market directory also shows each region's nearest stall location. Edda is an actual armed Dverger-based character who patrols near her stall, fights hostile creatures, and retaliates if a player attacks her. She has 2,200 health at level four and deals 2.5 times the source creature's weapon damage. She refuses trades while hostile. Defeating her drops roughly 15–30 coins. She returns after two full in-game days; purchases and sales pause until then, while previously earned goods can still be collected at the stall. Talking to her and combat produce short chat lines.

Interact with Edda or her stall and open the Edda tab. What she buys depends on the biome: Meadows traders want wood, stone, flint, berries, and early crops; Plains traders also want barley and flax. She buys only full bundles. For example, 5 wood or stone pay 1 coin, and 5 carrots pay 2 coins where carrots are accepted. The sale button shows the exact payout before depositing goods. Coins go straight to your inventory when there is space; otherwise they remain under Collect at a stall in that region.

Her stock also depends on the biome and changes each in-game day. Meadows traders sell expensive seeds and tree supplies; Black Forest and later traders can offer copper and tin ore alongside seeds and crops. Purchases go straight to your inventory when there is space; interrupted deliveries remain under Collect at a stall in the same region. Edda does not barter. Her stock prices remain far above her material buy rates.

The server stores one market file per world at BepInEx/config/ValheimMarket/<world ID>.market and a backup at <world ID>.market.bak. Include these files when backing up or moving a world. Clients keep a pending-action journal and collection receipts in the same directory to recover from ordinary connection loss.

Build

The project targets .NET Framework 4.6.2 and compiles against your own Valheim installation. On macOS with Valheim in the default Steam path:

dotnet build src/ValheimMarket/ValheimMarket.csproj -c Release
dotnet tool install --global tcli --version 0.2.4
./scripts/package.sh 1.0.0 Creaton

On other installations, pass GameManaged (the game's Managed assembly directory) and BepInExCore to MSBuild. For example:

dotnet build src/ValheimMarket/ValheimMarket.csproj -c Release \
  -p:GameManaged=/path/to/Valheim/valheim_Data/Managed \
  -p:BepInExCore=/path/to/Valheim/BepInEx/core

The compiled DLL is in src/ValheimMarket/bin/Release/net462/. The packaging script creates dist/Creaton-ValheimMarket-1.0.0.zip with Thunderstore's manifest, icon, README, and plugin DLL. No game assemblies or BepInEx binaries are included. Pass -p:MarketVersion=1.2.3 to dotnet build when building a different plugin version; pass the same version to package.sh.