ForgeRework

Forge Rework

A small BepInEx mod for Valheim's Forge of Potential. Successful attempts increase

the item's current quality by one. Failed attempts consume the normal idol cost

and leave the item unchanged: no destruction, downgrade, durability loss, or

damaging failure explosion. Ordinary crafting and other crafting stations keep

their normal behavior.

Configuration

On first launch, BepInEx creates BepInEx/config/MerlinofMines.ForgeRework.cfg

in the active profile. Settings also appear in BepInEx Configuration Manager.

Changes made through Configuration Manager apply immediately. Restart after

editing the file outside the game.

Levels use standard integer inputs. Min Level defaults to 0 and Max Level

to 10; 0 disables the maximum-level cap. Probabilities use standard 0–100 sliders.

Existing settings are migrated automatically to the new sections and names.

[Levels]

Min Level = 0

Max Level = 10

[Probabilities]

Max Probability = 100

Min Probability = 0

Probability Dropoff Per Level = 10

Percentages use 0–100, and dropoff is in percentage points per level.

chance = max(Min Probability, Max Probability - Probability Dropoff Per Level * max(0, currentQuality - Min Level))

Max Level is a separate hard cap on the resulting item quality. At or above it,

attempts are disabled even if the curve still gives a positive percentage.

Both the item status and disabled refinement button display MAX, either at

the hard cap or when the success probability reaches zero.

Those items also have greyed-out names and dimmed, visible icons in the forge list.

They remain selectable so you can inspect them. Changing the curve refreshes the

list, allowing items to become available again.

Set it to 0 to disable the hard cap. A zero success chance still blocks

attempts, without charging any resources. Existing items above the cap are

left unchanged. Min Level controls where the dropoff begins, not the item's

initial quality or eligibility. Below Min Level the odds stay at Max Probability.

Min Probability must not exceed Max Probability. Invalid combined settings

retain the last valid curve (defaults if none) and produce a warning in the log.

Default probability preview

Level means current displayed item quality, not the number of forge upgrades.

Level 0 is included to illustrate the formula; normal gear starts at quality 1.

| Upgrade | Success | Unchanged on failure |

|---|---:|---:|

| 0 → 1 | 100% | 0% |

| 1 → 2 | 90% | 10% |

| 2 → 3 | 80% | 20% |

| 3 → 4 | 70% | 30% |

| 4 → 5 | 60% | 40% |

| 5 → 6 | 50% | 50% |

| 6 → 7 | 40% | 60% |

| 7 → 8 | 30% | 70% |

| 8 → 9 | 20% | 80% |

| 9 → 10 | 10% | 90% |

| 10+ | Blocked | No cost |

Destruction and downgrade chances are always 0%.

For a constant 25% success chance up to level 20, use Max Probability=25,

Min Probability=25, Probability Dropoff Per Level=0, and Max Level=20. Level 19 → 20 has a

25% chance; level 20 → 21 is blocked. Alternatively, a falling curve such as

100% minus 10 points per level with a 20% floor and Max Level=15 gives:

| Current level | Success |

|---|---:|

| 4 | 60% |

| 5 | 50% |

| 6 | 40% |

| 7 | 30% |

| 8–14 | 20% |

| 15+ | Blocked |

Build and try it

Requires.NET SDK 9, a local Valheim installation, and BepInEx 5..\build.ps1

This builds the mod, runs automated tests, verifies Harmony/private member

bindings against the installed game, creates an importable ZIP in artifacts,

and copies the package into the cache under

MerlinofMines-ForgeRework/1.0.0. It also updates the installed copy in the

ValheimVR profile, so subsequent builds do not require another import. Close

Valheim before building, then launch it again to load the new DLL. Disabled mods

are left disabled. Override GamePath, BepInExPath, CachePath or ProfilePath with

script parameters; use -NoDeploy to build/package only.

A cache copy does not itself enable the mod in an existing profile. Import

artifacts/MerlinofMines-ForgeRework-1.0.0.zip Mod Manager's

local-mod import, then la