BlacksmithingExpanded

🔨 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!

Mod request by Aziraphale • Built by OdinPlus

IMPORTANT: It may be required to delete your old configuration file to use the new Percentage System.

New Percentage Based Upgrade system applies a better balance for Blacksmithing, this is set true in the Configuration File now by default. To use the OLD System, and preserve worlds already who want to keep the old system, 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).
• Applies to durability, damage, armor, block power, and parry.
• % based value system for proper balance of stats.
• % 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
• % 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, InfusionExpireTime

🛠️ 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

📊 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

🔥 Elemental Configs

🔗 Compatibility

• ✅ Compatible with most crafting and skill mods
• ✅ No known conflicts with Blaxxun’s Blacksmithing mod
• 🔁 If used together, set XPPerCraft = 0 to avoid double XP gain

📦 Installation

1. Install BepInEx
2. Drop BlacksmithingExpanded.dll into your BepInEx/plugins folder
3. Launch the game and configure settings via BepInEx/config

💬 Community & Support

Questions or feedback?
Find Gravebear in the Odin Plus Team on Discord:

🎁 Support the Forge

Get a free Admin-craft Shark Hat and Tuna Sword on my BuyMeACoffee page!

📜 Changelog

1.1.0

• PLEASE DELETE THE OLD CONFIG!!
• Rebalanced base config settings for better balance and a more rewarding feeling.
• Removed Inventory Repair due to problems it caused with repairing at workstations.

1.0.9

• Fixed Critical Upgrade Detection Issue: Completely overhauled upgrade detection system - upgrades now properly apply bonuses instead of just base vanilla stats
• Fixed Item Stat Persistence: Resolved issue where enhanced stats were lost when logging out and back in - items now properly retain their blacksmithing bonuses across sessions
• Added Quality Tracking: Items now track their upgrade level to detect quality changes and recalculate bonuses appropriately
• Improved Migration Handling: Existing items from previous mod versions now preserve their original crafting level instead of being overwritten with current player level
• Enhanced Performance: Added periodic cleanup routines for temporary data storage and improved memory management
• Optimized Stat Application: Streamlined the stat loading/unloading system to be more reliable and efficient
• Better Thread Safety: Improved base stats caching with proper locking mechanisms
• Code Cleanup: Removed redundant upgrade detection methods and consolidated logic for better maintainability

1.0.8

• Fixed issue with xp being given for items on blacklist or not blacksmithing items.
• Reduced logging events

1.0.7

• Fixed issue where blacksmithing skill wasn't being awarded when crafting at level 0
• Added Robust skill checking - Multiple fallbacks for skill detection

1.0.6

• Moved the Percentage-Based settings into their own config group in the configuration file.
• Fixed issue of Spears losing their Blacksmithing Data when thrown.

1.0.5

• Added percentage upgrade config, set to false in the config to use the flat upgrade system/legacy system.
• Fixed multi-damage calculation by using total elemental damage instead of individual types
• Added upgrade bonus support that works with both percentage and flat systems

1.0.4

• Rebalanced XP Values: -- XP per craft: 5 → 1 (80% reduction) -- XP per repair: 1 → 0.1 (90% reduction) -- XP per upgrade: 5 → 3 (40% reduction) -- First craft bonus: 25 → 10 (60% reduction)
• Percentage-Based Damage System added. Logic: Damage bonuses are now calculated as a percentage of the weapon's base damage
• New config: Use percentage damage bonus = true by default
• New config: Damage percentage bonus per tier = 3% per tier
• Added config options to revert to the old system by setting % to false
• Added scaling % for elemental effects
• Items with Elemental Infusion Added will no longer apply new elements each upgrade.

1.0.3

• Fixed issue where blacklisted items still provided xp.

1.0.2

• Added YML support and BacksmithingExpItemList
• Mod will create the Default Itemlist YML on first launch, may require restarting the game to apply.
• ItemList contains a Whitelist and Blacklist options
• Improved some of the Configuration Descriptions

1.0.1

• Refactored elemental infusion to support per-type config scaling (FireBonusPerTier, FrostBonusPerTier, etc)
• Improved durability, armor, and damage scaling logic with tier and upgrade bonuses
• Added support for inventory-based gear repair at configurable unlock level
• Expanded structure infusion logic for smelters and kilns
• Updated config grouping and descriptions for clarity and multiplayer sync
• README overhaul to reflect new features and config philosophy
• Fixed issue where Stats wouldnt Sync in Multiplayer
• Fixed issue where Durability may break an item if current amount was more than max amount.
• Fixed issue with ItemDataManager and stat storage if item was dropped or put in a chest.
• Improved XP values for crafting and first craft bonus.
• Config overhaul for group sections.
• Additional XP configs added.
• Added additional control for items with more than one base stat or elemental stats.

1.0.0

• Mod Released Mod Request by Aziraphale