You are viewing a potentially older version of this package. View all versions.
MerlinofMines-ForgeOfIdols-1.0.1 icon

ForgeOfIdols

Convert battle and protection idols in either direction and upgrade idol tiers at the Forge of Potential, with configurable costs and success chances.

Date uploaded a week ago
Version 1.0.1
Download link MerlinofMines-ForgeOfIdols-1.0.1.zip
Downloads 149
Dependency string MerlinofMines-ForgeOfIdols-1.0.1

This mod requires the following mods to function

shudnal-ConditionalConfigSync-1.0.9 icon
shudnal-ConditionalConfigSync

Shared config synchronization and server policy library for Valheim mods. Installed as a dependency and compatible with Jotunn and ServerSync.

Preferred version: 1.0.9
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

Forge of Idols

Convert and upgrade idols at the Forge of Potential, with configurable costs and success chances.

Works on its own or alongside Forge Rework. No new crafting station required.

Recipes

Action Recipe Default cost Default success chance
Convert Protection → Battle, same tier 1 idol → 1 idol 80%
Convert Battle → Protection, same tier 1 idol → 1 idol 80%
Upgrade Protection → next-tier Protection 3 idols → 1 idol 80%
Upgrade Battle → next-tier Battle 3 idols → 1 idol 80%

All eight vanilla idol tiers are supported. Upgrades advance one tier at a time; the highest tier cannot be upgraded further.

Every attempt consumes its input idols. Success produces one output idol; failure produces nothing. Successful attempts play the forge's native lightning and sound.

Using the forge

  1. Bring your idols to the Forge of Potential.
  2. Choose UPGRADE for next-tier idols, or CONVERT to switch idol types.
  3. Check the input cost and displayed success chance.
  4. Press Attempt Upgrade or Attempt Conversion.

Gear refinement and idol upgrades share the UPGRADE tab. Other crafting stations keep their usual menus.

Unlocking recipes

  • Carry at least one idol of the recipe's input type and tier.
  • Discover the exact output idol at least once with your character.
  • Collect enough input idols and leave room in your inventory for the output.

You do not need to keep the discovered output idol. This prevents lower-tier stockpiles from unlocking tiers you have never found.

A recipe remains visible when you carry too few input idols, but its attempt button is disabled. Recipes configured to 0% are also disabled and consume nothing.

Installation

Install through Thunderstore Mod Manager or r2modman. The manager installs these required dependencies:

  • BepInExPack Valheim
  • Conditional Config Sync 1.0.9+

For multiplayer, install Forge of Idols and its dependencies on the server and every client. Restart after installation. Forge Rework is optional.

For a manual install, place ForgeOfIdols.dll in BepInEx/plugins/ForgeOfIdols. Keep only one copy installed.

Configuration

The first launch creates:

BepInEx/config/MerlinofMines.ForgeOfIdols.cfg

Section Setting Default Range
Conversion Input Idols 1 1–10000
Conversion Success Probability 80 0–100%
Tier Upgrading Input Idols 3 1–10000
Tier Upgrading Success Probability 80 0–100%

Conversion settings apply to both directions and every tier. Tier Upgrading settings apply to both idol types and every upgrade tier. Input Idols is the cost per attempt to produce one output idol.

  • 0%: attempts disabled; no cost.
  • 100%: every attempt succeeds.
  • Changes through Configuration Manager apply immediately. Restart after editing the file externally.

Dedicated servers

The server controls all four settings. Only server administrators may edit them; there is no configuration-lock toggle. Clients wait for settings to synchronize before crafting, and local settings return after disconnecting.

Craft attempts run on the player's client. Configuration synchronization does not provide server-side anti-cheat.

CHANGELOG

Changelog

1.0.1

  • Reorganize the README with recipe and configuration tables, quick-start steps, and clear discovery requirements.
  • Move developer and hot-reload instructions to DEVELOPMENT.md. No gameplay changes.

1.0.0

  • Remove the Lock Configuration toggle; synchronized settings always require server administrator access to edit.

  • Disable attempts at 0% success without hiding recipes or consuming inputs.

  • Add same-tier protection-to-battle and battle-to-protection idol conversions (default 1:1, 80% success).

  • Add next-tier recipes for protection and battle idols (default 3:1, 80% success).

  • Use full-width native Upgrade and Convert tabs; Upgrade includes gear and idol tier upgrades.

  • Use Attempt Upgrade and Attempt Conversion action buttons and an uppercase CONVERT tab.

  • Show idol recipes only for carried input types and tiers; insufficient stacks remain visible but unavailable.

  • Require prior discovery of the exact output idol for both upgrades and conversions, including queued attempts.

  • Preserve native item descriptions without an appended cost/failure paragraph.

  • Display conversion and tier-upgrade success odds in the recipe status area.

  • Synchronize costs and probabilities with the server.

  • Support independent installation and use alongside Forge Rework.

  • Support ScriptEngine reloads with shared config-sync registration and UI cleanup.

  • Avoid refreshing the crafting panel before a player exists during connection or disconnect.

  • Keep Convert labeled correctly when the native localization component refreshes Craft text.