🐾【Changelog】Boss Companions - Combat & Tactical Overhaul (v1.0.2)

Minecraft Version: 1.21.1 (Fabric)
Requires: Fabric API
Overview: Compared to the initial release, this major update completely rewrites the companion AI state machine, eliminates combat jittering & desync, introduces the brand-new Companion Flute, and adds 18-slot inventories to all companions!

🌟 What's New & Major Highlights

1. New Item — Companion Flute: Sound the ancient flute to break sit/idle mode and rally all your companions across any dimension into a tactical battle formation!
2. 18-Slot Companion Backpack: Sneak + Right-Click with an empty hand to instantly access a dual-row portable mobile chest.
3. Combat AI Overhaul (No More Jittering): Permanently resolved the issue where companions constantly stuttered and warped back when fighting ranged mobs like skeletons.
4. Tactical Backstab & Silent Warp: Removed abrasive teleport sound effects; companions dynamically teleport behind enemy flanks for surprise backstabs!
5. Cross-Dimension Anti-Lost System: Transactional chunk management ensures companions never get stranded in unloaded chunks or portal transitions.
6. Friendly Fire Immunity & Downed Shield: Full protection against sweeping swords and splash potions, plus a totem-grade fatal damage shield.

⚔️ Detailed Changes

1. New Command Item & Quality of Life

• New Item — Companion Flute:
  • Comes with custom pixel art, item model, and craftable recipe.
  • Right-Click Rally: Instantly interrupts any "Sit / Stay" state and rallies all owned companions directly into active combat mode.
  • Tactical Semi-Circle Formation: Warps companions in an evenly spaced half-circle around the player to prevent collision clipping and prepare for immediate battle.
• 18-Slot Portable Storage:
  • Sneak + Right-Click any owned companion to open its dedicated 18-slot inventory.
• Mode Toggling:
  • Right-click with an empty hand to seamlessly switch between Follow (Combat) and Stay (Idle) modes.

2. Combat AI & State Machine Overhaul

• Dual-Threshold Hysteresis Loop (Anti-Jitter):
  • In the previous version, companions prematurely teleported back due to narrow distance checks, getting kited by skeletons and pillagers.
  • Implemented an advanced Hysteresis Loop (38-block disengage buffer vs. 26-block combat envelope). Companions now aggressively hold the frontline and only regroup when the player has truly moved away.
• Silent Flank & Backstab Infiltration:
  • Removed annoying, repetitive ender teleport sounds for a clean audio battlefield.
  • When repositioning in combat, companions calculate line-of-sight (LOS) and drop into the enemy's blind spot/flank to deliver critical backstabs.
• Proactive Threat Interception:
  • Companions actively scan a 24-block radius for hostiles targeting their master and intercept threats before the player takes damage.

3. Transactional Chunk Loading & Dimension Tracking

• Zero Lost Pets:
  • Fixed issues where companions would get stuck in unloaded dormant chunks after long-distance teleports or Nether portal transitions.
  • Companions can be safely recalled regardless of whether they are in the Overworld, Nether, or End.
• Zero Memory Leakage:
  • Powered by a 10-tick watchdog timer that automatically releases temporary chunk tickets, preventing server memory bloat and ghost entity duplication.

4. Companion Health & Friendly Fire Protection

• Friendly Fire & Sibling Immunity:
  • Companions are completely immune to their owner's sweeping edge strikes, arrows, tridents, and splash potions.
  • Allied companions under the same master will never damage each other.
• Downed Protection:
  • Fatal damage automatically triggers a totem-like golden shield and preserves companion health, giving owners ample time to heal them with Healing Biscuits!

📦 Installation & Compatibility

• World Compatibility: 100% backward compatible with existing worlds and previously tamed companions. Simply drop the new .jar file into your mods folder—no world reset required!