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

v0.1.0

Overhauled the mod. Hoping it works fully now

v0.0.4

Fixed minor bugs

v0.0.3

Changed README.md

v0.0.2

Changed minor bugs and added Discord invite

v0.0.1

Uploaded beta test mod