Home

Vanilla Outsider: Better Dogs

Welcome to the official GitHub Wiki for Vanilla Outsider: Better Dogs!

Vanilla Outsider: Better Dogs transforms Minecraft's vanilla wolves into intelligent, expressive companions with distinct personality traits, dynamic genetics, realistic physical scaling, tactical pack AI, and dedicated guard capabilities—all designed to seamlessly blend into vanilla survival gameplay.

---

📦 Minecraft Version Directory

Select your target Minecraft version to view dedicated installation guides, dependency bounds, and release notes:

• Minecraft 26.3 Guide & Release Notes — Latest Snapshot Build
• Minecraft 26.2 Guide & Release Notes — Primary Stable Target
• Minecraft 26.1 Guide & Release Notes — Legacy Maintenance Build
• Version Compatibility & History — Full version matrix and legacy 1.21.11 evolution

---

🎮 Player & Gameplay Mechanics Matrix

Explore detailed encyclopedic guides for every feature pillar:

• Wolf Personalities & Combat AI — Aggressive, Pacifist, and Normal personality traits, stat modifiers, follow distances, and storm anxiety.
• Guard Mode & Sentinel Patrols — Sentinel patrol radiuses (12 blk Aggro, 3 blk Pacifist, 0 blk Normal), Regeneration/Resistance owner aura, and alarm particles.
• Breeding, Genetics & Litter Sizes — Personality inheritance formulas, litters (1 to 4 puppies), inbreeding runt penalties, Golden Apple curing, and physical scale genetics (70% - 145%).
• Goat Horns & Tactical Commands — Goat Horn tactical orders (Ponder, Sing, Seek/Call), 64-block command range, and tactical override durations.
• Adoption System — Paper adoption system, pending states, ownership transfers, and damage cancellation logic.
• Dog Riding & Vehicle Transport — Vehicle boarding (Boats, Minecarts, Horses) and riding permission rules (bd_allow_unrestricted_dog_riding).
• Wild Packs & Territorial Rivalries — Pack cluster sizes (4-8 wolves), expanded biome spawning, and the Territorial Dispute Matrix (War %, Merge %, Retreat %).
• Ground Feeding & Favorite Treats — Automatic ground meat feeding, low health fleeing, ground food refusal, UUID-seeded favorite treats, zoomies, and morning gifts.
• Advancements & Achievements — Complete Husbandry advancement tree guide detailing all 13 custom advancements, criteria, and rewards.
• Namespaced GameRules Reference — Complete reference table of all 60+ namespaced GameRules (betterdogs:bd_*), data types, default values, and category toggles.
• Brigadier Command Suite — Brigadier command tree (/betterdogs) and debug subtrees (personality, action, territory).
• Configuration & GUI Integration — Server-side GameRule authority, client GUI integration via ModMenu & YACL v3, and config precedence.
• HUD & Diagnostics — Jade/WTHIT HUD overlay, debug stick shortcuts, runt particles, and diagnostic administration.

---

💻 Developer & Contributor Reference

Technical documentation for building from source, analyzing mixin injection points, and developing addons:

• Developer Setup & Building — Environment setup (JDK 25, Gradle 9.3+, Loom 1.15+) and building tagged release JARs (./gradlew build --no-daemon).
• Architecture & Mixins — Package organization, complete Mixin target breakdown (25 mixins), non-blocking AI goal priority stack, and thread looper safety.
• API & Addon Integration — DasikLibrary integration (DynamicGameRuleManager, ModVersionGuard), custom wolf data codecs, Jade WTHIT integration, and extension event hooks.