Item Upgrader

Choose your reward. See the odds. Take the risk.

Turn spare resources and equipment into a chance to obtain the item you want. Set your stake, pick a reward and its quantity, then watch the wheel spin. A win gives you the selected reward; a loss consumes your stake.

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

In-game screenshots

1. English interface

2. Russian interface

Actual in-game screenshots. Available items, values and odds depend on your character and configuration.

What you can do

Feature	How it works
Upgrade roulette	The orange sector shows your success chance. Enjoy a smooth five-second spin, then claim a win.
Quick value picks	×2 / ×4 / ×8 pick a random eligible reward near the requested multiple of your total stake value.
Quick odds picks	30% / 50% / 70% find a random reward with nearby calculated odds. The menu shows the actual chance.
Two quantity sliders	Adjust how much to spend and how many items to receive. Sliders, buttons and the reward number field stay in sync.
Character progression	Rewards become available as you discover items or learn recipes. Existing discoveries count too.
Balanced defaults	Rewards are limited to one actual stack of the selected item. The default success cap is 90%.
Valheim-style menu	Dark surfaces, warm gold details, a clear central wheel, search, categories and fast scrolling.
Automatic language	Russian and English follow the game language. Other languages use English UI text with native item names.

Your first upgrade

1. Press F8 and select an unequipped inventory item.
2. Set your stake quantity with the left slider or − / + / ALL.
3. Choose a reward from the catalog, or use a quick pick. Adjust its quantity on the right.
4. Check the actual success chance and press UPGRADE.
5. After the spin, press CLAIM if you win.

The selected stake is spent on every attempt. Rewards arrive at quality 1 with full durability. If your inventory is full, claim what fits and collect the remainder after making space. F8 / Esc closes the menu; closing it does not cancel a spin already started.

Quick picks: a shortcut to a new target

The value buttons use the total selected stake, including quantity, quality and wear. If your stake is worth 100, ×2 looks for a reward total near 200. The mod chooses both an eligible item and its legal integer quantity.

Percentage buttons use your current chance settings. Exact matches are not always possible because of item prices, discoveries and stack limits. Repeat a button for a new random choice among nearby options, or adjust a slider afterward. A quick pick only selects a target; UPGRADE starts the attempt.

Picks use the full eligible catalog, independently of search and category filters. The configured quantity ceiling and chance cap still apply.

NO LIMITS

Recommended: keep NO LIMITS off to preserve upgrade balance and progression.

The top-left switch is off by default. Normal mode follows your character's discoveries and allows at most one stack of the chosen reward. The stack size comes directly from the game's item data, including changes from other mods.

Turning NO LIMITS on opens the full obtainable catalog and permits multiple reward stacks, up to MaximumRewardAmount. Test, obsolete, NPC-only and exchange-disabled items stay hidden. Prices, the chance formula and the configured chance cap remain active.

Hover ? for detailed help and a red balance recommendation. The mode resets on world/character entry and is locked during spins or while a reward awaits collection. Previously earned rewards are preserved in full.

Installation and updates

Install with your Thunderstore-compatible mod manager; BepInEx is declared as a dependency. For manual installation, put the included DLL here:

Valheim/BepInEx/plugins/ItemUpgrader/ItemUpgrader.dll

Start Valheim with BepInEx, enter a world and press F8. No server installation is required: the menu, calculations and outcomes run locally.

When updating, close the game, replace the old DLL and keep only one copy. Preserve your cfg, ItemValues.json and AutomaticValues.json.

Settings and item values

Settings: BepInEx/config/valheim.itemupgrader.cfg
Item values: BepInEx/config/ItemUpgrader/ItemValues.json

Setting	Default	Purpose
OpenKey	F8	Open/close the menu
SpinSeconds	5	Wheel animation duration
ScrollRowsPerNotch	2	Rows moved per mouse-wheel notch
MaximumChance	0.90	Success chance cap in both modes
MaximumRewardAmount	1000	Absolute reward ceiling; normal mode also applies the item's stack size
ReturnRate	0.85	Base probability multiplier
UpgradeChanceExponent	1.25	Extra risk for rewards worth more than the stake

Automatic values account for resources, biome progression, recipes, processing chains and acquisition difficulty, including metals and Deep North items. Higher equipment quality adds at most ×2 base value; wear lowers stake value. More reward items increase total reward value and lower the chance for the same stake.

Edit individual values, then use RELOAD VALUES. A value of 0 disables exchange for that item; removing its entry restores automatic pricing. Custom values override automatic value limits. Edit cfg settings with the game closed.

Русский

Выбери награду. Посмотри шанс. Испытай удачу.

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

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

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

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

Быстрый подбор и количество

• ×2 / ×4 / ×8 выбирают случайный доступный предмет и его количество с общей ценностью около указанного множителя ставки. Для ставки на 100 кнопка ×2 ищет награду примерно на 200.
• 30% / 50% / 70% подбирают цель с близкой вероятностью по текущей формуле. Точное совпадение зависит от цен, целого количества, открытий персонажа и размеров стака. В меню всегда показан реальный шанс.
• Левый ползунок задаёт количество из выбранного стака инвентаря. Правый меняет количество награды в пределах действующего лимита. Цена и вероятность обновляются сразу.

Повторное нажатие делает новый случайный выбор среди близких вариантов. Подбор учитывает весь разрешённый каталог, независимо от поиска и категории. Кнопки только выбирают цель; попытку запускает УЛУЧШИТЬ.

Баланс и режим «Без ограничений»

По умолчанию каталог следует открытиям персонажа, максимум награды — один стак выбранного предмета, а предел успеха — 90%. Например, предмет со стаком 30 позволяет получить до 30 штук за попытку; предмет со стаком 1 — одну. Размеры берутся из игры.

Для сохранения баланса улучшений рекомендуем оставлять «БЕЗ ОГРАНИЧЕНИЙ» выключенным.

Переключатель одновременно открывает весь каталог доступных игровых вещей и разрешает несколько стаков, до MaximumRewardAmount. Служебные предметы остаются скрыты, цены и настройки шанса продолжают действовать. Подсказка ? объясняет оба режима и выделяет рекомендацию красным. Режим выключается при входе в мир или смене персонажа; во время вращения и до получения выигрыша выбор заблокирован.

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

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

Changelog / История изменений

0.6.4 · Interface polish / Доработка интерфейса

• Slim quantity sliders with no pale outline; fixed stretched handles and improved padding.
• More space between the wheel and UPGRADE.
• Red Russian/English recommendation in NO LIMITS help.
• Updated page description and two current in-game screenshots.
• Тонкие ползунки без светлой обводки, исправленные размеры и отступы, больше места у кнопки улучшения и красная рекомендация в подсказке.

0.6.3 · Quick selection / Быстрый подбор

• Added ×2 / ×4 / ×8 and 30% / 50% / 70% random reward picks.
• Added synchronized stake/reward quantity sliders.
• Added actual multiplier/odds feedback; picks respect discoveries and quantity limits.
• Кнопки подбора случайной цели по ценности или шансу, два ползунка количества и отображение фактического результата подбора.

0.6.2 · Balanced defaults / Ограничения и шанс

• Default chance cap reduced to 90%.
• Combined the catalog and stack overrides into NO LIMITS, off by default.
• Added ? hover help and improved wheel/footer spacing.
• Предел успеха 90%, общий переключатель «Без ограничений» и подробная подсказка.

Earlier updates / Предыдущие обновления

0.6.1

One actual reward stack by default; optional override and quantity clamping.
Максимум награды — один стак выбранного предмета по умолчанию.

0.6.0

Minimal Valheim-style interface, improved cards/wheel, slim scrollbars and window scaling.
Новый минималистичный интерфейс в стилистике Valheim и улучшенная компоновка.

0.5.1

Automatic Russian/English interface based on game language.
Автоматическое переключение русского и английского языка.

0.5.0

Obtainable-item filtering and progression based on character discoveries.
Фильтрация служебных вещей и открытие каталога по мере прохождения.

0.4.0

Reworked metal/equipment balance, recipe-chain valuation and a maximum ×2 quality bonus.
Переработан баланс металлов и снаряжения, бонус качества ограничен ×2.

0.3.0

Faster scrolling and improved Deep North/processing-chain values.
Ускорена прокрутка, уточнены ценности Deep North и цепочек переработки.

0.2.0

Smooth five-second spins, pooled catalog cards, reward quantities and partial claiming.
Плавное пятисекундное вращение, улучшенная производительность и получение награды частями.

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.