📜 MerlinBooks v5.0 — The "Vision & Resonance" Update

🧲 The Magnetic Resonator (Ore Detector Pickaxe)

• Calibration Chamber GUI: Right-clicking with a Magnetic Resonator pickaxe opens a specialized 1-slot calibration chamber (MagneticGUIHolder). Non-active slots are protected by unbreakable stained glass panes.

• Smart Mineral Resolver: Inserting any ore, raw mineral, ingot, or block (e.g., Diamond, Raw Iron, Gold Ingot, Debris) automatically resolves all related variants (Normal Ore, Deepslate Ore, Raw Block, and Compressed Block forms).

• Non-Mineral Rejection: Non-mineral items (dirt, tools, food, etc.) are rejected, returned to inventory, and accompanied by a warning notification.

• Precision Particle Laser: Emits a continuous, real-time cyan particle beam from the player’s eye-line straight to the nearest matching block within a 20-block radius when held in either the main hand or off-hand.

👁️ The Magic Eyes Suite (Helmet Attributes)

• Eye of Avarice (Loot Tracker): Automatically detects Chests, Barrels, Spawners, and Vaults within 15 blocks, projecting vertical gold beacon pillars (10 blocks high) through solid ground for visibility.

• Eye of Truth (Hazard Vision): Identifies TNT, Trapped Chests, Tripwires, and Infested Blocks within 15 blocks, shooting vertical lava particle pillars through blocks to signal hidden hazards.

• Eye of the Predator (Hunter’s Radar): Passively highlights all hostile and passive mobs within a 30-block radius with a spectral outline (excluding players).

• Eye of the Void (Phase Vision): Sneaking within 5 blocks of a solid wall turns a 3x3 block section into client-side glass on the player's screen, allowing real-time wall peeking. Releasing sneak restores the original blocks.

• Eye of Vitality (Tactical HUD): Looking directly at any entity displays a real-time action-bar HUD showing exact health pools (Current HP / Max HP). Entities below 20% HP bleed visual damage particles.

• Eye of the Abyss (Nightmare Ward): Grants permanent Night Vision and nullifies the Warden's Darkness and Blindness potion effects.

• Eye of the Slayer (Opening Thread & Flash Step): Landed strikes have a 10% chance to reveal an "Opening Thread" (a white tether linking player to target). Left-clicking within the 2-second window blinks the player behind the opponent, aligns camera orientation, and executes an instant 25.0 damage strike.

🏹 Combat Synergies

• Predator + Magic Arrows Arcane Lock-On: Wearing the Eye of the Predator alongside a Magic Arrows bow automatically routes all glowing targets into the arrow targeting queue. Firing a Magic Arrow triggers Yondu-style chain-piercing and homing trajectory across all nearby mobs without requiring manual tagging.

⚙️ Backend & Architecture Improvements

• Thread-Safe Arrow Runnables: Restructured projectile tracking to use immutable target lists (finalMarks), preventing variable-capture issues in inner tasks.

• Dedicated Custom GUI Holder: Replaced generic inventory views with MagneticGUIHolder to safeguard slot interactions and prevent item duplication or shift-click exploits.

• Modernized Switch Syntax & Code Cleanup: Updated rule-checks to use enhanced switch expressions, removed redundant type casts, and optimized collections with getFirst() method lookups.