Noctyra Item Upgrader

Turn spare items into a chance to obtain something better. Choose a stake, choose a reward and its quantity, then spin the upgrade wheel.

Version: 0.2.0. Built for Valheim 1.0.16 and confirmed working in-game by the mod author. The custom interface is Russian; item names use the game's localization.

Features

• Configurable item values based on resource rarity, biome progression, recipe ingredients and crafting effort.
• Select the quantity of both the stake and the desired reward.
• Orange wheel sector shows the success chance, with a smooth five-second spin.
• Searchable item catalog with categories and reused UI cards.
• Pending rewards can be claimed in batches when inventory space is limited.
• Client-side operation: install on your own game. A server installation is not required; chances and outcomes are calculated locally.

Installation

Mod manager

Install this package using Thunderstore Mod Manager or r2modman and launch the modded game. The BepInEx dependency is declared in the manifest.

Manual

1. Install BepInExPack for Valheim.
2. Copy the archive's BepInEx/plugins/NoctyraItemUpgrader folder into your game's BepInEx/plugins folder.
3. Launch the game and enter a world.

When updating an existing manual installation, replace the old ItemUpgrader.dll. Keep only one copy of the plugin DLL and preserve your configuration and custom item values.

How to play

1. Press F8 to open the menu, or Esc to close it.
2. Select an unequipped inventory item as the stake and choose how many units to spend.
3. Select the desired item from the catalog and set its quantity.
4. Check the total reward value and displayed chance, then press УЛУЧШИТЬ.
5. On success, claim the reward. On failure, the selected stake is consumed.

Rewards are created at quality 1. Increasing the reward quantity increases its total value and reduces the chance of success.

Default formula:

chance = min(95%, stake value / total reward value * 90%)

The selected stake is consumed for every attempt, including successful attempts. Inventory and pending rewards are persisted through normal character saving and logout. A forced shutdown before saving can lose recent changes.

Configuration

Created after starting the game and entering a world:

• BepInEx/config/noctyra.valheim.itemupgrader.cfg: hotkey, odds, reward limit, crafting markup and spin duration.
• BepInEx/config/ItemUpgrader/ItemValues.json: editable values per item prefab ID.
• BepInEx/config/ItemUpgrader/Catalog.csv: exported item catalog for reviewing values.

Setting	Default	Purpose
General.OpenKey	F8	Open or close the menu
Balance.ReturnRate	0.90	Multiplier in the chance formula
Balance.MaximumChance	0.95	Maximum success probability
Balance.MaximumRewardAmount	1000	Maximum requested reward quantity
Balance.CraftingMarkup	1.15	Crafting effort multiplier for calculated values
Visual.SpinSeconds	5	Wheel animation duration in seconds

Edit ItemValues.json and click ОБНОВИТЬ ЦЕНЫ to reload values. A value of zero disables the item. Existing JSON prices take precedence over automatic recipe calculations, so keep a backup before resetting prices to regenerate them. Values are balance estimates and can be adjusted to suit your world.

Русский

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

Мод устанавливается только на клиент. Серверная проверка результатов не предусмотрена. Настройки и ценности предметов находятся в BepInEx/config. Для обновления замени старую DLL и сохрани настройки.

Credits and license

Noctyra. Created with assistance from OpenAI Codex. MIT license; see LICENSE.txt.