Starter Wolf

# 🐺 Starter Wolf 2.0: The Awakening, Pack & Symbiote Overhaul!

Welcome to **Starter Wolf 2.0**—a massive RPG expansion that evolves your soul-bound companion and wild wolves into an unstoppable, zero-lag pack with custom 3D transformations, through-wall scent tracking, and deep progression!

---

## 🔥 What's New in Version 2.0.0

### 🧬 1. Werewolf Symbiosis Transformation (Default Key: `V`)
When your immortal **Alpha Wolf** reaches **Max Level (Lv. 20)**, you unlock the ultimate bond: **True Symbiosis**.
* **Merge with Your Alpha:** Press **`V`** (or `/starterwolf werewolf`) to absorb your Alpha Wolf into your body and transform into a custom **3D Bipedal Werewolf**!
* **Dynamic Posture & Combat Animations:**
  * **Bipedal Stance (Idle / Walking):** Stand tall on two legs and unleash **Dual Claw Slashes** when attacking.
  * **Quadruped Bounding Run (Sprinting):** Drop onto all fours for a feral wolf gallop, switching your attacks to a **Savage Lunge Bite**!
* **Inherited Alpha Power:** Gain your Alpha's Max HP, Attack Damage, Armor, Speed, 1.5-block Step Height, Fall Damage Immunity, 15% Lifesteal, and **30% Max HP Devour** on monster kills.
* **Lore-Accurate Werewolf Weaknesses:**
  * ☀ **Daylight Scorch:** Direct sunlight sets you ablaze—hunt by night, under forest canopies, or in caves!
  * 🍖 **Ravenous Hunger:** Symbiosis drains your hunger continuously while active.
  * ⚔ **Iron Allergy:** Werewolves cannot hold or wear **Iron equipment** (automatically sizzles and drops from your hands/armor slots) and take **+50% bonus damage** from Iron weapons and Iron Golems!

---

### 🌑 2. Pack Shadow Hide — Zero-Lag Mode (Default Key: `G`)
Love building a massive wolf army, but hate entity pathfinding lag in tight caves or bases?
* Press **`G`** (or `/starterwolf shadow`) to command your entire wolf pack to **merge into your shadow**!
* Stowed wolves become completely intangible and consume **zero AI/pathfinding FPS**, while **100% of their passive auras and abilities remain active** (including Night Vision, Shaman Healing & Totem Revives, Bloodhound Auto-Loot & X-Ray Scent, and Pack Blessings)!
* Press **`G`** again at any time to ambush enemies and release your pack back into the physical world.

---

### 🐾 3. Wild Wolf Growth & Level 10 Class Awakening
Every wild wolf you tame now starts as a **Level 1 Pup (0.5x size)** and physically grows larger with every level!
At **Level 10 (Beta Rank)**, right-click your wolf with a **Stick** to awaken one of **4 Specialized RPG Classes**:
* 🛡 **Brute:** Massive Tank with **+40 Bonus HP**, **+15 Armor**, and **3.5x Giant Size** at Level 20.
* 🗡 **Shadowfang:** Stealth Assassin that grants **Shared Night Vision**, inflicts **Wither**, shadow-steps behind enemies at Level 20, and **instantly executes** non-boss monsters below 15% HP.
* ✨ **Spirit Shaman:** Pack Healer that pulses AoE regeneration every 4 seconds and acts as a **Living Totem of Undying** at Level 20—sacrificing its energy (even from inside your shadow!) to save you from fatal damage.
* 🔍 **Bloodhound:** Utility Tracker that **vacuums nearby loot** straight into your inventory, highlights monsters with **Glowing**, and features the **X-Ray Scent Scanner** at Level 20!

---

### 💎 4. Redesigned Bloodhound X-Ray Block Highlight
* Place any block or ore into your Level 20 Bloodhound's **Scent Tracker Slot** (or leave it empty to auto-detect **Diamonds, Emeralds, Gold, and Ancient Debris**).
* Instead of chat spam, your Bloodhound now projects a **3D Through-Wall Wireframe Highlight** directly onto matching blocks within a 16-block radius!

---

### ♞ 5. Improved Giant Alpha Mounting & Native 1.20.1 Scaling
* **No External Dependencies Required:** Built-in 3D model & hitbox scaling—**Pehkui is no longer required!**
* **Elevated Rider Seat & Visual Raycast:** Mount your Saddled Level 20 Alpha Wolf by right-clicking anywhere on its giant 5x body and ride high on its back with responsive `WASD` steering and size-scaled jumping.

---

### 🔄 6. Seamless v1.8.0 World Upgrade Support & Admin Controls
* **Automatic Legacy Migration:** Upgrading an existing world from **Starter Wolf 1.8.0**? Version 2.0 automatically detects and upgrades your existing 1.8.0 Alpha Wolf and tamed pack wolves without spawning duplicate Alphas!
* **Full Server Config (`starterwolf-common.toml`) & Admin Commands:** Server admins can customize max scales, HUD positions, Werewolf weaknesses, or toggle Werewolf Symbiosis live in-game using `/starterwolf admin werewolf <true|false>`.