# ๐ Better Dogs
**No Backports:** This mod targets **Minecraft 26.1+**. Older versions are unsupported.
> **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, visible via custom particles:
- ๐ข **Aggressive**: The Guardian. Proactively attacks hostile mobs and scouts ahead.
- โค๏ธ **Pacifist**: The Healer. Avoids combat unless you are hurt. High health, low damage.
- โจ **Normal**: The Classic. Balanced stats and standard vanilla-plus behavior.
### ๐ค 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.
### ๐ก๏ธ Smart Survival AI
- **Cliff Safety**: Wolves detect fatal drops and airborne targets, stopping dangerous chases.
- **Hazard Awareness**: Improved pathfinding around lava, fire, and drowning hazards.
- **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.
### ๐ก Behavioral Specialization
- **Scouting**: Aggressive dogs proactively range ahead to clear your path.
- **Silent Alarm**: Pacifist dogs emit a high-pitched whine when they detect nearby monsters.
- **Gift System**: Loyal dogs bring you treasures based on their personality.
- **Debug Tools**: Use `/betterdogs debug` to test pack interactions and behaviors (Locked behind OP permissions and a safety GameRule).
---
## ๐โ๐ฆบ Tamed Wolf Guard Mode *(Added in v3.4.19)*
Put your tamed wolves to work protecting your base while you're away. Right-click a tamed wolf with a bone (consumes 1 bone) to assign it to a **Guard Post** โ it will anchor to that spot and defend the area on its own.
- **Personality Patrols**: Each personality guards differently:
- ๐ข **Aggressive**: Wide outer perimeter sweeps, actively scanning and attacking hostiles.
- โจ **Normal**: Sit-sentry at the post, or structured radial star patrols outward and back.
- โค๏ธ **Pacifist**: Close protective orbital pacing โ acts as a watchdog and alarm system.
- **Auto-Target & Chase Caps**: Guards automatically attack hostiles within range (16โ24 blocks) but are hard-capped from chasing targets too far โ they stay at their post.
- **Watchdog Alarms**: Pacifist guards whine and emit warning note particles when threats approach, and optionally apply Regeneration and Resistance to nearby allies.
- **Visual Indicators**: Subtle foot particles every 4 seconds (ASH / WHITE_ASH / MYCELIUM) show which wolves are on active guard duty at a glance.
- **Ownership Locked**: Only the wolf's owner can toggle Guard Mode or issue commands โ other players are ignored entirely.
---
## โจ More Features
### ๐ค๏ธ Immersive Events
- **Zoomies**: Dogs burst into hyperactive sprints in the morning or when it starts raining โ pure joy!
- **Group Howl**: 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.
### ๐ฐ Wild Wolf Territoriality
Wild wolf packs are now 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.
- **Configurable Instincts**: Use GameRules to fine-tune exactly how Aggressive, Normal, and Pacifist leaders react to each other.
- **1v1 Leader Duels**: If a dispute escalates to War, leaders engage in a cinematic 1v1 duel to settle dominance.
- **Yield & Merge**: Defeated packs are not lost; they yield and **merge** with the winning pack, allowing for the natural formation of massive wolf colonies.
- **Wild Personality AI (New Default)**: Out of the box, wild pack members exhibit unique behaviors (like Aggressive hunting or Pack Retreats) while anchored to their leader.
- **Dynamic Spawning & Reinforcements**: When a pack goes to war or is challenged, nearby wild wolves can spawn or join as reinforcements to defend their pack's territory.
- **Production Stable**: Fully compatible with high-performance engines like **C2ME**, ensuring safe multi-threaded AI execution.
- **Performance Hardened**: All AI logic is performance-optimized using **DasikLibrary 1.7.4**, ensuring zero console spam and smooth server TPS even with massive packs.
---
## โ๏ธ Configuration (Native Game Rules)
No messy config files. Better Dogs uses the **Native Minecraft Game Rules** system. All 50+ mod parameters are grouped into a dedicated **"Better Dogs"** category in the official UI.
> [!TIP]
> **Want a GUI?** Install the optional **[Cloth Config API](https://modrinth.com/mod/cloth-config)** and **[ModMenu](https://modrinth.com/mod/modmenu)** to get a full categorized settings screen inside the game โ no commands needed! *(Added in v3.4.16)*
> [!TIP]
> **Too many options?** If the game rule screen feels cluttered, we highly recommend installing **[Collapsible Game Rules](https://modrinth.com/mod/collapsible-gamerules)**. It will automatically group the settings into clean, expandable folders!
Optional Cloth Config GUI (left) ยท Native GameRule screen (right)
---
## โ Support
If you enjoy the **Vanilla Outsider** collection, consider fueling the next update!
[](https://ko-fi.com/dasikigaijin/tip)
[](https://sociabuzz.com/dasikigaijin/tribe)
[](https://saweria.co/DasikIgaijinn)
> [!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 |
---
**Made with โค๏ธ for the Minecraft community**
*Part of the Vanilla Outsider Collection*