Valheim

File information

Last updated

Original upload

Created by

Menthus

Uploaded by

Menthus15

Virus scan

Safe to use

Tags for this mod

About this mod

Adds a custom trader menu, 310+ items to buy/sell, built-in support for Epic Loot, and an extensive list of configuration options.

Requirements
Permissions and credits
Changelogs
Donations
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

You have 2 methods of configuration:

  1. Going to Valheim\BepInEx\config and opening Menthus.bepinex.plugins.BetterTrader.cfg.
  2. 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]
Is Server (defaults to false): True means Better Trader will behave as if it's installed on a dedicated server (this shouldn't be necessary otherwise).

[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

  1. 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!
  2. 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

Discord
https://discord.gg/veqFeuZFku

GitHub
https://github.com/Menthus123

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

Twitter
https://twitter.com/OriginalMenthus