TamedWolfBalance 1.5.0 — New Tames Only

獨立 BepInEx 模組，已包含編譯好的 DLL，可直接由 r2modman「Import local mod」匯入。 不依賴 Expand World Code、Expand World Prefabs 或 Jotunn；不需要自行編譯。

本版範圍

• 只在安裝並啟用本版後，原版成年 Wolf 經由遊戲的馴服流程完成馴服時套用。
• 最大血量 = 這隻狼完成馴服前的正常最大血量 × 3。
• 攻擊傷害 = 正常攻擊傷害 × 1/3（不是近似的 0.33）。
• 馴服時保留血量比例。例如原來 110/220，套用後是 330/660。
• 已套用的狼會保存專用標記及最大血量；重登、區域卸載重載後仍使用相同數值。
• 以前已馴服的狼，以及直接以馴服狀態出生／成長的繁殖狼，不會自動補套。
• 不修改野狼、其他生物、狼的速度、星級、攻擊動作或跟隨行為。

「正常值」指未經本模組修改、同一隻狼在目前遊戲設定中的數值。如果裝有 Elite Creatures Reborn 等模組，血量以牠在馴服時已有的正常最大血量為基準，並固定保存三倍結果，不再追蹤日後其他模組對基準的變更。 傷害倍率在 Attack.ModifyDamage 後套用；最終飄字仍會受到目標護甲、抗性及其他模組後續處理影響。

安裝

1. 完全退出 Valheim。
2. 在同一個 r2modman profile 停用或移除所有舊版 TamedWolfBalance，包括舊 Expand World 腳本版本。
3. 在 Settings 找到「Import local mod」，選取本 ZIP，完成匯入並啟用。
4. 使用 r2modman 的「Start modded」啟動遊戲。
5. 找一隻尚未馴服的成年原版狼，重新完成餵食馴服流程。

ZIP 內 DLL 的正確位置是 BepInEx/plugins/TamedWolfBalance/TamedWolfBalance.dll。匯入後可能會再有 r2modman 建立的套件子資料夾；只要 DLL 位於 profile 的 BepInEx/plugins 下即可。 不要同時保留兩個版本的 DLL。若曾手動裝入舊腳本，請移走只屬於本模組的 tamed_wolf_balance.cs 及 expand_prefabs_tamed_wolf_balance_bootstrap.yaml；其他模組的檔案不需處理。

多人遊戲：房主、所有參與的玩家，以及獨立伺服器（如有）均安裝同一版本。狼的網路擁有者可能轉移到不同玩家；不能只靠其中一個客戶端維持效果。

確認有載入、有套用

BepInEx 的 LogOutput.log 應該出現：

TWB 1.5.0 READY | new tames only | HP x3 | damage x0.3333333 | 4 patches installed

新狼完成馴服後，應新增：

TWB NEW TAME APPLIED | ZDO=... | normalMax=... | HP=.../... | damage=x0.3333333

• 沒有 READY：尚未成功載入本版，先核對是否在正確 profile 匯入並以 modded 啟動。
• 有 READY 但沒有 NEW TAME APPLIED：檢查是否測試新馴服的原版成年狼、多人端是否都安裝。
• 出現 PATCH FAILED：保留該次完整 LogOutput.log；不要把它當成已成功套用。

不需要聊天指令或開發者模式。最直接測試是記錄同一隻野狼馴服前、後的最大血量，並觀察受傷後血條是否立即下降。

驗證與限制

已使用使用者提供的 BepInEx、Harmony 及 Valheim 程式庫編譯。 已通過實際 DLL 載入、BepInPlugin 識別，以及四個遊戲掛接方法／傷害欄位型別檢查。 20 項模擬 API 邏輯檢查通過，包括新馴服、受傷比例、重複套用、持久標記、舊狼／繁殖狼排除和傷害倍率。 這些檢查不是 Valheim 遊戲內或多人連線實測；本環境不能啟動遊戲。

原始碼

source/Plugin.cs 僅供檢查及後續維護，安裝時無須處理。套件不包含或重新散布遊戲、BepInEx、Harmony DLL。