Whistle & Wander

🍃 Whistle & Wander

**Whistle & Wander** is a heartwarming, Vanilla+ companion mod for **Minecraft 1.20.1 (Forge)** that breathes life, charm, and utility into your world. Discover adorable, bouncy biome spirits, carry them safely on your shoulders, play interactive games of football, whistle tunes across mountain peaks, and enjoy their unique survival abilities!

---

🌟 Key Features

* 🐾 **6 Handcrafted Biome Companions** — Unique models, expressive bounce animations, distinct personalities, and authentic Vanilla+ survival abilities.

* 🪂 **Rock-Solid Shoulder Mechanics** — Carry up to two companions on your shoulders. No annoying dismounts when crossing rivers or falling through the air!

* ⚽ **Interactive Toy Ball (Pet Football)** — Throw a ball into your pet yard and watch your companions play football together, passing and kicking with bouncy physics!

* 🎶 **The Friendship Whistle** — A carved musical flute that commands all your companions at once and whistles back lost toys.

* 🌿 **Immersive Audio-Visual Feedback** — Pure organic gameplay with zero text spam: all abilities trigger with custom sounds, particle bursts, and mob animations.

---

🐾 Meet the Companions

1. 🌿 Mossy Hopper

> *The gentle, bouncy spirit of ancient taigas and lush canopies.*

* **Habitat:** Forests, Taigas, Old Growth Pines, Lush Caves *(Spawns in groups of 1–3)*

* **Taming Diet:** Sweet Berries, Glow Berries

* **Unique Abilities:**

* 🫐 **Thorn Walker (On Shoulder):** Sweet Berry Bushes never hurt or slow you down — your Hopper carefully parts the thorny branches with its tiny paws!

* 💡 **Living Spore Lantern:** When darkness surrounds you (light level <= 5), its bioluminescent antennas softly glow, granting you gentle Night Vision and emerald sparks.

* 🌱 **Slumber Gardener:** When resting beneath tree leaves, it periodically sprouts fresh flora nearby — wild Sweet Berry bushes, Ferns, Moss Carpets, or Flowering Azaleas.

* 🍄 **Spore Shedding:** Naturally sheds plantable Mossy Spores over time.

---

2. 🏜️ Sandy Dustbunny

> *A swift, tumbleweed-like desert runner with prickly cactus ears.*

* **Habitat:** Deserts, Badlands *(Spawns in groups of 1–3)*

* **Taming Diet:** Cactus blocks, Melon Slices

* **Unique Abilities:**

* ⏳ **Dune Glider (On Shoulder):** Move freely across Soul Sand and Mud with zero movement slowdown.

* 🏺 **Keen Archaeologist:** Wiggles its cactus ears and perks up whenever Suspicious Sand or Suspicious Gravel is buried nearby (within 8 blocks)!

* 🌵 **Cactus Poke:** If a monster sneaks up behind your back, your shoulder bunny reflexively pricks them with sharp thorns, dealing knockback and damage to warn you!

* ⚠️ *Terrified of water — hops in panic and splashes if it gets soaked!*

---

3. ❄️ Snow Puff

> *An ultra-fluffy, chilled cloud spirit born in frozen mountain peaks.*

* **Habitat:** Snowy Plains, Snowy Taiga, Frozen Peaks, Ice Spikes *(Spawns in groups of 1–3)*

* **Taming Diet:** Snowballs

* **Unique Abilities:**

* ❄️ **Frost Strider (On Shoulder):** Walk freely over Powder Snow without sinking (no leather boots needed!) and enjoy complete immunity to Freezing.

* ☃️ **Frost Snowball Sculptor:** Right-click with a regular snowball (or throw one directly at your Snow Puff) — it will gleefully sculpt a dense **Frost Snowball**! When thrown at enemies, it deals impact damage, Slowness II, and shivering freeze ticks.

* 🧯 **Fire Extinguisher:** If you catch fire from lava or blaze fireballs, your Puff shrieks and instantly extinguishes you in a burst of frosty snow dust (2 minute cooldown).

---

4. 🪨 Pebble Pup

> *A faithful underground miner-pup with crystalline ears and a rocky shell.*

* **Habitat:** Deep Underground Caves, Dripstone Caves, Stony Peaks *(Always spawns strictly solo)*

* **Taming Diet:** Raw Iron/Copper/Gold, Ores, Coal, and Charcoal

* **Unique Abilities:**

* ⛏️ **Ore Sniffer:** Deep subterranean tunnels awaken its nose — it periodically barks, hops, and points its snout directly toward hidden ore veins concealed in walls.

* 🪨 **Cobblestone Cracker:** Feed it regular Cobblestone or Cobbled Deepslate to watch it crunch away, spitting out useful **Flint** (75%) or rare **Amethyst Shards** (25%).

* 🛡️ **Stone Helmet (On Shoulder):** Shrugs off lethal falling stalactites (dripstone), falling blocks (sand/gravel), and stalagmites with a solid stone deflection clink.

* 🐕 **Fetch Stick:** Loves playing fetch! Toss a wooden stick onto the ground, and your pup will gleefully retrieve it in its jaws and place it directly into your inventory.

* 🌿 Apply Bone Meal to grow a lush moss coat on its back, which can be sheared for Moss Carpets.

---

5. 🐸 Bog Buddy

> *A cheerful swamp amphibian wearing a water lily hat and a reed tail.*

* **Habitat:** Swamps, Mangrove Swamps *(Spawns in groups of 1–3)*

* **Taming Diet:** Lily Pads, Seagrass, Slimeballs, Clay Balls

* **Unique Abilities:**

* 🧪 **Swamp Filter (On Shoulder):** If you are poisoned by cave spiders or witches, your Buddy croaks loudly, swallows the venom, and blows out soothing green bubbles (1.5 minute cooldown).

* 🚣 **Lilypad Surfer:** Loves water and never dismounts from your shoulder while swimming! Grants **Dolphin's Grace I** swimming speed and a sparkling bubble wake while riding your shoulder or swimming alongside you.

* 🐸 **Frog Rodeo:** Mounts wild adult frogs! Frogs ridden by a Bog Buddy leap 50% higher and faster, turning them into high-speed swamp vehicles.

* 🌊 *Fully amphibious — breathes underwater and never drowns.*

---

6. 🌸 Petallet

> *A graceful blossom spirit born from gentle cherry grove breezes.*

* **Habitat:** Cherry Groves *(Spawns in groups of 1–3)*

* **Taming Diet:** Pink Petals, Cherry Saplings, Sweet Berries

* **Unique Abilities:**

* 🪂 **Petal Parachute (On Shoulder):** Never dismounts in mid-air! As you plunge toward the ground, it flares its plush cherry petals like an umbrella right before impact to grant **Slow Falling**, completely negating all fall damage.

* 🐝 **Bee Friend:** Bees find Petallet irresistible! Bees remain peaceful toward you, allowing you to harvest wild bee nests and hives without smoke or stings.

* 🌺 **Blossom Trail:** When dancing to music discs or playing with toy balls, vibrant carpets of layered Pink Petals and wild meadow flowers bloom beneath its feet.

---

🎮 Interactive Toys & Tools

⚽ The Toy Ball

* **How to obtain:** Craftable with Slimeballs, Leather, and Dye (Tools & Utilities tab).

* **Companion Football:** Drop the ball near tamed pets to watch them play football! They chase the ball, bounce it with their snouts, make passes to teammates, and celebrate goals.

* **Player Controls:**

* **Left-Click (Kick):** Deliver a punt kick in the direction you look.

* **Walk/Sprint through:** Cleanly dribble the ball forward with smooth rolling physics.

* **Right-Click:** Safely pick the ball back into your hand.

🎶 The Friendship Whistle

* **How to obtain:** Carved from birch wood and amethyst.

* **Right-Click:** A musical tune calls all your tamed companions within 64 blocks to follow you.

* **Shift + Right-Click:** A calming lullaby commands all nearby pets to sit down and rest.

* **Lost Ball Recall:** If a toy ball rolled into the bushes or down a ravine, whistling summons it right back to your feet.

🎒 Shoulder Riding Controls

* **Mounting:** Shift + Right-Click a tamed pet with an empty hand, or let them hop onto you.

* **Dismounting:** **Shift + Right-Click with an empty hand on any solid block** to place your companion down gently.

* *Companions remain firmly on your shoulders while swimming, running, and jumping through the air.*

---

📦 Compatibility & Requirements

* **Minecraft Version:** 1.20.1

* **Mod Loader:** Forge 47.1.3+

* **Dependencies:** None! 100% standalone.

* **Multiplayer:** Fully compatible with dedicated servers and LAN.