# Hero Wolf Mod Introduction

 Raise your wolf to become a true legendary comrade-in-arms. Supported Version: Minecraft 1.21.1 · NeoForge Required Dependency: Curios API (Mandatory) Optional Compatibility Mods: L2Hostility / Iron's Spells 'n Spellbooks / Sophisticated Backpacks Recommended Add-ons: JEI (Recipe Lookup), Jade (Entity Info Display), Patchouli (Built-in Guidebook Hero Wolf Handbook) ## 🐺

What Is This Mod? Vanilla wolves become useless pets once tamed and left idle by your base. Hero Wolf completely reworks wolf gameplay, featuring exclusive UI panels, wolf armor, mountable weapons, skill tomes, trinkets, talent trees, spellcasting, and resurrection mechanics. Your wolf is no longer a mere pet — it is a fully fleshed-out combat progression system. Each player may tame only one wolf (Single Wolf Rule). It is your one-of-a-kind partner worthy of all your devotion.

✨ Core Features ### 🎛️ Exclusive Wolf GUI Panel Right-click your wolf with an empty hand to open its dedicated interface. A live 3D render of your wolf is displayed on the left; its head follows your mouse cursor. Wolf Armor Slot: Equip full armor that fully covers the wolf model for an imposing appearance. Weapon Slot: Swords grant sweeping attacks with every strike; axes guarantee leaping critical hits. Weapons are held in the wolf’s mouth, mimicking fox item carrying behavior. 10 universal trinket slots exclusive to wolves — unwearable by players or other mobs. 6 skill slots: Insert skill tomes to unlock abilities instantly. ID Customization: Rename your wolf freely with Chinese or English text. Stats Page: View all numerical wolf attributes at a glance; scroll with your mouse wheel to switch pages.

### ⚔️ Overhauled Combat AI Movement speed doubled when aggressive; melee attack range increased by 1 block. The wolf targets any mob you attack and immediately retaliates when you take damage. If no target is marked by you, the wolf automatically engages the closest hostile mob within a 10-block radius around you. No faulty wall targeting: The wolf will not stare at floors while underground mobs attack. Wolves can suppress Creepers: Creepers seized by a wolf cannot detonate. Hold Shift + Right-click with an empty hand to toggle sit/stand mode — an unintrusive control method free of accidental triggers. Seated wolves hold position and cannot cast skills.

### 💀 Death Is Not the End Upon defeat, your wolf does not despawn. It transforms into a Wolf Soul added directly to your inventory, retaining all equipment and permanent upgrades. Resurrect the wolf by right-clicking the Wolf Soul after a 60-second cooldown. Wolf Souls do not drop upon player death. The wolf teleports to you when you die or travel between dimensions. A Teleport Bell item lets you recall your wolf across all dimensions with a single right-click.

 ### 📈 Reciprocal Talent Tree Progression Unlocked by equipping the Wolf Bond trinket. The wolf gains experience from mob kills and earns 1 talent point per level, capped at level 100. Allocate points to boost health, attack damage, armor, toughness, movement speed, and spell power — these stat bonuses apply to you as well as the wolf. Grow stronger alongside your wolf in a true human-wolf symbiosis.

 ## 📖 Skill Tomes (20+ total; insert into skill slots to unlock) ### Active Skills (automatically cast in sequence once off cooldown) Guardian Howl: Emit a sonic blast hitting all enemies within 100 blocks. Wolf damage multiplier ×3, ignores all armor and enemy status effects (effective even against the Ender Dragon on its fountain). Shadow Lunge: Teleport behind targets within 48 blocks, dealing ×2 damage. Roar of Expansion: Deal ×2 damage and knock back all foes within a 12-block radius. Throat Lock: Pounce targets for ×2 damage and immobilize them for 3 seconds. Soul Reaper: Execute enemies below 20% health, dealing ×2 true damage. Seismic Stampede: Leap and slam the ground, damaging, launching, and stunning mobs within a 5-block radius. Moon Devourer: Pull all enemies within 8 blocks toward the wolf, dealing ×1.5 true damage. Lunar Howl: Grant Speed II and Strength II to both player and wolf. Shadow Clone / Pack Summon: Summon spectral wolf decoys to taunt enemies or fight alongside you. Hunter’s Mark: Brand a target, increasing all damage dealt by you and your wolf by 25%. ### Passive Skills Berserk: When health drops below 50%, wolf movement speed and attack damage double for 10 seconds. Evolution: Wolf model size ×1.5, attack range +3 blocks, sweep radius +1 block, larger sweeping slash visuals. Rending Claws: Attacks apply Wither, stackable up to Wither III. Lightning Fangs: Trigger chain lightning splash damage every 6 seconds. Glacial Fangs: Attacks stack frost buildup; 4 stacks fully freeze targets for 2 seconds. Bloodthirst Tracker: Mark low-health enemies; wolf gains +50% movement speed and +30% damage against marked targets. Swift Ambush: Charge while out of combat; first strike deals ×2 damage. Phantom Steps: 20% chance to completely negate incoming damage. Stone Hide: Gain Absorption IV automatically when health is low. Last Stand Survival: Survive fatal blows with 1 HP and unleash a radial counterattack dealing ×2 true damage. Protective Barrier: Teleport to your side and taunt all attackers when your health is critically low. Linked Onslaught: Wolf damage against your target increases if it strikes within 2 seconds of your hit. Shared Vitality: You recover 50% of all health restored to your wolf.

## 💍 Trinkets ### Wolf Exclusive Trinkets (Universal Trinket Slots) Wolf Fang Amulet (Lifesteal) · Warden’s Crest (caps all incoming damage at 30% max health) · Vitality Charm (regenerate 1 heart per second at all times) · Thorned Aura · Fire Resistance Serum · Owl Sight (+30% combat effectiveness at night) · Blood Frenzy (damage rises as health drops) · Hunter’s Scent (see enemies through walls) · Experience Scavenger · Treasure Nose (detect diamond ores through terrain) · Glutton Maw (auto-consume food to regenerate health) · Magnet Collar (auto-pickup items directly into inventory) · Medic Satchel (periodically heal the player) · Lucky Claw (doubles mob loot drops) · Shadow Cloak (avoid mob aggro while sneaking) ### Player-Bound Trinkets ⚠️ Permanent Binding Mechanic Wolf Bond: Transfers 50% of your attack damage, armor, toughness, and knockback resistance to the wolf while reducing your corresponding stats by 70%. Grants an automatic Totem of Undying every 120 seconds and constant passive health regeneration. Unlocks the reciprocal talent tree. Ember Pact (Iron's Spells Compatibility): Unlocks a dedicated Spell tab in the wolf GUI with 3 spell scroll slots. The wolf instant-casts spells in combat with zero cast animation or mana cost, precisely aiming at targets in line of sight. 50% of your spell power transfers to your wolf. Symbiotic Oath: Split all incoming healing evenly between player and wolf. ⚠️ Wolf Bond and Ember Pact cannot be removed once equipped. The only way to break the bond is to sacrifice your wolf by right-clicking it while holding the Sinbrand item — this permanently kills the wolf and resets all talent tree progress. True power always comes with a price.

## 🛡️ Wolf Armor Sets (Unique custom 3D full coverage models) Sun-Eclipse Sovereign (Void Obsidian Alloy): 10 Armor Points, 5 Toughness. Unique Set Ability: Eclipsing Thunder – Fire a piercing void lightning laser every 10 seconds, dealing ×3 true damage across a 100-block line. Abyssal Overlord: Underwater breathing, Dolphin’s Grace. Unique Set Ability: Abyssal Vortex – Spawn a whirlpool under targets to drag enemies inward. Magma Titan: Full fire immunity, burn attackers on contact. Unique Set Ability: Infernal Meteor – Summon impact meteors dealing area true damage and igniting foes. Skyward Ranger: Speed I, Slow Falling. Unique Set Ability: Heavenly Wind Blades – Unleash a 90-degree fan-shaped slash and grant temporary levitation. Wolf armor is unbreakable, and all standard & modded enchantments on wolf weapons and armor function normally.

 ## 🔗 Mod Compatibility Details L2Hostility: Your Hostility level is shared with your wolf. All Hostility trinkets (including Pandora line items) apply their effects to both you and the wolf. Iron's Spells 'n Spellbooks: Ember Pact trinket + dedicated spell panel. All spell rings and charms from Iron's Spells equipped in wolf trinket slots boost the wolf’s spell power directly. Sophisticated Backpacks: Wolves may carry backpacks, accessible via a dedicated backpack button in the wolf GUI. Magnet Collar auto-sends collected loot into the backpack or Ender Chest (single storage choice). Patchouli Guidebook: Complete in-game tutorial Hero Wolf Handbook, craftable as an item for permanent reference.

 ## ⚙️ Fully Configurable All numerical values for trinkets, skills, and wolf armor (damage multipliers, cooldowns, range, armor values, stat transfer percentages, etc.) are editable within this config file: config/hero_wolf_accessories.json All config categories include Chinese comments. Tick conversion reference: 20 ticks = 1 second. Changes take effect after game restart. Delete the file entirely to reset all configs to factory defaults.

## 📌 Quick Tips Wolves take no fall damage and do not panic or flee while burning. Passive natural regeneration: Wolves recover 1 heart per second out of combat. Crafting recipes for all skill tomes and trinkets are viewable via JEI. Single Wolf Rule: Treat your sole battle companion well. May your wolf stand beside you from your first night all the way to the End Dragon. 🐺

# 豪狼（Hero Wolf）模组介绍

> 把你的狼，养成真正的传奇战友。

**适用版本：** Minecraft 1.21.1 · NeoForge
**前置模组：** Curios API（必需）
**可选联动：** 莱特兰-恶意（L2Hostility）/ Iron's Spells 'n Spellbooks（铁咒法术）/ 精妙背包（Sophisticated Backpacks）
**推荐搭配：** JEI（查配方）、Jade（看信息）、Patchouli（内置说明书《豪狼教程》）

---

## 🐺 这是什么模组？

原版的狼，驯完就只能在门口吃灰。豪狼彻底重写了狼的玩法：专属面板、狼铠、武器、技能书、饰品、成长树、法术施放、死亡复活……你的狼不再是一只宠物，而是一套完整的战斗养成体系。

每位玩家只能驯服**一只**狼（一狼制）——它是你独一无二的搭档，值得你倾注一切。

---

## ✨ 核心特色

### 🎛️ 专属狼面板（GUI）

- **空手右键**你的爱狼，打开它的专属面板
- 左侧实时渲染狼的 **3D 模型**（它的头还会跟着你的鼠标转）
- **狼铠槽**：穿上狼铠，模型全面包裹，威严拉满
- **武器槽**：装备剑 = 每次攻击附带横扫；装备斧 = 必然跳劈暴击——武器会被狼**叼在嘴里**（参照狐狸的叼物方式）
- **10 个通用饰品槽**：只属于你的狼，其他生物和玩家都无法装备
- **6 个技能槽**：放入技能书即学即用
- **ID 区**：自定义爱狼的名字，中文英文都可以（旺财，启动！）
- **属性页**：一页看清狼当前的全部属性数值（支持滚轮翻页）

### ⚔️ 重写的战斗 AI

- 攻击状态时移速 ×2，近战攻击范围 +1
- **主人攻击谁，狼就咬谁**；主人挨打，狼立刻索敌反击
- 主人没指定目标时，狼自动守护主人 10 格范围内最近的威胁
- 不会隔墙索敌（地下生物不会再让狼对着地板发呆了）
- 狼的攻击能**压制苦力怕**：被狼咬住的苦力怕无法自爆
- **Shift + 空手右键**切换坐下/起立——唯一方式，绝不误触；坐下的狼原地驻守、不放技能

### 💀 死亡不再是终点

- 狼倒下后不会消失，而是化作**「狼之魂」**进入你的背包，保留全部装备与记忆
- 60 秒冷却后右键即可复活，狼之魂不会随主人死亡掉落
- 主人死亡、跨维度传送，狼都会跟上；还有**传送铃铛**，右键跨维度召回

### 📈 反哺技能树（成长系统）

- 佩戴「狼狈」后解锁：狼击杀生物攒经验，**每升一级获得 1 技能点**（上限 100 级）
- 可加点生命、攻击、护甲、韧性、速度、法术强度——**强化的是主人自己**
- 狼变强的同时你也在变强，真正的人狼一体

---

## 📖 技能书（共 20+ 本，放入技能槽即学会）

### 主动技能（按冷却自动释放，仅冷却完毕时按顺序触发）

| 技能 | 效果 |
| --- | --- |
| 坚守者咆哮 | 音波攻击 100 格内敌人，狼总攻击 ×3，无视护甲与目标状态（末影龙停在祭坛也照打） |
| 瞬移突袭 | 瞬移到 48 格内目标身后，×2 伤害 |
| 范围吼叫 | 12 格范围 ×2 伤害并击退 |
| 锁喉 | 扑击目标 ×2 伤害 + 定身 3 秒 |
| 噬魂 | 处决残血（20% 以下）目标，×2 真实伤害 |
| 地震践踏 | 跃起砸地，5 格范围伤害 + 击飞眩晕 |
| 吞月 | 把 8 格内敌人拖到狼面前，×1.5 真伤 |
| 天狼啸月 | 主人与狼获得速度 II + 力量 II |
| 影分身 / 狼群召唤 | 召唤幻影狼嘲讽敌人 / 协同作战 |
| 狩猎标记 | 标记目标，人狼对其伤害 +25% |

### 被动技能

| 技能 | 效果 |
| --- | --- |
| 狂化 | 生命低于 50% 时总速度 ×2、总攻击 ×2，持续 10 秒 |
| 进化 | 体积 ×1.5，攻击距离 +3，横扫范围 +1，横扫刀光同步变大 |
| 撕裂爪 | 攻击附加凋零，可叠至凋零 III |
| 雷牙 | 每 6 秒引发连锁闪电溅射 |
| 冰封牙 | 攻击叠冰冻，满 4 层冻结 2 秒 |
| 嗜血追猎 | 标记残血敌人，狼对其移速 +50%、伤害 +30% |
| 疾风突袭 | 脱战蓄力，首击 ×2 |
| 风影步 | 20% 概率完全闪避伤害 |
| 石肤 | 低血量自动获得吸收 IV |
| 绝地反击 | 致命伤留 1 血并范围反击 ×2 真伤 |
| 护主屏障 | 主人濒危时狼瞬移回身边嘲讽敌人 |
| 同仇连击 | 主人攻击后 2 秒内狼攻击同一目标伤害递增 |
| 反哺 | 狼回血时主人恢复其 50% |

---

## 💍 饰品

### 狼饰品（通用饰品槽）

狼牙护符（吸血）· 守护徽章（单次受伤不超过最大生命 30%）· 生命之符（任意状态每秒回 1 心）· 荆棘反甲 · 抗火血清 · 夜枭之瞳（夜战 +30%）· 狂暴之血（血越少攻越高）· 猎手嗅觉（隔墙透视敌人）· 经验拾荒 · 寻宝鼻（能嗅出钻石）· 饕餮之胃（自动捡食物回血）· 磁石项圈（自动拾取进背包）· 医疗挎包（定期治疗主人）· 幸运爪（掉落翻倍）· 匿踪斗篷（潜行不引怪）

### 玩家饰品（绑定机制⚠️）

- **狼狈**：自身攻击/护甲/韧性/击退抗性的 50% 传给狼，自身相应属性降低 70%；每 120 秒自动获得一次不死图腾；每秒回血。反哺技能树的钥匙
- **薪火**（铁咒法术联动）：解锁狼面板「法术」分页——3 个法术卷轴槽，狼在战斗中**瞬发施法**（无前摇、不耗法力），视线精确瞄准目标，指哪打哪；自身法术强度的 50% 转移给狼
- **共生契约**：人狼平分治疗

> ⚠️ 狼狈与薪火**一旦佩戴便无法取下**。唯一解除方式：手持**「罪业」**右键爱狼献祭它（狼真正死亡、技能树清零）。力量从来都有代价。

---

## 🛡️ 狼铠套装（独立建模，全面包裹）

| 套装 | 属性 | 专属技能 |
| --- | --- | --- |
| **吞日星君**（紫黑神金） | 10 护甲 5 韧性 | 「蚀日雷光」：每 10 秒一道紫黑雷电激光，贯穿 100 格，×3 真伤 |
| **深海霸主** | 水下呼吸 + 海豚恩惠 | 「怒渊漩涡」：目标脚下漩涡拖曳敌人 |
| **熔岩魔神** | 火焰免疫 + 反灼攻击者 | 「炼狱陨星」：陨石范围真伤 + 点燃 |
| **苍穹游侠** | 移速 I + 缓降 | 「天罚风刃」：90° 扇形风刃 + 浮空 |

狼铠无法破坏，且狼装备武器/铠甲上的**任意模组附魔**都能正常生效。

---

## 🔗 模组联动

- **莱特兰-恶意**：主人恶意等级与狼绑定，狼戴上的恶意饰品（含潘多拉系列）双方共同生效
- **铁咒法术**：薪火饰品 + 法术分页；ISS 的戒指/护符戴在狼饰品栏，法术强度直接加成狼的施法
- **精妙背包**：狼可以背背包！面板出现背包按钮可直接打开；磁石项圈自动拾取进背包；也可放末影箱（二选一）
- **Patchouli**：内置完整说明书《豪狼教程》，合成一本随时查阅

---

## ⚙️ 高度可配置

所有饰品、技能、狼铠的数值（伤害倍率、冷却、范围、护甲值、转移比例……）都集中在：

```
config/hero_wolf_accessories.json
```

每个分组带中文说明，`20 ticks = 1 秒`，改完重启生效。改坏了删掉文件即恢复默认。

---

## 📌 小贴士

- 狼免疫摔落伤害、不会因着火而惊慌乱跑
- 狼在非战斗状态每秒自然恢复 1 颗心
- 所有技能书和饰品都有合成配方（用 JEI 查询）
- 一狼制：请善待你唯一的战友

**愿你的狼，陪你从第一夜走到末地尽头。** 🐺