Valheim Marketplace Mod
Complete Configuration Guide
NPCs
Quests
Dialogues
Trading
Territories
AI Ready
🎯 Overview
The Valheim Marketplace mod adds various NPCs and mechanics to your Valheim server, allowing admins to configure them server-side without needing to restart the server.
🏪 Marketplace
Player-to-player trading system with currency support
👥 NPCs
Trader, Buffer, Gambler, Banker, Teleporter, Quest Giver, Info NPC
🎮 Quests
7 quest types: Kill, Collect, Harvest, Craft, Talk, Build, Move
💬 Dialogues
Interactive conversations with conditions and commands
🗺️ Territories
Zone management with special effects and restrictions
🎨 Transmog
Item appearance customization with visual effects
⚙️ Installation & Setup
Prerequisites
- Valheim server with BepInEx installed
- Admin access to server files
- Debug mode enabled for NPC placement
Installation Steps
- Install the mod on both server and all clients
- Restart the server to generate configuration folders
- Enable debug mode and spawn the "MarketplaceHammer"
- Configure NPCs using the hammer tool
📁 Folder Structure
BepInEx/config/Marketplace/
├── Configs/
│ ├── Bankers/
│ ├── BufferProfiles/
│ ├── Buffers/
│ ├── Dialogues/
│ ├── Gamblers/
│ ├── QuestEvents/
│ ├── QuestProfiles/
│ ├── Quests/
│ ├── ServerInfos/
│ ├── Traders/
│ ├── Transmogrifications/
│ └── Territories/
├── DiscordWebhooks/
├── DistancedUI/
├── PlayerTags/
└── MarketPlace.cfg
👥 NPC System
Creating NPCs
- Enable debug mode
- Spawn "MarketplaceHammer" item
- Use hammer to place NPCs in the world
- Configure NPC type, profile, and appearance
NPC Types
🏪 Marketplace
Player-to-player trading
🛒 Trader
NPC-to-player trading
⚡ Buffer
Temporary buffs for items
🎲 Gambler
Chance-based rewards
🏦 Banker
Item storage and interest
🚀 Teleporter
Fast travel system
NPC Configuration
NPC Profile: [profile_name]
NPC Name: [custom_name]
NPC Model: [prefab_name] or [prefab_name@humanoid]
Patrol Data: [x1,z1,x2,z2,...]
Dialogue Profile: [dialogue_profile]
🎮 Quest System
Quest Database Format
[QuestID=autocomplete]
QuestType
Name
Description
Quest Target Prefab, Amount, Min Level
QuestRewardType: prefab, Amount, Level
In-Game Days Cooldown, Quest Time Limit
QuestRequirementType: Prefab, MinLevel
Quest Types
| Type | Description | Example |
|---|---|---|
| Kill | Target creatures | Wolf, 10, 2 (10 wolves level 2+) |
| Collect | Target items (takes from inventory) | SwordIron, 5 |
| Harvest | Target pickable objects | Pickable_Carrot |
| Craft | Target crafted items | SwordIron, 1, 5 (level 5 iron sword) |
| Talk | Target NPCs by name | Village Elder |
| Build | Target building pieces | WoodWall |
| Move | Target coordinates | X, Z, Radius, "Destination", true |
Quest Rewards
Item: SwordIron, 1, 5 # 1 iron sword level 5
Skill: Run, 10 # +10 run skill levels
Pet: Wolf, 2, 10 # 2 wolves level 10
Skill_EXP: Run, 100 # +100 run skill exp
EpicMMO_EXP: 100 # +100 EpicMMO exp
Battlepass_EXP: 100 # +100 battlepass exp
GuildAddLevel: 10 # +10 guild levels
SetCustomValue: MyValue, 100 # set custom value
AddCustomValue: MyValue, 100 # add to custom value
Example Quest
[WolfHunter=autocomplete]
Kill
Wolf Hunter
Kill 10 wolves to prove your hunting skills
Wolf, 10, 2
Item: SwordIron, 1, 3 | Item: Coins, 100
10, 1800
Skill: Bows, 5
💬 Dialogue System
Dialogue Format
[UniqueProfileName]
Dialogue Text
Player Option 1
Player Option 2
...
Player Option Attributes
| Attribute | Usage | Example |
|---|---|---|
| Text | Option text | Text: Hello there! |
| Transition | Next dialogue | Transition: NextDialogue |
| Command | Execute action | Command: GiveItem, Coins, 50 |
| Icon | Display icon | Icon: Hammer |
| Condition | Show conditionally | Condition: HasItem, SwordIron, 1 |
| Color | Text color | Color: 255, 128, 0 |
Available Commands
OpenUI: OpenUI, UIType, Profile
GiveItem: GiveItem, ItemPrefab, Amount, Level
RemoveItem: RemoveItem, ItemPrefab, Amount
GiveQuest: GiveQuest, QuestName
Teleport: Teleport, X, Y, Z, TeleportWithOre
Damage: Damage, Amount
Heal: Heal, Amount
GiveBuff: GiveBuff, BuffName, Duration
PlaySound: PlaySound, SoundName
ConsoleCommand: ConsoleCommand, Command
Example Dialogue
[mainmenu]
What are you searching for?
Text: I'm looking to Buy or Sell | Transition: trader | Icon: Coins
Text: I'm looking for Buffs | Transition: buffs | Icon: BeltStrength
Text: I'm looking to do Quests | Transition: quests | Icon: BlackCore
Text: Heal Me | Command: Heal, 100 | Icon: Demister
[trader]
What do you want to browse?
Text: Misc Related | Command: OpenUI, Trader, misc | Icon: Dandelion
Text: Hunting Related | Command: OpenUI, Trader, hunter | Icon: SerpentMeat
Text: Take me back to MainMenu | Transition: mainmenu
💰 Trading Systems
Trader Format
[ProfileName]
ItemA, ItemA quantity, ItemB, ItemB quantity, ItemB level
Advanced Trader Format
[ProfileName]
Item1, Quality1, Level1, Item2, Quality2, Level2 = Item1, Quality1, Level1, Item2, Quality2, Level2
Gambler Format
[ProfileName=ItemsPerRollCount]
RollItemPrefab, RollItemCount, Item1, Item1count, Item2, Item2Count, Item3, Item3Count
Banker Format
[ProfileName]
ItemPrefab1
ItemPrefab2
ItemPrefab3
🗺️ Territory System
Territory Format
[ZoneName@Priority]
Shape type (Circle, Square, Custom)
X pos, Z pos, Radius (for circle/square) or X pos, Z pos, X length, Z length (for custom)
Red Color, Green Color, Blue Color, Show Territory on water (True/False)
Zone Flags (separated by comma if multiple)
Owners SteamID (separated by comma if multiple)
Available Flags
Basic
PushAway, NoBuild, NoPickaxe, NoInteract, NoAttack
PvP
PvpOnly, PveOnly
Healing
PeriodicHeal, PeriodicHealALL
Environment
NoMonsters, CustomEnvironment, ForceBiome
Movement
MoveSpeedMultiplier, NoPortals
Resources
InfiniteFuel, InfiniteEitr, InfiniteStamina
Example Territory
[ExampleZone]
Square
150, 100, 800
0, 128, 255, false
NoBuild, NoInteract, PeriodicHealALL = 50
None
[ZoneWithHigherPriority@2]
Square
150, 100, 400
255, 0, 0, false
CustomEnvironment = Clear, NoAttack, NoPickaxe, PeriodicDamage = 10
None
🛠️ Quest Builder Tool
Create quests, dialogues, and other configurations using interactive forms. Fill out the forms below and generate the proper configuration code.
🎮 Quest Configuration
💬 Dialogue Configuration
💰 Trader Configuration
⚡ Buffer Configuration
🤖 AI Agent Instructions
For AI Agents Creating Configurations
When creating configurations for the Valheim Marketplace mod, follow these guidelines:
1. File Structure
- Always create files in the correct subdirectories under
Configs/ - Use descriptive filenames that indicate the purpose
- Follow the exact formatting shown in examples
2. Quest Creation
- Use
[QuestID=autocomplete]for quests that should auto-complete - Always specify quest type, name, description, targets, rewards, cooldown, and requirements
- Use proper formatting for multiple targets/rewards with
|separator - Include appropriate cooldown values (use 10000+ for one-time quests)
3. Dialogue Creation
- Use unique profile names in square brackets
- Include NPC dialogue text on the line after the profile name
- Format player options with proper attributes separated by
| - Use appropriate conditions and commands for interactive dialogues
4. Common Mistakes to Avoid
- Don't forget commas between parameters
- Don't mix old and new format syntax
- Don't use invalid prefab names
- Don't forget to include all required fields
- Don't use incorrect condition syntax
5. Validation Checklist
[ ] All required fields are present
[ ] Proper syntax and formatting
[ ] Valid prefab names and references
[ ] Logical quest progression and requirements
[ ] Balanced rewards and costs
[ ] Appropriate cooldowns and time limits
[ ] Complete dialogue trees with proper transitions
[ ] Consistent naming conventions
6. AI Agent Workflow
- Identify Requirements: Determine what type of content is needed
- Choose File Type: Select appropriate configuration file type
- Create Structure: Set up basic file structure with proper headers
- Add Content: Fill in all required fields with appropriate values
- Validate Format: Check syntax and formatting against examples
- Test Logic: Ensure quest chains, dialogue flows, and rewards make sense
- Balance Check: Verify costs, rewards, and requirements are appropriate
- Final Review: Double-check all references and dependencies