NPC Pathmaker (v1.0.89 Schedule & UX Update) - beta

Stop using hundreds of clunky Command Blocks! Bring your NPCs to life with the power of modern Minecraft Scripting. NPC Pathmaker is a high-performance navigation and AI system for Minecraft Bedrock that allows you to engineer complex, realistic movement behaviors for any NPC using a professional, in-game interface.

🔥 KEY FEATURES (v1.0.89 Update):

• 🌙 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.
• 📖 Comprehensive Help & Guide: A new built-in documentation system explaining all features, interactions, and scriptevent commands.
• 🛡️ In-Game Permission Manager: No more manual /tag commands! Admins can now manage team roles (Admin vs. Editor) directly through a new "Manage Permissions" UI.
• 🌋 Advanced Lava & Pit Logic: The AI now treats Lava, Magma, and Fire as solid walls. NPCs automatically recalculate detour paths.
• 🎵 Interactive Audio UX: Voice and sound cues for successful waypoint placement, access denied errors, and mode toggles.

🛠️ HOW TO USE:

1. First Launch: Run /scriptevent huntunu:setup_admin to grant yourself the master admin role.
2. Select NPC: Tap any NPC with a Stick to open the Control Center.
3. Quick Toggle (Sneak + Click): Crouch and tap the NPC with the stick to instantly enter or exit Edit Mode.
4. Work Schedule: In "General Settings", set the Work Schedule to define when the NPC should be active.
5. Help System: Access the "Help & Guide" from the main menu to learn about remote commands.
6. Exit: Sneak + Click in the air to globally turn off the HUD and hide all visuals.

⚙️ TECHNICAL REQUIREMENTS:

• Game Version: Minecraft Bedrock v1.21.30 or higher (Optimized for the latest 1.21.x updates).
• Compatibility Note: This add-on was developed and tested on version 1.21.30. Support for older versions is not guaranteed.
• Experimental Toggles: You MUST enable "Beta APIs" (Script API) in your world settings for this add-on to function.

📜 CHANGELOG (v1.0.87 – v1.0.88)

🧠 Intelligence & Navigation (Hazard AI)

• Smart Hazard Detours: Rewrote the radar to treat Lava and Pits (3+ blocks) as wall obstacles. NPCs now trigger path-finding maneuvers to bypass hot or deep surfaces.
• Clearance & Height Safety: Added vertical clearance checks (1.9 blocks) to prevent NPCs from jumping into low ceilings.
• Sideways Anti-Stuck: Replaced the "push back" logic with a "sideways nudge" + micro-jump. Allows NPCs to "glide" off complex corners and steps.

🏃 Physics & Motion

• Lava-Proof Movement: NPC physics now strictly ignore Lava as a valid floor surface, preventing the "Lava Walking" glitch.
• Aquatic Bobbing: Integrated Sine-wave mathematics for realistic floating and wave-bobbing while in water.
• Door Etiquette: NPCs maintain a persistent memory queue of doors they opened, ensuring they are closed after the NPC moves 1.5 blocks away.

🖥️ Interface & UX

• Permission Manager UI: Added a dedicated player-list menu with toggles for npc_admin and npc_editor roles.
• Audio Feedback System: Integrated vanilla sound events (note.bass, note.pling, random.orb, random.pop) for all UI and tool interactions.
• Admin Setup Event: Added huntunu:setup_admin script-event for reliable first-time installation.

⚙️ Technical Architecture (Optimization)

• Cache Garbage Collection: Implemented a cleanup loop that runs every 15 seconds to delete cached data for non-existent NPCs (ID-based memory management).
• Dual-Layer Cache: Combined the npcPathCache and npcDoorCache with the staggered radar to ensure maximum performance on low-end devices.
• JSON Compactor: Optimized the data string format further to support 80 points with Arrival Commands, Idle Timers, and custom Speed levels per point.

NPC Pathmaker — Precision Navigation since 2026. 🚀