Potential Reforged 1.0.2

Client-only Valheim mod for Forge of Potential success odds and failure consequences.

Install

With a mod manager, install this package and its declared dependency, then launch the modded game. For manual installation:

1. Install BepInExPack Valheim 5 on your gaming PC, or enable it in your mod-manager profile.
2. For manual installation, create BepInEx/plugins/Dyls123-PotentialReforged/ in your Valheim folder and copy this ZIP's root-level PotentialReforged.dll into it. The config is generated at BepInEx/config/Dyls123.PotentialReforged.cfg after first launch.
3. Start the game. Check BepInEx/LogOutput.log for Potential Reforged 1.0.2: all Forge patches installed.

Nothing needs installing on the dedicated server. Each player who wants these rules installs their own copy. Settings are local and are not synchronized or enforced for other players. Jotunn is not required.

For Thunderstore/r2modman installation, the manager creates the Author-ModName folder. Publish under team Dyls123 with package name PotentialReforged to obtain Dyls123-PotentialReforged.

Configuration

Close Valheim, edit BepInEx/config/Dyls123.PotentialReforged.cfg, and restart. If omitted, the file is generated on first launch.

[Chances]
SuccessChance = 65

[Failure]
BreakOnFailure = false
ReduceLevelOnFailure = true

SuccessChance accepts 0–100, including decimals. Failure is automatically the remainder: 65 means 65% success and 35% failure. There is no separate failure value that could conflict with the total. Zero always fails; 100 always succeeds.

Breaking enabled means every failed attempt breaks the item, not a second random break chance. Success still increases quality normally. Idol/material consumption, animations, crafting duration and normal crafting remain under the game's existing rules. Non-breaking failure text is adjusted so it does not report a level loss when that option is disabled.

Defaults are 65% success, no item destruction, and one level lost on failure (minimum level 1).

Compatibility and validation

• Compiled successfully against the locally installed dedicated-server game libraries (Steam build 25390671), using BepInExPack Valheim 5.4.2351 references.
• Automated tests checked odds, exact 0%/100% boundaries, both toggles, the level-1 floor, and all patch sites in the real InventoryGui.DoCrafting method. The patch preserves unrelated crafting instructions.
• Not yet tested inside the running Valheim client or in multiplayer. Compatibility with your client game version still needs an in-game check.
• Do not combine with another mod that changes Forge of Potential roll/failure logic without compatibility testing.
• If the expected game code changes, patch installation is rejected as a unit and an error is logged. In that case vanilla behavior remains active, including its normal risk of destruction. Check the successful-load message before testing valuable equipment.

For an in-game smoke test, use disposable gear: set success to 100 and confirm an upgrade, then set it to 0 and test the three failure behaviors in the table. Confirm an ordinary forge/workbench upgrade is unaffected, and repeat while connected to your server. Restore your desired settings afterward.

Upgrading from Potential Control

Remove earlier PotentialControl.dll and PotentialReforged.dll copies from their old plugin folders before installing this build. The config is now Dyls123.PotentialReforged.cfg. The old config is not loaded; the new file starts with the new defaults unless you edit it.

Remove

Close Valheim and remove BepInEx/plugins/Dyls123-PotentialReforged/PotentialReforged.dll from the client/profile. The configuration may also be deleted. Future refinement uses the game's normal behavior; existing item levels are not reverted.

Changelog

1.0.5

• Preserve the original equipment item and its attached mod data on successful and non-breaking failed refinement.
• Retain Epic Loot enchantments, rarity, rolled values, and other stored item metadata.
• Add optional BlacksmithingExpanded compatibility: preserve existing bonuses and prevent immediate or delayed upgrade detection from recalculating them during refinement.
• Clear ItemDataManager's pending transfer for preserved items so later spawned items cannot receive their data.
• Keep ordinary crafting, destruction refunds, and existing configuration defaults unchanged.
• Compiled and checked against game IL and isolated behavior tests; in-game and multiplayer validation pending.

1.0.4

• Added LevelsLostOnFailure: choose a loss of 1 to 10 levels, default 1.
• Applies only when level reduction is enabled and item destruction is disabled.
• Item quality remains at least level 1.

1.0.3

• Updated the mod description and simplified the README.

1.0.2

• Plugin ID and generated config: Dyls123.PotentialReforged and Dyls123.PotentialReforged.cfg.
• Manual installation folder: BepInEx/plugins/Dyls123-PotentialReforged.
• Thunderstore archive lets the mod manager create the Author-ModName folder.
• Defaults remain 65% success, no item destruction, and level reduction on failure.

1.0.1

• Renamed the generated config to local.valheim.potentialreforged.cfg.
• Defaults: 65% success, item destruction disabled, and level reduction enabled.
• The old config is not loaded; remove old PotentialControl.dll installations before upgrading.

1.0.0

• Configurable Forge of Potential success percentage; failure is the remaining percentage.
• Toggle item destruction on failure.
• Toggle one-level reduction on non-breaking failure, with a minimum quality of 1.
• Client-only settings, with no dedicated-server installation required.
• Initial release: compiled and checked against game IL; in-game and multiplayer testing pending.