🐕 Better Dogs

• Compatibility Notice Added: ⚠️ Incompatible with Jade >= 26.2.11+ | Works on Jade < 26.2.10 or without Jade (Fix available in version 4.24.37+ on early access)

Make Wolves Worthy Companions. Smarter, Safer, Livelier.

Every Minecraft player knows the pain: you spend hours finding a wolf, tame it, and five minutes later it jumps into lava or walks off a cliff. Better Dogs overhauls wolf AI to make them effective partners. Powered by a high-performance Event-Driven AI Scheduler, they act efficiently without sacrificing performance.

Part of the Vanilla Outsider Collection — mods that refine the vanilla experience with modern standards.

---

✨ Features

🧠 Personality Intelligence

When tamed, wolves develop one of three permanent personalities:

• 💢 Aggressive: The Guardian. Proactively attacks hostile mobs and scouts ahead. Emits red dust particles (0xFF3333) on patrol.
• ❤️ Pacifist: The Healer. Avoids combat unless you are hurt. High health, low damage. Emits green/teal dust particles (0x00FF88) on patrol.
• ✨ Normal: The Classic. Balanced stats and standard vanilla-plus behavior. Emits gold/yellow dust particles (0xFFD700) on patrol.

🛡️ Tamed Wolf Guard Mode

Right-click a tamed wolf with a bone while sneaking (Shift + Right Click) to toggle Guard Mode (consuming exactly 1 bone) and anchor the wolf to its current spot. Guard Mode is locked to the owner.

Guard Mode Particles: To help you easily identify a patrolling or guarding wolf's personality from a distance, they emit tiny, custom-colored dust particles only while actively in Guard Mode (no particles are emitted during normal following or sitting):

  

• Patrol Patterns:
  • Aggressive: Paces in a circular/polygon shape along its outer perimeter sweep (80% range), pausing to scan outward for threats.
  • Normal: Sentry posture at the guard post (range = 0), or radial patrols outward and back (range > 0).
  • Pacifist: Close protective orbital circular pacing around the post.
• Auto-Targeting & Chase Caps: Normal and Aggressive guards automatically attack hostiles within their range but are capped from chasing targets too far to prevent them from being lured away.
• Watchdog Alarms & Alert Stance: Pacifist sentinels whine, freeze in a pointing/alert stance facing the direction of detected threats, and emit warning note particles when hostiles approach, applying Regeneration and Resistance to owners/allies if enabled.

📄 Wolf Ownership Transfer (Adoption)

Easily transfer ownership of your tamed wolves to other players using standard, vanilla-only Paper:

• Pending Adoption State: Shift + Right-Click your tamed wolf with a sheet of Paper to put them up for adoption. The wolf will sit down, halt pathfinding, clear all aggression, and emit a beautiful, sparkling trail of Rose Pink particles.
• Claiming the Wolf: Any non-owner player can right-click the adoptable wolf with an empty main hand to claim them as their new companion, instantly triggering heart particles and mutual overlay notifications.
• Safety Checks: The adoption state is automatically cancelled if the wolf takes any damage, or if the owner simply right-clicks the dog again normally to cancel, preventing accidental claims.

📏 Dynamic Size & Attribute Scaling

In the 26.2+ release stream, physical size is integrated directly with genetics and health using Minecraft's native Attributes.SCALE:

• Health-Based Sizing: A wolf's physical size scales dynamically based on its rolled max health, ranging from 0.808x (weaker/smaller wolves) up to a massive 1.312x (high-health champions).
• Physical Collision & Hitbox: Uses native attributes so collision hitboxes, eye heights, passenger offsets, step heights, and reach ranges update seamlessly.

📏 Dynamic Follower Spread Scaling

Follow/spread spacing of wild and tamed wolf packs scales dynamically based on the number of active followers:

• Spacing increases mathematically based on the square root formula: $f(N) = \text{multiplier} \times \sqrt{N - 1}$ to prevent visual overcrowding.
• Fully configurable via 4 native GameRules: bd_tamed_pack_spread_multiplier, bd_tamed_pack_spread_max, bd_wild_pack_spread_multiplier, bd_wild_pack_spread_max.

🤝 Advanced Social AI

• Social Bonding (Affinity): Dogs form relationships within their pack. Socializing builds trust and reduces accidental infighting.
• Adult Correction: Aggressive adults discipline misbehaving puppies, preventing death loops.
• Pack Genetics: Puppies inherit personality traits and stats from their parents.
• Litter System: Wolves can produce multiple puppies in a single breed — each with independent personality rolls and stats.
• Unrelated Mate Prioritization: Tamed wolves will prioritize breeding with unrelated pack mates in range to prevent accidental inbreeding. If no unrelated options exist, they will fallback to related mates.
• Selective Ground Food Refusal: Some selectively bred or tamed-from-birth lineages can persistently refuse to eat food scavenged from the ground, ensuring they only eat when fed directly by their owner. Toggleable via game rules.

🛡️ Smart Survival AI

• Cliff Safety: Wolves detect fatal drops and airborne targets, stopping dangerous chases.
• Hazard & Magma Avoidance: Wolves intelligently pathfind around lava, fire, drowning hazards, and magma blocks.
• Collision & Push Safety: Tamed wolves colliding with a sitting, guarding, or endangered packmate (facing a cliff, lava, or magma hazard) immediately halt their navigation to prevent pushing them into danger.
• Creeper Awareness: Wolves flee from hissing Creepers!
• Dog Feeding: Tamed dogs scavenge dropped raw or cooked food from the ground to restore health — no manual feeding required.
• Dynamic Whimpering Thresholds: Low-health whining/whimpering is dynamically scaled based on the wolf's maximum health (< 50% max HP) instead of a fixed threshold, preventing Runts and puppies from whining constantly when healthy.

📡 Select-and-Ride Dog Command System

• Mount & Dismount Commands: Sneak-right-click a tamed wolf with a standard Stick (or Blaze Rod / Breeze Rod) to command them to sit or ride inside vehicles, mounts, boats, minecarts, or modded chairs, forcing a proper visual sitting pose.

🎬 Video Tutorial: Select-and-Ride Command System
Watch the feature showcase tutorial below (or click to open on YouTube)

🏆 Custom Advancement System

A collection of custom advancements rewards exploring all mechanics:

• 🐕 A Pack of Personalities: Tame one of each wolf personality type (Normal, Aggressive, and Pacifist).

🔍 Jade Mod HUD Integration

• Dynamic Health Display: Correctly overrides Jade's default health bar to render exact numeric values (HP: X / Y) and hearts, reflecting dynamic health scaling and personality traits.
• Inbred Tag Indicator: Displays genetic inbred status directly in the Jade HUD tooltip.
• Favorite Treat Tooltip: Displays the dog's hidden Favorite Treat in Jade tooltips once discovered.

🌤️ Immersive Events

• Zoomies: Dogs burst into hyperactive sprints in the morning or when it starts raining — pure joy!
• Restored Soundscapes & Group Howl: Restored the atmospheric vanilla pack howl audio files as a registered sound event. Under a full moon, wolves trigger pack-wide howling sessions that spread to nearby pack members.
• Storm Anxiety: Thunderstorms make dogs anxious — they whine, tremble, and pace nervously until the storm passes. This is highly dependent on their personality: Pacifist dogs are extremely prone to anxiety, Normal dogs have standard chances, and Aggressive dogs are completely immune.

🏰 Wild Wolf Territoriality

Wild wolf packs are dynamic, territorial entities led by a dominant leader:

• Territorial Probability Matrix: Pack interactions now utilize a complex, personality-driven matrix. No two disputes are the same!
• Dynamic Outcomes: Depending on leader personalities, packs may Merge (Dominance based), engage in War (1v1 Duels or Pack Combat), or peacefully Retreat to maintain their own borders.
• Yield & Merge: Defeated packs yield and merge with the winning pack, allowing for the natural formation of massive wolf colonies.

💻 Server-Side Optional & Client Gating

• Server-Side Optional: Better Dogs is fully compatible with vanilla clients! Vanilla clients can connect to servers running the mod without installing it.
• Dedicated Server Support: Client-only rendering logic is isolated to prevent classloading crashes on headless dedicated servers.
• GUI Config Integration: Fully supports configuration GUI integrations via ModMenu + Cloth Config / YACL v3 in singleplayer mode.

---

⚙️ Configuration (Native Game Rules)

[!IMPORTANT] Config vs. In-Game GameRules: The global configuration file only defines default values for new worlds at creation time. If you have already created/opened a world, changing the config file will have no effect. You must change the settings in-game using the Edit Game Rules UI screen or the /gamerule command.

No messy config files. Better Dogs uses the Native Minecraft Game Rules system. All mod parameters are grouped into a dedicated "Better Dogs" category in the official UI.

[!TIP] Too many rules? If the game rule screen feels cluttered, we highly recommend installing Collapsible Game Rules. It will automatically group the Personality Matrix settings into clean, expandable folders!

---

☕ Support

If you enjoy the Vanilla Outsider collection, consider fueling the next update!

[!NOTE] Indonesian Users: SocioBuzz and Saweria support local payment methods (Gopay, OVO, Dana, etc.) if you want to support me without using PayPal/Ko-fi!

---

📜 Credits

Role	Author
Creator	Dasik (Rifaditya)
Collection	Vanilla Outsider
License	GPLv3

📦 Modpack Permissions & Distribution:
You are free to include this mod in any modpack on any platform. However, the mod itself must be downloaded from its official distribution pages on Modrinth or CurseForge. Re-uploading or redistributing the mod jar file to third-party sites is strictly prohibited unless explicitly permitted by the creator.

License & Forks:
Since the source code is licensed under GNU GPLv3, you are fully permitted to fork the repository, make modifications, build your own versions, and distribute them under the terms of the GPLv3. The prohibition on third-party redistribution applies exclusively to the official compiled releases/jars published by the original creator (Dasik/Rifaditya). Forks must be published as distinct projects, not direct re-uploads of official builds.

---