Item Upgrader

Turn spare resources and equipment into a chance to obtain the reward you want. Choose your stake, choose an item and its quantity, then check the odds before spinning the upgrade wheel.

Valheim 1.0.16 · Client-side · English / Русский · F8 menu

Actual in-game screenshot of the English interface. Items and values shown depend on your game and configuration.

How it works

1. Press F8 to open the menu.
2. Select an unequipped item from your inventory and the quantity you want to spend.
3. Choose a reward from the catalog and set how many you want to receive.
4. Check the displayed success chance and press UPGRADE.
5. Watch the smooth five-second spin. On success, press CLAIM to collect your reward.

The selected stake is spent on every attempt. A successful roll gives you the chosen reward; a failed roll consumes the stake without a reward. Rewards are created at quality 1 with full durability. If your inventory cannot hold everything, you can claim the reward in smaller batches.

F8 or Esc closes the menu. Closing it does not cancel a spin already in progress.

Features

• A menu that fits Valheim. Dark panels, warm bronze details, clear item cards and a central chance wheel.
• Progression that follows your character. Rewards unlock as you discover their materials/items or crafting recipes. Existing character discoveries count too.
• An optional all-items mode. The top-left ALL ITEMS / ВСЕ ПРЕДМЕТЫ switch bypasses discovery restrictions. It starts off when entering a world; test, obsolete and NPC-only items remain excluded.
• Quantity selection. Choose both how much to stake and how many reward items you want. Higher total reward value lowers your chance for the same stake.
• Configurable item values. Automatic values consider resources, biome progression and crafting costs, including metals and Deep North content. Equipment quality increases value by at most ×2; wear reduces stake value.
• A quick catalog. Search by item name or internal ID, cycle categories, scroll with the mouse wheel or drag the slim scrollbars.
• Automatic English and Russian. The interface follows the game language. Other languages use English UI text, while item names stay in the game's selected language.

Installation

Install with Thunderstore Mod Manager or r2modman. The required BepInEx package is installed as a dependency.

For manual installation, copy the included folder so the DLL is located at:

Valheim/BepInEx/plugins/ItemUpgrader/ItemUpgrader.dll

Start the game with BepInEx, enter a world and press F8.

The mod runs on the client. No server installation is required; the menu, odds and outcomes are calculated locally.

Settings and balance

After the first launch, settings are stored in BepInEx/config/valheim.itemupgrader.cfg. Individual values are in BepInEx/config/ItemUpgrader/ItemValues.json.

Setting	Default	What it changes
OpenKey	F8	Menu hotkey
MaximumRewardAmount	1000	Maximum selected reward quantity
SpinSeconds	5	Wheel animation duration
ScrollRowsPerNotch	2	Mouse-wheel scrolling speed
ReturnRate	0.85	Base chance multiplier
MaximumChance	0.95	Chance cap: 95%
UpgradeChanceExponent	1.25	Extra reduction for rewards worth more than the stake

The chance depends on total stake value ÷ total reward value. A small stake aimed at a much more valuable reward has a smaller chance; adding reward items increases their total value. The number shown in the menu is the calculated chance for the current selection, not a fixed chance for every roll.

Edit ItemValues.json and use RELOAD VALUES / ОБНОВИТЬ ЦЕНЫ to apply the new values. Setting an item's value to 0 disables its exchange; removing its entry restores automatic pricing. Custom prices override automatic value limits, while the quality multiplier remains capped at ×2.

When updating, close the game, replace the DLL and keep only one copy in your plugins folder. Preserve your configuration, ItemValues.json and AutomaticValues.json.

Русский

Item Upgrader превращает лишние ресурсы и снаряжение в шанс получить выбранный предмет. Задай ставку и желаемую награду, посмотри вероятность и испытай удачу на колесе улучшения.

Как пользоваться

1. Нажми F8 и выбери предмет из своего инвентаря.
2. Укажи количество ставки кнопками − / + / ВСЁ.
3. Выбери награду в каталоге справа и задай её количество.
4. Посмотри шанс в центре и нажми УЛУЧШИТЬ.
5. После пятисекундного вращения при успехе нажми ЗАБРАТЬ.

Ставка списывается при каждой попытке. При успехе ты получаешь выбранную награду; при проигрыше ставка сгорает. Награда выдаётся первого качества и с полной прочностью. При нехватке места её можно забрать частями. F8 / Esc закрывает меню, но не отменяет начатое вращение.

Прогрессия, ценности и язык

По умолчанию каталог учитывает открытия персонажа: знакомые предметы/материалы и рецепты. Сверху слева есть переключатель ВСЕ ПРЕДМЕТЫ, который временно снимает это ограничение. При входе в мир он выключен; служебные, тестовые и устаревшие вещи скрыты в обоих режимах.

Ценности учитывают ресурсы, биом и стоимость изготовления. Чем выше суммарная ценность награды относительно ставки, тем меньше шанс её получить. Бонус качества ограничен ×2, а износ снижает оценку ставки. Цены можно настроить в ItemValues.json и применить кнопкой ОБНОВИТЬ ЦЕНЫ.

Русский и английский интерфейсы переключаются автоматически по языку Valheim. Для остальных языков интерфейс мода английский, а названия предметов остаются на языке игры.

Установи через менеджер модов или скопируй BepInEx/plugins/ItemUpgrader в папку игры. На сервер устанавливать мод не требуется: меню и обмен работают локально. При обновлении закрой игру, замени DLL и сохрани cfg и оба файла цен.

Credits and license

Created with assistance from OpenAI Codex. Released under the MIT License.

MIT License

Copyright (c) 2026 Item Upgrader contributors

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.