


A comprehensive Valheim mod that introduces a persistent Smithing skill system with XP progression, item stat bonuses, master-forge mechanics, and special boons.
Persistent leveling: Your smithing skill is saved per player and persists across server sessions
Skill range: Level 1-100
Auto-apply: Crafted items automatically receive stat bonuses based on your smithing level
Gain Smithing XP by:
Feeding Kilns - +5 XP per wood item fed
Feeding Smelters - +10 XP per ore/coal item fed
Feeding Blast Furnaces - +15 XP per ore/coal item fed
Crafting at Forges - +13 XP + 2×forge level
Crafting at Black Forges - +26 XP + 4×forge level
Upgrading Items - +8 XP + 2×forge level or +13 XP + 2×black forge level
All crafted items receive automatic stat boosts:
Durability bonus: +5-10 base + (skill÷3)
Weapon damage bonus: +3-6 base + max(2, skill÷5) per damage type
Armor/block bonus: +4-7 base + max(2, skill÷4)
When an item is master-forged:
Durability: +20 additional
Damage: +5 to all damage types
Armor/Block: Enhanced (varies by boon type)
Special abilities applied to master-forged items:
Weapons:
Razor (40% chance): +25% damage to all damage types
Ogre (40% chance): +75% attack force
Goblin (20% chance): +15% attack speed (at equip time)
Shields:
Stalwart (50% chance): +60% block power
Sealed (50% chance): +35% armor
Armor:
Reinforced (60% chance): +25% armor
Feather (40% chance): +3% movement speed (at equip time)
The mod uses a forgiving exponential curve for skill progression:
Formula: XP required for level n = floor(80 × 1.05^(n-1))
Examples:
Level 1→2: 80 XP
Level 10→11: ~103 XP
Level 20→21: ~132 XP
Level 50→51: ~427 XP
Level 75→76: ~1,086 XP
Level 100: ~59,000 total XP
Early levels: Quick progression to feel rewarding
Mid game: Steady XP gain matches crafting pace
Late game: Challenging but achievable with regular play
Forgiving: No massive level gates like linear progression
Approximately 59,000 total XP to reach level 100 (doable with ~500-600 crafts or equivalent feeding).
Smithing data is stored in JSON format:
{BepInEx config path}/weaponcrafting_smithing.json
Format:
{
"Players": [
{
"Name": "PlayerName",
"XP": 1234,
"Level": 15
}
]
}
Data is automatically saved:
When you gain XP
When the mod unloads
JotunnModStub.dll in your BepInEx plugins folder:```
{Valheim}/BepInEx/plugins/
```
- BepInEx 5.x or later
The mod outputs detailed logs to the BepInEx console:
Kiln feeds: [WeaponCrafting] Kiln fed by PlayerName: +5 XP
Forge crafts: [WeaponCrafting] Craft on forge level 2: +17 XP
Upgrades: [WeaponCrafting] Upgrade near forge level 1: +10 XP
Master-forges: [WeaponCrafting] Master-forged: PlayerName -> SwordName (boon: Razor)
RPC broadcasts: [WeaponCrafting] Broadcast master-forge RPC: PlayerName -> ItemName
Each player has their own independent Smithing skill
Master-forge messages are broadcast to all players on the server
Forge level detection respects actual forge upgrade levels (including black forges)
XP is awarded client-side but persisted server-side for integrity