Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
PotentialReforged
Forge of Potential controls: configurable success chance, item breaking and optional level loss. Preserves modded item data. Works client-side with optional server configuration override.
By Dyls123
| Date uploaded | a month ago |
| Version | 1.1.1 |
| Download link | Dyls123-PotentialReforged-1.1.1.zip |
| Downloads | 1875 |
| Dependency string | Dyls123-PotentialReforged-1.1.1 |
This mod requires the following mods to function
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.2351README
Potential Reforged
About
Configure the Forge of Potential success chance and what happens when refinement fails. The defaults are 65% success, no item destruction, and one level lost on a failed attempt. Successful refinement upgrades normally, and normal idol and material costs apply.
Surviving refinement keeps the original equipment item and its custom data, crafter information and attached mod data. Quality-based stats update normally, and refinement repairs the item to its modded maximum durability.
| BreakOnFailure | ReduceLevelOnFailure | Failed attempt |
|---|---|---|
| false | false | Keep the current level. |
| false | true | Lose the configured levels, with a minimum level of 1. |
| true | Either | Destroy the item using the normal break refunds. |
Requires BepInEx 5 for Valheim. Jötunn is not required. Use the Forge of Potential normally; the mod applies the configured rules to your attempts.
Configuration
The first launch creates BepInEx/config/Dyls123.PotentialReforged.cfg. Edit it with the game closed, or use a compatible in-game config manager. File edits require a reload or restart; config-manager changes apply to the next relevant action. Existing values are carried into the numbered sections automatically. If both an old and a new section contain the same setting, the new section takes priority.
| Section / Setting | Default | Purpose |
|---|---|---|
| 10 - Chances / SuccessChance | 65 | Success percentage; 0–100. Failure chance is the remaining percentage. |
| 11 - Failure / BreakOnFailure | false | Destroy the item on every failed refinement. Overrides level-loss settings. |
| 11 - Failure / ReduceLevelOnFailure | true | Lose levels when failure does not destroy the item. |
| 11 - Failure / LevelsLostOnFailure | 1 | Levels lost on failure; 1–10, with a minimum final level of 1. |
| 90 - Server / LockConfiguration | true | Lock all refinement settings to server administrators. |
Server configuration
Install the mod on your client to use your own settings in single-player or on a server without the mod. Install the same version on the server to override the gameplay settings of clients running the mod. Server settings are locked to server administrators by default. Keybinds and display preferences stay local, and your local gameplay values return when you disconnect. Players without the mod do not gain its features.
All four refinement settings are synced when the mod is installed on the server.
Support
Epic Loot: enchantments, rarity and rolled values remain attached to surviving equipment.
BlacksmithingExpanded: existing bonuses and the original smith skill are preserved rather than recalculated for the refining player or new quality.
Other item-editing mods: most should also be supported when their changes are stored on the original item, because refinement preserves that item and its attached custom data.
Epic Loot and BlacksmithingExpanded are optional. Stackable items retain native handling; item destruction still uses native break refunds.
Manual installation
- Install BepInEx 5 for Valheim.
- Create
BepInEx/plugins/Dyls123-PotentialReforged/in the game installation or active mod-manager profile. - Copy
PotentialReforged.dllfrom the release ZIP into that folder. - Keep only one copy of the DLL and launch the game to generate the config.
The versioned ZIP and Dyls123-PotentialReforged.zip use the same Thunderstore-compatible layout, with the DLL at the ZIP root. A mod manager installs the package and its declared dependencies automatically.
CHANGELOG
Changelog
1.1.1
- Include CHANGELOG.md in both release packages so version history is available on Thunderstore.
- Clarify support for other item-editing mods that store changes on the original item.
1.1.0
- Standardise README sections and numbered config categories.
- Preserve existing configured values when moving sections.
- Add optional server overrides for gameplay settings while keeping personal controls and display settings local.
- Use a consistent Thunderstore-compatible package for all downloads.
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.
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.