📜 CHANGELOG (v1.1.3 – Major Add-on Transition)

🚀 Major Transition: Plugin to Add-on

• Integrated Particle System: Replaced standard block-based visualizations with low-latency custom particles. Waypoints now use huntunu:path_point, huntunu:path_target, and animated huntunu:path_line for route mapping.
• Performance Optimization: Transitioned from heavy entity-tick polling to a staggered logic engine. AI processing is now distributed across multiple ticks based on NPC density.

🧠 Intelligence & Navigation (Collision Fixes)

• Stacked Slab/Stair Logic: Fixed a physics bug where multiple slabs or stairs stacked on top of each other were treated as partial blocks. The AI now correctly identifies "Full Block Height" formations and applies appropriate bypass or jump rules.
• Enhanced Surface Detection: Updated getSurfaceY to handle minecraft:vertical_half states. NPCs now "magnetize" to the top of upside-down stairs and upper-half slabs with perfect precision.
• Smart Wall Detection: Added validation for blocks with height > 1.2 meters. NPCs now recognize these as walls instead of traversable steps, preventing them from getting stuck against tall partial blocks.

🌙 Schedules & Access Management

• Day/Night Cycle Schedules: NPCs can now have specific work shifts! Configure NPCs to only move during the day, only at night, or stay active 24/7.
• Return Home Logic: When a shift ends, NPCs intelligently finish their journey and return to waypoint #0 before resting.
• Permission Manager UI: Added a dedicated player-list menu with toggles for npc_admin and npc_editor roles. No more manual /tag commands!

🏃 Physics & Motion

• Radar Refinement: Improved wide-shoulder collision checks to prevent NPCs from "clipping" into walls while turning corners.
• Jump Velocity Sync: Staggered the jump sequence to ensure NPCs clear 1-block steps even when moving at high speeds.
• Advanced Hazard Logic: The AI now treats Lava, Magma, and Fire as solid walls. NPCs automatically recalculate detour paths and ignore hazardous floor surfaces.

🖥️ Interface & UX

• Visual HUD Feedback: The Action Bar HUD now displays real-time waypoint progress and active editing session status.
• Audio UX Overhaul: Integrated vanilla sound triggers (note.bass, note.pling, random.orb, random.pop) for permission updates, path placement, and error handling.
• Comprehensive Help & Guide: A new built-in documentation system explaining all features, interactions, and scriptevent commands directly from the Hub Menu.

NPC Pathmaker — Precision Navigation since 2026. 🚀