JGFoP

JGFoP is a lightweight, configurable Forge of Potential mod for Valheim.

It is designed to keep the Forge of Potential system focused on upgrading equipment without adding unrelated systems, events, weather effects, announcements, or other extra features.

Features

Configurable Upgrade Chances

Control the outcome of Forge of Potential upgrades with:

• Success Chance
• Failure Chance
• Break On Failure Chance

Success and Failure values are treated as relative weights and normalized.

Example:

• Success Chance = 70
• Failure Chance = 30

Results in:

• 70% Success
• 30% Failure

Break On Failure Chance applies only to failed attempts.

Example:

• Success Chance = 70
• Failure Chance = 30
• Break On Failure Chance = 25

Results in approximately:

• 70% Success
• 22.5% Normal Failure
• 7.5% Break

Failure Consequences

Configure what happens when an upgrade fails:

• Levels Lost On Failure
• Minimum Level On Failure
• Failure At Minimum Level Breaks Item

Example:

• Levels Lost On Failure = 2
• Minimum Level On Failure = 3

An item at level 8 would fall to level 6 on failure.

An item at level 4 would fall to level 3.

An item already at level 3 would remain level 3 unless Failure At Minimum Level Breaks Item is enabled.

Break Behavior

Configure what happens when an item breaks:

• Break Returns Item At Level 1
• Break Return Ingredients Percent

If Break Returns Item At Level 1 is enabled, the broken item is returned at quality level 1 instead of being destroyed.

When this option is enabled, ingredient recovery is disabled for that break.

If the item is destroyed normally, Break Return Ingredients Percent controls how many recoverable crafting materials are returned.

Maximum Upgrade Level

Set a hard Forge of Potential upgrade cap with:

Max Upgrade Level

Once an item reaches this level, further Forge of Potential upgrades are blocked.

Idol Cost Scaling

Control how many Idols are required as equipment levels increase.

Available settings:

• Cost Start
• Cost Increase Per Interval
• Cost Increase Interval
• Cost Scaling Level Start

Example:

Cost Start = 1
Cost Increase Per Interval = 1
Cost Increase Interval = 2
Cost Scaling Level Start = 6

Produces:

Levels 1-5  = 1 Idol
Levels 6-7  = 2 Idols
Levels 8-9  = 3 Idols
Levels 10-11 = 4 Idols

Upgrade Duration

Forge of Potential crafting time can also scale with equipment level.

Available settings:

• Base Crafting Time
• Upgrade Duration Increase Per Level

This allows higher-level refinement attempts to take progressively longer if desired.

Craftable Idols

All Protection and Battle Idols can be crafted at the standard Forge.

Both Idol types within each tier use the same recipe.

Wooden Idols

• 20 Fine Wood
• 10 Tin
• 10 Greydwarf Eyes
• 1 Eikthyr Trophy

Bronze Idols

• 10 Bronze
• 1 Surtling Core
• 1 Elder Trophy

Iron Idols

• 10 Iron
• 5 Elder Bark
• 1 Bonemass Trophy

Silver Idols

• 10 Silver
• 5 Freeze Glands
• 5 Obsidian
• 1 Moder Trophy

Black Metal Idols

• 10 Black Metal
• 2 Needles
• 5 Tar
• 1 Yagluth Trophy

Black Marble Idols

• 20 Black Marble
• 10 Bug Meat
• 10 Carapace
• 1 Queen Trophy

Flametal Idols

• 10 Flametal
• 15 Charred Bone
• 1 Fader Trophy

Bloodgold Idols

• 10 Gold
• 40 Coins
• 1 Sacrificial Blood

Recipes follow normal Valheim recipe discovery rules.

Vanilla Behavior

JGFoP preserves the vanilla behavior that allows equipment to use the Forge of Potential before reaching its normal crafting-station maximum quality.

The mod does not require equipment to be fully upgraded at a standard crafting station first.

Multiplayer

JGFoP uses server-synchronized configuration.

When playing on a server, the server's JGFoP configuration controls:

• Upgrade chances
• Failure behavior
• Break behavior
• Upgrade level cap
• Idol costs
• Upgrade duration

JGFoP should be installed on both the server and all connecting clients.

Configuration

The configuration file is generated at:

BepInEx/config/com.jgmods.jgfop.cfg

Configuration sections include:

01 - Success and Failure
02 - Failure Consequences
03 - Breaking
04 - Upgrade Limits
05 - Idol Cost
06 - Upgrade Duration

Requirements

• BepInExPack Valheim
• Jötunn

Installation

Install with Thunderstore Mod Manager / r2modman, or manually place JGFoP.dll inside:

Valheim/BepInEx/plugins

Version

0.1.0

Initial release.

Includes:

• Configurable Forge of Potential success and failure chances
• Configurable break chance
• Configurable level loss on failure
• Configurable minimum failure level
• Optional break when failing at minimum level
• Optional level 1 item recovery after breaking
• Configurable ingredient recovery after breaking
• Configurable maximum upgrade level
• Configurable Idol cost scaling
• Configurable upgrade duration scaling
• Craftable Protection and Battle Idols for all tiers
• Server-synchronized gameplay configuration