MerchantNPCs

MerchantNPCs

A Valheim mod that adds buildable merchant NPCs to your solo world. Each merchant is tied to a specific biome and progression stage.

Watch the video to learn more:

Features

• Biome-Based Progression: Merchants unlock as you defeat bosses
• Eight Unique Merchants: One for each biome in Valheim
• Customizable Inventories: Easily modify what each merchant sells
• Customizable Merchant Build Requirements: Set the build material requirements for each merchant
• Automatic Selling: Sell items to merchants at half their buy price
• Easy to Use: Build merchants using the hammer's "Merchants" tab
• Solo Worlds Only: The mod is designed to work only in solo worlds. If you would like multiplayer, check out KG's Marketplace and Server NPCs mod.

Installation

• Install BepInEx
• Install Jotunn
• Download the latest release of MerchantNPCs
• Place the MerchantNPCs.dll in your BepInEx/plugins folder

Merchant Types & Requirements

• Meadows Merchant
• Requirements: Wood (50), Stone (50), Flint (25)
• Sells: Basic meadows resources and tools
• Black Forest Merchant
• Requirements: Fine Wood (20), Troll Hide (10), Copper (10), Eikthyr Trophy (1)
• Sells: Black Forest resources and bronze equipment
• Swamp Merchant
• Requirements: Ancient Bark (20), Guck (10), Iron (10), Elder Trophy (1)
• Sells: Swamp resources and iron equipment
• Mountain Merchant
• Requirements: Freeze Gland (10), Wolf Pelt (10), Silver (10), Bonemass Trophy (1)
• Sells: Mountain resources and silver equipment
• Plains Merchant
• Requirements: Barley (10), Black Metal Scrap (10), Deathsquito Needle (5), Moder Trophy (1)
• Sells: Plains resources and black metal equipment
• Mistlands Merchant
• Requirements: Royal Jelly (10), Yggdrasil Wood (20), Carapace (5), Yagluth Trophy (1)
• Sells: Mistlands resources and carapace equipment
• Ashlands Merchant
• Requirements: Blackwood (20), Flametal Ore (5), Fiddlehead Fern (10), Seeker Queen Trophy (1)
• Sells: Ashlands resources and flametal equipment
• Deep North Merchant
• Requirements: Freeze Gland (200), Wolf Pelt (200), Fader Trophy (20)
• Sells: Deep North resources and frost equipment

Customizing Merchant Inventories

Merchant inventories can be customized by editing the text files in:

BepInEx/config/MerchantNPCs/

Each merchant type has its own file:

• meadows.txt
• blackforest.txt
• swamp.txt
• mountain.txt
• plains.txt
• mistlands.txt
• ashlands.txt
• deepnorth.txt

File Format

Each line in the file represents one item with the following format:

ItemName:BuyPrice

Example:

Iron:30

IronNails:8

Item Properties

• ItemName: The internal name of the item (e.g., "Iron", "IronNails")
• BuyPrice: How much the item costs to buy

Sell prices are automatically set to half of the buy price.

Customizing Merchant Build Costs

You can customize the resource requirements for building each merchant by editing the configuration file at:

BepInEx/config/ruijven.merchantnpcs.cfg

The configuration file is automatically generated the first time you run the game with the mod installed.

Configuration Format

The configuration file is organized into sections for each merchant type:

[Meadows Merchant]

Resource1Type=Wood

Resource1Amount=50

Resource2Type=Stone

Resource2Amount=50

Resource3Type=Flint

Resource3Amount=25

[Black Forest Merchant]

Resource1Type=RoundLog

Resource1Amount=20

Resource2Type=TrollHide

Resource2Amount=10

Resource3Type=Copper

Resource3Amount=10

Resource4Type=TrophyEikthyr

Resource4Amount=1

Customization Options

For each merchant, you can:

• Change Resource Types: Modify what materials are needed to build each merchant by changing the ResourceXType values
• Adjust Resource Amounts: Change how much of each material is required by modifying the ResourceXAmount values
• Add or Remove Requirements: You can set an amount to 0 to effectively remove a requirement

Item Type Names

When changing resource types, you must use the internal item name. Some common examples:

• Wood - Regular wood
• ElderBark