BlacksmithingExpanded

A modular, skill-driven enhancement system for Valheim.

Craft smarter, repair faster, and forge gear that evolves with your blacksmithing skill. Configure XP, tiers, upgrades, and durability. Now multiplayer-safe with proper upgrade detection!

Mod request by Aziraphale • Built by OdinPlus

Special thanks for testing: Aziraphale, Pingletown, Thunderstorm

⚠️ IMPORTANT: It may be required to delete your old configuration file to use the new Percentage System. The new Percentage Based Upgrade system applies a better balance for Blacksmithing, and is set to true in the Configuration File by default. To use the OLD System, and preserve worlds that want to keep it, set Percentage Settings to false.

⚒️ Core Features

🧠 Skill-Driven Progression

Earn Blacksmithing XP by crafting, repairing, smelting ore, and feeding kilns.

Unlock stat tiers that scale gear bonuses based on your skill level.

Tier intervals are fully configurable (StatTierInterval, DurabilityTierInterval, etc).

🔧 Upgrade-Based Bonuses

Items gain additional stat bonuses based on their upgrade level (quality).

Properly detects upgrades and recalculates bonuses for enhanced items.

Applies to durability, damage, armor, block power, and parry.

Percentage-based value system for proper balance of stats.

Percentage-based upgrade system or flat upgrade system via config.

🔥 Elemental Infusion

Weapons gain elemental damage (fire, frost, lightning, poison, spirit) once unlocked.

Infusion type is randomized from available types not already present.

Each element scales independently via config: FireBonusPerTier, FrostBonusPerTier, etc.

Unlock level and behavior controlled by ElementalUnlockLevel, AlwaysAddElementalAtMax.

Percentage-based scaling of Infused Stats.

🏗️ Structure Infusion

Smelters, kilns, and blast furnaces gain speed boosts based on your skill tier.

Infusions expire after a set time or when idle.

Configurable via InfusionTierInterval, SmeltingSpeedBonusPerTier, KilnSpeedBonusPerTier, InfusionExpireTime.

Only workstations listed in Blacksmithing workstations give XP and bonuses (default: smelter, blast furnace, charcoal kiln). Windmills, Spinning Wheels and Eitr Refineries are excluded; add a modded furnace's prefab name to include it.

🛠️ Inventory Repair Unlock

Repair gear directly from your inventory once you reach the required level.

Visual effects and XP gain included.

Controlled by EnableInventoryRepair, InventoryRepairUnlockLevel.

📋 Item Filtering System

YAML-based whitelist/blacklist system for precise item control.

Creates BlacksmithExpItemList.yml on first launch.

Configurable via UseYamlFiltering, LogFilteredItems.

📊 Skill Mechanics

Skill name: Blacksmithing

Description: Craft better, last longer. Improves durability, damage, and armor of crafted items.

XP sources: Crafting (XPPerCraft), Smelting (XPPerSmelt), Repairing (XPPerRepair), Upgrading (XPPerUpgrade), First-time crafts (FirstCraftBonusXP)

Effects scale with: SkillGainFactor, SkillEffectFactor

⚙️ Configuration Overview

💡 All configs are grouped for clarity and synced in multiplayer. You may see a skill_########## group — this is auto-generated by SkillManager and not used by this mod.

🗂 Config Groups

| Group | Purpose |

|-------|---------|

| General | XP gain, infusion logic, blacksmithing workstations, inventory repair |

| Item Filtering | YAML whitelist/blacklist system |

| XP | XP values per action |

| Tooltip | UI visibility toggles |

| Durability | Milestone scaling, upgrade bonuses, caps |

| Stats | Damage/armor scaling, tier logic, caps |

| PercentageSystem | Percentage vs flat bonus toggles |

| Elemental | Elemental unlocks and per-type bonuses |

| Shields | Parry and block scaling |

🔥 Elemental Configs

| Config Name | Description |

|-------------|--------------|

| ElementalUnlockLevel | Minimum level to unlock elemental infusion |

| AlwaysAddElementalAtMax | Force infusion at milestone tier |

| FireBonusPerTier | Fire damage per tier (DoT) |

| FrostBonus