WeaponCrafting Mod

A comprehensive Valheim mod that introduces a persistent Smithing skill system with XP progression, item stat bonuses, master-forge mechanics, and special boons.

What the Mod Does

Smithing Skill System

• 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

XP Sources

Gain Smithing XP by:

1. Feeding Kilns - +5 XP per wood item fed

2. Feeding Smelters - +10 XP per ore/coal item fed

3. Feeding Blast Furnaces - +15 XP per ore/coal item fed

4. Crafting at Forges - +13 XP + 2×forge level

5. Crafting at Black Forges - +26 XP + 4×forge level

6. Upgrading Items - +8 XP + 2×forge level or +13 XP + 2×black forge level

Item Modifications

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)

Master-Forge (40-60% chance by level)

When an item is master-forged:

• Durability: +20 additional

• Damage: +5 to all damage types

• Armor/Block: Enhanced (varies by boon type)

Master-Forge Boons

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)

How XP Works

XP Progression (Non-Linear Exponential Curve)

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

Why This Curve?

• 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

Total XP to Max

Approximately 59,000 total XP to reach level 100 (doable with ~500-600 crafts or equivalent feeding).

Data Persistence

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

Installation

1. Place JotunnModStub.dll in your BepInEx plugins folder:

```

{Valheim}/BepInEx/plugins/

```

1. Requires:

- BepInEx 5.x or later

1. Launch Valheim

Debug Logging

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

Multiplayer Notes

• 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