Dvergr Allies

Tame, breed, and lead an army of custom Dwarven warriors.

Dvergr Allies is a massive overhaul to the Valheim taming system, allowing you to tame vanilla Dvergrs, breed them, and genetically evolve them into four distinct custom combat classes. Featuring dynamic weapon scaling, complex genetics, and custom-built Native Monster AI, your Dvergrs are no longer just passive NPCs—they are an elite fighting force.

🛡️ Features

• Taming & Breeding: Tame wild vanilla Dvergrs using Coins, Cooked Meat, Sausages, or Yggdrasil Wood.
• Mercenary Contracts (Gacha): Don't want to tame? Buy Dvergr Contracts from Haldor the Trader! Consuming a contract will instantly summon a fully-tamed, randomized Dvergr class (including rare elites like Spellswords or Berserkers!).
• Genetic Class System: Breed your Dvergrs to discover specialized classes. Cross-breed existing classes to unlock powerful elite hybrids.
• Dynamic Equipment Scaling: Your allies don't just get more health when they level up. Their physical gear dynamically upgrades! A 0-star Warrior wields a Bronze Sword. A 1-star upgrades to Iron. A 2-star wields a devastating Blackmetal Battleaxe.
• Native Combat AI: Weapons and magic have been flawlessly integrated into the native Valheim monster physics engine, ensuring perfect hit registration, aggression, and particle effects.
• Cleric AoE Healing: Clerics pulse massive Area-of-Effect Heal-over-Time spells to keep your army alive during raids.

🧬 The Classes & Prefabs

Base Dvergr (AllyDvergr)

The foundation of your army. When you tame a wild vanilla Dvergr, they convert into this base class. They wield simple weapons and serve as the genetic baseline for your breeding operations.

⚔️ The Warrior (AllyDvergrWarrior)

A heavily armored, highly aggressive melee tank. They rush headfirst into combat and draw aggro.

• 0-Star: Bronze Sword & Bronze Buckler
• 1-Star: Iron Sword & Silver Shield
• 2-Star (Berserker): Blackmetal Battleaxe (+50% Slash Damage buff)

🌿 The Cleric (AllyDvergrCleric)

A dedicated support unit. They hang back from the frontline and cast powerful restorative spells.

• Ability: Pulses a 15 HP/s AoE Heal-over-Time buff that affects all nearby allies.
• Self-Defense: Wields an Iron Mace to protect themselves if flanked.

🔥/❄️ The Spellsword (AllyDvergrSpellswordFire & AllyDvergrSpellswordIce)

An elite hybrid combatant that weaves magic and steel.

• Ability: Casts a devastating native Fireball (or Icebolt) from their hands to open combat, then aggressively rushes in with melee while the magic recharges.
• 0-Star: Bronze Sword
• 1-Star: Iron Sword
• 2-Star: Blackmetal Sword

🌌 The Elemental Mage (AllyDvergrMageElemental)

The pinnacle of Dvergr arcane arts. This unit completely eschews melee combat for pure magical bombardment.

• Ability: Dynamically cycles between three native Valheim elements every 10 seconds:
  1. Dverger Fireball
  2. Dverger Icebolt
  3. Goblin Shaman Fire (Adapted for Dvergr rigs)

🌳 The Breeding Tree

You can't just find an elite unit in the wild—you have to breed one. When two Dvergrs mate, their offspring has a chance to mutate into a higher-tier class based on their parents' genetics.

Tier 1 Mutations (From Vanilla Tames)

Combining two base Dvergr tames has a chance to produce a specialized unit.

• Rogue + Rogue = Warrior (Pure Melee Evolution)
• Support Mage + Support Mage = Cleric (Pure Healing Evolution)
• Fire Mage + Ice Mage = Elemental Mage (Dual Magic Evolution)

Tier 2 Mutations (Hybrids & Elites)

Combining different classes passes down their traits into an Elite Hybrid.

• Rogue + Fire Mage = Fire Spellsword (Melee + Fire traits)
• Rogue + Ice Mage = Ice Spellsword (Melee + Ice traits)
• Warrior + Warrior = Berserker (The Ultimate Melee Evolution)

(Note: In the code, offspring that don't trigger the "Special Combo Chance" simply inherit the exact class of one of their parents, maintaining your bloodlines!).

⚙️ Configuration Options

Dvergr Allies is highly customizable via the BepInEx/config/DvergrAllies.cfg file. You can adjust almost every aspect of the mod in real-time.

Taming

• Taming Time: Time required to tame a wild Dvergr. (Default: 1800s)
• Taming Items: The prefabs they will eat. (Default: CookedMeat, Coins, Sausages, YggdrasilWood)
• Fed Duration / Consume Range: Fine-tune their hunger mechanics and eating distance.

Breeding

• Pregnancy Duration: How long it takes for offspring to spawn. (Default: 600s)
• Breeding Limit: Max Dvergrs allowed in a 10m radius before they stop breeding. (Default: 4)
• Pregnancy Chance: Likelihood of successful mating per interval. (Default: 33%)
• Special Combo Chance: The chance that a valid genetic pair produces the Hybrid Mutation instead of a normal child. (Default: 25%)
• Level Up Chance: The chance an offspring is born with +1 Star. (Default: 10%)
• Max Breeding Level: Cap the maximum stars they can achieve. (Default: 2 Stars / Level 3)

Stats

• Health Multiplier: Global multiplier for your Dvergrs' base health pools.
• Damage Multiplier: Global multiplier applied directly to the physical slash/blunt/pierce damage of all custom Dvergr weapons, and the elemental damage of all Mage staves.

AI & Economy

• Max Follow Leash: The maximum distance (in meters) a Dvergr will chase an enemy before dropping aggro and returning to the player they are following. (Default: 40m)
• Contract Cost: Cost in coins to purchase a Mercenary Contract from Haldor. (Default: 999)

Debugging

• Toggle robust AI, Equipment, and Breeding logs to see exactly what your Dvergrs are thinking, who they are mating with, and what weapons they are equipping.

KNOWN LIMITATIONS:

• Dvergr's arent designed to handle "player" weapons, so it can look janky at times
• Leash is currently acting as a distance holder, they wont go past 40m(default) but currently stay aggro-ed at the limit distance set

🛠️ Installation

1. Install BepInEx for Valheim.
2. Install Jotunn (The Valheim Library).
3. Drop DvergrAllies.dll into your BepInEx/plugins/ folder.
4. Tame a Dvergr and begin your empire!

Changelog

1.0.2

• Deep Compatibility Overhaul for BalrondIdleActors:
  • Added aggressive script-stripping to prevent Balrond's mod from hijacking our custom tamed Dvergr Allies.
  • Strips BalrondActor, BalrondActorTalker, and BalrondActorNamePicker directly from all custom Ally prefabs (AllyDvergrWarrior, AllyDvergrCleric, etc.) at load time.
  • Added a runtime failsafe (DvergrCombatAI) that scans and dynamically destroys Balrond components if they are forcibly injected into active Ally game objects after spawning.
  • Completely disabled our MonsterAI prefix patch on wild Dvergrs when Balrond's mod is detected, ensuring wild NPCs retain their custom idle behaviors without interference.
  • Ensures your tamed Allies will properly fight and follow you instead of standing idle or breaking their custom AI.
• Manifest Correction: Updated manifest.json on Thunderstore to correctly list required dependencies and the accurate Discord website URL.

1.0.1

• Compatibility Patch: Added an explicit compatibility check for BalrondIdleActors. If detected, DvergrAllies will automatically skip modifying wild Dvergrs to prevent conflicts with Idle NPCs. Dvergr allies purchased from Haldor or spawned by command will still function properly.

1.0.0

• Initial Release!
• Tame vanilla Dvergrs and recruit them as an Ally base-class.
• Mercenary Contracts (Gacha): Buy Dvergr Contracts from Haldor to instantly summon randomized tamed allies!
• Custom Genetic Class System:
  • Warrior (Aggressive melee tank)
  • Berserker (The ultimate 2-star melee evolution, wielding a Blackmetal Battleaxe)
  • Cleric (AoE heal-over-time support)
  • Spellsword (Fire & Ice) (Hybrid magic + melee combat, inherits specific magic based on parents)
  • Elemental Mage (Dynamically rotates between Fire, Ice, and Goblin Fire magic)
• Full Elementalist breeding tree system: Combine different traits to discover powerful hybrids.
• Star-level dynamic weapon scaling (Gear visually and statistically upgrades from Bronze -> Iron -> Blackmetal as they level up).
• Aggressive Combat AI: Forced behavioral overrides ensure tamed Dvergrs fight aggressively, hold their ground, and don't panic around fire or destroy player structures.
• Follow Leash System: Configurable MaxFollowLeash (default 40m) ensures your Dvergrs never chase enemies too far away while following you.