# Class Trinkets

A Valheim mod that adds 8 unique class trinket lines, each with 5 progressive ranks (making 40 total).

Choose your class and grow stronger as you advance through Valheim's biomes!

<p align="center"><img src="https://i.postimg.cc/XvXjmCT7/7.png" alt="JamesJonesTV"></p>
<p align="center"><img src="https://i.postimg.cc/tg7qwxLq/7a.png" alt="JamesJonesTV"></p>
<p align="center"><img src="https://i.postimg.cc/FHjwhdzb/models2.png" alt="JamesJonesTV"></p>

## Features

- **8 Unique Classes**: Warrior, Paladin, Death Knight, Druid, Hunter, Rogue, Mage, and Warlock
- **5 Progressive Ranks**: Each class has 5 ranks that scale with game progression (Bronze → Flametal Age)
- **Custom Crafting Stations**: 5 thematic crafting stations for creating your trinkets
- **Dynamic Stats**: Base stat modifications that stack with food and other equipment
- **Progressive Recipes**: Each rank requires the previous trinket plus biome-appropriate materials
- **Fully Configurable**: All 40 recipes fully customizable via ItemManager with live updates (no restart needed!)
- **Life Steal**: Death Knight and Warlock classes features life steal mechanics
- **Server-Synced**: Configuration syncs from server to clients automatically

---

## The Classes

### Warrior (Blunt Damage)

*A mighty melee fighter focused on strength and endurance*

**Crafting Station**: Searing Station
**Unique Trophy**: Greydwarf Brute

**Rank 5 Stats**:

- Health: +40
- Stamina: +25
- Armor: +10
- Carry Weight: +100
- Health Regen: +15%
- Stamina Regen: +10%
- Blunt Damage: +5%
- Blunt Resistance: 50% (Rank 5)
- Skills: Swords +10, Axes +10

---

### Paladin (Spirit Damage)

*A holy warrior balancing physical might with magical power*

**Crafting Station**: Sacred Station
**Unique Trophy**: Frost Troll

**Rank 5 Stats**:

- Health: +40
- Eitr: +30
- Armor: +10
- Carry Weight: +100
- Health Regen: +10%
- Eitr Regen: +10%
- Spirit Damage: +5%
- Spirit Resistance: 50% (Rank 5)
- Skills: Polearms +10, Blocking +10

---

### Death Knight (Frost Damage)

*A dark warrior wielding both blade and forbidden magic*

**Crafting Station**: Shadow Station
**Unique Trophy**: Skeleton

**Rank 5 Stats**:

- Health: +40
- Eitr: +20
- Armor: +8
- **Life Steal: 5%** ⚡
- Carry Weight: +75
- Move Speed: -5%
- Frost Damage: +5%
- Frost Resistance: 50% (Rank 5)
- Skills: Clubs +10, Blood Magic +10

---

### Druid (Poison Damage)

*A nature-bound spellcaster in harmony with the elements*

**Crafting Station**: Sylvan Station
**Unique Trophy**: Bear (Bjorn)

**Rank 5 Stats**:

- Health: +20
- Stamina: +20
- Eitr: +20
- Armor: +5
- Health Regen: +5%
- Stamina Regen: +5%
- Eitr Regen: +5%
- Poison Damage: +5%
- Poison Resistance: 50% (Rank 5)
- Skills: Elemental Magic +10

---

### Hunter (Pierce Damage)

*A swift ranger excelling at ranged combat and survival*

**Crafting Station**: Sylvan Station
**Unique Trophy**: Deer

**Rank 5 Stats**:

- Health: +25
- Stamina: +40
- Armor: +5
- Carry Weight: +50
- Move Speed: +3%
- Stamina Regen: +10%
- Pierce Damage: +5%
- Pierce Resistance: 50% (Rank 5)
- Skills: Bows +10, Crossbows + 10

---

### Rogue (Slash Damage)

*A swift assassin specializing in stealth and critical strikes*

**Crafting Station**: Searing Station
**Unique Trophy**: Boar

**Rank 5 Stats**:

- Health: +20
- Stamina: +40
- Armor: + 3
- Carry Weight: +25
- Move Speed: +5%
- Stamina Regen: +15%
- Slash Damage: +5%
- Slash Resistance: 50% (Rank 5)
- Skills: Knives +10, Sneak +10

---

### Mage (Lightning Damage)

*A pure spellcaster wielding devastating elemental magic*

**Crafting Station**: Shimmering Station
**Unique Trophy**: Greydwarf Shaman

**Rank 5 Stats**:

- Health: +10
- Eitr: +40
- Carry Weight: +20
- Move Speed: -1%
- Health Regen: +3%
- Eitr Regen: +15%
- Lightning Damage: +5%
- Lightning Resistance: 50% (Rank 5)
- Skills: Elemental Magic +15, Blood Magic + 5

---

### Warlock (Fire Damage)

*A dark spellcaster who sacrifices mobility for power and sustain*

**Crafting Station**: Shadow Station
**Unique Trophy**: Neck

**Rank 5 Stats**:

- Health: +15
- Eitr: +40
- Move Speed: -5%
- **Life Steal: 5%** ⚡
- Health Regen: +5%
- Eitr Regen: +10%
- Fire Damage: +5%
- Fire Resistance: 50% (Rank 5)
- Skills: Blood Magic +15, Elemental Magic +5

---

## Crafting Stations

You must build the appropriate crafting station before creating trinkets:

| Station [PrefabName]                        | Classes               | Materials                                                          |
|---------------------------------------------|-----------------------|--------------------------------------------------------------------|
| **Sylvan Station** [SylvanStation]          | Hunter, Druid         | 10 Fine Wood, 10 Core Wood, 10 Resin, 1 Bear Trophy                |
| **Searing Station** [SearingStation]        | Warrior, Rogue        | 10 Fine Wood, 10 Copper, 5 Surtling Core, 1 Greydwarf Brute Trophy |
| **Shadow Station** [ShadowStation]          | Death Knight, Warlock | 10 Fine Wood, 10 Coal, 5 Bone Fragments, 1 Skeleton Trophy         |
| **Sacred Station** [SacredStation]          | Paladin               | 10 Fine Wood, 10 Deer Hide, 5 Bronze, 1 Frost Troll Trophy         |
| **Shimmering Station** [ShimmmeringStation] | Mage                  | 10 Fine Wood, 10 Greydwarf Eye, 5 Tin, 1 Greydwarf Shaman Trophy   |

All crafting stations are placed using the **Hammer** and found in the **Crafting** category.

---

## Progressive Recipes

Each trinket rank requires the previous rank plus new materials. All trinkets are crafted at your **class-specific
crafting station** (no station upgrades needed!).

### Rank 1 (Bronze Age)

- 10 Bronze
- 10 Fine Wood
- 1 Surtling Core
- 1 **Unique Class Trophy** (see class descriptions above)

### Rank 2 (Iron Age)

- **Previous Trinket** (Rank 1)
- 10 Iron
- 10 Core Wood
- 5 Guck

### Rank 3 (Silver Age)

- **Previous Trinket** (Rank 2)
- 10 Silver
- 10 Ancient Bark
- 5 Crystal

### Rank 4 (Black Metal Age)

- **Previous Trinket** (Rank 3)
- 10 Black Metal
- 10 Yggdrasil Wood
- 5 Tar

### Rank 5 (Flametal Age)

- **Previous Trinket** (Rank 4)
- 10 Flametal
- 10 Ashwood
- 5 Black Marble

---

## Configuration

Configuration file is located at: `BepInEx/config/Azumatt.ClassTrinkets.cfg`

### Available Options

| Setting                  | Default | Description                                     |
|--------------------------|---------|-------------------------------------------------|
| **Lock Configuration**   | On      | If on, only server admins can change settings   |
| **Enable Debug Logging** | Off     | Enables detailed debug logs for troubleshooting |

### Recipe Configuration

**All 40 trinket recipes** (8 classes × 5 ranks) are **fully configurable** via the config file, powered by **ItemManager**!

Each trinket has customizable:
- **Crafting materials** and amounts
- **Crafting station** requirements
- **Station level** requirements
- **Previous trinket** requirements (for progressive recipes)

#### Live Configuration Updates ✨

Thanks to ItemManager integration, if you use the **Configuration Manager** mod, all recipe changes apply **immediately in real-time** without restarting! Simply:
1. Open Configuration Manager (F1)
2. Find the Class Trinkets section
3. Modify any recipe, material, or station requirement
4. Changes apply instantly when you close the menu

No server restart required!

#### Example Config Entries

```ini
[Trinket_Warrior_Rank1]
Crafting Station = Custom
Crafting Station (Custom) = SearingStation
Crafting Station Level = 1
Crafting Costs = Bronze:10,FineWood:10,SurtlingCore:1,TrophyGreydwarfBrute:1

[Trinket_Warrior_Rank2]
Crafting Costs = Trinket_Warrior_Rank1:1,Iron:10,RoundLog:10,Guck:5
```

#### Customization Examples

**Make trinkets easier to craft:**
```ini
Crafting Costs = Trinket_Warrior_Rank4:1,FlametalNew:5,Blackwood:5
```

**Change crafting station:**
```ini
Crafting Station = Forge
Crafting Station Level = 3
```

**Remove progression requirement:**
```ini
Crafting Costs = FlametalNew:10,Blackwood:10,BlackMarble:5
```

---

## How Stats Work

### Base Stat Modifications

Unlike food, trinkets modify your **base maximum** health, stamina, and eitr:

- **Health/Stamina/Eitr**: Increases your maximum values (does NOT instantly heal)
- **Armor**: Direct armor bonus added to your total armor
- **Carry Weight**: Increases maximum carry capacity
- **Move Speed**: Percentage modifier to movement speed
- **Regen**: Percentage increase to regeneration rates
- **Damage**: Percentage increase to specific damage type and causes the elemental effects to be applied
- **Resistance**: Reduces damage taken from specific type
- **Skills**: Adds skill levels while equipped

### Stacking Behavior

- You can wear **one trinket at a time**
- Trinket stats **stack with food** and other equipment
- Higher ranks **replace** lower ranks (you don't keep both)

### Resistances

Resistances are unlocked as you progress through the ranks:

- **Ranks 1-3**: No resistance bonus
- **Rank 4**: 25% resistance (Slightly Resistant - takes 75% damage)
- **Rank 5**: 50% resistance (Resistant - takes 50% damage)

Each class provides resistance to their specific damage type (e.g., Warrior gets Blunt Resistance, Mage gets Lightning
Resistance).

---

## Frequently Asked Questions

### Can I change classes?

Yes! Simply craft a different class trinket. You can only wear one trinket at a time.

### Can I skip ranks?

No (not unless you're cheating them), you must craft each rank in order (1→2→3→4→5) as each recipe requires the previous
trinket.

### What happens if I die?

Trinkets work like any other equipment - they'll be in your tombstone, and you can retrieve them.

### Does this work with other mods?

Yes! This mod is designed to be compatible with most other Valheim mods. Stats stack normally with other equipment.

### Can server admins customize stats?

Not via config the stats are balanced and fixed in code to ensure fair multiplayer & commissioner's request. Configuration
options might be added later for this.

### Why can't I craft a trinket?

Check that you:

1. Built the correct crafting station for your class
2. Are standing near the crafting station
3. Have all required materials in your inventory
4. Have the previous rank trinket (for ranks 2-5)

---

## Troubleshooting

### "Recipe not showing up"

- Ensure you're at the correct crafting station
- Verify all materials are in your inventory
- For Rank 2+, you need the previous rank trinket

### "Stats not applying"

- Unequip and re-equip the trinket
- Enable debug logging in config to see stat values
- Check your status effects (you should see a class trinket effect active)

### "Life steal not working (Warlock)"

- Life steal only triggers when dealing damage to enemies. It's a percentage of total damage dealt.
- Does not work on self-damage
- Enable debug logging to see life steal healing amounts

### "Mod not loading"

- Verify BepInEx is installed correctly
- Check `BepInEx/LogOutput.log` for error messages
- Ensure all required files are in the plugins folder. If you're using a mod manager, check the profile folder for the
  mods.

---

## Screenshots

<p align="center"><img src="https://i.postimg.cc/4xJx4x3w/1.png" alt="JamesJonesTV"></p>
<p align="center"><img src="https://i.postimg.cc/W4tNCkxY/3a.png"></p>
<p align="center"><img src="https://i.postimg.cc/bvdyWtKX/6.png"></p>

---

## Credits

**Mod Author**: Azumatt
- You can also find other awesome mods that Azumatt has made at https://thunderstore.io/c/valheim/p/Azumatt/
- You can also donate to Azumatt at https://buymeacoffee.com/azumatt

## Tech Support

Found a bug or have a suggestion?
[Report an issue on Azumatt's Discord](https://discord.gg/pdHgy6Bsng)

---

## The Ravenwood Community
Feel free to join our discord at https://discord.gg/h6cDGkgE8h 


You can see my other mods at: https://thunderstore.io/c/valheim/p/JamesJonesTV/
<p align="center"><img src="https://i.postimg.cc/pXm5mXXT/combinedmods6.png" alt="JamesJonesTV"></p>

---

## Donate
If anyone wants to help me be able to afford spending so much of my time making mods, you can donate below and it will go towards more cool stuff.
- Paypal = jamesjonesjiujitsu@gmail.com
- Venmo = JonesJiuJitsu
- CashApp = $JonesJiuJitsu
<p align="center"><img src="https://i.postimg.cc/vBCWHdQz/Donate2.png" alt="JamesJonesTV"></p>

## Changes

- 1.0.2: Adds unique models for the 8 trinket class types. Recent valheim update startup issue fixed.
- 1.0.1: Updated information.
- 1.0.0: 40 new trinkets have been added!