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.

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.

Changelog

0.7.1 · Cleaner menu / Главное окно и настройки

• Moved NO LIMITS into SETTINGS, with the original ? help and red balance recommendation.
• Moved RELOAD VALUES into SETTINGS; added ? help with the exact price-file path, edit/save/reload steps, exclusions and automatic-price restoration.
• Grouped these controls as immediate actions, separate from the visual-settings draft.
• Removed the main footer divider above SETTINGS and HISTORY; widened the footer hint area.
• Centered the subtitle below the main title; resized settings and help panels with comfortable spacing.
• Added Russian/English action hints. Prices, odds, progression, character state and earned rewards unchanged.
• «Без ограничений» и «Обновить цены» перенесены в настройки; у обеих функций есть вопросики с подсказками.
• Убрана линия над кнопками настроек и истории, подзаголовок выровнен по центру.
• Действия применяются сразу; кнопка «Применить» сохраняет параметры интерфейса.

0.7.0 · Personal catalog and comfort

• Character favorites, last selected reward/quantity and a saved 20-attempt history.
• Name/value/near-stake sorting and biome/progression filtering.
• Detailed value tooltips with quality, durability, totals, acquisition estimates and stack size.
• In-game text/menu size, scroll speed, spin duration, volume, sound and effect settings.
• Quiet original wheel/result sounds and a short success rune glow.
• Compact catalog toolbar, two complete card rows and separate history/settings windows with Esc support.
• The current history outcome stays hidden until the wheel stops; Apply saves settings together and Close discards the draft.
• Existing prices, 90% default chance cap, progression, one-stack default limits and reward receipts retained.
• Built with the supplied Valheim 1.0.16 and BepInEx 5.4.23.5 assemblies; intended for 1.0.17, pending live testing.
• No item-protection/locking feature added.

Русский

• Избранное, история последних 20 попыток и последняя цель с количеством сохраняются отдельно для персонажа.
• Сортировка по названию, ценности и близости к ставке; фильтр биома/этапа получения.
• Подробные подсказки с расчётом ценности, качеством, износом и размером стака.
• Окно настроек текста, меню, прокрутки, вращения, громкости, звуков и эффектов.
• Тихие звуки колеса и результата; краткое свечение рун при успехе.
• Компактная строка фильтров, два полных ряда карточек, отдельные окна истории и настроек.
• Баланс и получение сохранённых наград сохранены; защита предметов не добавлялась.
• Сборка по библиотекам 1.0.16; использование с 1.0.17 нужно проверить в игре.

0.6.4 (local UI update)

• Slim quantity sliders: 2-unit rail/fill and 6-by-12 handle, with no pale handle outline.
• Fixed Unity's perpendicular handle stretching: the height delta is zero, so visible size is exactly the handle area's height instead of adding a second height.
• Added comfortable spacing below quantity buttons and above the item-slot bottom, while retaining a larger invisible drag area.
• Moved UPGRADE lower and reduced its height slightly; wheel-to-button clearance increases from 6 to 19 reference units.
• Added a separate bold red Russian/English recommendation at the top of NO LIMITS hover help: keep the mode off to preserve upgrade balance.
• Increased help popup space, separated recommendation/body, and prewarmed the new bold glyphs across frames.
• Gameplay, presets, prices, quantity rules, config markers and saved rewards are unchanged. Local archive only; no Thunderstore package prepared for this version.

0.6.3

• Added ×2 / ×4 / ×8 random reward presets based on total selected stake value.
• Added 30% / 50% / 70% presets using the configured chance curve and cap.
• Presets choose an eligible item and its best legal integer quantity, then randomize within a nearby group. Actual value multiplier and odds are displayed; selection never starts a roll or spends items.
• Quick selection respects character discoveries, obtainable-item filtering, real stack sizes and the NO LIMITS ceiling. Search/category filters do not narrow automatic picks.
• Added integer quantity sliders for both stake and reward, synchronized with buttons and the reward number field; controls are locked during spins and pending rewards.
• Extended item slots downward for sliders and placed six preset buttons below the reward. Wheel, inventory grid, card pool and existing footer padding are retained.
• Manual quantity changes clear stale preset summaries. Balance, 90% default cap, migration markers and saved reward format are unchanged.

0.6.2

• Default maximum success chance reduced to 90%. The former standard 95% config value is migrated once; other custom values are retained.
• Combined the all-items and stack switches into NO LIMITS / БЕЗ ОГРАНИЧЕНИЙ, off by default on world/character entry. It bypasses discovery and one-stack limits together.
• Added a ? icon with a detailed localized hover popup showing the current quantity and chance caps. The configured ceiling, prices and obtainable-item filtering still apply.
• Switching back restores progression and one-stack rewards, clears undiscovered targets and clamps oversized quantities immediately.
• Added lower padding for RELOAD VALUES and more space between the wheel/needle and the header divider.
• Preserved prior rewards, price files, five-second spins, scrolling and the pooled catalog.

0.6.1

• Reward quantity defaults to one actual stack of the selected item, read from the game's item data.
• Added the top-left ONE STACK / ОДИН СТАК toggle, enabled on every player/world entry. Turning it off allows multiple stacks within the existing configured ceiling.
• Buttons and typed quantities share the per-item limit; the current reward limit is shown below the reward slot.
• Turning the limit back on clamps an oversized selection and recalculates its value and success chance immediately.
• The roll checks the quantity again before consuming the stake. The toggle is locked during spins and while a reward awaits collection.
• Previously earned rewards, custom values, progression, pricing and local-only operation are retained.

0.6.0

• Minimal Valheim-inspired UI: warm charcoal surfaces, subdued bronze/gold, thin borders and small corner accents.
• Refined chance wheel, larger item wells, clearer selected cards, restrained hover transitions and reward highlight.
• Reworked spacing between the wheel, labels and upgrade button; long item names use two lines with bounded font fitting.
• Standard 32-slot inventory fits without vertical clipping; catalog count moved next to its heading.
• Added slim draggable scrollbars; normalized mouse-wheel scrolling and the existing scroll-speed setting retained.
• Window scaling fits both axes, including ultrawide and 4:3 screens.
• Game Norse title font is reused when loaded and compatible with the translated title; unsupported glyphs use the existing body font.
• Decoration uses static vertex gradients and procedural meshes, with no texture bundles or continuous effects.
• Catalog still uses 20 pooled cards. Russian/English language, progression, economy 0.4.0, quantities and saved rewards retained.

0.5.1

• Automatic Russian/English UI follows the game language; other languages use English interface text.
• Translated all buttons, placeholders, categories, tooltips, status messages, errors and claim results.
• Language changes update existing labels, native item names and sorting without rebuilding the menu.
• Selections, quantities, progress, prices, prizes and roll outcomes are retained.
• Native item-name caches also invalidate between two English-fallback game languages.

0.5.0

• Default rewards follow the current character's discovered materials and crafting recipes.
• Top-left all-items toggle is off on world entry and preserves the obtainable-item filter.
• Removed obsolete/test/NPC-only records, including CapeTest and old health/stamina upgrades.
• Catalog acquisition paths use live loot, pickups, vendors, production and reachable processing.
• Switching back clears locked targets; mode cannot change during a spin; prior prizes remain claimable.
• Discovery refreshes a cache, with the 0.4.0 economy and custom prices retained.

0.4.0

• Медь, олово, бронза, железо, серебро, чёрный металл, Flametal и Bloodgold значительно дороже.
• Руда, лом, очищенный эйтр, редкие фрагменты, формы и эссенции приведены к новой шкале.
• Раздельный расчёт исходной себестоимости и обменной оценки: наценка применяется один раз.
• EquipmentValueFactor=0.60, CraftingMarkup=1.05 и пределы категорий по биомам.
• Плащи ограничены двумя/тремя единицами металла биома; отливки, сёдла и ключи также ограничены.
• Улучшения больше не суммируют цену всех ресурсов и идолов; бонус качества всегда максимум ×2.
• ReturnRate=0.85; для более дорогой цели показатель UpgradeChanceExponent=1.25.
• В меню показан коэффициент качества ставки; очень малые шансы видны в научной записи.
• Выбирается самая дешёвая допустимая цепочка рецептов; оценка вещей без рецепта улучшена.
• Переход с 0.3.0 пересчитывает автоматические цены и сохраняет ручные цены/отключения.
• Резервные копии обоих файлов цен перед переходом на 0.4.0; подробный каталог и отчёт баланса.
• Сохранены производительность меню, быстрая прокрутка, количество награды и плавное колесо.

0.3.0

• Прокрутка колёсиком: два ряда за деление, нормализация небольших значений ввода.
• Настройка Visual.ScrollRowsPerNotch (по умолчанию 2).
• Цены реальных ресурсов Deep North, форм, эссенций, идолов и редких наград.
• Полные цепочки Frost Foundry, печей, мельниц, приготовления и брожения.
• Рецепты только для улучшения не используются как стоимость получения качества 1.
• Автоматические цены пересчитываются; ручные изменения и отключения сохраняются.
• Резервная копия старого ItemValues.json создаётся до перехода.
• Название Item Upgrader и новый ID valheim.itemupgrader.
• Импорт старых настроек и сохранённых наград.

0.2.0

• Колесо уменьшено и отделено от заголовка и кнопки дополнительными отступами.
• Вращение: 5 секунд, плавный разгон, равномерный ход и плавное торможение.
• Каталог: 20 переиспользуемых карточек вместо полного пересоздания ~1000 карточек.
• Карточки инвентаря переиспользуются. Подготовка меню распределена по кадрам.
• Выбор предмета и запуск попытки не пересоздают каталог.
• Убраны принудительные полные сохранения персонажа и карты с каждого нажатия. Инвентарь и награда сохраняются через штатное автосохранение и выход из мира.
• Добавлено количество цели: кнопки − / + и числовое поле. По умолчанию максимум 1000.
• Суммарная ценность цели и вероятность пересчитываются по количеству.
• Награду можно получать частями при нехватке места; остаток хранится в ячейке.
• Старые сохранённые награды и таблица ценностей совместимы.

ОБНОВЛЕНИЕ Полностью закрой игру и замени ItemUpgrader.dll файлом из этого архива. Не удаляй cfg и ItemValues.json. Не оставляй вторую копию старой DLL в plugins.