You are viewing a potentially older version of this package. View all versions.
Fai-Tamed_Wolf_Balance-1.7.0 icon

Tamed Wolf Balance

All tamed creatures: 3x max health, 0.35x outgoing attack damage, and 1% max-HP healing per natural regeneration tick while fed. Updates existing pets and saved 1.5.x/1.6.0 records without stacking.

By Fai
Date uploaded a month ago
Version 1.7.0
Download link Fai-Tamed_Wolf_Balance-1.7.0.zip
Downloads 51
Dependency string Fai-Tamed_Wolf_Balance-1.7.0

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2350 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2350

README

Tamed Wolf Balance 1.7.0 — All Tamed Creatures

Retains the existing plugin ID, package name, and DLL path for replacement updates.

Effects

  • Maximum health: 3 times the normal maximum.
  • Outgoing attack damage: 0.35 times normal damage.
  • While fed: each natural regeneration tick restores 1% of the boosted maximum health. The game's original tick timing is retained, normally approximately every 2 seconds.
  • Applies to newly tamed creatures, existing pets, and tamed offspring, including their adult forms.
  • No wolf-only or prefab-name filter. Mod creatures are eligible when they use Valheim's standard Character.IsTamed() state and networked Character components.
  • Wild creatures and players are not enrolled.
  • Health changes preserve the current HP percentage: 40/100 becomes 120/300.
  • Existing pets and offspring are checked approximately once per second while loaded. Pets outside loaded zones are processed when their area is loaded.
  • Normal Tameable.Tame completion applies the balance change immediately.
  • Saved absolute maximums prevent repeated multiplication during later checks, reloads, and maximum-health setup calls.

The normal health baseline is captured at enrollment, including star levels and other stat changes already applied. This mod saves that baseline; it does not continuously recalculate later changes from other health mods.

Fed regeneration

Natural creature regeneration uses BaseAI.UpdateRegeneration. The supplied game assembly has a timer threshold of 2 seconds. Its original heal amount is:

maximum HP / m_regenAllHPTime * elapsed world seconds

The Character class defaults m_regenAllHPTime to 3600, equivalent to roughly 0.056% of maximum HP per 2-second tick with that default. Individual prefabs or other mods can change this field.

Version 1.7.0 replaces only this routine's Character.Heal call with a wrapper. For a living, owned, tamed creature with a Tameable component that is not hungry, the amount becomes boosted maximum HP x0.01 per tick. It does not add a second healing timer or alter other healing sources. Regeneration stops when the creature becomes hungry; HP is capped at the maximum by the normal game healing method.

Example: normal HP 220 becomes 660 maximum HP, then each fed regeneration tick requests 6.6 HP of healing. The final tick can restore less if the creature is almost full.

Updating saved pets

  • From 1.6.0: the previous x5 maximum becomes x3 using the saved normal baseline, preserving the current HP percentage. Example: 550/1100 becomes 330/660.
  • From 1.5.0/1.5.1: saved x3 wolf records stay at x3 and are enrolled into this version; outgoing damage becomes x0.35.
  • A creature is migrated once. Previous boosts are not multiplied again.

Installation

  1. Fully close Valheim.
  2. Disable or remove previous Tamed Wolf Balance packages, duplicate manually installed DLLs, and any old script edition belonging to this mod.
  3. In r2modman, choose Settings → Import local mod, then select this ZIP.
  4. Launch with Start modded. Loaded pets update automatically; no fresh taming or console command is required.

Compiled DLL:

BepInEx/plugins/TamedWolfBalance/TamedWolfBalance.dll

Keep only one version enabled. The fai.tamedwolfbalance plugin ID is intentionally retained.

For multiplayer, the host, all joining players, and the dedicated server if used should install the same version. The creature's network owner saves its HP changes and performs natural regeneration.

Compatibility and validation

Damage is adjusted after Attack.ModifyDamage. Independent custom damage or regeneration systems that bypass the standard methods need their own compatibility handling. Armor, resistances, and later processing can affect the final damage number.

The BepInEx log should contain:

TWB 1.7.0 READY | all tamed creatures | HP x3 | damage x0.35 | fed regeneration 1% per tick

Individual enrollment logs say TWB APPLIED or TWB MIGRATED. PATCH FAILED means the balance patches have not activated.

Built against the available Valheim, Unity, BepInEx, and Harmony reference assemblies. Validation passed:

  • 27 assertions on the actual DLL, plugin identity/version, game target signatures, and compiled HP calculations.
  • 71 assertions applying the compiled regeneration transpiler to the actual game IL, confirming that only one healing call changes and that timer instructions, hunger checks, branches, and instruction metadata remain intact. Unknown layouts are rejected.
  • 89 behavioral assertions using unchanged production source and a simulated game API, covering saved x5-to-x3 migration, x3 legacy migration, repeated application, creature eligibility, offspring, damage x0.35, fed healing, hunger, ownership, death, full-HP limits, and other healing sources.

These are assembly and simulated-behavior checks. A live Valheim session, Unity scheduling, and multiplayer synchronization have not been tested here.

Source and a project file are included. Game and framework DLLs are not redistributed.

CHANGELOG

1.7.0

  • Change maximum health to x3 and outgoing attack damage to x0.35 for all eligible tamed creatures.
  • Set fed natural regeneration to 1% of boosted maximum HP per original regeneration tick, normally approximately every 2 seconds.
  • Change only the natural regeneration healing call, preserving the original timer and feeding checks; unrelated healing sources remain unchanged.
  • Migrate saved 1.6.0 x5 pets to x3 using the original baseline and preserving current HP percentage.
  • Keep 1.5.x x3 wolves at x3 and prevent repeated migration or multiplier stacking.
  • Preserve the existing plugin ID, package name, DLL path, and all-tamed-creatures scope.
  • Rebuild the DLL and verify the actual game regeneration IL plus migration and healing behavior.

1.6.0

  • Extend eligibility from newly tamed vanilla adult wolves to all tamed creatures using standard Character taming state.
  • Include existing pets, tamed offspring, and mod-added creatures using the standard APIs.
  • Change maximum health to x5 and outgoing attack damage to x0.5.
  • Add a one-second loaded-creature check for previously tamed pets, offspring, streaming, and network-owner changes.
  • Migrate saved 1.5.0/1.5.1 x3 wolf records to x5 without multiplying the old boost again.
  • Preserve current HP percentage, persistent maximums, and duplicate-application protection.
  • Keep the same plugin ID, package name, and DLL path for replacement updates.
  • Rebuild the DLL as 1.6.0 and update documentation.

1.5.1

  • Replaced the package icon with a new English-friendly Thunderstore icon.
  • Converted the Thunderstore-facing README content to English.
  • Refreshed package metadata for Thunderstore upload.
  • Gameplay is unchanged from 1.5.0: newly tamed adult wolves receive x3 pre-tame maximum health and x1/3 outgoing damage.

1.5.0

  • Rebuilt with the actual supplied reference assemblies, correcting the invalid core-library assembly reference found in the 1.4.1 standalone DLL.
  • Uses the completed Tameable.Tame transition to enroll newly tamed adult Wolves only.
  • Saves an absolute x3 maximum in the wolf ZDO; no global scan or repeated multiplication.
  • Applies exactly 1/3 outgoing attack damage to enrolled tamed wolves.
  • Uses the saved maximum for health-bar reads and subsequent maximum-health writes.
  • Adds explicit startup, patch-failure, and new-tame application logging.
  • Includes compiled DLL under the BepInEx/plugins hierarchy and readable source.