📜 MerlinBooks v6.0 — The "Synergy & Stability" Update

⚔️ Anti-Recursion Engine & Crash Protection

• Metadata Combat Lock: Resolved a critical recursive damage loop (StackOverflowError) where AoE skills re-triggered the onCombat event infinitely.

• Safe Magic Damage Pipeline: All magical damage effects (Cleave, Chain Lightning, Seismic Slam, Frost Nova, Thorn Weaver, Zeus Strike, and Eye of the Slayer) now route through an isolated damage handler tagged with merlin_magic_damage, preventing secondary enchant triggers and protecting server stability.

🏹 Hunter's Synergy: Predator & Magic Arrows

• Auto-Lock Integration: Wearing a helmet with Eye of the Predator while wielding a Magic Arrows bow automatically routes all nearby glowing mobs into the bow's target queue. Magic Arrows will immediately home and chain-pierce without requiring manual tagging hits first.

• Mob-Only Targeting: Eye of the Predator strictly filters for passive and hostile mobs (Mob class), ensuring other players are not marked.

🧲 Magnetic Resonator Refinements

• Complete Ore Family Resolution: Fixed an issue where raw materials or specific ore variants bypassed the scanner. Inserting any variant (e.g., Diamond, Diamond Ore, Deepslate Diamond Ore, Raw Iron, Gold Ingot, Ancient Debris) now automatically matches and locates all related block forms.

• Non-Mineral Rejection: Items that are not recognized ores or minerals (food, tools, blocks like dirt or wood) are automatically rejected, ejected back into the player's inventory, and accompanied by a chat warning.

👁️ Visual Upgrades for Magic Eyes

• Pillar Beams for Avarice & Truth: Eye of Avarice and Eye of Truth now shoot 10-block-high vertical beacon particle pillars (Gold for loot, Lava for hazards) that pierce solid terrain, making buried chests, spawners, and TNT clearly visible through walls and underground.

• Spectral Outlines: Eye of the Predator now applies a clear glowing outline rather than overhead particles for better visibility in dark caves.

• Streamlined Roster: Removed Eye of the Architect to reduce background particle overhead.

⚙️ Backend & Architecture Improvements

• Thread-Safe Arrow Runnables: Arrow targeting tasks now utilize immutable target copies (finalMarks) to prevent concurrency errors.

• Modernized Syntax: Upgraded internal logic across all attributes to use Java enhanced switch expressions and getFirst() collection lookups.