ВЕРСИИ (302)

### Changed - 🧬 **Additive Modifier Behavioral Quirk Model** (`WolfDispositionHelper.java`): - Implemented additive modifier variance model with wide personality spread: - **Fetch Reluctance**: Aggressive (0–5%), Normal (3–18%), Pacifist (15–45%). - **Storm Fearlessness**: Aggressive (90–100%), Normal (10–35%), Pacifist (0–15%). - **Quiet Howling**: Aggressive (0–10%), Normal (5–30%), Pacifist (25–65%). - Combined personality baseline percentages with deterministic UUID offsets (±10% to ±20%). --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs/issues) - [Source Code](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/vanilla-outsider-better-dogs/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [5.0.56+26.3] ### Added - 🧬 **Personality + UUID Seeded Behavioral Variance (`WolfDispositionHelper.java`)**: - Deterministically seeded individual behavioral nuances using 64-bit bit-mixing hashing over `UUID` + `WolfPersonality` + behavior salt (zero NBT storage). - ~5% of dogs are organically reluctant to fetch sticks; non-fetchers either curiously tilt their heads (`setIsInterested(true)`) or naturally ignore nearby thrown sticks. - ~10% of dogs are naturally fearless during thunderstorms, bypassing storm panic and whimpering. - ~15% of dogs are quiet observers who refrain from participating in nocturnal group howling choruses. --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs/issues) - [Source Code](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/vanilla-outsider-better-dogs/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [1.0.51+1.21.11] ### Added - 🏆 **Dedicated 13 Husbandry Advancements Tree (`WolfAdvancementHelper.java`)**: - Implemented 13 custom advancements nested under Vanilla's Husbandry tree (`minecraft:husbandry/tame_an_animal`): - **Man's Best Companion** (`tame_wolf`, Task): Tame a canine companion with an authentic personality. - **Who's a Good Dog?** (`pet_dog`, Task): Pet a tamed dog with an empty hand. - **Safe and Sound** (`soothe_dog`, Task): Soothe a trembling or weather-panicked dog during a thunderstorm. - **Gourmet Canine** (`favorite_treat`, Task): Discover and feed your companion their individual favorite treat. - **The Zoomies** (`zoomies`, Task): Trigger a sprint burst by giving your dog its favorite snack. - **Fetch Master** (`fetch_stick`, Task): Throw a stick and have your dog retrieve it for you. - **Sentinel on Duty** (`guard_mode`, Task): Place a loyal dog on sentinel guard patrol mode. - **Morning Surprise** (`morning_gift`, Task): Receive a morning gift from your sleeping companion. - **Second Chance** (`adopt_dog`, Task): Successfully adopt a listed dog using an adoption paper certificate. - **Pack Conductor** (`horn_command`, Task): Command a pack of dogs using a Goat Horn. - **Genetic Restoration** (`cure_inbred`, Goal): Cure an inbred runt defect with a Golden Apple. - **Nocturnal Symphony** (`chorus_howl`, Goal): Witness or participate in a nocturnal pack chorus howl under the moonlight. - **Apex Dynasty** (`giant_lineage`, Challenge): Successfully breed a giant-scale (1.25x+) companion dog through generational lineage. - Added automated unit test suite `AdvancementCriteriaTest`. --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs/issues) - [Source Code](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/vanilla-outsider-better-dogs/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [1.0.49+1.21.1] ### Added - ⚡ **Full Brigadier `/betterdogs` & `/bd` In-Game Command Suite (`BetterDogsCommand.java`, `CommandSuggestionsHelper.java`)**: - Implemented complete in-game Brigadier command tree with root `/betterdogs` and convenient short alias `/bd`. - **Welcome & Help** (`/betterdogs`, `/betterdogs help`): Displays formatted syntax reference and command guides for players and administrators. - **Categorized Companion Status** (`/betterdogs status`): Visual, color-coded diagnostic overview displaying active states across Personalities & Stats, Environmental Safety, Combat/Tactics, and Genetics/Breeding. - **Rule Querying with Flexible Resolution** (`/betterdogs get <rule>`): Queries active GameRule values with full tab completion and shorthand matching (e.g., `cliff_safety` resolves to `bd_cliff_safety`). - **Permission-Gated Rule Modification** (`/betterdogs set <rule> <val>`): Allows operators (Permission Level 2) to dynamically adjust boolean toggles and integer modifiers on the fly. - **Factory Reset & State Sync** (`/betterdogs reset`, `/betterdogs reload`): Instantly restores all 80+ companion GameRules to factory defaults or confirms active state synchronization. - Added automated unit test suite `CommandSuiteTest`. --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs/issues) - [Source Code](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/vanilla-outsider-better-dogs/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [1.0.51+1.20.1] ### Added - 🥩 **Feeding-Gated Merits & Gift System (`WolfGiftGoal.java`, `WolfGiftHelper.java`, `WolfPersistentData.java`)**: - Implemented persistent feeding merits tracking (`feedCount`) incremented each time the dog is fed. - Dogs require $\ge 10$ feeding merits (`bd_gift_feed_threshold`) before bringing gifts, consuming 10 merits upon delivery. - Added accidental player attack demerit penalty (`bd_demerit_accidental_attacks`) resetting accumulated merits upon friendly fire. - 🐾 **Follower Pack Spacing Offset (`PersonalityFollowOwnerGoal.java`)**: - Implemented `FollowerSpacingCache` and dynamic $\sqrt{N-1}$ pack spread offset expanding follower start/stop distances, eliminating clustering and crowding at the player's feet. - Added GameRules `bd_tamed_pack_spread_multiplier` (default `100`) and `bd_tamed_pack_spread_max` (default `50`). - 🌸 **Puppy Curiosity AI (`BabyCuriosityGoal.java`)**: - Puppies explore natural vegetation and observe critters when idle. - Added automated test suite `WolfGiftMeritsTest` and `BabyCuriosityTest`. --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs/issues) - [Source Code](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/vanilla-outsider-better-dogs/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [4.24.56+26.2] ### Changed - 🧬 **Full-Spectrum [-100%, +100%] UUID Behavioral Variance (`WolfDispositionHelper.java`)**: - Expanded individual dog UUID offset range to $[-100\%, +100\%]$ (clamped to $[0\%, 100\%]$). - Applied base personality values: - **Fetch Reluctance**: Aggressive ($10\%$), Normal ($30\%$), Pacifist ($60\%$). - **Storm Fearlessness**: Aggressive ($80\%$), Normal ($40\%$), Pacifist ($10\%$). - **Quiet Howling**: Aggressive ($10\%$), Normal ($25\%$), Pacifist ($60\%$). --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs/issues) - [Source Code](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/vanilla-outsider-better-dogs/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [5.1.1+26.1.2] ### Changed - GameRule Identifier Crash Fix & Harmless Pack Sparring Suite --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs/issues) - [Source Code](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/vanilla-outsider-better-dogs/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [1.0.50+1.21.11] ### Added - ❄️ **Dynamic Climate Coat Biome Variants (`WolfCoatVariantHelper.java`)**: - Implemented dynamic climate-appropriate coat textures mapped across biome temperatures: Freezing (Snowy/Ashen), Cold Taiga (Pale/Black/Chestnut/Ashen), Temperate Forest (Woods/Pale), Warm Jungle (Rusty), and Hot Savanna/Badlands/Desert (Spotted/Striped). - Implemented 50/50 puppy breeding adaptation: puppies born in new biomes have a 50% chance to inherit their parents' coat variant and a 50% chance to adapt their coat to the local biome's climate temperature. - Gated under `bd_dynamic_climate_variants` GameRule (default: `true`). - Added automated unit test suite `ClimateVariantTest`. --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs/issues) - [Source Code](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/vanilla-outsider-better-dogs/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [1.0.48+1.21.1] ### Added - 🏆 **Dedicated 13 Husbandry Advancements Tree (`WolfAdvancementHelper.java`)**: - Implemented 13 custom advancements nested under Vanilla's Husbandry tree (`minecraft:husbandry/tame_an_animal`): - **Man's Best Companion** (`tame_wolf`, Task): Tame a canine companion with an authentic personality. - **Who's a Good Dog?** (`pet_dog`, Task): Pet a tamed dog with an empty hand. - **Safe and Sound** (`soothe_dog`, Task): Soothe a trembling or weather-panicked dog during a thunderstorm. - **Gourmet Canine** (`favorite_treat`, Task): Discover and feed your companion their individual favorite treat. - **The Zoomies** (`zoomies`, Task): Trigger a sprint burst by giving your dog its favorite snack. - **Fetch Master** (`fetch_stick`, Task): Throw a stick and have your dog retrieve it for you. - **Sentinel on Duty** (`guard_mode`, Task): Place a loyal dog on sentinel guard patrol mode. - **Morning Surprise** (`morning_gift`, Task): Receive a morning gift from your sleeping companion. - **Second Chance** (`adopt_dog`, Task): Successfully adopt a listed dog using an adoption paper certificate. - **Pack Conductor** (`horn_command`, Task): Command a pack of dogs using a Goat Horn. - **Genetic Restoration** (`cure_inbred`, Goal): Cure an inbred runt defect with a Golden Apple. - **Nocturnal Symphony** (`chorus_howl`, Goal): Witness or participate in a nocturnal pack chorus howl under the moonlight. - **Apex Dynasty** (`giant_lineage`, Challenge): Successfully breed a giant-scale (1.25x+) companion dog through generational lineage. - Added automated unit test suite `AdvancementCriteriaTest`. --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs/issues) - [Source Code](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/vanilla-outsider-better-dogs/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [1.0.50+1.20.1] ### Added - 🪑 **Dog Mounting & Vehicle/Seat Boarding Command Suite (`DogCommandManager.java`, `MoveToVehicleGoal.java`, `BetterDogsTags.java`)**: - Implemented stick/command item interaction allowing players crouching with a command item (Stick, Blaze Rod) to select an owned tamed dog and command it to board a vehicle (Boat, Minecart, Horse, Camel, Saddled Pig/Strider) or stair/chair block within 12 blocks. - Added `MoveToVehicleGoal` enabling dogs to navigate at 1.25x speed directly to the targeted seat and mount smoothly. - Added shift-right-click dismounting command when interacting with a seated dog using a command item. - Registered `#vanilla-outsider-better-dogs:command_items` item tag. - Added namespaced boolean GameRule `bd_allow_unrestricted_dog_riding` (default: `false`). - Added automated unit test suite `DogCommandTest`. --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs/issues) - [Source Code](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/vanilla-outsider-better-dogs/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [4.24.55+26.2] ### Changed - 🧬 **Additive Modifier Behavioral Quirk Model (`WolfDispositionHelper.java`)**: - Implemented additive modifier variance model with wide personality spread: - **Fetch Reluctance**: Aggressive ($0\text{--}5\%$), Normal ($3\text{--}18\%$), Pacifist ($15\text{--}45\%$). - **Storm Fearlessness**: Aggressive ($90\text{--}100\%$), Normal ($10\text{--}35\%$), Pacifist ($0\text{--}15\%$). - **Quiet Howling**: Aggressive ($0\text{--}10\%$), Normal ($5\text{--}30\%$), Pacifist ($25\text{--}65\%$). - Combined personality baseline percentages with deterministic UUID offsets ($\pm 10\%$ to $\pm 20\%$). --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs/issues) - [Source Code](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/vanilla-outsider-better-dogs/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [5.1.0+26.1.2] ### Added - 🐕 **Harmless Pack Play Sparring AI Suite**: Tamed co-owned dogs of the same pack can now initiate safe, playful sparring sessions featuring playful circles, dynamic pouncing, spectator dog reactions, and tail-wagging. - 🐺 **Adult Discipline & Hierarchy Correction Snap**: Calm adult dogs deliver non-lethal hierarchy correction snaps (0.5 hearts to adults, 0 damage to puppies with gentle growl) when pounced upon excessively (3-5 pounces), silencing pack alerts and suppressing retaliation. - ⏱️ **Play Timeout Penalties & Mood Postures**: Disciplined dogs receive a 10-minute play timeout penalty, adopting a subdued tail posture and emitting gentle submissive whines when petted. - 🍖 **Comforting Treat Soothing**: Feeding disciplined dogs comforting treats (bones, cooked/raw meats) soothes their mood and reduces timeout penalties by up to 10% per treat. - 👥 **Pack Audience Reactions**: Nearby packmate dogs within 6 blocks spectate sparring matches with excited tail wags. - 🏆 **Advancements & GameRules**: Added `Roughhousing` and `Know Your Place` husbandry advancements, accompanied by `betterdogs:dogPlayFighting` and `betterdogs:playPenaltyMinutes` GameRules. --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs/issues) - [Source Code](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/vanilla-outsider-better-dogs/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [1.0.49+1.21.11] ### Added - 💬 **Configurable Subtitle & Actionbar Feedback Options (`WolfFeedbackHelper.java`, `BetterDogsGameRules.java`)**: - Added namespaced boolean GameRule `bd_actionbar_feedback` (default: `false`) to give players and server hosts full control over companion HUD notifications. - When disabled (`false`), HUD/actionbar subtitle text is kept clean and unobtrusive while preserving all natural in-world particle bursts and authentic sound effects. - Gated text notifications include: Taming Personality Announcements, Adoption Listing/Cancellation/Adoption alerts, Guard Mode Coordinate Status, and Morning Gift Arrivals. - Added automated unit test suite `SubtitleFeedbackTest`. --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs/issues) - [Source Code](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/vanilla-outsider-better-dogs/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [1.0.47+1.21.1] ### Added - ❄️ **Dynamic Climate Coat Biome Variants (`WolfCoatVariantHelper.java`)**: - Implemented dynamic climate-appropriate coat textures mapped across biome temperatures: Freezing (Snowy/Ashen), Cold Taiga (Pale/Black/Chestnut/Ashen), Temperate Forest (Woods/Pale), Warm Jungle (Rusty), and Hot Savanna/Badlands/Desert (Spotted/Striped). - Implemented 50/50 puppy breeding adaptation: puppies born in new biomes have a 50% chance to inherit their parents' coat variant and a 50% chance to adapt their coat to the local biome's climate temperature. - Gated under `bd_dynamic_climate_variants` GameRule (default: `true`). - Added automated unit test suite `ClimateVariantTest`. --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs/issues) - [Source Code](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/vanilla-outsider-better-dogs/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [1.0.49+1.20.1] ### Added - ⚡ **Full Brigadier `/betterdogs` & `/bd` In-Game Command Suite (`BetterDogsCommand.java`, `CommandSuggestionsHelper.java`)**: - Implemented complete in-game Brigadier command tree with root `/betterdogs` and convenient short alias `/bd`. - **Welcome & Help** (`/betterdogs`, `/betterdogs help`): Displays formatted syntax reference and command guides for players and administrators. - **Categorized Companion Status** (`/betterdogs status`): Visual, color-coded diagnostic overview displaying active states across Personalities & Stats, Environmental Safety, Combat/Tactics, and Genetics/Breeding. - **Rule Querying with Flexible Resolution** (`/betterdogs get <rule>`): Queries active GameRule values with full tab completion and shorthand matching (e.g., `cliff_safety` resolves to `bd_cliff_safety`). - **Permission-Gated Rule Modification** (`/betterdogs set <rule> <val>`): Allows operators (Permission Level 2) to dynamically adjust boolean toggles and integer modifiers on the fly. - **Factory Reset & State Sync** (`/betterdogs reset`, `/betterdogs reload`): Instantly restores all 80+ companion GameRules to factory defaults or confirms active state synchronization. - Added automated unit test suite `CommandSuiteTest`. --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs/issues) - [Source Code](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/vanilla-outsider-better-dogs/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [4.24.54+26.2] ### Added - 🧬 **Personality + UUID Seeded Behavioral Variance (`WolfDispositionHelper.java`)**: - Deterministically seeded individual behavioral nuances using 64-bit bit-mixing hashing over `UUID` + `WolfPersonality` + behavior salt (zero NBT storage). - ~5% of dogs are organically reluctant to fetch sticks; non-fetchers either curiously tilt their heads (`setIsInterested(true)`) or naturally ignore nearby thrown sticks. - ~10% of dogs are naturally fearless during thunderstorms, bypassing storm panic and whimpering. - ~15% of dogs are quiet observers who refrain from participating in nocturnal group howling choruses. --- **Links & Resources**: - [Issue Tracker](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs/issues) - [Source Code](https://github.com/Rifaditya/Vanilla-Outsider-Better-Dogs) - [Wiki & Documentation](https://dasik-mc-studio.pages.dev/vanilla-outsider-better-dogs/) - [Support on Ko-fi](https://ko-fi.com/dasikigaijin) - [Discord Community](https://discord.gg/VSHP6mw4qY)

## [5.0.94+26.1.2] ### Changed - Multi-Era Parity Alignment (MC 26.1.2)

## [1.0.48+1.21.11] ### Added - 🐺 **Wild Pack Dynamics & Territorial Chorus Howling (`WolfHowlHelper.java`, `GroupHowlGoal.java`, `WildWolfTerritorialGoal.java`)**: - Implemented nocturnal skyward chorus howling where wolves tilt their heads skyward (pitch $-45^\circ$) for 3 seconds (60 ticks), prompting nearby pack members within 24 blocks to join in sequential chorus with natural randomized pitch variations. - Full moon phases significantly increase the frequency of nocturnal pack howling. - Implemented untamed pack territorial dynamics where wild wolves encountering rival wolves within 12 blocks perform threat posturing: Aggressive wolves aggressively challenge and stalk intruders, Pacifist wolves yield and retreat, and Normal wolves hold territorial standoff boundaries. - Added automated unit test suite `WildPackDynamicsTest`.

## [1.0.46+1.21.1] ### Added - 💬 **Configurable Subtitle & Actionbar Feedback Options (`WolfFeedbackHelper.java`, `BetterDogsGameRules.java`)**: - Added namespaced boolean GameRule `bd_actionbar_feedback` (default: `false`) to give players and server hosts full control over companion HUD notifications. - When disabled (`false`), HUD/actionbar subtitle text is kept clean and unobtrusive while preserving all natural in-world particle bursts and authentic sound effects. - Gated text notifications include: Taming Personality Announcements, Adoption Listing/Cancellation/Adoption alerts, Guard Mode Coordinate Status, and Morning Gift Arrivals. - Added automated unit test suite `SubtitleFeedbackTest`.

## [1.0.48+1.20.1] ### Added - 🏆 **Dedicated 13 Husbandry Advancements Tree (`WolfAdvancementHelper.java`)**: - Implemented 13 custom advancements nested under Vanilla's Husbandry tree (`minecraft:husbandry/tame_an_animal`): - **Man's Best Companion** (`tame_wolf`, Task): Tame a canine companion with an authentic personality. - **Who's a Good Dog?** (`pet_dog`, Task): Pet a tamed dog with an empty hand. - **Safe and Sound** (`soothe_dog`, Task): Soothe a trembling or weather-panicked dog during a thunderstorm. - **Gourmet Canine** (`favorite_treat`, Task): Discover and feed your companion their individual favorite treat. - **The Zoomies** (`zoomies`, Task): Trigger a sprint burst by giving your dog its favorite snack. - **Fetch Master** (`fetch_stick`, Task): Throw a stick and have your dog retrieve it for you. - **Sentinel on Duty** (`guard_mode`, Task): Place a loyal dog on sentinel guard patrol mode. - **Morning Surprise** (`morning_gift`, Task): Receive a morning gift from your sleeping companion. - **Second Chance** (`adopt_dog`, Task): Successfully adopt a listed dog using an adoption paper certificate. - **Pack Conductor** (`horn_command`, Task): Command a pack of dogs using a Goat Horn. - **Genetic Restoration** (`cure_inbred`, Goal): Cure an inbred runt defect with a Golden Apple. - **Nocturnal Symphony** (`chorus_howl`, Goal): Witness or participate in a nocturnal pack chorus howl under the moonlight. - **Apex Dynasty** (`giant_lineage`, Challenge): Successfully breed a giant-scale (1.25x+) companion dog through generational lineage. - Added automated unit test suite `AdvancementCriteriaTest`.

## [5.0.55+26.3] ### Changed - ✨ **Subtle Particle Feedback for Fetch, Gifts & Treat Feeding (`WolfFetchHelper`, `WolfGiftHelper`, `DogTreatHelper`, `WolfParticleHelper`)**: - Integrated `WolfParticleHelper.spawnSubtleParticles` to scale subtle interaction cues with `bd_particle_density` GameRule (`NONE`: 0, `LOW`: 1, `MEDIUM`/`HIGH`: 2). - Reduced stick/item fetch return and scavenged morning gift delivery particles to 2 subtle emerald glints (`0.15` spread, `0.02` speed). - Softened favorite treat feeding visual feedback from 10 happy villager + 5 heart particles to subtle 2 happy villager + 1 heart particle.

## [5.0.39+26.3] ### Added & Refactored - **Morning Gift Bringing & Feeding Merits System (`WolfGiftGoal`, `WolfGiftHelper`, `WolfPersistentData`)**: - Implemented morning approach AI where healthy, monster-free dogs approach waking owners at $1.25\times$ speed to present scavenged gifts. - Enforced 10-meal feeding merit threshold (`bd_gift_feed_threshold`), consuming 10 merits upon delivery with strict 1-day cooldown tracking. - Implemented personality-themed scavenged gift loot pools (Aggressive: combat drops/bones/eyes; Pacifist: berries/apples/flowers; Normal: utility/sticks/feathers) plus 5% rare treasures (gold nuggets, emeralds, name tags, bone meal). - Emits happy villager celebration particles via `WolfParticleHelper` and ambient audio cues upon gift delivery. - Added automated test suite `MorningGiftTest` asserting threshold gating, merit deduction, daily cooldown math, health eligibility, and null safety.

## [5.0.22+26.3] ### Refactored & Polished - **Minimal Tame Particle Polish (`WolfParticleHandler`)**: Polished first-time taming particle feedback with a clean, subtle Minimal Signature (~5-6 particles) per personality: - **Aggressive**: 3 `ANGRY_VILLAGER` icons + 3 subtle crimson dust sparkles (`0xFF3333`). - **Normal**: 3 `HAPPY_VILLAGER` emerald stars + 3 subtle golden dust sparkles (`0xFFD700`). - **Pacifist**: 3 `HEART` icons + 3 subtle mint dust sparkles (`0x00FF88`).

## [5.0.22+26.3] ### Refactored & Polished - **Minimal Tame Particle Polish (`WolfParticleHandler`)**: Polished first-time taming particle feedback with a clean, subtle Minimal Signature (~5-6 particles) per personality: - **Aggressive**: 3 `ANGRY_VILLAGER` icons + 3 subtle crimson dust sparkles (`0xFF3333`). - **Normal**: 3 `HAPPY_VILLAGER` emerald stars + 3 subtle golden dust sparkles (`0xFFD700`). - **Pacifist**: 3 `HEART` icons + 3 subtle mint dust sparkles (`0x00FF88`).

## [1.0.47+1.21.11] ### Added - 🐾 **Puppy Mischief & Adult Disciplinary Correction AI (`WolfMischiefHelper.java`, `BabyMischiefGoal.java`, `AdultCorrectionGoal.java`)**: - Puppies playfully bound and stalk towards nearby adult wolves (within 8 blocks) or small critters (chickens, rabbits) at $1.2\times$ speed, nipping playful tail/paw bounces. - Adult dogs discipline overly hyperactive misbehaving puppies with a low warning growl (`SoundEvents.WOLF_GROWL`) and a harmless 0-damage disciplinary tap. - Disciplined puppies immediately whimper softly (`SoundEvents.WOLF_WHINE`) and enter an 8-second (160 ticks) calm submissive state before resuming normal play. - Added automated unit test suite `PuppyMischiefTest`.

## [1.0.45+1.21.1] ### Added - 🐺 **Wild Pack Dynamics & Territorial Chorus Howling (`WolfHowlHelper.java`, `GroupHowlGoal.java`, `WildWolfTerritorialGoal.java`)**: - Implemented nocturnal skyward chorus howling where wolves tilt their heads skyward (pitch $-45^\circ$) for 3 seconds (60 ticks), prompting nearby pack members within 24 blocks to join in sequential chorus with natural randomized pitch variations. - Full moon phases significantly increase the frequency of nocturnal pack howling. - Implemented untamed pack territorial dynamics where wild wolves encountering rival wolves within 12 blocks perform threat posturing: Aggressive wolves aggressively challenge and stalk intruders, Pacifist wolves yield and retreat, and Normal wolves hold territorial standoff boundaries. - Added automated unit test suite `WildPackDynamicsTest`.

## [1.0.47+1.20.1] ### Added - 💬 **Configurable Subtitle & Actionbar Feedback Options (`WolfFeedbackHelper.java`, `BetterDogsGameRules.java`)**: - Added namespaced boolean GameRule `bd_actionbar_feedback` (default: `false`) to give players and server hosts full control over companion HUD notifications. - When disabled (`false`), HUD/actionbar subtitle text is kept clean and unobtrusive while preserving all natural in-world particle bursts and authentic sound effects. - Gated text notifications include: Taming Personality Announcements, Adoption Listing/Cancellation/Adoption alerts, Guard Mode Coordinate Status, and Morning Gift Arrivals. - Added automated unit test suite `SubtitleFeedbackTest`.

## [5.0.21+26.3] ### Changed - **Dismount Overlay Message Translation (`en_us.json` & `id_id.json`)**: Updated `text.betterdogs.dog_dismounted` overlay text to `"%s hopped out of the seat."` (Indonesian: `"%s keluar dari tempat duduk."`) for improved clarity when commanding dogs to dismount vehicles and seats.

## [5.0.21+26.3] ### Changed - **Dismount Overlay Message Translation (`en_us.json` & `id_id.json`)**: Updated `text.betterdogs.dog_dismounted` overlay text to `"%s hopped out of the seat."` (Indonesian: `"%s keluar dari tempat duduk."`) for improved clarity when commanding dogs to dismount vehicles and seats.

## [1.0.46+1.21.11] ### Added - 🎾 **Stick Fetching AI & Favorite Treat Zoomies (`WolfFetchHelper.java`, `WolfFetchGoal.java`, `ZoomiesGoal.java`)**: - Implemented stick-throwing fetch mini-game where companion dogs actively track down dropped sticks within 16 blocks at $1.25\times$ speed, pick them up, and return them directly to the owner's feet with happy barks and green sparkles (`ParticleTypes.HAPPY_VILLAGER`). - Implemented favorite treat "zoomies" behavior where dogs fed their individual favorite treat enter a 6-second (120 ticks) burst of playful $1.5\times$ sprint loops around the owner with heart/cloud/sparkle trails. - Added automated unit test suite `FetchAndZoomiesTest`.

## [1.0.44+1.21.1] ### Added - 🐾 **Puppy Mischief & Adult Disciplinary Correction AI (`WolfMischiefHelper.java`, `BabyMischiefGoal.java`, `AdultCorrectionGoal.java`)**: - Puppies playfully bound and stalk towards nearby adult wolves (within 8 blocks) or small critters (chickens, rabbits) at $1.2\times$ speed, nipping playful tail/paw bounces. - Adult dogs discipline overly hyperactive misbehaving puppies with a low warning growl (`SoundEvents.WOLF_GROWL`) and a harmless 0-damage disciplinary tap. - Disciplined puppies immediately whimper softly (`SoundEvents.WOLF_WHINE`) and enter an 8-second (160 ticks) calm submissive state before resuming normal play. - Added automated unit test suite `PuppyMischiefTest`.

## [1.0.46+1.20.1] ### Added - 🐺 **Wild Pack Dynamics & Territorial Chorus Howling (`WolfHowlHelper.java`, `GroupHowlGoal.java`, `WildWolfTerritorialGoal.java`)**: - Implemented nocturnal skyward chorus howling where wolves tilt their heads skyward (pitch $-45^\circ$) for 3 seconds (60 ticks), prompting nearby pack members within 24 blocks to join in sequential chorus with natural randomized pitch variations. - Full moon phases significantly increase the frequency of nocturnal pack howling. - Implemented untamed pack territorial dynamics where wild wolves encountering rival wolves within 12 blocks perform threat posturing: Aggressive wolves aggressively challenge and stalk intruders, Pacifist wolves yield and retreat, and Normal wolves hold territorial standoff boundaries. - Added automated unit test suite `WildPackDynamicsTest`.

## [5.0.20+26.3] ### Fixed - **YACL Config Option Descriptions (`YaclScreenHelper` & Translation Sheets)**: - **Attached Descriptions**: Added missing `.description(OptionDescription.of(...))` builders to every option across all 6 YACL config categories (General, Personalities, Breeding, Territoriality, Gifts, Visual & Performance Options). - **Translation Keys**: Added complete `.description` translation keys to both `en_us.json` and `id_id.json` for all options, ensuring informative hover tooltips are displayed cleanly in the YACL v3 GUI screen.

## [4.24.53+26.2] ### Changed - ✨ **Subtle Particle Feedback for Fetch, Gifts & Treat Feeding (`WolfFetchHelper`, `WolfGiftHelper`, `DogTreatHelper`, `WolfParticleHelper`)**: - Integrated `WolfParticleHelper.spawnSubtleParticles` to scale subtle interaction cues with `bd_particle_density` GameRule (`NONE`: 0, `LOW`: 1, `MEDIUM`/`HIGH`: 2). - Reduced stick/item fetch return and scavenged morning gift delivery particles to 2 subtle emerald glints (`0.15` spread, `0.02` speed). - Softened favorite treat feeding visual feedback from 10 happy villager + 5 heart particles to subtle 2 happy villager + 1 heart particle.

## [1.0.45+1.21.11] ### Added - 🎁 **Morning Gift Bringing AI (`WolfGiftHelper.java`, `WolfGiftGoal.java`)**: - Healthy, full-health companion dogs sleeping near their owner wake up and deliver daily morning gifts upon the owner waking from bed. - Implemented personality-themed foraging loot pools: - **Aggressive**: Bone, Leather, Rotten Flesh, Rabbit Hide, Spider Eye, Arrow. - **Pacifist**: Sweet Berries, Apple, Dandelion, Poppy, Honeycomb, Wheat Seeds. - **Normal**: Stick, Feather, Flint, String, Clay Ball. - **5% Rare Treasure Tier**: Gold Nugget, Emerald, Name Tag, Bone Meal. - Companion approaches owner, drops item drop entity at player's feet, barks happily with green sparkle particles (`ParticleTypes.HAPPY_VILLAGER`), and displays Action Bar notice. - Tracks `BetterDogsLastGiftDay` SaveData & NBT key ensuring exactly 1 gift delivery per in-game day. - Added automated unit test suite `MorningGiftTest`.

## [1.0.43+1.21.1] ### Added - 🎾 **Stick Fetching AI & Favorite Treat Zoomies (`WolfFetchHelper.java`, `WolfFetchGoal.java`, `ZoomiesGoal.java`)**: - Implemented stick-throwing fetch mini-game where companion dogs actively track down dropped sticks within 16 blocks at $1.25\times$ speed, pick them up, and return them directly to the owner's feet with happy barks and green sparkles (`ParticleTypes.HAPPY_VILLAGER`). - Implemented favorite treat "zoomies" behavior where dogs fed their individual favorite treat enter a 6-second (120 ticks) burst of playful $1.5\times$ sprint loops around the owner with heart/cloud/sparkle trails. - Added automated unit test suite `FetchAndZoomiesTest`.

## [1.0.45+1.20.1] ### Added - 🐾 **Puppy Mischief & Adult Disciplinary Correction AI (`WolfMischiefHelper.java`, `BabyMischiefGoal.java`, `AdultCorrectionGoal.java`)**: - Puppies playfully bound and stalk towards nearby adult wolves (within 8 blocks) or small critters (chickens, rabbits) at $1.2\times$ speed, nipping playful tail/paw bounces. - Adult dogs discipline overly hyperactive misbehaving puppies with a low warning growl (`SoundEvents.WOLF_GROWL`) and a harmless 0-damage disciplinary tap. - Disciplined puppies immediately whimper softly (`SoundEvents.WOLF_WHINE`) and enter an 8-second (160 ticks) calm submissive state before resuming normal play. - Added automated unit test suite `PuppyMischiefTest`.

## [5.0.19+26.3] ### Fixed - **Dog Adoption Crash Fix (`WolfInteractionHelper` & `WolfStatManager`)**: Fixed `NullPointerException` crash during adoption by adding personality null guards in `WolfStatManager` and pre-assigning random personalities for uninitialized dogs.

## [4.24.37+26.2] ### Added & Refactored - **Morning Gift Bringing & Feeding Merits System (`WolfGiftGoal`, `WolfGiftHelper`, `WolfPersistentData`)**: - Implemented morning approach AI where healthy, monster-free dogs approach waking owners at $1.25\times$ speed to present scavenged gifts. - Enforced 10-meal feeding merit threshold (`bd_gift_feed_threshold`), consuming 10 merits upon delivery with strict 1-day cooldown tracking. - Implemented personality-themed scavenged gift loot pools (Aggressive: combat drops/bones/eyes; Pacifist: berries/apples/flowers; Normal: utility/sticks/feathers) plus 5% rare treasures (gold nuggets, emeralds, name tags, bone meal). - Emits happy villager celebration particles via `WolfParticleHelper` and ambient audio cues upon gift delivery. - Added automated test suite `MorningGiftTest` asserting threshold gating, merit deduction, daily cooldown math, health eligibility, and null safety.

## [1.0.44+1.21.11] ### Added - 📄 **Paper Adoption Ownership Transfer System**: - Sneak (Shift) + Right-clicking a tamed dog with `Items.PAPER` lists the dog for adoption (`WolfAdoptionHelper`). - Added ambient subtle green/golden sparkles (`ParticleTypes.HAPPY_VILLAGER`) and Action Bar notification indicating the dog is up for adoption. - Another player can adopt the listed dog by Sneak (Shift) + Right-clicking with an empty hand, transferring full ownership with heart explosion FX (`ParticleTypes.HEART`) and chime celebration (`SoundEvents.PLAYER_LEVELUP`). - The original owner can cancel adoption listing at any time by Sneak + Right-clicking again. - Added automated unit test suite `AdoptionSystemTest`.

## [1.0.42+1.21.1] ### Added - 🎁 **Morning Gift Bringing AI (`WolfGiftHelper.java`, `WolfGiftGoal.java`)**: - Healthy, full-health companion dogs sleeping near their owner wake up and deliver daily morning gifts upon the owner waking from bed. - Implemented personality-themed foraging loot pools: - **Aggressive**: Bone, Leather, Rotten Flesh, Rabbit Hide, Spider Eye, Arrow. - **Pacifist**: Sweet Berries, Apple, Dandelion, Poppy, Honeycomb, Wheat Seeds. - **Normal**: Stick, Feather, Flint, String, Clay Ball. - **5% Rare Treasure Tier**: Gold Nugget, Emerald, Name Tag, Bone Meal. - Companion approaches owner, drops item drop entity at player's feet, barks happily with green sparkle particles (`ParticleTypes.HAPPY_VILLAGER`), and displays Action Bar notice. - Tracks `BetterDogsLastGiftDay` NBT key ensuring exactly 1 gift delivery per in-game day. - Added automated unit test suite `MorningGiftTest`.

## [1.0.44+1.20.1] ### Added - 🎾 **Stick Fetching AI & Favorite Treat Zoomies (`WolfFetchHelper.java`, `WolfFetchGoal.java`, `ZoomiesGoal.java`)**: - Implemented stick-throwing fetch mini-game where companion dogs actively track down dropped sticks within 16 blocks at $1.25\times$ speed, pick them up, and return them directly to the owner's feet with happy barks and green sparkles (`ParticleTypes.HAPPY_VILLAGER`). - Implemented favorite treat "zoomies" behavior where dogs fed their individual favorite treat enter a 6-second (120 ticks) burst of playful $1.5\times$ sprint loops around the owner with heart/cloud/sparkle trails. - Added automated unit test suite `FetchAndZoomiesTest`.

## [5.0.18+26.3] ### Fixed & Added - **Litematica Compatibility & Command Item Expansion (`DogCommandManager`)**: - **Litematica Tool Conflict Fix**: Resolved issue where sneaking with a stick to dismount or command mount tame wolves onto seats/vehicles failed when Litematica was installed due to Litematica intercepting `minecraft:stick` right-clicks on client side. - **Data-Driven Command Item Tag (`vanilla-outsider-better-dogs:command_items`)**: Created `#vanilla-outsider-better-dogs:command_items` item tag containing `minecraft:stick`, `minecraft:blaze_rod`, `minecraft:breeze_rod`, and `#c:tools/sticks`. - **Alternative Command Tools**: Players can now use **Blaze Rods** or **Breeze Rods** (or any stick-like tool) to dismount and command mount dogs seamlessly alongside standard sticks. - **Bone Reservation Safeguard**: Explicitly excluded `minecraft:bone` from command items so Bone remains 100% reserved for toggling Guard Mode (`bd_guard_mode`).

## [4.24.36+26.2] - ⚠️ Incompatible with Jade >= 26.2.11+ (Works on Jade < 26.2.10 or without Jade) ### Added & Refactored - **Friendly Fire Dampening & Protection (`WolfFriendlyFireHelper`, `WolfCombatHooks`)**: - Implemented standing owner melee attack cancellation against owned dogs when `bd_friendly_fire_protection` is enabled, eliminating accidental friendly hits during combat. - Allowed crouching owner melee attacks to bypass protection for intentional discipline and bonding demerits. - Preserved owner projectile damage and enforced lethal friendly fire health clamp at 1.0 HP. - Decoupled friendly fire logic from monolithic `WolfCombatHooks` into single-purpose `WolfFriendlyFireHelper`. - Added automated test suite `FriendlyFireTest` asserting standing melee cancellation, crouching bypass, projectile damage, lethal clamping, and null safety.

## [1.0.43+1.21.11] ### Added - 🛡️ **Guard Mode & Sentinel Patrol AI**: - Sneak (Shift) + Right-clicking a tamed dog with an empty hand toggles anchored Guard Mode on/off at its current location (`WolfGuardHelper`). - Added modern Action Bar HUD feedback displaying `"Guard Mode: Active (X, Y, Z)"` or `"Guard Mode: Inactive"` with shield FX (`ParticleTypes.ENCHANT`) and armor chime. - Implemented personality-scaled patrol radii: Aggressive (12-block combat patrol), Pacifist (4-block perimeter + periodic Regeneration I aura), Standard (8-block territory patrol). - Dogs actively patrol between waypoints within their assigned territory and automatically leash/sprint back if pushed or lured outside (`WolfGuardGoal`). - Added automated unit test suite `GuardModePatrolTest`.

## [1.0.41+1.21.1] ### Added - 📄 **Paper Adoption Ownership Transfer System**: - Sneak (Shift) + Right-clicking a tamed dog with `Items.PAPER` lists the dog for adoption (`WolfAdoptionHelper`). - Added ambient subtle green/golden sparkles (`ParticleTypes.HAPPY_VILLAGER`) and Action Bar notification indicating the dog is up for adoption. - Another player can adopt the listed dog by Sneak (Shift) + Right-clicking with an empty hand, transferring full ownership with heart explosion FX (`ParticleTypes.HEART`) and chime celebration (`SoundEvents.PLAYER_LEVELUP`). - The original owner can cancel adoption listing at any time by Sneak + Right-clicking again. - Added automated unit test suite `AdoptionSystemTest`.

## [1.0.43+1.20.1] ### Added - 🎁 **Morning Gift Bringing AI (`WolfGiftHelper.java`, `WolfGiftGoal.java`)**: - Healthy, full-health companion dogs sleeping near their owner wake up and deliver daily morning gifts upon the owner waking from bed. - Implemented personality-themed foraging loot pools: - **Aggressive**: Bone, Leather, Rotten Flesh, Rabbit Hide, Spider Eye, Arrow. - **Pacifist**: Sweet Berries, Apple, Dandelion, Poppy, Honeycomb, Wheat Seeds. - **Normal**: Stick, Feather, Flint, String, Clay Ball. - **5% Rare Treasure Tier**: Gold Nugget, Emerald, Name Tag, Bone Meal. - Companion approaches owner, drops item drop entity at player's feet, barks happily with green sparkle particles (`ParticleTypes.HAPPY_VILLAGER`), and displays Action Bar notice. - Tracks `BetterDogsLastGiftDay` NBT key ensuring exactly 1 gift delivery per in-game day. - Added automated unit test suite `MorningGiftTest`.

## [5.0.17+26.3] ### Added - **Dynamic Climate-Aware Wolf Coat Variants (`WolfVariantHelper`)**: - **Universal Biome Compatibility**: Introduced dynamic climate coat variant resolution (`betterdogs:bd_dynamic_climate_variants`, default `true`). When wolves spawn in modded or un-mapped biomes (Biomes O' Plenty, Terralith, Regions Unexplored, etc.) and Vanilla tag lookup defaults to Pale, Better Dogs evaluates the biome's physical climate properties (temperature, precipitation, downfall) at spawn time. - **Dynamic Climate Assignment**: Automatically assigns Snowy (cold/snowy), Ashen/Red (arid/hot), Rusty (jungle/humid), Black (dark taiga), or Chestnut (cool taiga) coat variants based on real climate data. - **3-Tier Priority Safeguard**: Preserves third-party custom mod variants (`somemod:custom_wolf`) and native Vanilla tag matches 100% untouched, acting as a smart fallback only when default Pale/Woods fallback occurs.

## [4.24.8+26.2] ### Fixed - **Minecart & Vehicle Dismount Interaction Interception (`DogCommandManager.java`, `WolfInteractionHelper.java`)**: - Resolved raycast hitbox interception when clicking directly on Minecarts, Boats, or Seats containing owned dogs with a command item or empty hand. - Implemented anti-collision lateral offset positioning (`0.8` blocks away from vehicle bounding box) on dismount, completely preventing vanilla `AbstractMinecart` collision logic from immediately re-boarding the wolf. - Ensured active vehicle navigation targets and selections are cleanly cleared on dismount, accompanied by cloud particles and dismount audio.

## [1.0.42+1.21.11] ### Added - 🍏 **Golden Apple Inbred Curing Interaction**: - Feeding a Golden Apple or Enchanted Golden Apple to an inbred runt dog completely cleanses inbred status (`WolfCureHelper`). - Restores full adult size scale potential ($\ge 1.0x$ scale) and full personality combat attributes (removing runt penalties). - Enchanted Golden Apples grant temporary Absorption and Regeneration status buffs. - Added rewarding celebration FX: green sparkle burst (`ParticleTypes.HAPPY_VILLAGER`) and uplifting level-up chime (`SoundEvents.PLAYER_LEVELUP`). - Added automated unit test suite `InbredCureTest`.

## [1.0.40+1.21.1] ### Added - 🛡️ **Guard Mode & Sentinel Patrol AI**: - Sneak (Shift) + Right-clicking a tamed dog with an empty hand toggles anchored Guard Mode on/off at its current location (`WolfGuardHelper`). - Added modern Action Bar HUD feedback displaying `"Guard Mode: Active (X, Y, Z)"` or `"Guard Mode: Inactive"` with shield FX (`ParticleTypes.ENCHANT`) and armor chime. - Implemented personality-scaled patrol radii: Aggressive (12-block combat patrol), Pacifist (4-block perimeter + periodic Regeneration I aura), Standard (8-block territory patrol). - Dogs actively patrol between waypoints within their assigned territory and automatically leash/sprint back if pushed or lured outside (`WolfGuardGoal`). - Added automated unit test suite `GuardModePatrolTest`.

## [1.0.42+1.20.1] ### Added - 📄 **Paper Adoption Ownership Transfer System**: - Sneak (Shift) + Right-clicking a tamed dog with `Items.PAPER` lists the dog for adoption (`WolfAdoptionHelper`). - Added ambient subtle green/golden sparkles (`ParticleTypes.HAPPY_VILLAGER`) and Action Bar notification indicating the dog is up for adoption. - Another player can adopt the listed dog by Sneak (Shift) + Right-clicking with an empty hand, transferring full ownership with heart explosion FX (`ParticleTypes.HEART`) and chime celebration (`SoundEvents.PLAYER_LEVELUP`). - The original owner can cancel adoption listing at any time by Sneak + Right-clicking again. - Added automated unit test suite `AdoptionSystemTest`.

## [5.0.16+26.3] ### Fixed - **Automated GameTest Execution & Final Audit Pass**: Purged unused `HashMap` import in `BetterDogsGameTests.java` and executed automated GameTest checks (`./gradlew check`) under Core-auditor directives.

## [4.24.7+26.2] ### Refactored & Polished - **Minimal Tame Particle Polish (`WolfParticleHandler`)**: Polished first-time taming particle feedback with a clean, subtle Minimal Signature (~5-6 particles) per personality: - **Aggressive**: 3 `ANGRY_VILLAGER` icons + 3 subtle crimson dust sparkles (`0xFF3333`). - **Normal**: 3 `HAPPY_VILLAGER` emerald stars + 3 subtle golden dust sparkles (`0xFFD700`). - **Pacifist**: 3 `HEART` icons + 3 subtle mint dust sparkles (`0x00FF88`).

## [1.0.41+1.21.11] ### Added - 🧪 **Inbreeding Lineage Tracking & Runt Stat Penalties**: - Implemented 1-generation immediate family lineage tracking storing parent UUIDs (`parentUUID1`, `parentUUID2`) on all dogs. - Automatically detects parent-child and sibling (full/half) incestuous pairings upon breeding (`WolfInbreedingHelper`). - Marked inbred dogs receive authentic runt debuffs: adult scale capped to 0.70x–0.80x, -25% Max Health, -25% Attack Damage, and -15% Movement Speed. - Added visual smoke tell: dense smoke puff on birth and subtle ambient smoke particles while moving. - Added automated unit test suite `InbreedingLineageTest`.

## [1.0.39+1.21.1] ### Added - 🍏 **Golden Apple Inbred Curing Interaction**: - Feeding a Golden Apple or Enchanted Golden Apple to an inbred runt dog completely cleanses inbred status (`WolfCureHelper`). - Restores full adult size scale potential ($\ge 1.0x$ scale) and full personality combat attributes (removing runt penalties). - Enchanted Golden Apples grant temporary Absorption and Regeneration status buffs. - Added rewarding celebration FX: green sparkle burst (`ParticleTypes.HAPPY_VILLAGER`) and uplifting level-up chime (`SoundEvents.PLAYER_LEVELUP`). - Added automated unit test suite `InbredCureTest`.

## [1.0.41+1.20.1] ### Added - 🛡️ **Guard Mode & Sentinel Patrol AI**: - Sneak (Shift) + Right-clicking a tamed dog with an empty hand toggles anchored Guard Mode on/off at its current location (`WolfGuardHelper`). - Added modern Action Bar HUD feedback displaying `"Guard Mode: Active (X, Y, Z)"` or `"Guard Mode: Inactive"` with shield FX (`ParticleTypes.ENCHANT`) and armor chime. - Implemented personality-scaled patrol radii: Aggressive (12-block combat patrol), Pacifist (4-block perimeter + periodic Regeneration I aura), Standard (8-block territory patrol). - Dogs actively patrol between waypoints within their assigned territory and automatically leash/sprint back if pushed or lured outside (`WolfGuardGoal`). - Added automated unit test suite `GuardModePatrolTest`.

## [5.0.15+26.3] ### Added - **Additional GameTest Expansion**: Added `testWolfFetchGoalTriggering`, `testZoomiesGoalTriggering`, `testStormAnxietySoothedState`, and `testAvoidHazardsGoalGating` to `BetterDogsGameTests.java` for automated headless verification of AI goal event scheduling, storm soothing, and hazard gating.

## [4.24.6+26.2] ### Changed - **Dismount Overlay Message Translation (`en_us.json` & `id_id.json`)**: Updated `text.betterdogs.dog_dismounted` overlay text to `"%s hopped out of the seat."` (Indonesian: `"%s keluar dari tempat duduk."`) for improved clarity when commanding dogs to dismount vehicles and seats.

## [1.0.40+1.21.11] ### Added - 🐕 **Variable Multi-Puppy Litter Sizes**: - Implemented realistic canine litter sizes rolling 1 to 4 puppies (`bd_wolf_litter_max_size`, `WolfLitterHelper`). - Sibling puppies independently roll personality and adult scale genetics from parents, inheriting owner and mother collar color. - Added subtle celebration birth FX with heart particles and gentle high-pitched puppy whimpers (`SoundEvents.WOLF_AMBIENT`). - Added automated unit test suite `VariableLitterTest`.

## [1.0.38+1.21.1] ### Added - 🧪 **Inbreeding Lineage Tracking & Runt Stat Penalties**: - Implemented 1-generation immediate family lineage tracking storing parent UUIDs (`parentUUID1`, `parentUUID2`) on all dogs. - Automatically detects parent-child and sibling (full/half) incestuous pairings upon breeding (`WolfInbreedingHelper`). - Marked inbred dogs receive authentic runt debuffs: adult scale capped to 0.70x–0.80x, -25% Max Health, -25% Attack Damage, and -15% Movement Speed. - Added visual smoke tell: dense smoke puff on birth and subtle ambient smoke particles while moving. - Added automated unit test suite `InbreedingLineageTest`.

## [1.0.40+1.20.1] ### Added - 🍏 **Golden Apple Inbred Curing Interaction**: - Feeding a Golden Apple or Enchanted Golden Apple to an inbred runt dog completely cleanses inbred status (`WolfCureHelper`). - Restores full adult size scale potential ($\ge 1.0x$ scale) and full personality combat attributes (removing runt penalties). - Enchanted Golden Apples grant temporary Absorption and Regeneration status buffs. - Added rewarding celebration FX: green sparkle burst (`ParticleTypes.HAPPY_VILLAGER`) and uplifting level-up chime (`SoundEvents.PLAYER_LEVELUP`). - Added automated unit test suite `InbredCureTest`.

## [5.0.14+26.3] ### Fixed - **Unused Imports Cleanup & 100% Audit Pass**: Purged unused imports in `WolfBreedingMixin` and `WolfGuardGoal` to achieve a 100% clean audit pass under Core-auditor rules.

## [4.24.5+26.2] ### Fixed - **YACL Config Option Descriptions (`YaclScreenHelper` & Translation Sheets)**: - **Attached Descriptions**: Added missing `.description(OptionDescription.of(...))` builders to every option across all 6 YACL config categories (General, Personalities, Breeding, Territoriality, Gifts, Visual & Performance Options). - **Translation Keys**: Added complete `.description` translation keys to both `en_us.json` and `id_id.json` for all options, ensuring informative hover tooltips are displayed cleanly in the YACL v3 GUI screen.

## [1.0.39+1.21.11] ### Added - 📏 **Parental Size Inheritance & Scale Variance**: - Implemented mathematical adult size inheritance from parents with natural ±10% genetic variance (`WolfScaleGeneticsHelper`). - Clamped strictly between `bd_wolf_min_scale_percent` (0.70x) and `bd_wolf_max_scale_percent` (1.45x). - Added natural Gaussian bell-curve generation for freshly spawned wild wolves. - Added automated unit test suite `ScaleGeneticsTest`.

## [1.0.37+1.21.1] ### Added - 🐕 **Variable Multi-Puppy Litter Sizes**: - Implemented realistic canine litter sizes rolling 1 to 4 puppies (`bd_wolf_litter_max_size`, `WolfLitterHelper`). - Sibling puppies independently roll personality and adult scale genetics from parents, inheriting owner and mother collar color. - Added subtle celebration birth FX with heart particles and gentle high-pitched puppy whimpers (`SoundEvents.WOLF_AMBIENT`). - Added automated unit test suite `VariableLitterTest`.

## [1.0.39+1.20.1] ### Added - 🧪 **Inbreeding Lineage Tracking & Runt Stat Penalties**: - Implemented 1-generation immediate family lineage tracking storing parent UUIDs (`parentUUID1`, `parentUUID2`) on all dogs. - Automatically detects parent-child and sibling (full/half) incestuous pairings upon breeding (`WolfInbreedingHelper`). - Marked inbred dogs receive authentic runt debuffs: adult scale capped to 0.70x–0.80x, -25% Max Health, -25% Attack Damage, and -15% Movement Speed. - Added visual smoke tell: dense smoke puff on birth and subtle ambient smoke particles while moving. - Added automated unit test suite `InbreedingLineageTest`.

## [5.0.13+26.3] ### Fixed - **Audit Remediation & Code Quality Cleanup**: Fixed license headers to standard `// Copyright (C) 2026 Dasik (Rifaditya) | GNU GPLv3` across `WolfPersistentData`, `WolfBreedingMixin`, `WolfNemesisTargetGoal`, and `WolfGuardGoal`. Added missing citation comment to `WolfNemesisTargetGoal` and removed unused `ParticleTypes` import in `WolfGuardGoal`.

## [4.24.4+26.2] ### Fixed - **Dog Adoption Crash Fix (`WolfInteractionHelper` & `WolfStatManager`)**: - **Personality Null Guard**: Added null personality safeguards to `WolfStatManager.applyPersonalityStats` (`if (personality == null) personality = WolfPersonality.NORMAL;`), preventing `NullPointerException` crashes when adopting vanilla or unassigned wolves. - **Personality Pre-Assignment**: Automatically initializes a random personality on adoption if the adoptable wolf lacks one prior to applying owner stats. - **Safe Owner UUID Lookup**: Replaced unsafe `getOwnerReference()` with safe `getOwnerUUID()`, preventing null dereference exceptions when former owners are offline or unlinked.

## [1.0.38+1.21.11] ### Added - 🧬 **Genetic Personality Inheritance**: - Implemented weighted parental trait inheritance when breeding tamed wolves (`WolfGeneticsHelper`). - **Same-Trait Parents**: 80% chance to inherit parent personality (`bd_breed_same_chance`), with 10% mutation chance (`bd_breed_same_other_chance`). - **Mixed-Trait Parents**: 40% Parent A (`bd_breed_mixed_dominant_chance`), 40% Parent B (`bd_breed_mixed_recessive_chance`), 20% Normal dilution (`bd_breed_diluted_normal_chance`). - Added automated unit test suite `GeneticsInheritanceTest`.

## [1.0.36+1.21.1] ### Added - 📏 **Parental Size Inheritance & Scale Variance**: - Implemented mathematical adult size inheritance from parents with natural ±10% genetic variance (`WolfScaleGeneticsHelper`). - Clamped strictly between `bd_wolf_min_scale_percent` (0.70x) and `bd_wolf_max_scale_percent` (1.45x). - Added natural Gaussian bell-curve generation for freshly spawned wild wolves. - Added automated unit test suite `ScaleGeneticsTest`.

## [1.0.38+1.20.1] ### Added - 🐕 **Variable Multi-Puppy Litter Sizes**: - Implemented realistic canine litter sizes rolling 1 to 4 puppies (`bd_wolf_litter_max_size`, `WolfLitterHelper`). - Sibling puppies independently roll personality and adult scale genetics from parents, inheriting owner and mother collar color. - Added subtle celebration birth FX with heart particles and gentle high-pitched puppy whimpers (`SoundEvents.WOLF_AMBIENT`). - Added automated unit test suite `VariableLitterTest`.

## [5.0.12+26.3] ### Changed - **AI Goal Tick Throttling & Spatial Search Optimization**: Added entity ID staggered modulo gating to `FleeCreeperGoal`, `WolfNemesisTargetGoal`, and `WolfGuardGoal` to prevent all wolves from running expensive spatial bounding-box searches on the same tick frame.

## [4.24.3+26.2] ### Fixed & Added - **Litematica Compatibility & Command Item Expansion (`DogCommandManager`)**: - **Litematica Tool Conflict Fix**: Resolved issue where sneaking with a stick to dismount or command mount tame wolves onto seats/vehicles failed when Litematica was installed due to Litematica intercepting `minecraft:stick` right-clicks on client side. - **Data-Driven Command Item Tag (`vanilla-outsider-better-dogs:command_items`)**: Created `#vanilla-outsider-better-dogs:command_items` item tag containing `minecraft:stick`, `minecraft:blaze_rod`, `minecraft:breeze_rod`, and `#c:tools/sticks`. - **Alternative Command Tools**: Players can now use **Blaze Rods** or **Breeze Rods** (or any stick-like tool) to dismount and command mount dogs seamlessly alongside standard sticks. - **Bone Reservation Safeguard**: Explicitly excluded `minecraft:bone` from command items so Bone remains 100% reserved for toggling Guard Mode (`bd_guard_mode`).

## [1.0.37+1.21.11] ### Added - 💖 **Personality Dynamic Stat Scaling & Attribute Modifiers**: - Dynamically recalculates max health, attack damage, and base movement attributes when personalities are assigned or loaded (`WolfPersonalityStatHelper`). - **Aggressive Dogs**: Enhanced attack power (`bd_aggro_damage`), speed scaling (`bd_aggro_speed_percent`), and configured health (`bd_aggro_health`). - **Pacifist Dogs**: High-vitality guardians with increased max health (`bd_paci_health`) and gentle damage (`bd_paci_damage`). - Added automated unit test suite `PersonalityStatScalingTest`.

## [1.0.35+1.21.1] ### Added - 🧬 **Genetic Personality Inheritance**: - Implemented weighted parental trait inheritance when breeding tamed wolves (`WolfGeneticsHelper`). - **Same-Trait Parents**: 80% chance to inherit parent personality (`bd_breed_same_chance`), with 10% mutation chance (`bd_breed_same_other_chance`). - **Mixed-Trait Parents**: 40% Parent A (`bd_breed_mixed_dominant_chance`), 40% Parent B (`bd_breed_mixed_recessive_chance`), 20% Normal dilution (`bd_breed_diluted_normal_chance`). - Added automated unit test suite `GeneticsInheritanceTest`.

## [1.0.37+1.20.1] ### Added - 📏 **Parental Size Inheritance & Scale Variance**: - Implemented mathematical adult size inheritance from parents with natural ±10% genetic variance (`WolfScaleGeneticsHelper`). - Clamped strictly between `bd_wolf_min_scale_percent` (0.70x) and `bd_wolf_max_scale_percent` (1.45x). - Added natural Gaussian bell-curve generation for freshly spawned wild wolves. - Added automated unit test suite `ScaleGeneticsTest`.

## [5.0.11+26.3] ### Added - **Automated GameTest Expansion**: Added `testGeneticsScaleClamping`, `testKinshipAndInbreedingRisk`, `testTraitMutationAndReset`, and `testGuardModePosAnchoring` to `BetterDogsGameTests.java` for automated headless verification of genetics scale clamping, kinship risk prediction, dynamic trait mutation/reset, and Guard Mode position anchoring.

## [4.24.2+26.2] ### Added - **Dynamic Climate-Aware Wolf Coat Variants (`WolfVariantHelper`)**: - **Universal Biome Compatibility**: Introduced dynamic climate coat variant resolution (`betterdogs:bd_dynamic_climate_variants`, default `true`). When wolves spawn in modded or un-mapped biomes (Biomes O' Plenty, Terralith, Regions Unexplored, etc.) and Vanilla tag lookup defaults to Pale, Better Dogs evaluates the biome's physical climate properties (temperature, precipitation, downfall) at spawn time. - **Dynamic Climate Assignment**: Automatically assigns Snowy (cold/snowy), Ashen/Red (arid/hot), Rusty (jungle/humid), Black (dark taiga), or Chestnut (cool taiga) coat variants based on real climate data. - **3-Tier Priority Safeguard**: Preserves third-party custom mod variants (`somemod:custom_wolf`) and native Vanilla tag matches 100% untouched, acting as a smart fallback only when default Pale/Woods fallback occurs.

## [1.0.36+1.21.11] ### Added - 🚀 **Fast-Travel Sprint Catchup & Dimension Teleport Sync**: - Implemented dynamic catch-up sprint speed scaling (up to 2.0x base speed) whenever owners travel rapidly on mounts (horses, donkeys, camels), boats, minecarts, elytra, or high-speed sprinting (`bd_fast_travel_catchup`). - Added interdimensional portal teleport sync helper `WolfCatchupHelper.syncOwnerDimensionTeleport` (`bd_sync_owner_teleport`). - Added automated unit test suite `FastTravelCatchupTest`.

## [1.0.34+1.21.1] ### Added - 💖 **Personality Dynamic Stat Scaling & Attribute Modifiers**: - Dynamically recalculates max health, attack damage, and base movement attributes when personalities are assigned or loaded (`WolfPersonalityStatHelper`). - **Aggressive Dogs**: Enhanced attack power (`bd_aggro_damage`), speed scaling (`bd_aggro_speed_percent`), and configured health (`bd_aggro_health`). - **Pacifist Dogs**: High-vitality guardians with increased max health (`bd_paci_health`) and gentle damage (`bd_paci_damage`). - Added automated unit test suite `PersonalityStatScalingTest`.

## [1.0.36+1.20.1] ### Added - 🧬 **Genetic Personality Inheritance**: - Implemented weighted parental trait inheritance when breeding tamed wolves (`WolfGeneticsHelper`). - **Same-Trait Parents**: 80% chance to inherit parent personality (`bd_breed_same_chance`), with 10% mutation chance (`bd_breed_same_other_chance`). - **Mixed-Trait Parents**: 40% Parent A (`bd_breed_mixed_dominant_chance`), 40% Parent B (`bd_breed_mixed_recessive_chance`), 20% Normal dilution (`bd_breed_diluted_normal_chance`). - Added automated unit test suite `GeneticsInheritanceTest`.

## [5.0.10+26.3] ### Added - **Dynamic Trait Modifiers & Stat Reset API Integration**: Integrated `setTrait`, `modifyTrait`, and `resetGenetics` methods from `DasikAnimalGeneticsAPI` in `DasikLibrary` v1.8.8. Delegated `setPersistedHealthBonus`, `setPersistedDamageMod`, and `setPersistedSpeedMod` in `WolfPersistentData.java` directly to `DasikAnimalGeneticsAPI.setTrait`.

## [4.24.1+26.2] ### ⚠️ Incompatibility Warning - **Minecraft 26.2 Target Only**: `4.24.1+26.2` is strictly compiled for Minecraft 26.2. Running on Minecraft 26.3 snapshot instances will crash on startup due to upstream Minecraft 26.3 API refactors (`EntityPredicate.ADVANCEMENT_CODEC` removal and `DynamicGameRuleManager` breaking changes). Upgrade to `5.0.0+26.3` for Minecraft 26.3+. ### Fixed - **Startup Crash / GameRule Registration Idempotency**: - **Dynamic Registry Delegation**: Refactored `BetterDogsGameRules` registration methods (`registerBoolean` and `registerInteger`) to delegate through `DynamicGameRuleManager` from `dasik-library`. - **Duplicate Key Exception Fix**: Resolves `IllegalStateException: Adding duplicate key 'ResourceKey[minecraft:game_rule / betterdogs:bd_creeper_awareness]' to registry` on Fabric 26.2 client/server startup.

## [1.0.35+1.21.11] ### Added - 🛡️ **Friendly Fire Protection & Owner Damage Safeguards**: - Intercepts and completely cancels accidental player weapon sweeps, stray projectiles/arrows, and direct owner melee hits against owned dogs. - Intercepts and cancels friendly infighting between dogs belonging to the same owner. - Fully configurable via the namespaced `bd_friendly_fire` GameRule (defaults to `false` = protected; setting `true` enables vanilla damage). - Added automated unit test suite `FriendlyFireTest`.

## [1.0.33+1.21.1] ### Added - 🚀 **Fast-Travel Sprint Catchup & Dimension Teleport Sync**: - Implemented dynamic catch-up sprint speed scaling (up to 2.0x base speed) whenever owners travel rapidly on mounts (horses, donkeys, camels), boats, minecarts, elytra, or high-speed sprinting (`bd_fast_travel_catchup`). - Added interdimensional portal teleport sync helper `WolfCatchupHelper.syncOwnerDimensionTeleport` (`bd_sync_owner_teleport`). - Added automated unit test suite `FastTravelCatchupTest`.

## [1.0.35+1.20.1] ### Added - 💖 **Personality Dynamic Stat Scaling & Attribute Modifiers**: - Dynamically recalculates max health, attack damage, and base movement attributes when personalities are assigned or loaded (`WolfPersonalityStatHelper`). - **Aggressive Dogs**: Enhanced attack power (`bd_aggro_damage`), speed scaling (`bd_aggro_speed_percent`), and configured health (`bd_aggro_health`). - **Pacifist Dogs**: High-vitality guardians with increased max health (`bd_paci_health`) and gentle damage (`bd_paci_damage`). - Added automated unit test suite `PersonalityStatScalingTest`.

## [5.0.9+26.3] ### Added - **Kinship & Pedigree API Expansion**: Added `isRelated`, `isParentOf`, `areSiblings`, and `predictInbreedingRiskPercent` helper methods to `DasikAnimalGeneticsAPI` in `DasikLibrary` v1.8.7 for family tree tracking and inbreeding risk prediction.

## [4.24.0+26.2] ### ⚠️ Incompatibility & Startup Crash Warning - **Minecraft 26.3 Startup Crash & Dynamic GameRule Crash**: `4.24.0+26.2` crashes on Fabric 26.3 snapshot instances (`NoSuchFieldError: EntityPredicate.ADVANCEMENT_CODEC`) and can crash on MC 26.2 startup if duplicate GameRule keys are registered. Upgrade to `4.24.1+26.2` for Minecraft 26.2 or `5.0.0+26.3` for Minecraft 26.3+. ### Added - **AI Refinement: Creeper Blast Evasion**: - **Swelling Fuse Detection**: Enhanced creeper awareness (`FleeCreeperGoal.java`). When a nearby creeper begins swelling/igniting within 10 blocks, tamed wolves sprint radially away at maximum speed (`1.5x`). - **Smoke Particle Trails**: Emits emergency sprint smoke trails (`ParticleTypes.SMOKE`) at the feet of the fleeing wolf. - **GameRules**: Governed by `betterdogs:bd_creeper_evasion_enabled` (default `true`).

## [1.0.34+1.21.11] ### Added - 😡 **3-Day Nemesis Memory & Pack Vendetta Combat AI**: - Tamed wolves now remember and avenge fallen pack mates or owners killed by hostile mobs. - When a tamed wolf dies in combat, the killer's `EntityType` is broadcast to all pack wolves belonging to the same owner within 64 blocks, persisting for 3 in-game days (72,000 game ticks, controlled by `bd_nemesis_duration_days`). - Added `WolfNemesisTargetGoal` prioritizing the pack's active Nemesis mob type at highest targeting priority. - Added automated unit test suite `NemesisGrudgeTest`.

## [1.0.32+1.21.1] ### Added - 🛡️ **Friendly Fire Protection & Owner Damage Safeguards**: - Intercepts and completely cancels accidental player weapon sweeps, stray projectiles/arrows, and direct owner melee hits against owned dogs. - Intercepts and cancels friendly infighting between dogs belonging to the same owner. - Fully configurable via the namespaced `bd_friendly_fire` GameRule (defaults to `false` = protected; setting `true` enables vanilla damage). - Added automated unit test suite `FriendlyFireTest`.

## [1.0.34+1.20.1] ### Added - 🚀 **Fast-Travel Sprint Catchup & Dimension Teleport Sync**: - Implemented dynamic catch-up sprint speed scaling (up to 2.0x base speed) whenever owners travel rapidly on mounts (horses, donkeys, camels), boats, minecarts, elytra, or high-speed sprinting (`bd_fast_travel_catchup`). - Added interdimensional portal teleport sync helper `WolfCatchupHelper.syncOwnerDimensionTeleport` (`bd_sync_owner_teleport`). - Added automated unit test suite `FastTravelCatchupTest`.

## [5.0.8+26.3] ### Added - **Size-Stats & Scale API Expansion**: Added universal `getScale`, `setScale`, `isRunt`, and `isGiant` helper methods to `DasikAnimalGeneticsAPI` in `DasikLibrary`. Delegated wolf scale querying in `WolfPersistentData.java` directly to `DasikAnimalGeneticsAPI.getScale(wolf)`.

## [4.23.0+26.2] ### Added - **Goat Horn Command System (Stage 5: Seek Horn - Search & Track Target Command)**: - **Seek Goat Horn (Focus Fire & Area Search)**: Blowing the Seek Goat Horn (`seek_goat_horn`) commands active following wolves in range (default: `64` blocks) to focus fire on a targeted entity or enter aggressive area search mode at `1.3x` speed. - **Cone-Inflated Crosshair Raycast (`EntityRaycastHelper`)**: Reliable 32-block cone raycast intersects target entity under player's crosshair. - **Fallback Area Search**: If no entity is highlighted under crosshair, wolves automatically search `bd_horn_command_range` for hostiles targeting the owner or pack. Emits smoke particles if no hostile targets are found.

## [1.0.33+1.21.11] ### Fixed - 🥩 **Full-HP Wolf Breeding & Food Refusal Fix**: - Corrected `DogTreatHelper.shouldRefuseFood` logic so tamed wolves at full health can still be fed meat to enter breeding love mode (`canFallInLove()`) or grow baby puppies (`isBaby()`). - Food refusal now strictly activates when wolves are adult, at full HP, and unable to breed (already in love or on breeding cooldown).

## [1.0.31+1.21.1] ### Added - 😡 **3-Day Nemesis Memory & Pack Vendetta Combat AI**: - Tamed wolves now remember and avenge fallen pack mates or owners killed by hostile mobs. - When a tamed wolf dies in combat, the killer's `EntityType` is broadcast to all pack wolves belonging to the same owner within 64 blocks, persisting for 3 in-game days (72,000 game ticks, controlled by `bd_nemesis_duration_days`). - Added `WolfNemesisTargetGoal` prioritizing the pack's active Nemesis mob type at highest targeting priority. - Added automated unit test suite `NemesisGrudgeTest`.

## [1.0.33+1.20.1] ### Added - 🛡️ **Friendly Fire Protection & Owner Damage Safeguards**: - Intercepts and completely cancels accidental player weapon sweeps, stray projectiles/arrows, and direct owner melee hits against owned dogs. - Intercepts and cancels friendly infighting between dogs belonging to the same owner. - Fully configurable via the namespaced `bd_friendly_fire` GameRule (defaults to `false` = protected; setting `true` enables vanilla damage). - Added automated unit test suite `FriendlyFireTest`.

## [5.0.7+26.3] ### Added - **Universal AnimalGeneticsAPI Integration**: Created `net.dasik.social.api.genetics.AnimalGeneticsAPI` in `DasikLibrary` providing a standardized, multi-animal genetics API facade (`hasGenetics`, `getTrait`, `getHealthBonus`, `getDamageMod`, `getSpeedMod`, `isInbred`, `inherit`, `rollStats`) usable across all animal mods. Integrated API calls into `WolfPersistentData.java` and `WolfBreedingMixin.java`.

## [4.22.0+26.2] ### Added - **Goat Horn Command System (Stage 4: Yearn Horn - Resume Follow Command)**: - **Yearn Goat Horn (Resume Follow / Stand Up)**: Blowing the Yearn Goat Horn (`yearn_goat_horn`) orders all sitting owned wolves in range (default: `64` blocks) to stand up (`setOrderedToSit(false)` & `setSittingManually(false)`) and resume following. - **Dedicated Filter (`isEligibleSittingWolf`)**: Specifically targets owned, non-leashed, non-guarding sitting dogs. - **State Reset**: Clears assemble pathing targets and Tactical Pacifist override timers. Emits joyful musical note and green particles.

## [1.0.32+1.21.11] ### Fixed - 💥 **Startup Crash Fix**: Fixed `InvalidInjectionException: Invalid descriptor on WolfMixin->@Inject::betterdogs$writeNbt` on Minecraft 1.21.11 by migrating entity serialization hooks from legacy `CompoundTag` to native `net.minecraft.world.level.storage.ValueOutput` (`addAdditionalSaveData`) and `ValueInput` (`readAdditionalSaveData`). - Supersedes and replaces broken builds `1.0.28+1.21.11` through `1.0.31+1.21.11`.

## [1.0.30+1.21.1] ### Fixed - 🥩 **Full-HP Wolf Breeding & Food Refusal Fix**: - Corrected `DogTreatHelper.shouldRefuseFood` logic so tamed wolves at full health can still be fed meat to enter breeding love mode (`canFallInLove()`) or grow baby puppies (`isBaby()`). - Food refusal now strictly activates when wolves are adult, at full HP, and unable to breed (already in love or on breeding cooldown).

## [1.0.32+1.20.1] ### Added - 😡 **3-Day Nemesis Memory & Pack Vendetta Combat AI**: - Tamed wolves now remember and avenge fallen pack mates or owners killed by hostile mobs. - When a tamed wolf dies in combat, the killer's `EntityType` is broadcast to all pack wolves belonging to the same owner within 64 blocks, persisting for 3 in-game days (72,000 game ticks, controlled by `bd_nemesis_duration_days`). - Added `WolfNemesisTargetGoal` prioritizing the pack's active Nemesis mob type at highest targeting priority. - Added automated unit test suite `NemesisGrudgeTest`.

## [5.0.6+26.3] ### Refactored - **NBT Data & Codec Serialization Hardening**: Added null-safety fallback guards to `WolfPersistentData.getWolfData(wolf)` returning `DEFAULT` if attachment decoding yields null. Added NaN/Infinity checks and scale clamping (`Math.clamp(scale, 0.5f, 2.0f)`) to prevent rendering and hitbox corruption from legacy or malformed entity NBT tags.

## [4.21.0+26.2] ### Added - **Goat Horn Command System (Stage 3: Sing Horn - Hold Command)**: - **Sing Goat Horn (Hold Command / Sit)**: Blowing the Sing Goat Horn (`sing_goat_horn`) orders all active following wolves in range (default: `64` blocks) to sit down in place (`setOrderedToSit(true)` & `setSittingManually(true)`). - **Preemption Handling**: Blowing Sing Horn clears active assemble pathing (`soundLocationTarget = null`) and active Tactical Pacifist overrides (`passiveOverrideTicks = 0`). - **Combat Disengagement**: Instantly clears attack targets, hostility, and navigation. Emits single-burst musical note particles.

## [1.0.31+1.21.11] [BROKEN / CRASHED ON STARTUP] > **CRITICAL FAILURE**: Crashed on game initialization with `InvalidInjectionException: Invalid descriptor on WolfMixin->@Inject::betterdogs$writeNbt(Lnet/minecraft/class_2487;...)V! Expected (Lnet/minecraft/class_11372;...)V`. Minecraft 1.21.11 changed entity serialization parameters from `CompoundTag` to `ValueOutput` / `ValueInput`. Superseded by `[1.0.32+1.21.11]`. ### Added - 📯 **Acoustic Goat Horn Commands & Pack Horn Overrides**: - Implemented tactical acoustic pack commanding via Goat Horn variants across a 64-block range (`bd_horn_command_range`). - **Ponder Horn**: Emits an Assemble/Rally signal directing following dogs to path to the sounding player's location (`WolfHornGoal`). - **Yearn Horn**: Issues a Stand Up/Resume Follow order commanding sitting dogs to immediately stand and follow. - **Sing Horn**: Issues a Hold/Sit command ordering active dogs to sit and clearing all combat targets. - **Feel Horn**: Emits a 30-second Pacifist/Calm override (`bd_horn_override_duration`) suppressing aggressive hostile target acquisition. - **Seek Horn**: Directs the pack to hunt down and attack the owner's crosshair target or nearest hostile monster. - Added automated unit test suite `GoatHornCommandTest`.

## [1.0.29+1.21.1] ### Added - 📯 **Acoustic Goat Horn Commands & Pack Horn Overrides**: - Implemented tactical acoustic pack commanding via Goat Horn variants across a 64-block range (`bd_horn_command_range`). - **Ponder Horn**: Emits an Assemble/Rally signal directing following dogs to path to the sounding player's location (`WolfHornGoal`). - **Yearn Horn**: Issues a Stand Up/Resume Follow order commanding sitting dogs to immediately stand and follow. - **Sing Horn**: Issues a Hold/Sit command ordering active dogs to sit and clearing all combat targets. - **Feel Horn**: Emits a 30-second Pacifist/Calm override (`bd_horn_override_duration`) suppressing aggressive hostile target acquisition. - **Seek Horn**: Directs the pack to hunt down and attack the owner's crosshair target or nearest hostile monster. - Added automated unit test suite `GoatHornCommandTest`.

## [1.0.31+1.20.1] ### Fixed - 🥩 **Full-HP Wolf Breeding & Food Refusal Fix**: - Corrected `DogTreatHelper.shouldRefuseFood` logic so tamed wolves at full health can still be fed meat to enter breeding love mode (`canFallInLove()`) or grow baby puppies (`isBaby()`). - Food refusal now strictly activates when wolves are adult, at full HP, and unable to breed (already in love or on breeding cooldown).

## [5.0.5+26.3] ### Added - **Automated GameTest Framework Suite & Core Mandate**: Established project-wide `gradle-tester` skill and `Automated GameTest Verification Law` in Core Constitution. Implemented automated GameTest suite in `BetterDogsGameTests.java` covering wolf initialization, Guard Mode anchoring, and state cleanup verification.

## [4.20.0+26.2] ### Added - **Goat Horn Command System (Stage 2: Feel Horn - Tactical Pacifist Override)**: - **Feel Goat Horn (Tactical Pacifist - 30s)**: Blowing the Feel Goat Horn (`feel_goat_horn`) triggers a 30-second (`600` ticks) Tactical Pacifist override on all active following wolves in range (default: `64` blocks). - **Immediate Combat Clear**: Wolves instantly drop active attack targets, clear hostility, stop navigation, and emit single-burst green happy villager particles. - **Preemption Handling**: Blowing Feel Horn cancels any active Ponder assemble pathing, and blowing Ponder Horn immediately cancels Tactical Pacifist override. - **GameRules**: Added `betterdogs:bd_horn_override_duration` (default `600` ticks).

## [1.0.30+1.21.11] [BROKEN / CRASHED ON STARTUP] > **CRITICAL FAILURE**: Crashed on game initialization with `InvalidInjectionException: Invalid descriptor on WolfMixin->@Inject::betterdogs$writeNbt(CompoundTag)`. Superseded by `[1.0.32+1.21.11]`. ### Added - 🖐️ **Shift + Right-Click Petting & Soothe Calming Mechanic**: - Owners can now crouch and right-click their tamed dogs with an empty hand to gently pet them. - Petting calms active anger, emits comforting heart and note particles with whimper/pant vocalizations, and soothes thunderstorm anxiety for 10 minutes (12,000 game ticks). - Added automated unit test suite `PettingSootheTest`.

## [1.0.28+1.21.1] ### Added - 🖐️ **Shift + Right-Click Petting & Soothe Calming Mechanic**: - Owners can now crouch and right-click their tamed dogs with an empty hand to gently pet them. - Petting calms active anger, emits comforting heart and note particles with whimper/pant vocalizations, and soothes thunderstorm anxiety for 10 minutes (12,000 game ticks). - Added automated unit test suite `PettingSootheTest`.

## [1.0.30+1.20.1] ### Added - 📯 **Acoustic Goat Horn Commands & Pack Horn Overrides**: - Implemented tactical acoustic pack commanding via Goat Horn variants across a 64-block range (`bd_horn_command_range`). - **Ponder Horn**: Emits an Assemble/Rally signal directing following dogs to path to the sounding player's location (`WolfHornGoal`). - **Yearn Horn**: Issues a Stand Up/Resume Follow order commanding sitting dogs to immediately stand and follow. - **Sing Horn**: Issues a Hold/Sit command ordering active dogs to sit and clearing all combat targets. - **Feel Horn**: Emits a 30-second Pacifist/Calm override (`bd_horn_override_duration`) suppressing aggressive hostile target acquisition. - **Seek Horn**: Directs the pack to hunt down and attack the owner's crosshair target or nearest hostile monster. - Added automated unit test suite `GoatHornCommandTest`.

## [5.0.4+26.3] ### Refactored - **Memory Leak & Entity Removal Cleanup Hooks**: Implemented `betterdogs$clearTransientState()` and injected `die` and `remove` hooks in `WolfMixin.java`. Nullifies transient `socialTarget` entity references, resets spatial targets (`soundLocationTarget`, `pathfindAvoidPos`), clears Goat Horn override timers (`passiveOverrideTicks`), and cancels running scheduler tasks when a wolf dies or is removed.

## [4.19.0+26.2] ### Added - **Goat Horn Command System (Stage 1: Ponder Horn)**: - **Ponder Goat Horn (Assemble Call)**: Blowing the Ponder Goat Horn (`ponder_goat_horn`) issues an Assemble Call, commanding all active following wolves in range (default: `64` blocks) to pathfind directly to the location where the horn was blown at `1.25x` speed. - **Single-Burst Note Particles**: Wolves emit single-burst musical note particles upon receiving the call without visual noise. - **Strict Follow Filtering**: Sitting, leashed, or guarding dogs remain stationed at their posts and ignore the call. - **GameRules**: Added `betterdogs:bd_horn_command_range` (default `64`) and `betterdogs:bd_horn_pathing_timeout` (default `400` ticks).

## [1.0.29+1.21.11] [BROKEN / CRASHED ON STARTUP] > **CRITICAL FAILURE**: Crashed on game initialization with `InvalidInjectionException: Invalid descriptor on WolfMixin->@Inject::betterdogs$writeNbt(CompoundTag)`. Superseded by `[1.0.32+1.21.11]`. ### Added - ⚡ **Thunderstorm Anxiety & Shelter Seeking AI**: - Tamed dogs exhibit realistic anxiety during thunderstorms, whimpering and actively seeking covered indoor shelter blocks. - Added personality-based storm anxiety scaling (Pacifists experience 3x anxiety, Aggressive dogs remain fearless on guard).

## [1.0.27+1.21.1] ### Added - ⚡ **Thunderstorm Anxiety & Shelter Seeking AI**: - Tamed dogs exhibit realistic anxiety during thunderstorms, whimpering and actively seeking covered indoor shelter blocks. - Added personality-based storm anxiety scaling (Pacifists experience 3x anxiety, Aggressive dogs remain fearless on guard).

## [1.0.29+1.20.1] ### Added - 🖐️ **Shift + Right-Click Petting & Soothe Calming Mechanic**: - Owners can now crouch and right-click their tamed dogs with an empty hand to gently pet them. - Petting calms active anger, emits comforting heart and note particles with whimper/pant vocalizations, and soothes thunderstorm anxiety for 10 minutes (12,000 game ticks). - Added automated unit test suite `PettingSootheTest`.

## [5.0.3+26.3] ### Refactored - **C2ME & Multi-Threading Asynchronous Chunk Safety**: Added strict `level.hasChunkAt(pos)` guards across AI goals (`WolfStormAnxietyGoal`, `EatGroundFoodGoal`) and teleportation helpers (`WolfTeleportHelper`, `WolfCatchUpHelper`) to prevent chunk loading deadlocks and race conditions under multi-threaded chunk generators (C2ME / Noisium).

## [4.18.0+26.2] ### Added - **Fast Travel & Chunk-Unload Catch-Up Teleport Safety**: Added automatic periodic catch-up teleportation for standing following wolves when the owner moves rapidly (via Elytra, horses, or speed buffs) and distance exceeds 40 blocks before entering unloaded chunks. - **Strict Follow Filter**: Only teleports active following wolves (`!unableToMoveToOwner()`), strictly ignoring dogs that are sitting, leashed, or assigned to Guard/Sentry Mode. Controlled via `betterdogs:bd_fast_travel_catchup`.

## [1.0.28+1.21.11] [BROKEN / CRASHED ON STARTUP] > **CRITICAL FAILURE**: Crashed on game initialization with `InvalidInjectionException: Invalid descriptor on WolfMixin->@Inject::betterdogs$writeNbt(CompoundTag)`. Reintroduced legacy `CompoundTag` parameter descriptors into `WolfMixin.java`. Superseded by `[1.0.32+1.21.11]`. ### Added - 🥩 **Food Refusal & Favorite Treats Begging AI**: - Tamed dogs now refuse player-fed food when at full health with a head-tilt animation and whimper response. - Dogs discover a permanent favorite treat affinity upon feeding, granting +100% bonus healing and enhanced begging behavior.

## [1.0.26+1.21.1] ### Added - 🥩 **Food Refusal & Favorite Treats Begging AI**: - Tamed dogs now refuse player-fed food when at full health with a head-tilt animation and whimper response. - Dogs discover a permanent favorite treat affinity upon feeding, granting +100% bonus healing and enhanced begging behavior.

## [1.0.28+1.20.1] ### Added - ⚡ **Thunderstorm Anxiety & Shelter Seeking AI**: - Tamed dogs exhibit realistic anxiety during thunderstorms, whimpering and actively seeking covered indoor shelter blocks. - Added personality-based storm anxiety scaling (Pacifists experience 3x anxiety, Aggressive dogs remain fearless on guard).

## [4.15.16+26.2] ### Added - **Cozy Storm Shelter**: Dogs suffering from storm anxiety now search for covered blocks where they cannot see the sky (in a 12x4x12 area, prioritizing the owner's vicinity). They will navigate to shelter if idle instead of pacing randomly. - **Comfort Soothing**: Players can comfort their anxious dogs during a storm by sneaking and right-clicking them with an empty hand, or by feeding them their Favorite Treat. Petting plays a comforting low-pitched whimper and note/heart particles, soothing their storm anxiety for 10 minutes (12000 ticks) and disabling whining and pacing.

## [1.0.27+1.21.11] ### Added - 🍖 **Autonomous Ground Food Foraging & Healing**: - Injured tamed dogs automatically detect and seek dropped meat items within 10 blocks to heal themselves. - Added food item classification respecting raw and cooked food GameRule toggles.

## [1.0.25+1.21.1] ### Added - 🍖 **Autonomous Ground Food Foraging & Healing**: - Injured tamed dogs automatically detect and seek dropped meat items within 10 blocks to heal themselves. - Added food item classification respecting raw and cooked food GameRule toggles.

## [1.0.27+1.20.1] ### Added - 🥩 **Food Refusal & Favorite Treats Begging AI**: - Tamed dogs now refuse player-fed food when at full health with a head-tilt animation and whimper response. - Dogs discover a permanent favorite treat affinity upon feeding, granting +100% bonus healing and enhanced begging behavior.

## [5.0.2+26.3] ### Refactored - **Mixin Security & Naming Compliance**: Audited all 25 Mixin classes to enforce `@Unique` annotations on all custom fields and helper methods, and ensured strict `betterdogs$` member prefixing across all injection points. - **Architectural Extraction (Goat Horn Handler)**: Extracted 260-line Goat Horn command logic (Ponder, Feel, Sing, Yearn, Seek) out of `InstrumentItemMixin.java` into standalone helper class `WolfHornHelper.java`, keeping `InstrumentItemMixin` clean and minimal ("1 File, 1 Purpose").

## [4.15.15+26.2] ### Added - **Smart Creeper Blast Evasion**: Increased dog detection/avoidance range of active/swelling creepers to `10` blocks, raised walking/sprinting evasion speeds to `1.2`/`1.6`, and added visual smoke trails at their feet when running away. - **GameRule Compliance**: Properly checked the `betterdogs:bd_creeper_awareness` GameRule inside `FleeCreeperGoal` to support in-game toggling.

## [4.24.68+26.1.2] ### Added - 🌐 **Italian (`it_it`) Localization & Player Guide (11-Language Suite Complete)**: - Added complete `assets/vanilla-outsider-better-dogs/lang/it_it.json` matching all 428 translation keys. - Added localized player guide in `Doc/Players/index_it_it.md`.

## [1.0.26+1.21.11] ### Added - 🐺 **Tactical Pack Flanking Encirclement AI**: - Implemented multi-angle pack encirclement AI allowing dogs targeting the same entity to spread out into distinct flanking slots rather than clumping. - Added line-of-sight and clear terrain raycasting for tactical approach maneuvers.

## [1.0.24+1.21.1] ### Added - 🐺 **Tactical Pack Flanking Encirclement AI**: - Implemented multi-angle pack encirclement AI allowing dogs targeting the same entity to spread out into distinct flanking slots rather than clumping. - Added line-of-sight and clear terrain raycasting for tactical approach maneuvers.

## [1.0.26+1.20.1] ### Added - 🍖 **Autonomous Ground Food Foraging & Healing**: - Injured tamed dogs automatically detect and seek dropped meat items within 10 blocks to heal themselves. - Added food item classification respecting raw and cooked food GameRule toggles.

## [5.0.1+26.3] ### Fixed - **MC 26.3 NaturalSpawner Mixin Fix**: Resolved world tick crash (`InvalidInjectionException`) by updating `NaturalSpawnerMixin.mobsAt` descriptor to match MC 26.3's refactored `NaturalSpawner.mobsAt` method signature. - **GameRule Registry Fix**: Fixed game initialization crash (`IllegalStateException: Adding duplicate key`) caused by redundant `betterdogs:bd_creeper_awareness` registration.

## [4.15.14+26.2] ### Added - **Configurable Wolf Size Range**: Added `wolfMinScale` and `wolfMaxScale` global options to config, allowing visual scale limits to be customized. - **Dynamic Size Range GameRules**: Added namespaced GameRules `betterdogs:bd_wolf_min_scale_percent` and `betterdogs:bd_wolf_max_scale_percent` to allow administrators to dynamically clamp scale on the logical server per-world. - **YACL UI Integration**: Integrated sliders for minimum and maximum size configuration in the Breeding & Genetics settings screen, including notice descriptions about per-world isolation. - **API Hardening**: Upgraded dependency constraint to `dasik-library >=1.8.3` to consume the new dynamic genetics limit APIs.

## [4.24.3+26.1.2] ### Fixed & Added - **Litematica Compatibility & Command Item Expansion (`DogCommandManager`)**: - **Litematica Tool Conflict Fix**: Resolved issue where sneaking with a stick to dismount or command mount tame wolves onto seats/vehicles failed when Litematica was installed due to Litematica intercepting `minecraft:stick` right-clicks on client side. - **Data-Driven Command Item Tag (`vanilla-outsider-better-dogs:command_items`)**: Created `#vanilla-outsider-better-dogs:command_items` item tag containing `minecraft:stick`, `minecraft:blaze_rod`, `minecraft:breeze_rod`, and `#c:tools/sticks`. - **Alternative Command Tools**: Players can now use **Blaze Rods** or **Breeze Rods** (or any stick-like tool) to dismount and command mount dogs seamlessly alongside standard sticks. - **Bone Reservation Safeguard**: Explicitly excluded `minecraft:bone` from command items so Bone remains 100% reserved for toggling Guard Mode (`bd_guard_mode`).

## [1.0.25+1.21.11] ### Changed - 🛡️ **Single-Purpose Architecture Alignment**: - Decoupled cliff edge safety and thermal hazard helpers into dedicated single-responsibility classes (`WolfCliffSafetyHelper` and `WolfHazardHelper`).

## [1.0.23+1.21.1] ### Changed - 🛡️ **Single-Purpose Architecture Alignment**: - Decoupled cliff edge safety and thermal hazard helpers into dedicated single-responsibility classes (`WolfCliffSafetyHelper` and `WolfHazardHelper`).

## [1.0.25+1.20.1] ### Added - 🐺 **Tactical Pack Flanking Encirclement AI**: - Implemented multi-angle pack encirclement AI allowing dogs targeting the same entity to spread out into distinct flanking slots rather than clumping. - Added line-of-sight and clear terrain raycasting for tactical approach maneuvers.

## [4.15.13-26.2] ### Added - **YACL Option Descriptions**: Implemented description tooltips for all configuration options. - **Dynamic Warning Notice**: Added a dynamic helper that appends a gold warning notice (`§6Notice:§r...`) to all GameRule-default configuration settings, notifying players that settings for existing worlds must be changed in-game. - **Added Localization Keys**: Registered custom description translations for the 11 configuration-only (non-GameRule) options in the mod's `en_us.json` file.

## [1.0.24+1.21.11] ### Added - 🔥 **Emergency Thermal Safety & Hazard Evasion**: - Implemented automatic evasive backstep when standing within 1 block of Lava, Fire, Magma, or lit Campfires. - Implemented autonomous water-seeking extinguish response when burning. - Added automated test suite `HazardReactionTest`.

## [1.0.22+1.21.1] ### Added - 🔥 **Emergency Thermal Safety & Hazard Evasion**: - Implemented automatic evasive backstep when standing within 1 block of Lava, Fire, Magma, or lit Campfires. - Implemented autonomous water-seeking extinguish response when burning. - Added automated test suite `HazardReactionTest`.

## [1.0.24+1.20.1] ### Changed - 🛡️ **Single-Purpose Architecture Alignment**: - Decoupled cliff edge safety and thermal hazard helpers into dedicated single-responsibility classes (`WolfCliffSafetyHelper` and `WolfHazardHelper`).

## [4.15.12-26.2] ### Fixed - **ModMenu Config Screen Integration**: Corrected the YACL mod ID check in `ModMenuIntegration` from `"yet-another-config-lib"` to `"yet_another_config_lib_v3"`, resolving the issue where the config button would not display or crashed when YACL v3 was installed.

## [4.24.1+26.1.2] ### 🔄 Backport Release - **Full Parity Backport to Minecraft 26.1.2**: Backported all features, AI goals, Goat Horn Command systems, Creeper Evasion, Jade integration, and stability fixes from version `4.24.1+26.2`. - **API Mapping Adjustments**: Adapted Mojang registry and advancement APIs for Minecraft 26.1.2 compatibility (`EntityType`, `advancements.criterion`, `Gui.HeartType`).

## [1.0.23+1.21.11] ### Added - 🔥 **Active Hazard Detour Navigation**: - Implemented `AvoidHazardsGoal` inspecting forward path nodes and intercepting navigation when trajectories lead into Lava, Fire, Magma, or lit Campfires. - Prioritized hazard safety at priority 2 in wolf goal selection. - Added automated test suite `HazardDetourTest`.

## [1.0.21+1.21.1] ### Added - 🔥 **Active Hazard Detour Navigation**: - Implemented `AvoidHazardsGoal` inspecting forward path nodes and intercepting navigation when trajectories lead into Lava, Fire, Magma, or lit Campfires. - Prioritized hazard safety at priority 2 in wolf goal selection. - Added automated test suite `HazardDetourTest`.

## [1.0.23+1.20.1] ### Added - 🔥 **Emergency Thermal Safety & Hazard Evasion**: - Implemented automatic evasive backstep when standing within 1 block of Lava, Fire, Magma, or lit Campfires. - Implemented autonomous water-seeking extinguish response when burning. - Added automated test suite `HazardReactionTest`.

## [4.6.25+R-26.2] ### Summary The **"Stability & Loot API Alignment Release"** promotion. - **Release Promotion**: Promoted the genetics calculation engine integration and dependency constraints updates to a stable production Release. - **Dependency Alignment**: Compiled against `DasikLibrary` `v1.8.1`.

## [3.7.0+A-26.1.2] ### Summary The **"Dynamic Follower Spread Scaling"** update. Scales the follow/spread spacing of wild and tamed wolf packs dynamically based on the number of active followers. - **Dynamic Pack Spread Scaling**: Tamed and wild wolves now space themselves out wider as the pack size $N$ increases. Spacing is calculated mathematically using the square root formula: $f(N) = \text{multiplier} \times \sqrt{N - 1}$. - **Tamed Follow Spacing**: Tamed wolves following a player dynamically increase their follow start and stop thresholds, preventing overcrowding. - **Wild Flock Spacing**: Wild pack members dynamically adjust cohesion and separation radii during flocking, resulting in organic pack formations. - **New Spacing GameRules**: Added 4 new native GameRules to configure the spacing multipliers and limits: - `bd_tamed_pack_spread_multiplier` (Default: 120 = 1.2x) - `bd_tamed_pack_spread_max` (Default: 60 = 6.0 blocks max extra) - `bd_wild_pack_spread_multiplier` (Default: 80 = 0.8x) - `bd_wild_pack_spread_max` (Default: 40 = 4.0 blocks max extra)

## [1.0.3+1.21.11] ### Fixed - 💥 **1.21.11 Launch Crash Resolution (`MixinTransformerError`)**.

## [1.0.5+1.21.1] ### Added - **Proactive `AggressiveTargetGoal` (`NearestAttackableTargetGoal<Monster>`)**.

## [1.0.6+1.20.1] ### Added - **Proactive `AggressiveTargetGoal` (`NearestAttackableTargetGoal<Monster>`)**.

## [5.0.0+26.3] - 2026-07-30 ### Added - **Minecraft 26.3 Upgrade**: - Upgraded mod target to **Minecraft 26.3** (`5.0.0+26.3`). - **Advancement Trigger API Fix**: Fixed `GuardWolfPersonalityTrigger` codec compatibility for MC 26.3 advancement predicate refactors (`EntityPredicate.CODEC`), resolving world loading crash.

## [4.8.11-26.2] - 2026-06-12 ### Changed - **Guard Alarm Point & Freeze**: Pacifist dogs will now stand up, freeze in place, and look directly at the closest detected hostile mob during sentinel alarms.

## [3.10.12-26.1.2] - 2026-06-12 ### Changed - **Guard Alarm Point & Freeze**: Pacifist dogs will now stand up, freeze in place, and look directly at the closest detected hostile mob during sentinel alarms.

## [1.0.1+1.21.11] - 2026-08-13 ### Added - **Personality Follow & Teleport AI System (`PersonalityFollowOwnerGoal`)**.

## [1.0.3+1.21.1] - 2026-08-13 ### Fixed - **Mixin Injection Safety**.

## [1.0.4+1.20.1] - 2026-08-13 ### Added - **Personality Combat AI & Target Selection Rules (`PersonalityTargetGoal`)**.

### Changed - **Tamed Pack Spacing Multiplier**: Increased default `tamedPackSpreadMultiplier` to `280` (2.8x) to mathematically scale follow distances so that standard large packs (approx. 30 wolves) reach the maximum follow range spacing limit.

### Changed - **Guarding Pacifist Particles**: Redesigned the alert particles for guarding Pacifist dogs to spawn a highly noticeable, expanding horizontal circular ring of 12 pure red dust particles (0xFF0000) using trigonometric direction vectors and client-side outward velocity.

### Added - 🔥 **Thermal Hazard Identification Utility**: - Implemented `WolfHazardHelper` providing centralized thermal scanning and classification for Lava, Fire, Soul Fire, Magma Blocks, and lit Campfires (`CampfireBlock.LIT`). - Added fast radius-based proximity checks for hazard avoidance navigation.

### Added - 🔥 **Thermal Hazard Identification Utility**: - Implemented `WolfHazardHelper` providing centralized thermal scanning and classification for Lava, Fire, Soul Fire, Magma Blocks, and lit Campfires (`CampfireBlock.LIT`). - Added fast radius-based proximity checks for hazard avoidance navigation.

### Added - 🔥 **Active Hazard Detour Navigation**: - Implemented `AvoidHazardsGoal` inspecting forward path nodes and intercepting navigation when trajectories lead into Lava, Fire, Magma, or lit Campfires. - Prioritized hazard safety at priority 2 in wolf goal selection.

## [4.15.9-26.2] - 2026-07-05 ### Changed - **Tamed Pack Spacing Limit**: Increased default `tamedPackSpreadMax` to `150` (15.0 blocks) to prevent crowding when running large packs of tamed wolves.

## [3.10.8+A-26.1.2] - 2026-06-12 ### Changed - **Rare Pack-Wide Howling**: Gated howling chance checks to run only once every 100 ticks (5 seconds) and implemented shared pack-wide cooldowns (10 minutes) when one wolf initiates a pack howl.

## [1.0.21+1.21.11] - 2026-08-14 ### Added - 🏔️ **Cliff Edge Fall Safety Navigation**: - Implemented dynamic drop height probing (`WolfSafetyMixin` and `WolfSafetyHelper`) that halts forward navigation, zeroes horizontal momentum, and triggers sneak stance when approaching lethal ledge drops ($>3$ blocks down). - Implemented push collision protection (`WolfPushMixin`) preventing entities and mobs from shoving sitting or standing dogs over cliff edges or into hazards. - Implemented combat ledge retreat: wolves break pursuit if their combat target plunges over a cliff. - Controlled by GameRule `bd_cliff_safety` (default: `true`).

## [1.0.19+1.21.1] - 2026-08-14 ### Added - 🏔️ **Cliff Edge Fall Safety Navigation**: - Implemented dynamic drop height probing (`WolfSafetyMixin` and `WolfSafetyHelper`) that halts forward navigation, zeroes horizontal momentum, and triggers sneak stance when approaching lethal ledge drops ($>3$ blocks down). - Implemented push collision protection (`WolfPushMixin`) preventing entities and mobs from shoving sitting or standing dogs over cliff edges or into hazards. - Implemented combat ledge retreat: wolves break pursuit if their combat target plunges over a cliff. - Controlled by GameRule `bd_cliff_safety` (default: `true`).

## [4.15.8-26.2] ### Changed - **Dynamic Follow Range Scaling**: Scaled tamed wolf `Attributes.FOLLOW_RANGE` dynamically based on personality base stats (Aggressive: 32, Normal: 24, Pacifist: 16) plus a transient follow range spread offset to prevent wolves from dropping target too quickly in combat.

## [3.10.7+A-26.1.2] ### Changed - **Red Alert Dust Particles**: Replaced the default music note particles with an optimized horizontal burst of 6 red dust particles (`DustParticleOptions`), sent in a single network packet to avoid performance overhead while providing a clear threat/warning color.

## [1.0.20+1.21.11] ### Fixed - 💥 **Startup Crash Fix**: Fixed `InvalidInjectionException: Invalid descriptor on WolfMixin->@Inject::betterdogs$writeNbt` on Minecraft 1.21.11 by removing obsolete `addAdditionalSaveData(CompoundTag)` injections superseded by the 1.21.11 serialization system. ## [1.0.19+1.21.11] - [BROKEN / CRASHED ON STARTUP] > **CRITICAL FAILURE**: Crashed on game initialization with `org.spongepowered.asm.mixin.injection.throwables.InvalidInjectionException: Invalid descriptor on WolfMixin->@Inject::betterdogs$writeNbt(CompoundTag)`. Minecraft 1.21.11 changed entity serialization parameters from `CompoundTag` to `ValueOutput` (`class_11372`). Superseded by `[1.0.20+1.21.11]`. ### Changed - 🎨 **Bold Yellow Category Header**: Styled the `BETTER_DOGS` GameRules category name with bold yellow formatting (`ChatFormatting.BOLD, ChatFormatting.YELLOW`) to seamlessly match vanilla category headers in the Edit Game Rules UI screen.

## [1.0.18+1.21.1] ### Changed - 🎨 **Bold Yellow Category Header**: Styled the `BETTER_DOGS` GameRules category name with bold yellow formatting (`ChatFormatting.BOLD, ChatFormatting.YELLOW`) to seamlessly match vanilla category headers in the Edit Game Rules UI screen.

## [4.15.7-26.2] ### Fixed - **Tamed Wander Boundary Pacing**: Replaced the return-path fallback inside `TamedWanderNearOwnerGoal` with a clean null return. Wolves now naturally stand still at their perimeter boundary instead of pacing back and forth.

## [1.0.18+1.21.11] ### Added - 🏷️ **Dedicated 'Better Dogs' GameRules Category**: - Registered custom `BETTER_DOGS` category so all 80+ mod GameRules appear in their own section in the in-game world creation and edit gamerules menu. - Aligned all `en_us.json` GameRule titles and tooltip description keys (`gamerule.bd_*`).

## [3.10.6+A-26.1.2] ### Changed - **Sound Variant Weighted Lottery**: Transitioned the sound variant selection from a strict deterministic max-score model to a UUID-seeded weighted lottery. This ensures every individual dog gets a highly unique, stable, and randomish sound variant that aligns with its personality and genetics.

## [1.0.17+1.21.1] ### Added - 🏷️ **Dedicated 'Better Dogs' GameRules Category**: - Registered custom `BETTER_DOGS` category via `CustomGameRuleCategory` so all 80+ mod GameRules appear in their own section in the in-game world creation and edit gamerules menu. - Aligned all `en_us.json` GameRule titles and tooltip description keys (`gamerule.bd_*`).

## [4.15.6-26.2] ### Fixed - **Sit and Flee Low Health Conflict**: Added checks to prevent low-health fleeing goals from activating when a tamed wolf is sitting.

## [3.10.5+A-26.1.2] ### Added - **Dynamic Sound Variant Mapping**: Implemented a mathematical scoring system that deterministically assigns the wolf's sound variant (Classic, Big, Cute, Puglin, Angry, Grumpy, Sad) based on its rolled genetics, scale, and personality type rather than relying on vanilla's random selection.

## [1.0.17+1.21.11] ### Added - 🤺 **Pacifist Defensive Retaliation AI (`PacifistRevengeGoal`)**: - Pacifist wolves now defensively counter-attack hostiles that deal damage directly to the wolf or its owner (`getLastHurtByMob()`). - Strict non-aggression: Pacifist wolves will not assist offensive owner attacks and will never target friendly puppies or creepers.

## [1.0.16+1.21.1] ### Added - 🤺 **Pacifist Defensive Retaliation AI (`PacifistRevengeGoal`)**: - Pacifist wolves now defensively counter-attack hostiles that deal damage directly to the wolf or its owner (`getLastHurtByMob()`). - Strict non-aggression: Pacifist wolves will not assist offensive owner attacks and will never target friendly puppies or creepers.

## [4.15.5-26.2] ### Changed - **Wide-Arc Encirclement Adjustment**: Increased flanking coordinate side offset to 4.5 blocks and rear wrap to 2.0 blocks. Dampened direct approach speed to 50% during distant approaches.

## [3.10.4+A-26.1.2] ### Changed - **Pacifist Guard warning sound**: Changed the sentinel alarm sound for Pacifist dogs in Guard Mode from a whine to the specific growl sound corresponding to the wolf's sound variant itself (pitch adjusted to 1.0f).

## [1.0.16+1.21.11] ### Fixed - 💥 **Startup Crash Fix**: Fixed `NoClassDefFoundError: net/minecraft/class_1928$class_5198` (`GameRules.Category`) on Minecraft 1.21.11 by configuring native `minecraft_version=1.21.11` dependencies and registering rules with the 1.21.11 `GameRuleCategory` API. ## [1.0.15+1.21.11] - [BROKEN / CRASHED ON STARTUP] > **CRITICAL FAILURE**: Crashed on game initialization with `java.lang.NoClassDefFoundError: net/minecraft/class_1928$class_5198` (`GameRules.Category`). Subproject was compiled against 1.21.1 mappings instead of 1.21.11 where `GameRules.Category` was replaced by `GameRuleCategory`. Superseded by `[1.0.16+1.21.11]`. ### Added - ⚙️ **80+ GameRules Registry Foundation**: - Implemented `BetterDogsGameRules` registering all 80+ namespaced GameRules via Fabric API `GameRuleRegistry.register("bd_*", ...)`. - Added NPE-safe static helper accessors `BetterDogsGameRules.getBoolean()` and `BetterDogsGameRules.getInt()`. - Added automated test suite `BetterDogsGameRulesTest` asserting registry keys and null-safety.

## [1.0.15+1.20.1] ### Changed - **Exact Minecraft Target Constraint**: Updated `fabric.mod.json` `minecraft` dependency bound to target exact version `"minecraft": "1.20.1"`.

check github

check github

## [1.0.14+1.20.1] ### Added - ⚔️ **Combat AI & Target Selection Mixins**: - `OwnerHurtTargetGoalMixin`: Enforces strict Pacifist combat ethics (Pacifist dogs never initiate or assist offensive player attacks; non-aggressive puppies skip offensive targets). - `OwnerHurtByTargetGoalMixin`: Implements the domestic Mercy Rule (adult dogs will not attack pet puppies even if the owner took damage from puppy discipline). - `HurtByTargetGoalMixin`: Silences pack-wide alarm broadcasts during domestic puppy scuffles.

## [1.0.12+1.21.1] ### Added - 🖼️ **Mod Icon Asset**: Deployed official `icon.png` (235 KB) into `assets/vanilla-outsider-better-dogs/` and registered it in `fabric.mod.json`. - 📜 **License Packaging**: Embedded GNU GPLv3 `LICENSE` file into release JAR distribution. - 🎵 **Sound Resources & Audio**: Added `sounds.json` and custom wolf howling audio tracks (`howl1.ogg`, `howl2.ogg`). - 🌐 **Base Localization**: Deployed `lang/en_us.json` resource bundle. - 📦 **Dependency Declaration**: Added `"fabric-api": "*"` explicitly to `fabric.mod.json`.

## [1.0.13+1.21.11] ### Added - ⚔️ **Combat AI & Target Selection Mixins**: - `OwnerHurtTargetGoalMixin`: Enforces strict Pacifist combat ethics (Pacifist dogs never initiate or assist offensive player attacks; non-aggressive puppies skip offensive targets). - `OwnerHurtByTargetGoalMixin`: Implements the domestic Mercy Rule (adult dogs will not attack pet puppies even if the owner took damage from puppy discipline). - `HurtByTargetGoalMixin`: Silences pack-wide alarm broadcasts during domestic puppy scuffles.

## [3.10.2+A-26.1.2] ### Added - **Low Health Fleeing Goal**: Backported `WolfFleeLowHealthGoal` from 26.2 to 26.1.2 to align concept parity. Wolves will now retreat from combat at low health (<30% health) depending on their personality probability. ### Fixed - **Storm Anxiety AI Registration**: Refactored `WolfAIMixin` to register `WolfStormAnxietyGoal` unconditionally to enable dynamic runtime GameRule toggling. - **Storm Anxiety Personality Modifiers**: Updated `WolfStormAnxietyGoal` to query the GameRule state inside the goal methods, and added personality-based trigger modifiers (Pacifist 3x risk, Normal 1x, Aggressive immune).

## [4.15.2-26.2] ### Changed - **Tamed Flanking Coordination**: Direct-charging wolves slow down to 80% speed during target approach, allowing flanking followers at normal speed to successfully encircle the target first.

## [1.0.13+1.20.1] - 2026-08-14 ### Added - 🖼️ **Mod Icon Asset**: Deployed official `icon.png` (235 KB) into `assets/vanilla-outsider-better-dogs/` and registered it in `fabric.mod.json`. - 📜 **License Packaging**: Embedded GNU GPLv3 `LICENSE` file into release JAR distribution. - 🎵 **Sound Resources & Audio**: Added `sounds.json` and custom wolf howling audio tracks (`howl1.ogg`, `howl2.ogg`). - 🌐 **Base Localization**: Deployed `lang/en_us.json` resource bundle.

## [1.0.12+1.21.1] - 2026-08-14 ### Added - 🖼️ **Mod Icon Asset**: Deployed official `icon.png` (235 KB) into `assets/vanilla-outsider-better-dogs/` and registered it in `fabric.mod.json`. - 📜 **License Packaging**: Embedded GNU GPLv3 `LICENSE` file into release JAR distribution. - 🎵 **Sound Resources & Audio**: Added `sounds.json` and custom wolf howling audio tracks (`howl1.ogg`, `howl2.ogg`). - 🌐 **Base Localization**: Deployed `lang/en_us.json` resource bundle. - 📦 **Dependency Declaration**: Added `"fabric-api": "*"` explicitly to `fabric.mod.json`.

## [1.0.12+1.21.11] - 2026-08-14 ### Added - 🖼️ **Mod Icon Asset**: Deployed official `icon.png` (235 KB) into `assets/vanilla-outsider-better-dogs/` and registered it in `fabric.mod.json`. - 📜 **License Packaging**: Embedded GNU GPLv3 `LICENSE` file into release JAR distribution. - 🎵 **Sound Resources & Audio**: Added `sounds.json` and custom wolf howling audio tracks (`howl1.ogg`, `howl2.ogg`). - 🌐 **Base Localization**: Deployed `lang/en_us.json` resource bundle. - 📦 **Dependency Declaration**: Added `"fabric-api": "*"` explicitly to `fabric.mod.json`.

## [4.15.1-26.2] - 2026-06-30 ### Fixed - **Tamed Flanking Navigation**: Overrode the `tick()` method in flanking goals to bypass vanilla pathing overrides and added a 1.35x speed boost to allow flanking dogs to sweep around targets dynamically.

## [3.10.1+A-26.1.2] - 2026-06-11 ### Fixed - **Classloader Mixin Shadow Crash**: Fixed a startup and runtime crash when trying to locate `@Shadow Mob mob` field inside `WalkNodeEvaluatorMixin` by making the mixin class inherit from `NodeEvaluator` directly. ## [3.10.0+A-26.1.2] - 2026-06-11 [DEPRECATED - CRITICAL BUG] > [!WARNING] > This version contains a classloader startup crash (InvalidMixinException) in `WalkNodeEvaluatorMixin` and is deprecated. Use `3.10.1+A-26.1.2` instead. ### Added - **Restored Howling Sounds**: Bundled original vanilla wolf howling sound effects (`Wolf_howl1.ogg` and `Wolf_howl2.ogg`) within the mod and registered the `betterdogs:entity.wolf.howl` sound event. - **AI Integration**: Updated `GroupHowlGoal` to play the authentic wolf howl sound instead of the baby whine fallback. ## [3.9.5+A-26.1.2] - 2026-06-11 [DEPRECATED - CRITICAL BUG] > [!WARNING] > This version contains a classloader startup crash (InvalidMixinException) in `WalkNodeEvaluatorMixin` and is deprecated. Use `3.10.1+A-26.1.2` instead. ### Added - **Alternative Pathfinding on Push**: Added checks to see if another path exists to get to the target area (even if longer) before giving up and halting navigation. ## [3.9.4+A-26.1.2] - 2026-06-11 ### Added - **Ground Food Refusal Trait**: Added a feature where some tamed-from-birth dogs (bred from parents, not wild-tamed) persistently refuse to eat food from the ground. - Adds `bd_enable_refuse_ground_food` GameRule and toggle setting to enable/disable the feature globally. - Adds `bd_refuse_ground_food_chance` GameRule and setting to configure the percentage chance (default: 30%) that a puppy receives the refusal trait at birth. ## [3.9.3+A-26.1.2] - 2026-06-11 ### Added - **Wolf-on-Wolf Collision Push Safety**: Added cooperative collision handling between tamed wolves. - Tamed wolves colliding with a sitting, guarding, or endangered dog (facing a cliff/lava/magma/fire hazard) will immediately halt their navigation path. - A patience timer (`pushWaitTimer` of 60 ticks / 3 seconds) is applied to the pushing dog to prevent continuous pathfinding attempts and jittering. - Player-to-dog pushes are exempted to prevent player blocking. ## [3.9.2+R-26.1.2] - 2026-06-06 ### Summary - **Release Promotion**: Promoted the Select-and-Ride Dog Command System and Cloth Config GUI warning layout fixes to a stable production Release.

## [1.0.13+1.20.1] - 2026-08-14 ### Changed - **Exact Minecraft Target Constraint**: Updated `fabric.mod.json` `minecraft` dependency bound to target exact version `"minecraft": "1.20.1"`. ## [1.0.12+1.20.1] - 2026-08-14 ### Added - 💣 **`FleeCreeperGoal` (100% 26.2 Parity)**: Tamed wolves detect ignited or swelling Creepers within 10 blocks and sprint away at `1.5x` speed with smoke particle trails. - 🩹 **`WolfFleeLowHealthGoal` (100% 26.2 Parity)**: Wolves below 30% health automatically retreat from combat to preserve life. ## [1.0.11+1.20.1] - 2026-08-14 ### Changed - **Wolf Movement & Sprint Speed Boost**: Upgraded `PersonalityFollowOwnerGoal` base follow speed modifier from `1.0` to `1.25` (fast trot), with `1.35x` sprint catch-up multiplier when > 8 blocks away. ## [1.0.10+1.20.1] - 2026-08-14 ### Fixed - **`fabric.mod.json` `${version}` Expansion Fix**: Added `processResources` property expansion block into `build.gradle`. ## [1.0.9+1.20.1] - 2026-08-14 ### Fixed - 💥 **Taming Particle Level Crash Fix (`NoSuchMethodError`)**: Replaced `wolf.level()` with `wolf.getCommandSenderWorld()`. ## [1.0.8+1.20.1] - 2026-08-14 ### Fixed - 💥 **`TamedWanderNearOwnerGoal` Crash Fix (`NoSuchMethodError`)**: Replaced `owner.position()` with primitive getters. ## [1.0.7+1.20.1] - 2026-08-14 ### Fixed - 💥 **Taming Crash Fix (`NoSuchMethodError`)**: Replaced `wolf.level()` with `wolf.getRandom()`. ## [1.0.6+1.20.1] - 2026-08-14 ### Added - **Proactive `AggressiveTargetGoal` (`NearestAttackableTargetGoal<Monster>`)**. ## [1.0.5+1.20.1] - 2026-08-13 ### Fixed - **Entity AI Goal Registration (`Wolf.registerGoals`)**. ## [1.0.4+1.20.1] - 2026-08-13 ### Added - **Personality Combat AI & Target Selection Rules (`PersonalityTargetGoal`)**. ## [1.0.3+1.20.1] - 2026-08-13 ### Added - **Personality Follow & Teleport AI System (`PersonalityFollowOwnerGoal`)**. ## [1.0.2+1.20.1] - 2026-08-11 ### Fixed - **One-Time Tame Notification**. ## [1.0.1+1.20.1] - 2026-08-11 ### Added - **Distinct Tame Particles**.

## [1.0.11+1.21.1] - 2026-08-14 ### Added - 💣 **`FleeCreeperGoal` (100% 26.2 Parity)**: Tamed wolves detect ignited or swelling Creepers within 10 blocks and sprint away at `1.5x` speed with smoke particle trails. - 🩹 **`WolfFleeLowHealthGoal` (100% 26.2 Parity)**: Wolves below 30% health automatically retreat from combat to preserve life. ## [1.0.10+1.21.1] - 2026-08-14 ### Changed - **Wolf Movement & Sprint Speed Boost**: Upgraded `PersonalityFollowOwnerGoal` base follow speed modifier from `1.0` to `1.25` (fast trot), with `1.35x` sprint catch-up multiplier when > 8 blocks away. ## [1.0.9+1.21.1] - 2026-08-14 ### Fixed - **`fabric.mod.json` `${version}` Expansion Fix**: Added `processResources` property expansion block into `build.gradle`. ## [1.0.8+1.21.1] - 2026-08-14 ### Fixed - 💥 **Taming Particle Level Crash Fix (`NoSuchMethodError`)**: Replaced `wolf.level()` with `wolf.getCommandSenderWorld()`. ## [1.0.7+1.21.1] - 2026-08-14 ### Fixed - 💥 **`TamedWanderNearOwnerGoal` Crash Fix (`NoSuchMethodError`)**: Replaced `owner.position()` with primitive getters. ## [1.0.6+1.21.1] - 2026-08-14 ### Fixed - 💥 **Taming Crash Fix (`NoSuchMethodError`)**: Replaced `wolf.level()` with `wolf.getRandom()`. ## [1.0.5+1.21.1] - 2026-08-14 ### Added - **Proactive `AggressiveTargetGoal` (`NearestAttackableTargetGoal<Monster>`)**. ## [1.0.4+1.21.1] - 2026-08-13 ### Fixed - **Entity AI Goal Registration (`Wolf.registerGoals`)**. ## [1.0.3+1.21.1] - 2026-08-13 ### Fixed - **Mixin Injection Safety**. ## [1.0.2+1.21.1] - 2026-08-13 ### Added - **Personality Combat AI & Target Selection (`PersonalityTargetGoal`)**. ## [1.0.1+1.21.1] - 2026-08-13 ### Added - **Personality Follow & Teleport AI System (`PersonalityFollowOwnerGoal`)**. ## [1.0.0+1.21.1] - 2026-08-13 ### Added - Initial subproject setup for Minecraft 1.21.1.

## [1.0.11+1.21.11] - 2026-08-14 ### Added - 💣 **`FleeCreeperGoal` (100% 26.2 Parity)**: Tamed wolves detect ignited or swelling Creepers within 10 blocks and sprint away at `1.5x` speed with smoke particle trails. - 🩹 **`WolfFleeLowHealthGoal` (100% 26.2 Parity)**: Wolves below 30% health automatically retreat from combat to preserve life. ## [1.0.10+1.21.11] - 2026-08-14 ### Changed - **Wolf Movement & Sprint Speed Boost**: Upgraded `PersonalityFollowOwnerGoal` base follow speed modifier from `1.0` to `1.25` (fast trot), with `1.35x` sprint catch-up multiplier when > 8 blocks away. ## [1.0.9+1.21.11] - 2026-08-14 ### Fixed - **`fabric.mod.json` `${version}` Expansion Fix**: Added `processResources` property expansion block into `build.gradle`. ## [1.0.8+1.21.11] - 2026-08-14 ### Fixed - 💥 **Taming Particle Level Crash Fix (`NoSuchMethodError`)**: Replaced `wolf.level()` with `wolf.getCommandSenderWorld()`. ## [1.0.7+1.21.11] - 2026-08-14 ### Fixed - 💥 **`TamedWanderNearOwnerGoal` Crash Fix (`NoSuchMethodError`)**: Replaced `owner.position()` with primitive getters. ## [1.0.6+1.21.11] - 2026-08-14 ### Fixed - 💥 **Taming Crash Fix (`NoSuchMethodError`)**: Replaced `wolf.level()` with `wolf.getRandom()`. ## [1.0.5+1.21.11] - 2026-08-14 ### Added - **Proactive `AggressiveTargetGoal` (`NearestAttackableTargetGoal<Monster>`)**. ## [1.0.4+1.21.11] - 2026-08-13 ### Fixed - **Entity AI Goal Registration (`Wolf.registerGoals`)**. ## [1.0.3+1.21.11] - 2026-08-13 ### Fixed - 💥 **1.21.11 Launch Crash Resolution (`MixinTransformerError`)**. ## [1.0.2+1.21.11] - 2026-08-13 ### Added - **Personality Combat AI & Target Selection (`PersonalityTargetGoal`)**. ## [1.0.1+1.21.11] - 2026-08-13 ### Added - **Personality Follow & Teleport AI System (`PersonalityFollowOwnerGoal`)**. ## [1.0.0+1.21.11] - 2026-08-13 ### Added - Initial subproject setup for Minecraft 1.21.11.

## [1.0.2+1.21.11] - 2026-08-13 ### Added - **Personality Combat AI & Target Selection (`PersonalityTargetGoal`)**: - 💖 **Pacifist**: **Does NOT initiate attacks or assist owner offensive attacks**. ONLY retaliates IF dog or owner is directly struck. Emits silent hurt alarm bark when hostiles are within 12b. - ⚔️ **Aggressive**: Active 20b hostile scan, assists owner attacks (+50% damage boost), 10% flee chance. - 🐕 **Normal**: Vanilla neutral targeting and retaliation. - **Headless Unit Test (`WolfCombatAiTest`)**: Verified combat rules and pacifist defense filters.

## [1.0.2+1.21.1] - 2026-08-13 ### Added - **Personality Combat AI & Target Selection (`PersonalityTargetGoal`)**: - 💖 **Pacifist**: **Does NOT initiate attacks or assist owner offensive attacks**. ONLY retaliates IF dog or owner is directly struck. Emits silent hurt alarm bark when hostiles are within 12b. - ⚔️ **Aggressive**: Active 20b hostile scan, assists owner attacks (+50% damage boost), 10% flee chance. - 🐕 **Normal**: Vanilla neutral targeting and retaliation. - **Headless Unit Test (`WolfCombatAiTest`)**: Verified combat rules and pacifist defense filters.

## [1.0.3+1.20.1] - 2026-08-13 ### Added - **Personality Follow & Teleport AI System (`PersonalityFollowOwnerGoal`)**: - ⚔️ **Aggressive**: Follow start `50.0 blocks`, teleport threshold `32.0 blocks` (Dynamic sim cap), 1.5x catch-up sprint speed. - 💖 **Pacifist**: Follow start `5.0 blocks`, teleport threshold `10.0 blocks` (Sticks tight to owner for protection). - 🐕 **Normal**: Follow start `10.0 blocks`, teleport threshold `20.0 blocks`. - **Tamed Roaming Radius (`TamedWanderNearOwnerGoal`)**: - Restricts tamed wolf wandering near owner based on personality: `14.0 blocks` (Aggressive), `4.0 blocks` (Pacifist), `8.0 blocks` (Normal). - **Headless Unit Test (`WolfRadiusAiTest`)**: Verified AI distance math and threshold calculations.

## [1.0.0+1.21.1] - 2026-08-13 ### Added - Initial subproject setup for Minecraft 1.21.1 (Fabric, Java 21, Mojang Mappings). - Core `WolfPersonality` enum (`NORMAL`, `AGGRESSIVE`, `PACIFIST`), NBT persistent data serialization, 3 distinct tame particles, and actionbar taming feedback.

## [4.15.0-26.2] - 2026-06-30 ### Added - **Tamed Pack Flanking Tactics**: Tamed wolves now treat their owner as the pack leader, enabling cooperative flanking AI during combat (splitting left/right around targets).

## [3.9.0+A-26.1.2] - 2026-06-06 old file public released ### Added - **Select-and-Ride Dog Command System**: Command dogs to sit/ride in vehicles, mounts, and modded chairs using a Stick tool. - **Visual Sitting Pose**: Force visual sitting pose on wolves while riding any vehicle. - **Dismount Controls**: Dismount using Stick (dismount & stand) or Empty-hand Shift+Right-click (dismount & sit). - **Optional Unrestricted Riding GameRule**: Added `betterdogs:allow_unrestricted_dog_riding` to allow dogs to ride any entity (e.g. Ghasts).

# this is a rebuilt for older version might take months to catch up i dont know how to correctly port to old version so i rebuild it ## [1.0.2+1.20.1] - 2026-08-11 ### Fixed - **One-Time Tame Notification**: Moved taming particle & actionbar overlay trigger to `TamableAnimal.tame()` via `TamableAnimalMixin`. This prevents tame particles and actionbar messages from repeatedly popping up when right-clicking already-tamed dogs to sit or stand. ## [1.0.1+1.20.1] - 2026-08-11 ### Added - **Distinct Tame Particles**: Spawns 3 distinct particle bursts when taming a wolf (`ANGRY_VILLAGER`, `HEART`, `HAPPY_VILLAGER`). - **Actionbar Personality Overlay**: Displays real-time hotbar overlay notification (e.g. `Tamed an Aggressive Wolf!`) upon taming. - **`WolfMixin`**: Registered mixin handling wolf persistent data serialization. ## [1.0.0+1.20.1] - 2026-08-11 ### Added - Initial project scaffolding for Minecraft 1.20.1 (Fabric, Java 17, Mojang Mappings). - Core `WolfPersonality` enum (`NORMAL`, `AGGRESSIVE`, `PACIFIST`), NBT persistent data serialization, and UUID deterministic DNA seed calculation.

# Releasing old - might not works ## [3.8.4+A-26.1.2] - 2026-06-06 ### Added - **Unrelated Mate Prioritization**: Added `BreedGoalMixin` to prioritize breeding with unrelated wolves in range. If no unrelated wolves are available, they will fallback to related ones. ## [3.8.3+R-26.1.2] - 2026-06-06 ### Summary The **"Stability & Loot API Alignment Release"** promotion. - **Release Promotion**: Promoted the genetics calculation engine integration and dependency constraints updates to a stable production Release. - **Dependency Alignment**: Compiled against `DasikLibrary` `v1.8.1`. ## [3.8.2+A-26.1.2] - 2026-06-05 ### Summary The **"Library Dependency Realignment"** update. - **Dependency Constraint Update**: Updated `fabric.mod.json` depends block to require `"dasik-library": ">=1.8.0"` (preventing startup crashes with older library versions due to missing genetics API classes). - **Library Realignment**: Re-aligned and compiled against `DasikLibrary` `v1.8.1`. ## [3.8.1+A-26.1.2] - 2026-06-04 ### Summary The **"Genetics Library Migration"** update. Abstracts and migrates all selective breeding, inbreeding, and outcross recovery calculations to `DasikLibrary` `v1.8.0`. - **Genetics Centralization**: Migrated `WolfPersistentData` genetics fields to the new library-provided `dasik-library:genetics` attachment type. - **Thin Mod Architecture**: Delegated breeding calculations, inbreeding checks, and outcross recovery rules to `GeneticsEngine.inheritGenetics`, keeping the mod lightweight and clean.

## [4.14.7-26.2] - 2026-06-28 ### Added - **Hidden Favorite Treats**: Added a "Hidden until discovered" mode to the Jade tooltip for a tamed dog's Favorite Treat.

## [4.14.6-26.2] - 2026-06-28 ### Changed - **Sanitary Compliance**: Migrated all GameRule keys to the `betterdogs` namespace.

## [4.14.5-26.2] - 2026-06-28 ### Added - **Jade Config**: Added built-in configuration toggles to the Jade plugin.

## [4.14.4-26.2] - 2026-06-28 ### Fixed - **Jade Sync**: Fixed client-side desync for the Inbred tag display by implementing a Jade `IServerDataProvider` sync package. ## [4.14.3-26.2] - 2026-06-28 ### Changed - **Refactor**: Extracted combat hooks from `WolfMixin` to `WolfCombatMixin` to stay under the 300 LOC limit. ## [4.14.2-26.2] - 2026-06-28 ### Optimized - **Performance Optimization**: Extracted particle options into static fields and throttled adoptable particle trails and Pacifist buff checks via tick modulo.

## [4.14.1-26.2] - 2026-06-28 ### Fixed - **Jade Registration**: Resolved Jade plugin modid registration crashes.

## [4.13.5-26.2] - 2026-06-28 ### Added - **Dynamic Jade Health UI**: Added a custom heart element to bypass Jade's hardcoded 20-icon render cap, and implemented client synchronization for Max Health attribute modifications. ## [4.13.2-26.2] - 2026-06-28 (Broken - Skip) ### Fixed - **Jade Health Override Priority**: Fixed an issue where the custom Jade health provider was executing before Jade's default provider, causing the accurate dynamic hearts to be immediately overwritten by the default vanilla capped hearts. The custom provider now correctly replaces the default health component. ## [4.13.0-26.2] - 2026-06-28 (Broken - Skip) ### Added - **Jade Mod Integration**: Added official support for the Jade HUD tooltip mod. - Now correctly overrides Jade's default health renderer to display the accurate dynamic health/max health of wolves, accounting for Better Dogs' genetic scaling and personality traits. - Adds a custom tooltip line for tamed dogs showing their hidden "Favorite Treat" if the feature is enabled. - The plugin is built as an isolated, optional dependency; the mod will not crash on clients/servers running without Jade.

## [4.12.1-26.2] - 2026-06-27 ### Fixed - **Localization & GUI Quality Polish**: Cleaned up duplicate blocks and malformed JSON syntax in `id_id.json`. Added missing config keys for Creeper Avoidance and Pack Flanking Tactics in `en_us.json`. - **Tooltip Precision**: Corrected default value descriptions for Aggressive HP (from `20` to `-10`) and Pacifist HP (from `0` to `20`) in both language sheets to match the active code constants.

## [4.12.0-26.2] - 2026-06-27 ### Added - **Favorite Treats Mechanic**: Tamed wolves now have a hidden favorite treat determined dynamically by their UUID. Feeding them their favorite treat fully heals them, grants Regeneration II, and triggers their morning Zoomies. - **Dynamic Config/GameRules**: Toggles for the mechanic are integrated in Cloth Config GUI and registered via the `bd_favorite_treats` gamerule.

## [4.11.0-26.2] - 2026-06-27 ### Added - **Nemesis (Grudge) System**: When a tamed wolf dies to a hostile mob (LivingEntity), all other tamed wolves of the same owner within a 32-block radius form a 'Nemesis' grudge against that mob type. - While holding a grudge, wolves will actively seek out and attack any mob of the nemesis type. - When attacking their nemesis, wolves gain Strength and Speed buffs and emit angry particles. - Grudges last for a configurable duration (default: 3 in-game days). - Can be toggled via GameRule `bd_nemesis_system` (default: true). - Duration is configurable via GameRule `bd_nemesis_duration_days`

## [4.10.0-26.2] - 2026-06-26 ### Added - **True Pack Hunting Tactics (Flanking)**: When a pack of wolves engages a target, only the leader will attack directly. The follower wolves will now perform flanking maneuvers, dynamically pathfinding around the target to strike from the sides or behind. This makes packs significantly deadlier and more visually coordinated without causing server strain. - Can be toggled off via the `bd_pack_flanking_tactics` GameRule (defaults to `true`). ## [4.9.8-26.2] - 2026-06-26 ### Fixed - Fixed an issue where adopted wolves would retain their old pack leader UUID, guard mode status, and old grudges after being claimed by a new owner.

## [4.9.7-26.2] - 2026-06-23 ### Changed - **Merit-Scaled Gifting Chances**: Rebalanced how gift chances are evaluated to create a true daily chance. The dog's chance to give a gift now scales linearly based on its interaction merits, from the base percentage (default 1%) at the minimum threshold, up to a 100% chance when reaching maximum interaction merits (10,000).

## [4.9.6-26.2] - 2026-06-23 ### Changed - **Gifting Threshold Balancing**: Increased the default required interactions for a gift (`bd_gift_feed_threshold`) from `3` to `10`. Increased the maximum hard-limit of accumulated interaction merits from `10` to `10,000`, allowing players who configure high thresholds to actually reach them.

## [4.9.5-26.2] - 2026-06-23 ### Changed - **Gifting Demerits Refinement**: Refined the demerit system. Intentional attacks (shift-attacking) still fully reset the wolf's gifting merits to 0. Accidental attacks (normal hitting) when `bd_demerit_accidental_attacks` is enabled now only reduce the merit count by 1 instead of a full reset.

## [4.9.4-26.2] - 2026-06-23 ### Fixed - **Gifting Demerits on Owner Attacks Fix**: Fixed a bug where any accidental attack on a tamed dog would reset its interaction merits. Players must now be sneaking/crouching while attacking their dog to trigger the demerit/reset logic.

## [4.9.3-26.2] - 2026-06-23 ### Added - **Configurable Interaction Cooldown**: Replaced the hardcoded 5-second cooldown on free player-wolf interactions (like sitting/standing) with a configurable GameRule `bd_gift_interaction_cooldown` (default: 100 ticks / 5 seconds) to prevent exploit spamming.

## [4.9.2-26.2] - 2026-06-23 ### Added - **Gifting Demerits on Owner Attacks**: Attacking your own tamed wolf now immediately resets its interaction/gifting merits to `0`. The wolf will not bring morning gifts again until positive interactions are rebuilt back to the threshold. This demerit applies to all attacks (including sneak-attacks) even if friendly fire protection is enabled and blocks the actual damage.

## [4.9.1-26.2] - 2026-06-23 ### Added - **Expanded Gifting Interaction Gates**: Expanded the wolf gifting gates to track all forms of positive player-wolf interaction instead of just feeding. - Interacting to sit/stand, calming down, toggling guard mode, stick commands, and putting up for adoption now count towards the gift eligibility threshold. - Implemented a 5-second (100 ticks) anti-spam cooldown for free interactions to prevent exploit gating, while feeding actions bypass the cooldown and always count. - Rebranded the GameRule to **Gift Interaction Threshold** (`bd_gift_feed_threshold`) and updated localizations.

## [4.8.13-26.2] - 2026-06-21 ### Added - **Wolf Spawn Multiplier**: Introduced a configuration setting and game rule `bd_wolf_spawn_multiplier_percent` (default: 1.5x) to dynamically adjust wolf spawning weights in biome settings, making them spawn more commonly. ## [4.8.12-26.2] - 2026-06-21 ### Changed - **Tamed Wolf Wander Restriction**: Replaced the owner-unaware vanilla wandering behavior (`WaterAvoidingRandomStrollGoal`) with a personality-based `TamedWanderNearOwnerGoal`. Wolves now stay closer to their owner: Aggressive (max 14 blocks), Normal (max 8 blocks), and Pacifist (max 4 blocks), preventing them from drifting too far away. - **Dynamic Wander Scaling**: Integrated the wander radius with the follower spacing offset. In larger packs, the wander boundaries expand dynamically to prevent clumping and overcrowding. ## [4.8.11-26.2] - 2026-06-12 ### Changed - **Guard Alarm Point & Freeze**: Pacifist dogs will now stand up, freeze in place, and look directly at the closest detected hostile mob during sentinel alarms. ## [4.8.10+A-26.2] - 2026-06-12 ### Changed - **Directional Guard Alarm Particles**: Modified Pacifist watchdog alarm particles to shoot forward in a 60-degree cone aligning with the wolf's looking direction, spawned at head/mouth level.

## [4.8.9+A-26.2] - 2026-06-12 ### Added - **Configurable Guard Particle Density**: Introduced a client/server configuration setting `guardParticleDensity` inside a new "Visual & Performance Options" Cloth Config screen tab to scale or toggle guard alert particles (`high` = 12, `medium` = 6 [default], `low` = 3, `off` = 0). ## [4.8.8+A-26.2] - 2026-06-12 ### Changed - **Guarding Pacifist Particles**: Redesigned the alert particles for guarding Pacifist dogs to spawn a highly noticeable, expanding horizontal circular ring of 12 pure red dust particles (0xFF0000) using trigonometric direction vectors and client-side outward velocity. ## [4.8.7+A-26.2] - 2026-06-12 ### Changed - **Rare Pack-Wide Howling**: Gated howling chance checks to run only once every 100 ticks (5 seconds) and implemented shared pack-wide cooldowns (10 minutes) when one wolf initiates a pack howl. ## [4.8.6+A-26.2] - 2026-06-12 ### Changed - **Red Alert Dust Particles**: Replaced the default music note particles with an optimized horizontal burst of 6 red dust particles (`DustParticleOptions`), sent in a single network packet to avoid performance overhead while providing a clear threat/warning color. ## [4.8.5+A-26.2] - 2026-06-12 ### Changed - **Sound Variant Weighted Lottery**: Transitioned the sound variant selection from a strict deterministic max-score model to a UUID-seeded weighted lottery. This ensures every individual dog gets a highly unique, stable, and randomish sound variant that aligns with its personality and genetics.

## [4.8.5+A-26.2] - 2026-06-12 ### Changed - **Sound Variant Weighted Lottery**: Transitioned the sound variant selection from a strict deterministic max-score model to a UUID-seeded weighted lottery. This ensures every individual dog gets a highly unique, stable, and randomish sound variant that aligns with its personality and genetics.

## [4.8.4+A-26.2] - 2026-06-12 ### Summary The **"Dynamic Sound Variant Mapping"** patch. Implements a mathematical decision-tree/scoring system that resolves the wolf's sound variant dynamically based on genetics, scale, and personality. - **Dynamic Sound Variant Mapping**: Implemented a mathematical scoring system that deterministically assigns the wolf's sound variant (Classic, Big, Cute, Puglin, Angry, Grumpy, Sad) based on its rolled genetics, scale, and personality type rather than relying on vanilla's random selection.

## [4.8.3+A-26.2] - 2026-06-11 ### Summary The **"Pacifist Guard Sentinel Growl Alert"** patch. Changes the sentinel alarm sound for Pacifist dogs in Guard Mode from a whine to the specific growl sound corresponding to the wolf's sound variant itself. - **Pacifist Guard warning sound**: Changed the sentinel alarm sound for Pacifist dogs in Guard Mode from a whine to the specific growl sound corresponding to the wolf's sound variant itself (pitch adjusted to 1.0f).

## [4.8.1+A-26.2] - 2026-06-11 ### Summary The **"Classloader Mixin Shadow Crash Fix"** patch. Resolves a startup crash caused by an invalid `@Shadow` on the inherited `mob` field in `WalkNodeEvaluatorMixin`. - **Classloader Mixin Shadow Crash**: Fixed a startup and runtime crash when trying to locate `@Shadow Mob mob` field inside `WalkNodeEvaluatorMixin` by making the mixin class inherit from `NodeEvaluator` directly. ## [4.8.0+A-26.2] - 2026-06-11 [DEPRECATED - CRITICAL BUG] > [!WARNING] > This version contains a classloader startup crash (InvalidMixinException) in `WalkNodeEvaluatorMixin` and is deprecated. Use `4.8.1+A-26.2` instead. ### Summary The **"Custom Howling Sound Restoration"** minor release. Packages and registers custom howling sound events to play the authentic wolf howling sound clips that were removed from the vanilla game. - **Custom Howling Sound Restoration**: Packaged and restored the deleted vanilla `Wolf_howl1.ogg` and `Wolf_howl2.ogg` sound files into the mod assets. - **Custom Sound Event Registration**: Registered the `betterdogs:entity.wolf.howl` sound event. - **AI Group Howl update**: Updated `GroupHowlGoal` to play the authentic howling sound effects instead of the baby whine fallback. ## [4.7.6+A-26.2] - 2026-06-11 [DEPRECATED - CRITICAL BUG] > [!WARNING] > This version contains a classloader startup crash (InvalidMixinException) in `WalkNodeEvaluatorMixin` and is deprecated. Use `4.8.1+A-26.2` instead. ### Summary The **"Alternative Pathfinding on Push"** update. Adds checks to see if another path exists to get to the target area (even if longer) before giving up and halting navigation. - **Alternative Pathfinding on Push**: Added checks to see if another path exists to get to the target area (even if longer) before giving up and halting navigation. ## [4.7.5+A-26.2] - 2026-06-11 ### Summary The **"Ground Food Refusal Trait"** update. Adds a feature where some tamed-from-birth dogs persistently refuse to eat food from the ground. - **Ground Food Refusal Trait**: Added a feature where some tamed-from-birth dogs (bred from parents, not wild-tamed) persistently refuse to eat food from the ground. - Adds `bd_enable_refuse_ground_food` GameRule and toggle setting to enable/disable the feature globally. - Adds `bd_refuse_ground_food_chance` GameRule and setting to configure the percentage chance (default: 30%) that a puppy receives the refusal trait at birth. ## [4.7.4+A-26.2] - 2026-06-11 ### Summary - **Wolf-on-Wolf Collision Push Safety**: Added cooperative collision handling between tamed wolves. - Tamed wolves colliding with a sitting, guarding, or endangered dog (facing a cliff/lava/magma/fire hazard) will immediately halt their navigation path. - A patience timer (`pushWaitTimer` of 60 ticks / 3 seconds) is applied to the pushing dog to prevent continuous pathfinding attempts and jittering. - Player-to-dog pushes are exempted to prevent player blocking. ## [4.7.3+A-26.2] - 2026-06-11 ### Summary - **Magma Block Avoidance**: Added `Blocks.MAGMA_BLOCK` to the hazard list in `AvoidHazardsGoal`, preventing wolves from walking onto magma blocks. - **Lava Safety Verification**: Confirmed that any level of lava (source or flowing) is avoided. ## [4.7.2+R-26.2] - 2026-06-06 ### Summary - **Release Promotion**: Promoted the Select-and-Ride Dog Command System and Cloth Config GUI warning layout fixes to a stable production Release. ## [4.7.1+A-26.2] - 2026-06-06 ### Summary - **Optional GUI Integration**: Upgraded config screen classloading to resolve via `GuiHelper` in `DasikLibrary` 1.8.2. - **UI Warning Polish**: Removed repetitive hover tooltips from config options and moved them to category headers.

## [4.7.0+A-26.2] - 2026-06-06 ### Summary The **"Select-and-Ride Dog Command System"** update. Adds a Stick-based dog selection, mounting, and dismounting system with custom visual sitting poses. - **Select-and-Ride Dog Command System**: Command dogs to sit/ride in vehicles, mounts, and modded chairs using a Stick tool. - **Visual Sitting Pose**: Force visual sitting pose on wolves while riding any vehicle. - **Dismount Controls**: Dismount using Stick (dismount & stand) or Empty-hand Shift+Right-click (dismount & sit). - **Optional Unrestricted Riding GameRule**: Added `betterdogs:allow_unrestricted_dog_riding` to allow dogs to ride any entity (e.g. Ghasts).

## [4.6.26+A-26.2] - 2026-06-06 ### Added - **Unrelated Mate Prioritization**: Added `BreedGoalMixin` to prioritize breeding with unrelated wolves in range. If no unrelated wolves are available, they will fallback to related ones. ## [4.6.25+R-26.2] - 2026-06-06 ### Summary The **"Stability & Loot API Alignment Release"** promotion. - **Release Promotion**: Promoted the genetics calculation engine integration and dependency constraints updates to a stable production Release. - **Dependency Alignment**: Compiled against `DasikLibrary` `v1.8.1`.

## [4.6.24+A-26.2] - 2026-06-05 ### Summary The **"Library Dependency Realignment"** update. - **Dependency Constraint Update**: Updated `fabric.mod.json` depends block to require `"dasik-library": ">=1.8.0"` (preventing startup crashes with older library versions due to missing genetics API classes). - **Library Realignment**: Re-aligned and compiled against `DasikLibrary` `v1.8.1`. ## [4.6.23+A-26.2] - 2026-06-04 ### Summary The **"Genetics Library Migration"** update. Abstracts and migrates all selective breeding, inbreeding, and outcross recovery calculations to `DasikLibrary` `v1.8.0`. - **Genetics Centralization**: Migrated `WolfPersistentData` genetics fields to the library-provided `dasik-library:genetics` attachment type. - **Thin Mod Architecture**: Delegated breeding calculations, inbreeding checks, and outcross recovery rules to `GeneticsEngine.inheritGenetics`, keeping the mod lightweight and clean. ## [4.6.22+R-26.2] - 2026-06-04 ### Summary - **Release Promotion**: Promoted all recent codebase optimizations and refactoring alignments to a stable production Release. - **Genetics & Breeding Info**: Players can selectively breed dogs over generations to optimize attribute combinations (such as breeding massive high-health Aggressive watchdogs or fast Pacifists), creating unique and specialized companions. - **Naming Polish**: Renamed the debugging GameRule from `betterdogdebugging` to namespaced `vanilla-outsider-better-dogs:bd_debugging` (along with english and indonesian translation key updates). - **API Cleanups**: Replaced legacy `Identifier.parse` calls with the modern `Identifier.fromNamespaceAndPath` API, pre-allocating static fields inside `WolfStatManager` to eliminate dynamic parser allocations. - **Config Sync**: Synchronized the template config JSON with all newly introduced configuration settings.

## [4.6.21+A-26.2] - 2026-06-04 ### Summary - **Refactor**: Cleaned up and modularized player-wolf right-click interactions. Extracted all interaction handlers from `WolfInteractMixin` into a new utility class, `WolfInteractionHelper`, successfully reducing the Mixin code size from 347 lines to 92 lines to comply with a self-imposed 300 LOC limit. ## [4.6.20+A-26.2] - 2026-06-04 ### Summary - **Performance**: Optimized `PersonalityFollowOwnerGoal` by purging dynamic lambda and closure allocations in its tick and offset calculations. Switched from inline functional predicates to standard loops and static predicate fields to eliminate heap garbage. ## [4.6.19+A-26.2] - 2026-06-04 ### Summary - **Performance**: Optimized `EatGroundFoodGoal` by throttling nearby item scanning to a random 10-20 tick cooldown, and replaced Java Stream API/lambdas with a standard loop to eliminate heap allocations.

## [4.6.18+A-26.2] - 2026-06-04 ### Summary - **Performance**: Optimized `AvoidHazardsGoal` by using `BlockPos.MutableBlockPos` instead of allocating new `BlockPos` objects in the hot AI path, eliminating heap allocations.

## [4.6.17+A-26.2] - 2026-05-30 ### Summary - **Bug Fix**: Resolved size scaling override conflict in `WolfSocialMixin` where the genetic scale calculation was replaced by a random value during DNA initialization. - **New Feature**: Added a deterministic random offset of between `-0.10` and `+0.10` based on the wolf's UUID seed to the final genetic scale in `WolfStatManager`.

## [4.6.16+A-26.2] - 2026-05-30 ### Summary - **Bug Fix**: Resolved an issue where toggling the storm anxiety GameRule (`vanilla-outsider-better-dogs:bd_storm_anxiety`) mid-game had no effect on already-spawned wolves. - **Implementation**: Registered `WolfStormAnxietyGoal` unconditionally in `WolfAIMixin` and moved the dynamic GameRule check inside `WolfStormAnxietyGoal`'s `canUse()` and `canContinueToUse()` methods to evaluate it dynamically.

## [4.6.15+R-26.2] - 2026-05-30 ### Summary - **Stable Release**: Promoted the custom advancements/achievements system for Minecraft 26.2 to a stable production Release. - **Bug Fix**: Includes the critical startup crash fix (`InvalidInjectionException` for `killedEntity` in `WolfMixin`) that impacted versions `4.6.11` to `4.6.13`. - **Custom Advancements**: - **A Pack of Personalities**: Tame all three wolf personality types (Normal, Aggressive, and Pacifist). - **On Guard!**: Place a tamed wolf into Guard Mode for the first time. - **A Pack of Guardians**: Place a tamed wolf of each personality type into Guard Mode. - **Looking for a Home**: Put a tamed dog up for adoption by sneak-right-clicking them with a piece of paper. - **On Patrol**: Defeat a monster using an Aggressive dog in Guard Mode within its patrol radius. - **Self-Service**: Tamed dog automatically eats food dropped on the ground by its owner to heal itself. - **Keep it in the family**: Breed closely related dogs to produce an inbred runt. - **Fresh Blood**: Breed an inbred runt with an unrelated dog to recover the lineage. - **A Fresh Start**: Cure an inbred runt using a Golden Apple. - **Litter Size Trackers**: Double Trouble (2 puppies), Triple Threat (3 puppies), Puppy Rain (4 puppies), and the Litter Legend challenge advancement (experiencing all). ## [4.6.14+B-26.2] - 2026-05-30 ### Summary - **Bug Fix**: Resolved a critical startup crash (`InvalidInjectionException` for `killedEntity` in `WolfMixin`) that caused the game to crash. - **Technical Detail**: Replaced the invalid inherited method injection in `WolfMixin` with a new `EntityMixin` targeting the base `Entity` class, dynamically resolving the wolf instance at runtime. ## [4.6.13+R-26.2] - 2026-05-30 [CRASHING - DEPRECATED] ### Summary - **Stable Release**: Promoted the custom advancements/achievements system for Minecraft 26.2 to a stable production Release. - **Custom Advancements**: - **A Pack of Personalities**: Tame all three wolf personality types (Normal, Aggressive, and Pacifist). - **On Guard!**: Place a tamed wolf into Guard Mode for the first time. - **A Pack of Guardians**: Place a tamed wolf of each personality type into Guard Mode. - **Looking for a Home**: Put a tamed dog up for adoption by sneak-right-clicking them with a piece of paper. - **On Patrol**: Defeat a monster using an Aggressive dog in Guard Mode within its patrol radius. - **Self-Service**: Tamed dog automatically eats food dropped on the ground by its owner to heal itself. - **Keep it in the family**: Breed closely related dogs to produce an inbred runt. - **Fresh Blood**: Breed an inbred runt with an unrelated dog to recover the lineage. - **A Fresh Start**: Cure an inbred runt using a Golden Apple. - **Litter Size Trackers**: Double Trouble (2 puppies), Triple Threat (3 puppies), Puppy Rain (4 puppies), and the Litter Legend challenge advancement (experiencing all). ## [4.6.12+A-26.2] - 2026-05-30 [CRASHING - DEPRECATED] ### Summary - **New Feature**: Added custom advancement "Self-Service" (Indonesian: "Makan Mandiri") parented to "Tame an Animal" (`minecraft:husbandry/tame_an_animal`). The advancement is awarded when a player's tamed dog heals itself by automatically eating food dropped on the ground by its owner. It uses Cooked Beef as its icon and a Task frame. ## [4.6.11+A-26.2] - 2026-05-30 [CRASHING - DEPRECATED] ### Summary - **New Feature**: Added custom advancement "On Patrol" (Indonesian: "Patroli Aktif") parented to "On Guard!" (`minecraft:husbandry/on_guard`). The advancement is awarded when a player's guarding Aggressive dog defeats a monster within its patrol radius. It uses an Iron Sword as its icon and a Task frame. ## [4.6.10+A-26.2] - 2026-05-30 ### Summary - **New Feature**: Added custom advancement "Looking for a Home" under the Husbandry tab, parented to the vanilla "Tame an Animal" advancement. The advancement is awarded when a player puts one of their tamed dogs up for adoption (by sneak right-clicking them with a piece of paper). It uses Paper as its icon and a Task frame. ## [4.6.9+A-26.2] - 2026-05-30 ### Summary - **New Feature**: Added custom advancements to track wolf litter sizes when breeding tamed wolves: - **Double Trouble** (2 puppies): Awarded when breeding tamed wolves results in a litter of at least 2 puppies (displays with 2 Wolf Spawn Eggs icon). - **Triple Threat** (3 puppies): Awarded when breeding tamed wolves results in a litter of at least 3 puppies (displays with 3 Wolf Spawn Eggs icon). - **Puppy Rain** (4 puppies): Awarded when breeding tamed wolves results in a maximum litter of 4 puppies (displays with 4 Wolf Spawn Eggs icon). - **Litter Legend** (Experiencing all): A challenge advancement awarded when the player experiences a litter of exactly 2, exactly 3, and exactly 4 puppies (displays with a Golden Carrot icon). ## [4.6.8+A-26.2] - 2026-05-30 ### Summary - **New Feature**: Added custom advancement "A Fresh Start" (`minecraft:husbandry/cure_runt`) parented to "Keep it in the family" (`minecraft:husbandry/inbred_runt`). Awarded when the player cures an inbred runt using a Golden Apple, displaying with a Golden Apple icon and a Goal frame. - **New Feature**: Added subtle rotten flesh particle emitter for tamed runt (inbred) wolves, so players can visually identify them. This effect is optional and can be enabled/disabled via the custom GameRule `vanilla-outsider-better-dogs:bd_show_runt_particles` or debug mode `betterdogdebugging`. - **Configuration**: Changed the default value of the `bd_enable_inbred_curing` GameRule and the config default to `true`. ## [4.6.7+A-26.2] - 2026-05-30 ### Summary - **New Feature**: Added custom advancement "Fresh Blood" parented to "Keep it in the family" (`minecraft:husbandry/inbred_runt`). The advancement is awarded when a player breeds an inbred runt parent with an unrelated wolf, successfully recovering the lineage. It uses Raw Beef as its icon and a Task frame. ## [4.6.6+A-26.2] - 2026-05-30 ### Summary - **New Feature**: Added custom advancement "Keep it in the family" parented to "The Parrots and the Bats" (`minecraft:husbandry/breed_an_animal`). The advancement is awarded when a player breeds two closely related wolves and produces an inbred runt. It uses Rotten Flesh as its icon and a Task frame. ## [4.6.5+A-26.2] - 2026-05-30 ### Summary - **New Feature**: Added custom advancement "On Guard!" parented to "Tame an Animal". The advancement is awarded when a player places a tamed wolf into Guard Mode for the first time. It uses a Bone as its icon and uses a Task frame. ## [4.6.4+A-26.2] - 2026-05-30 ### Summary - **New Feature**: Added custom advancement "A Pack of Guardians" parented to "A Pack of Personalities". The advancement is awarded when a player places a tamed wolf of each personality type (Normal, Aggressive, and Pacifist) into Guard Mode (by sneak right-clicking with a bone). It uses a Bone as its icon and uses a Goal frame.

## [4.6.3+A-26.2] - 2026-05-30 ### Summary - **Visual Polish**: Changed the custom advancement "A Pack of Personalities" display frame shape from Challenge to Goal. ## [4.6.2+A-26.2] - 2026-05-30 ### Summary - **Visual Polish**: Changed the custom advancement "A Pack of Personalities" icon from a Wolf Spawn Egg to a Bone, and its border shape to a Challenge frame.

## [4.6.1+A-26.2] - 2026-05-30 Ea on kofi ### Summary - **Bug Fix**: Renamed the custom taming advancement and item tag data folders to singular (`advancement` and `tags/item`) to align with Minecraft 26.2+ data pack directory naming conventions. This fixes the custom advancement and food items tags not loading in-game. ## [4.6.0+A-26.2] - 2026-05-30 ### Summary - **New Feature Planning**: Initializing version 4.6.0 for a new feature implementation. Corrected all mixin file header comments and dynamic mod version logging statements.

## [4.5.18+A-26.2] - 2026-05-30 theres too many small stuff to be publish once a day so i will jump to this ### Summary - **Standard Alignment**: Added a custom advancement "A Pack of Personalities" under the Husbandry tab, parented by the vanilla "Tame an Animal" advancement. The advancement triggers when a player tames a wolf of each personality type: Normal, Aggressive, and Pacifist. Uses bone its visual icon. ## [4.5.17+R-26.2] - 2026-05-29 ### Summary - **Stable Release**: Promoted the migration of the wolf/dog scaling system to the native Minecraft `Attributes.SCALE` attribute to a stable production Release. ## [4.5.16+A-26.2] - 2026-05-29 ### Summary - **Standard Alignment**: Migrated the custom wolf/dog scaling system to the native Minecraft `Attributes.SCALE` attribute introduced in 1.20.5+ / 26.2+. This resolves the client-side visual scaling sync issues and enables native physical size scaling (hitboxes, eye height, step height, passenger offsets, and interaction range) out of the box. Deleted redundant custom client rendering mixins (`WolfRendererMixin`, `WolfRenderStateMixin`, and `WolfRenderStateExtensions`). ## [4.5.15+R-26.2] - 2026-05-29 ### Summary - **Stable Release**: Promoted all recent codebase sanitary refactoring, optimized Pacifist sentinel scans, transient damage cooldown serialization, and cooperative follower cache spacing offsets to a stable production Release. ## [4.5.14+A-26.2] - 2026-05-29 ### Summary - **Standard Alignment**: Resolved code quality and modularity violations from the sanitary audit. Cleaned up unused imports in `WolfMixin` and `WolfGuardGoal`. Modularized `WolfMixin` by extracting complex tick-handler calculations (colored particle emitting, watchdog grace buffs, adoptable particles, and passive healing calculations) into a new dedicated helper class `WolfTickHelper`, bringing `WolfMixin` well under the 300 LOC limit (down to 276 LOC). Formatted single-line conditional blocks with brackets in `WolfMixin` and `PersonalityFollowOwnerGoal` to satisfy style guidelines. ## [4.5.13+A-26.2] - 2026-05-29 ### Summary - **Standard Alignment**: Optimized the performance of Pacifist sentinel watchdogs in `WolfGuardGoal`. Refactored the monster scan filter lambda to check vertical distance first (`dy <= 4.0`). For monsters within 4 blocks vertically, the goal immediately counts them and skips the expensive `hasLineOfSight` raycast calculation. This bypasses raycasting for over 90% of scanned mobs, preserving server TPS. ## [4.5.12+A-26.2] - 2026-05-29 ### Summary - **Standard Alignment**: Optimized allocation performance and fixed a passive healing freeze bug in `WolfMixin`. Replaced the persistent `lastDamageTime` updates in the 19-field `WolfPersistentData` attachment with a transient, `@Unique` JVM-level field in the mixin. This prevents expensive record re-creations during combat and tick updates. To preserve state persistence across reloads/restarts, the remaining combat cooldown ticks are dynamically serialized to and from the attachment record during entity save/load operations (`addAdditionalSaveData`/`readAdditionalSaveData`). ## [4.5.11+A-26.2] - 2026-05-29 ### Summary - **Standard Alignment**: Implemented a cooperative cache and dynamic scan radius for follow goal spacing offsets in `PersonalityFollowOwnerGoal`. Wolves now share active follower counts through a static registry `FollowerSpacingCache` mapped to their owner's UUID, reducing scans to a single request per interval for the entire pack. Additionally, the scan radius scales dynamically based on the last known follower count ($\min(32.0 + N \times 0.5, 64.0)$) to ensure outer dogs are counted in larger packs without bloated queries for smaller packs. ## [4.5.10+A-26.2] - 2026-05-29 ### Summary - **Standard Alignment**: Optimized the performance of tamed wolves by throttling the active follower spacing search in `PersonalityFollowOwnerGoal`. Instead of scanning a 32-block bounding box for all other tamed followers on every tick when the goal is inactive/active, the query runs once every 20-40 ticks (1-2 seconds) using a staggered, entity-randomized throttle timer. This prevents severe server TPS degradation when players have large packs of wolves. ## [4.5.9+A-26.2] - 2026-05-29 ### Summary - **Standard Alignment**: Optimized the performance of wild wolf pack leader interactions by throttling the 96-block rival pack search in `WildWolfTerritorialGoal`. Instead of scanning for rival leaders every tick when none are nearby, the search is restricted to run once every 40-80 ticks (2-4 seconds), protecting server TPS when multiple packs are loaded. ## [4.5.8+A-26.2] - 2026-05-29 ### Summary - **Standard Alignment**: Limited the range and line-of-sight conditions for guarding wolves. Normal/Aggressive guarding wolves now strictly require line-of-sight to target hostile mobs, preventing them from targeting cave monsters. Pacifist sentinels use a hybrid model: detecting mobs up to 16 blocks vertically with line-of-sight, but only up to 4 blocks vertically without line-of-sight (hearing through solid walls). Also adjusted pacing look targets to eye level (+1.0 block). ## [4.5.7+A-26.2] - 2026-05-29 ### Summary - **Standard Alignment**: Implemented a breeding-based genetic outcrossing recovery system. Breeding an inbred runt wolf with a healthy, unrelated wolf will now produce healthy offspring that inherit the parent's reconstructed, unpenalized baseline stats instead of the parent's stunted/penalized values. The active Golden Apple cure remains available but is off by default. ## [4.5.6+A-26.2] - 2026-05-29 ### Summary - **Standard Alignment**: Added a genetic recovery system (off by default) to cure inbred runt wolves. Feeding a tamed, inbred wolf a Golden Apple will clear the inbred status, reverse the inbreeding modifiers to normal levels, and dynamically update the wolf's scale and attributes. Exposes the curing feature under a configurable GameRule `bd_enable_inbred_curing` and Cloth Config GUI. ## [4.5.5+A-26.2] - 2026-05-28 ### Summary - **Standard Alignment**: Fixed Pacifist watchdog grace buff area validation and config integration. Moved grace buff application from goal ticking to entity ticking so it persists during active combat. Exposed `pacifistGuardBuffs` in configuration files and the Cloth Config GUI screen. ## [4.5.4+A-26.2] - 2026-05-28 ### Summary - **Standard Alignment**: Expanded GameRule screen tooltips with detailed explanations of behavior and default values for all configuration parameters, complying with localization guidelines.

## [4.5.3+A-26.2] - 2026-05-28 ea on kofi ### Summary - **Standard Alignment**: Wild wolves now roll and apply their personality-based stats (Max Health, Attack Damage, Movement Speed, and calculated Scale) immediately when they spawn, eliminating visual scale jumps and sudden attribute shifts during taming. Tamed wolves are now also correctly full-healed upon taming.

## [4.5.2+A-26.2] - 2026-05-28 ea on kofi ### Summary - **Standard Alignment**: Rebranded "Taming Chance" gamerules, config settings, and translations to "Spawn Chance" to better match the mechanic where wolves roll their personality when they spawn as wild wolves, not when they are tamed.

## [4.5.1+A-26.2] - 2026-05-28 ea on kofi ### Summary - **Breeding Mixin Performance Optimization**: Optimized the breeding method by caching the data record lookups for the parents (reducing attachment lookups by over 70%) and refactoring UUID comparisons to use plain null-gated checks, eliminating short-lived object allocations.

## [4.5.0+A-26.2] - 2026-05-28 Ea on kofi ### Summary The **"Wolf Stat Inheritance & Inbreeding Prevention"** minor release. - **Genetic Stat Inheritance**: Bred tamed wolves now inherit their Max Health, Attack Damage, and Movement Speed based on their parents' genes (calculated as the average of the parents' stats plus a minor triangular mutation roll). - **Inbreeding Prevention & Penalties**: Breeding related wolves (siblings or parent-child pairings) triggers a severe genetic penalty, rendering the baby wolf tiny (runt scale), weak, slow, and fragile. - **Kinship NBT Tracking**: Added tracking for `parent1Uuid` and `parent2Uuid` and an `inbred` status flag.

## [4.4.0+R-26.2] - 2026-05-28 Ea on Kofi ### Summary The production **Release** version of the **"Health-Based Dog Scaling"** features. - **Dynamic Size Scaling**: Tamed wolf scales are now dynamically calculated and applied based on their rolled max health bonus. - Formula: `scale = 1.0 + (healthBonus * 0.012)` - Re-scales range from a tiny **0.808x** (worst-case Aggressive) to a massive **1.312x** (best-case Pacifist) size. - **Dynamic Updates**: Recalculates and adjusts the scale automatically if a wolf is tamed, loaded, or if its personality is cycled via command/debug stick. - **Stable Release**: Promoted the health-based dynamic size scaling mechanics to a stable production Release.

## [4.3.1+R-26.2] - 2026-05-28 Ea on kofi ### Summary The production **Release** version of the **"Personality-Based Range Stats"** features. - **Range-Based Stats**: Wolf stats (Max Health, Attack Damage, and Movement Speed) are now determined by rolling within personality-defined ranges using a symmetric triangular distribution. - Worst-case rolls are significantly lowered to allow for weak or "handicapped" wolves. - **UUID Seeding**: Seeding utilizes the wolf's unique UUID, ensuring that rolled stats are deterministic, persistent, and do not change across reloads. - **Backward Compatibility**: Existing tamed wolves automatically roll their stats once upon load if they have not been rolled yet. - **Stable Release**: Promoted the personality range stats rolling and deterministic UUID seeding to a stable production Release.

## [4.3.0+R-26.2] - 2026-05-28 ea on kofi ### Summary The production **Release** version of the **"Paper Ownership Transfer (Adoption)"** features. - **Paper Adoption Mechanics**: Owners can shift+right-click their tamed wolves with a sheet of Paper (`Items.PAPER`) to toggle them into a pending adoption state. - Commands the wolf to sit, stops navigation, clears target/anger, and spawns beautiful custom Rose Pink `trail` particles (`0xFF99BB`) floating towards a target offset. - Another player can right-click the adoptable wolf with an empty hand to adopt it, immediately shifting ownership. - The adoption is cancelled if the owner interacts normally with the wolf or if the wolf takes damage.

## [4.2.2+R-26.2] - 2026-05-28 ea on kofi ### Summary The production **Release** version of the **"Calm Down Interaction & Named Guard Mode Overlay"** features. - **Stable Release**: Promoted the Calm Down empty-hand Shift-Right Click interaction and the Named Guard Mode activation/deactivation overlays to a stable production Release.

# [4.2.1+A-26.2] ### Summary The **"Named Guard Mode Overlay"** patch. - **Named Guard Mode overlay**: Modified the Guard Mode activation and deactivation messages to include the name of the wolf (e.g., "Guard Mode Activated for Buddy at X, Y, Z").

## [4.2.0+A-26.2] ### Summary The **"Calm Down Interaction"** minor release. - **Calm Down Interaction**: Added shift+right-click empty hand interaction for owners to calm down their tamed wolves. - Commands the wolf to sit, stops navigation, and completely clears its attack target and anger state (`stopBeingAngry()`). - Plays a whine sound and spawns smoke particles to indicate calming down. - Displays an action bar/overlay message: `"Calmed down [Wolf Name]"`.