RepairRequiresMaterials

Recipe-based equipment repair, Crafting-skill bonuses, and incinerator dismantling through Valheim's existing UI.

Showcase

Material-based repair

See the selected equipment, its durability, and every required material beside Valheim's original repair button.

Scroll over the repair button to cycle through every item the current crafting station can repair.

Repair the selected item directly with its displayed recipe materials.

Crafting skill bonus

A deterministic Crafting-skill roll can replace the material requirements with a free repair.

Incinerator dismantling

Eligible equipment is converted back into a configurable share of its base and cumulative upgrade materials.

Hold the configured modifier and use the incinerator to dismantle items while ordinary use remains unchanged.

Features

• Repairs equipment with materials from its exact crafting recipe.
• Keeps the vanilla repair button and adds a compact material strip with subtle per-slot backgrounds.
• Uses Crafting skill for free repairs, bonus output, and faster equipment changes.
• Pulls missing repair materials from permitted AzuCraftyBoxes containers when available.
• Dismantles equipment and explicitly allowed items in an incinerator without replacing normal incineration.
• Includes English and Korean UI text.

Repair

Open a crafting station that matches the equipment's recipe and required station level. Only damaged equipment that the current station can repair is shown.

1. Hover the vanilla repair button.
2. Use the mouse wheel to select damaged equipment.
3. Check the material icons and available/required counts.
4. Click the vanilla repair button.

The player inventory is used first. If AzuCraftyBoxes is installed, permitted nearby containers can provide the remainder. Snapshot-only kg Item Drawers are excluded because their removal cannot be verified safely.

Repair cost

full repair cost = base recipe amount × (Base Material Cost Percent / 100)
                 + (quality - 1) × amount per level × (Quality Increment Material Cost Percent / 100)

payment = full repair cost × (missing durability bucket / 100)

For an upgrade-only recipe with no crafting material cost, the first upgrade amount is used as the base recipe amount.

Durability uses 10% buckets; for example, 51-60% remaining durability counts as 40% missing. Fractional costs use stochastic rounding: 0.1 costs one item with a 10% chance, while 1.8 always costs one and has an 80% chance to cost a second. The fractional roll stays fixed for that item and repair cycle, so reopening the UI cannot reroll it; the required amount can still change when the cost itself changes.

Equipment and Trophy ingredients are excluded from repair costs. Ammunition remains valid unless Repair Material Blacklist excludes it. If no eligible exact recipe retains an allowed ingredient, that equipment is omitted from the repair list. Recipe-less equipment that another mod explicitly makes repairable, such as Homestead's Dvergr circlet, instead follows that mod's station rule and has no material cost. Successful repairs keep Valheim's durability-based Crafting experience.

Crafting Skill Effects

Free repairs

Material-cost repairs can be free. The default chance scales from 10% at Crafting level 0 to 30% at level 100; a level-0 value above the level-100 value is capped to it. The ticket cannot be rerolled. FREE remains valid only while the repair-cost plan is unchanged; changing that plan locks the current cycle to paid.

Bonus output

Eligible stackable outputs at Crafting-skill stations roll once per base item. With the default setting, each item has a 25% bonus chance at Crafting level 100; a 20-item recipe therefore performs 20 independent rolls. Successful rolls are combined into Valheim's existing +K result and one bonus effect.

Outputs matched by Bonus Output Excluded Prefabs receive neither this mod's bonus nor Valheim's original Crafting bonus.

Equip speed

Equipment equip and manual unequip times decrease linearly with Crafting skill. The default setting reaches a 50% reduction at level 100. The current effects are also summarized in the in-game Crafting skill tooltip.

Incinerator

Incinerator Build Recipe changes the materials required to construct the vanilla incinerator. Its default is the vanilla Iron:8,Copper:4,Thunderstone:1 recipe.

Put items in a vanilla incinerator, hold Modifier Key (default LeftAlt), and press the current Valheim Use binding. This dismantles every eligible item currently inside, including the full stack of any matched stackable item. Ordinary Use is unchanged.

• Supported tools, weapons, shields, armor, capes, utility items, trinkets, and torches are eligible by default; ammunition is not.
• Additional Dismantleable Items can add non-equipment prefabs.
• The requesting player must know the item's recipe.
• Quest items, blacklisted items, and unsafe or ambiguous recipes remain untouched.
• Returned materials stay in the incinerator; if they do not fit, nothing is changed.

raw return = base crafting cost × (Base Material Return Percent / 100)
           + cumulative upgrade cost × (Cumulative Upgrade Material Return Percent / 100)

Additional stackable items are scaled by their source stack and recipe output amount. Fractional returns are stochastically rounded after matching materials are combined. An eligible source is consumed even when every fractional roll returns zero; this prevents repeated rerolls of the same item. Enchantments and other custom item data do not increase the return and are destroyed with the source.

Configuration

Gameplay settings are synchronized through ServerSync. Modifier Key is local to each client.

Repair Material Blacklist, Bonus Output Excluded Prefabs, and Additional Dismantleable Items accept comma, semicolon, or newline separators and case-insensitive whole-name * wildcards. Item Blacklist accepts comma-separated, case-insensitive exact prefab names only and takes priority over both default equipment eligibility and additional entries.

Incinerator Build Recipe accepts comma, semicolon, or newline-separated exact ItemPrefab:Amount entries. Leave it empty to restore the original recipe, or use None for no build cost. Invalid definitions restore the original recipe. This setting does not alter normal incineration conversions or Alt+Use dismantling returns.

AzuCraftyBoxes container use and known-recipe dismantling are always enabled when applicable; they have no separate settings.

Admin Command

rrm_setdurability <0-100>

Sets every durability-bearing equipment item in the invoking host or administrator's inventory to the given percentage of its quality-adjusted maximum durability. On a dedicated server, the server verifies the requesting connection against its administrator permissions before the invoking client's inventory is changed. Equipped items are included; ammunition, materials, and consumables are not.

Changelog

1.0.9

• Changed Artisan Mastery's Galleon anvil into a repair-only station: choose equipment with the vanilla repair button's scroll controls, see required materials, and repair one item at a time. Crafting and upgrading remain unavailable.
• Added the server-synchronized Galleon Anvil Free Repair Bonus setting, adding 15 percentage points by default and capping the total free-repair chance at 100%. The bonus is shown above the repair controls in English and Korean.
• Kept free-repair outcomes fixed when switching between ordinary stations and the Galleon anvil. Anvil-only free repairs cannot be used elsewhere, and existing repair tickets are not rerolled.

1.0.8

• Added optional Artisan Mastery compatibility: Galleon anvils now use RRM material costs, Crafting free repairs, and nearby AzuCraftyBoxes materials. Items without enough materials or an eligible recipe are skipped with a repair summary. Ship-hull repairs remain unchanged.
• Added the server-synchronized Free Repair Damage Threshold Percent setting (default 10) to control the free repair damage range without changing the existing paid cost buckets.
• Added the server-synchronized Minimum One Material Per Repair option (default Off) to keep positive material costs from rounding to zero while preserving the free damage range, material exclusions, and Crafting free repairs.
• Updated the BepInEx package dependency to 5.4.2351.

1.0.7

• Added the server-synchronized Thunderstone Required Global Key setting, defaulting to defeated_eikthyr so traders sell Thunderstone after Eikthyr instead of The Elder. Leave it empty to preserve the original requirement.
• Changed the default incinerator build recipe to Tin:8,Copper:4,Bronze:2,Thunderstone:1 and documented the vanilla recipe in the config description. Existing saved recipe settings are preserved.

1.0.6

• Added the server-synchronized Allow Equipment Changes While Running option, enabled by default. Queued equip and manual unequip actions now temporarily suspend sprint so Valheim's original action time and animation can complete, then resume held or toggled Run input.

1.0.5

• Updated Crafting bonus patching and administrator command visibility for Valheim 1.0.12.
• Excluded upgrader-only catalysts such as Battle and Protection Idols from repair costs and incinerator dismantling returns.

1.0.4

• Updated console commands and Crafting bonus handling for Valheim 1.0.7.
• Updated the bundled ServerSync implementation for Valheim 1.0.7 networking and administrator checks.

1.0.3

• Moved the extended Crafting skill tooltip beside the Skills panel with safe-area positioning, gamepad support, and localized UI compatibility.
• Reduced repeated repair preview, affordability, UI lookup, and incinerator blacklist work without changing repair or dismantling rules.
• Added opt-in Debug deployment through DeployToGame=true so only the final merged DLL is copied to the game.

1.0.2

• Added server-authoritative administrator verification for rrm_setdurability on dedicated servers.
• Added safe repair support for recipe-less equipment exposed by other mods, including Homestead's Dvergr circlet.
• Used the first upgrade material amount as the base repair cost for upgrade-only recipes.

1.0.1

• Added subtle square backgrounds behind the selected repair item, each material cost, and the free-repair indicator for better readability.
• Simplified the repair cost, selection, and UI flow while preserving existing repair behavior.
• Kept Crafting bonus output chance within its configured level-100 maximum when other mods alter skill factors.
• Improved config reload lifecycle and incinerator dismantling validation and success handling.

1.0.0

• Initial release.