Update (2024.1.23): Check out https://www.nexusmods.com/valheim/mods/2509 as an alternative.

Update (2023.10.23): The 2.x version of BT has a core conflict with Hilder. There is a 3.x beta posted to NX. There is also a problem with the 3.x version. Menthus has gotten busy w/ work so I am not sure when we will see him again. He did however make the source code for the 3.x version public. https://github.com/MarvelProgramming/BetterTrader

Notice: Early Release of 3.0 version can be found in the file section. (2023.09.17).

GPORTAL Server Hosting
I've partnered with GPORTAL, a leading supplier of online game-hosting services around the globe. GPORTAL makes no compromises when it comes to your server's hardware, connection, routing and provides the best servers at an affordable cost!

Patreon

I spend countless hours every day working on, updating, and fixing mods for everyone to enjoy. While I will never ask for anyone to pay me to make a mod or add a feature, any support is greatly appreciated. >>Check it out<<, you might find benefits that catch your eye!



Better Trader

Vanilla Valheim's trader is very bare bones, only allows you to purchase a total of 6 items and has a clunky way of selling 'valuables'. Better Trader comes with a custom menu, adds over 310+ items, is highly configurable, and comes with built-in support for Epic Loot. Updates are ongoing and there is more to come, so stay tuned!



Configuration

Included with the mod are two config files.

• Menthus.bepinex.plugins.BetterTrader.cfg.vanilla closely emulates the vanilla values for buying and selling items.
• Menthus.bepinex.plugins.BetterTrader.cfg.full has most of the game items in it with the values Menthus set for them.
  

Select one of these files and copy it to Valheim\BepInEx\config, then rename it to Menthus.bepinex.plugins.BetterTrader.cfg


You have 2 methods of editing the configuration:

• Going to Valheim\BepInEx\config and opening Menthus.bepinex.plugins.BetterTrader.cfg.
• Using the >>BepInEx ConfigurationManager<< plugin. Simply download it, put it in your Valheim\BepInEx\plugins folder, and press F1 when in-game.
  

You have a growing list of configuration options:

[A_General.Trader]
Trader Wait For Discovery (defaults to true): True means the Trader will only sell items the player has discovered.
Trader Price Fluctuation (defaults to true): True means the Trader's prices will fluctuate every so often (the amount to fluctuate by and time it takes before the Trader's prices fluctuate are configurable).
Trader Price Fluctuation Scale (defaults to 0.3): Determines how much the prices should fluctuate from the base price of an item.
Trader Price Fluctuation Frequency (defaults to 1): How many days that pass between each price fluctuation.
Trader Has Coins (defaults to true): True means the Trader will use coins to purchase player items (the Trader's starting coin amount and time it takes before the Trader's coin reset are configurable).
Trader Base Coin Amount (defaults to 2000): How many coins the Trader has as a baseline.
Trader Coin Refresh Frequency (defaults to 2): How many days need to pass before refreshing the Trader's coin amount to [Trader Base Coin Amount].
Trader Can Repair Items (defaults to true): True means the Trader can repair items for the Player.

[B_General.ItemTypes.NameOfItemType]
enabled (defaults to true): True means every item of this type is enabled.

[C_Items.NameOfItemType.NameOfItem]
Purchase Price (defaults to 100): The base amount the Trader sells this item for (before fluctuating/scaling if [Trader Price Fluctuation] is true).
Sell Price (defaults to 100): The base amount this item can be sold for by the Player.
Tradeable (defaults to true): True means the Trader will sell this item to the Player.
Sellable (defaults to true): True means the Player can sell this item to the Trader.
Ignore Trader Wait For Discovery (defaults to false): True means this item will show up in the Trader's purchase list even if [Trader Wait For Discovery] is true and this item hasn't been discovered by the Player yet.

Example of an item's price being fluctuated:
priceFluctuationFactor = basePrice * TraderPriceFluctuationScale;
newPrice = basePrice + Random.Range(-priceFluctuationFactor, priceFluctuationFactor);


Installation

• This mod requires >>BepInExPack<< to work. Follow the BepInExPack installation instructions, then place the BepInEx folder (from the Better Trader download) into the Valheim folder. Make sure to replace all if you have a previous version of Better Trader installed!
• If you're playing the game in a different language and you are missing items, you must run the game in English and load into a world first. Then you can swap it back to your language and continue from there.
  

Compatibility Info

If you're a mod developer and something you've made adds custom items, in order for them to be loaded by Better Trader you must include them in Valheim's ObjectDB and ensure your mod loads before Better Trader.

For adding items to Valheim's ObjectDB: Consider creating postfix patches for ObjectDB's Awake and CopyOtherDB methods, then accessing ObjectDB's m_items field and adding your items there. An example of this might be:
namespace MyMod
{
[HarmonyBefore(new string[] { "Menthus.bepinex.plugins.BetterTrader" }), HarmonyPatch(typeof(ObjectDB))]
class ObjectDB_Patches
{
[HarmonyPostfix, HarmonyPatch("Awake")]
static void AwakePostfix(ObjectDB __instance)
{
__instance.m_items.Add(YourCustomItemGameObject);
}

[HarmonyPostfix, HarmonyPatch("CopyOtherDB")]
static void CopyOtherDBPostfix(ObjectDB __instance)
{
__instance.m_items.Add(YourCustomItemGameObject);
}
}
}


For changing your mod's load order: https://harmony.pardeike.net/articles/priorities.html for determining when your mod should load.



Server Info

Better Trader forces players to have the same (unmodified) version installed in order to join your server. Otherwise they're given an "Incompatible Version" error.

Better Trader syncs the server's config to connecting players without overwriting their config file (i.e., if a player connects to a server that has a different config, their config file won't change at all, but the values the Trader has will reflect the settings the server has). This was done so players can have a "solo" config, but also join servers where the config is different.



Links

GPORTAL
http://www.g-portal.com/?ref=Menthus15

Patreon
https://www.patreon.com/Menthus

Youtube
https://www.youtube.com/channel/UCfVYisJ8c6p37ol154rTHnw

Twitter
https://twitter.com/OriginalMenthus