Starter Wolf

🐺 Starter Wolf: RPG Companion

Never start your Minecraft adventure alone again!

Starter Wolf is a Vanilla+ companion mod that guarantees every player gets a loyal, auto-tamed wolf the very first time they log into a world. But this isn't just a regular vanilla dog—your new Starter Pet features a fully custom RPG leveling system, dynamic physical growth, and a controllable auto-hunting AI!

✨ Key Features

The Loyal Starter Pet

• Instant Companion: The moment you join a world for the first time, a tamed, named "Starter Pet" will spawn right by your side.

• Failsafe Respawn: Did your loyal companion meet a tragic end? Don't worry! If your Starter Pet dies, you will automatically be granted a new Level 1 wolf the next time you log into the server.

RPG Leveling & Growth

• Dynamic EXP System: Your wolf earns EXP every time it deals damage to a mob. If your wolf gets the final killing blow, it earns bonus EXP equal to the mob's maximum health!

• Stat Scaling: The wolf can reach a maximum of Level 20. Every time it levels up, it permanently gains +0.5 Max Health and +1.0 Attack Damage.

• Physical Growth: As your wolf levels up, it physically grows larger! A max-level wolf is nearly double the size of a standard vanilla wolf.

Visual Progression You can tell how strong a Starter Wolf is just by looking at it. As your pet levels up, its collar automatically changes color to reflect its power tier:

• Level 1+: Standard Red

• Level 5+: Emerald Green

• Level 10+: Gold Yellow

• Level 15+: Diamond Light Blue

• Level 20 (MAX): Epic Purple

Interactive Items

• The Stat Checker (Stick): Want to know exactly how much EXP your wolf needs to level up? Just right-click your wolf with a Stick to receive a private chat message detailing its exact Level, Health, and EXP.

• Berserk Mode (Bone): Right-click your wolf with a Bone to toggle Berserk Mode! When active, your wolf will emit angry storm-cloud particles and automatically hunt down any hostile mobs or animals within a 16-block radius. (Safety feature: Berserk wolves will automatically ignore Creepers, Players, and other pets to prevent accidental explosions and friendly fire!)

⚙️ Dependencies

This mod requires Pehkui (Forge 1.20.1) to handle the physical size scaling of the wolf. Please make sure Pehkui is installed in your mods folder alongside Starter Wolf, or the game will crash!

🎮 Multiplayer / Server Safe

Starter Wolf is fully compatible with multiplayer servers. Every individual player will receive their own personal Starter Pet upon joining the server for the first time!

Here is a complete, feature-rich description tailored for your Starter Wolf 2.0 mod page (ready to copy and paste directly into CurseForge, Modrinth, or Planet Minecraft):

🐺 Starter Wolf 2.0: Pack & Awakening (Minecraft 1.21.1 Forge)

Never adventure alone again.

What started as a simple loyal companion mod has evolved into a complete, vanilla-faithful Wolf RPG & Pack Management Overhaul for Minecraft 1.21.1! From dynamic riding physics to specialized pack archetypes, custom armor gem socketing, and immortal soul-binding, Starter Wolf 2.0 transforms your canine companion into the ultimate adventure partner.

🚀 What's New in Version 2.0?

• Zero External Dependencies: Say goodbye to Pehkui! Starter Wolf 2.0 natively harnesses Minecraft 1.21.1's built-in entity scale attributes. No extra libraries or external mod dependencies required.

• True WASD Mount System: Equip a saddle directly into your Alpha’s inventory to ride it like a noble mount with responsive WASD movement, dynamic step-height, fall damage immunity, and size-scaled jumping!

• Pack & Archetype Evolution: Any wild wolf you tame now enters your pack as an RPG companion. Level them to Beta (Level 10) to awaken unique class specializations!

• Soul-Bound Immortality: Your Alpha Wolf cannot permanently die. Fatal blows turn your Alpha into an ethereal ghost until you summon them back into the physical realm.

• Canine Satchel Storage: Your Alpha comes equipped with a dynamic backpack inventory that expands as your wolf pack grows.

• Seamless In-Place GUI: Allocate skill points into Vitality, Ferocity, and Swiftness through a customized management menu without annoying mouse-cursor resets.

🌟 Key Features

👑 The Starter Alpha Wolf

• Instant Soul-Bonding: Receive your immortal Alpha Wolf the moment you step foot into a new world.

• Manual RPG Stat Allocation: Wolves gain Skill Points as they level up. Distribute them across Vitality (Max Health), Ferocity (Attack Damage), and Swiftness (Movement Speed).

• Collar Progression: A visual tier indicator reflects your wolf’s power tier at a glance:

  • Level 1–4: Crimson Red

  • Level 5–9: Emerald Green

  • Level 10–14: Golden Yellow

  • Level 15–19: Diamond Light Blue

  • Level 20 (MAX): Royal Purple

• Rideable Mount (Level 20): Equip a Saddle directly into the Alpha's menu to ride it! Control its movement using smooth WASD steering, leap across ravines with Spacebar jumps that scale with your wolf's physical size, and traverse cliffs without fear thanks to built-in Fall Damage Immunity.

• Ghost State & The Bone Whistle: When an Alpha takes fatal damage, it shifts into a ghost form (-1 Level penalty). Shift + Right-Click a Bone to blow the Bone Whistle—restoring your Alpha and rallying all pack wolves across the entire dimension to your side.

🐾 Pack Mechanics & Archetype Evolution

Taming wild wolves now binds them to your pack as Pups. As they battle by your side and mine ores with you, they rank up through the pack hierarchy. Upon hitting Beta (Level 10), awaken them into one of three unique archetypes:

• 🗡️ The Shadowfang (Assassin):

  • Shadow Strike: Inflicts decaying Wither bleed on target hit.

  • Nocturnal Link: Grants permanent, shared Night Vision to you and the wolf.

  • Shadow Step (Level 20): Instantly teleports behind weakened targets to execute enemies below 15% HP.

• 🌿 The Spirit Shaman (Support):

  • Healing Pulse: Periodically emits radiant healing waves to restore health to the owner and nearby pack members.

  • Spirit Ward (Level 20): Sacrifices its own health to act as a Totem of Undying if its owner suffers fatal damage.

• 🧭 The Bloodhound (Scout & Utility):

  • Auto-Loot Vacuum: Automatically picks up nearby dropped mob loot and places it safely into your inventory.

  • Predator Mark (Level 20): Highlights nearby hostile threats with a glowing outline.

  • Smart Ore Sonar: Detects and points particle trails to high-value ores (Ancient Debris, Diamonds, Emeralds, and Gold).

  • Custom Scent Tracking: Shift-click any block from your inventory into the Bloodhound's menu to lock onto that specific block scent!

🎒 The Canine Satchel & Pack Aura

• Expanding Storage: Access your Alpha’s built-in Canine Satchel directly from the management menu. For every living wolf in your pack, the satchel unlocks 3 additional slots (up to 54 slots).

• Symbiosis: Whenever a pack pup ranks up, your Alpha absorbs spiritual energy and receives bonus Skill Points!

• Alpha Blessings: Staying close to your Alpha grants Haste. If you travel with multiple pack members, you gain Regeneration and Absorption shields that scale with pack size.

💎 Anvil Gem Socketing

Upgrade vanilla Wolf Armor by fusing gemstones at an Anvil:

• 💎 Diamond: Grants +10 Flat Armor (Physical Tank).

• 🟥 Redstone Block: Grants +15 Bonus Health (Blood Ruby).

• 🥇 Gold Ingot: Grants +Movement Speed (Topaz Agility).

• ❇️ Emerald: Grants +5% Lifesteal on hit.

• 🔮 Amethyst Shard: Grants +25% Magic & Potion Damage Resistance.

🎮 Controls & Commands

Action	Control / Item
Open Wolf Management GUI	Right-Click any wolf with a Stick
Toggle Berserk / Defense Mode	Right-Click any wolf with a Bone
Rally Pack & Revive Alpha	Shift + Right-Click holding a Bone
Mount Alpha (Level 20 + Saddled)	Right-Click Alpha with an Empty Hand
Steer & Jump Mount	WASD to steer, Spacebar to leap
Open Pack Overview Menu	/starterwolf pack
Grant Pack XP (Admin)	/starterwolf addxp <amount>

⚙️ Compatibility & Requirements

• Platform: Minecraft Forge 1.21.1

• Dependencies: None! (Pure standalone mod)

• Multiplayer / Server Safe: Fully optimized for dedicated servers. Every player receives their own personal Alpha upon first login, with all stats, satchel inventories, and pack bonds safely serialized via Forge Capabilities.

  🐺 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!
  * 🎨 **Fun Quirk — Edible Dye Fur Tinting:** Want a Blood-Red, Shadow-Black, or Cyan Werewolf? Right-click to **eat any Vanilla Dye** and your Werewolf fur will dynamically shift to the hue of the dye you ate!

  ---

  🌑 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>.