You are viewing a potentially older version of this package. View all versions.
Dyls123-PotentialReforged-1.0.4 icon

PotentialReforged

Client-only Forge of Potential controls: configurable success chance, item breaking on failure, and optional level loss. No server installation required.

By Dyls123
Date uploaded a week ago
Version 1.0.4
Download link Dyls123-PotentialReforged-1.0.4.zip
Downloads 807
Dependency string Dyls123-PotentialReforged-1.0.4

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2351 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2351

README

Potential Reforged

Customize the Forge of Potential's success chance and what happens when refinement fails.

  • Set the success rate from 0% to 100%. Failure chance is the remaining percentage.
  • Choose whether failed attempts destroy the item.
  • Choose whether non-breaking failures reduce the item's level, and set the loss from 1 to 10 levels. Item level cannot fall below 1.
  • Runs on your client; no server installation is needed. Settings apply to your own refinement attempts.

Defaults: 65% success, no item destruction, and one level lost on failure.

Successful refinement upgrades the item normally. Normal idol and material costs still apply.

BreakOnFailure ReduceLevelOnFailure Failed attempt
false false Item keeps its current level
false true Item loses the configured number of levels, minimum level 1
true Either Item is destroyed; normal game break refunds apply

Configuration

The config is generated after the first launch:

BepInEx/config/Dyls123.PotentialReforged.cfg

Close Valheim before editing, then restart to apply your changes.

[Chances]
SuccessChance = 65

[Failure]
BreakOnFailure = false
ReduceLevelOnFailure = true
LevelsLostOnFailure = 1

LevelsLostOnFailure accepts whole numbers from 1 to 10 and defaults to 1. It only applies when ReduceLevelOnFailure = true and BreakOnFailure = false. Existing configs gain this setting after launching the updated mod.

Manual install

  1. Install BepInEx 5 for Valheim.
  2. Create BepInEx/plugins/Dyls123-PotentialReforged/ in your Valheim folder.
  3. Copy PotentialReforged.dll from this ZIP into that folder.
  4. Launch Valheim to generate the config.

CHANGELOG

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.