NPC Pathmaker (v1.1.6 The Core Migration & Smart Pathing Update) - Professional NPC AI

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 & MECHANICS:

• 🧠 Smart Pathing & Whiskers (v1.1.6 Update): Implemented a 'Whiskers' approach with multiple fan-shaped rays, Corner Detection Squeeze, and Spline-Based Arc Detours.
• 🏃 Optional Gap Jumping (v1.1.6 Update): NPCs can now be configured to either jump over 1-block wide gaps or treat them as impassable walls.
• ⚙️ Advanced Pathing Settings (v1.1.5 Update): Added ping-pong reverse mode and customizable home waypoints.
• 🎨 Custom UI (v1.1.4 New): Completely custom dark-themed user interface, replacing standard vanilla forms with sleek grid-layouts and styled menus.
• 🛡️ In-Game Permission Manager (v1.1.4 UI Overhaul): Manage team roles (Admin vs. Editor) directly through a redesigned in-game UI. Admins can lock sensitive "Arrival Commands" from regular editors.
• 🚀 Add-on Transition (v1.1.3 Major Update): Migrated to a complete Add-on with custom particle effects for waypoints and path lines, significantly reducing server overhead compared to block-based indicators.
• 🧠 Smart Surface Logic (v1.1.3 Physics Fixes): Perfect collision logic for all block heights. NPCs correctly identify when Slabs, Stairs, or Snow Layers form a full block and adjust their "Shoulder-scanning" AI accordingly.
• 🌙 Day/Night Schedules (v1.1.3 Feature): 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 (v1.1.3 Feature): When a shift ends, NPCs intelligently finish their journey and return to waypoint #0 (Home) before resting.
• 📖 In-Game Help & Guide (v1.1.3 Feature): A full documentation system explaining interactions and scriptevent commands directly inside the tool.
• 🗺️ Particle Path Mapping (v1.1.3 Engine): Route waypoints are connected by animated particle lines in Edit Mode, providing a clean and non-intrusive visualization.
• 🚀 Zero-Lag "Staggered" Engine (v1.1.3 Optimization): Processes NPC logic in a staggered frequency across multiple ticks to allow for 50+ active NPCs with zero impact on server TPS.
• 📍 Waypoint Event Editor (Core Mechanism): Set up to 80 waypoints per NPC. Each point is an independent event trigger with custom wait times, animations, and console commands.

🛠️ QUICK START GUIDE & HOW TO USE

First Launch & Admin Setup

Run /huntunu:npcadmin @s to grant yourself the master admin role. This is required for your first launch to access all tools.

Global Hub

Simply tap with a Stick in the air (while not sneaking) to open the Global Hub. From here, you can manage nearby NPCs, check the guide, or manage player permissions.

Control Center (New Custom UI)

Tap any NPC with a Stick (Magic Tool) to open their individual Control Center featuring the new sleek grid-layout. Here you can adjust general settings, work schedules, and waypoints.

Edit Mode, Route Building & HUD

Crouch (Sneak) and tap the NPC with the stick to instantly enter Edit Mode. While in Edit Mode, simply tap the floor to place a waypoint. You will see animated particles connecting your route! Look at the Action Bar — the HUD Indicator shows the current NPC name and waypoint progress (X/80).

Exiting HUD & Visuals

Sneak + Click in the air with the Stick to globally turn off the HUD and hide all particle visuals when you are done editing.

Starting the NPC & Schedules

Once your path is set, go to General Settings to set the Work Schedule (Day, Night, or Always) and toggle "Movement Active". You can also use the remote command /scriptevent huntunu:walk all to set them in motion!

⚙️ ENGINE MECHANICS

Jumping over Obstacles

The AI dynamically scans the environment ahead. If a standard 1-block high obstacle blocks the way, the NPC will automatically perform a synchronized jump to clear it seamlessly. In addition, you can now toggle the ability for NPCs to jump over 1-block wide gaps via their Control Center!

Parkour Gap Jumping

Elevate your map design with agile movement mechanics! NPCs are now fully equipped to perform precise, 1-block wide parkour leaps across gaps. Whether traversing broken bridges, jumping between rooftops, or navigating rugged dungeon terrain, they will seamlessly clear short chasms to reach their next waypoint. This behavior is fully customizable and can be toggled on or off directly through the Control Center.

Wall Avoiding & Sliding

NPCs no longer get stuck at corners. The advanced radar uses wide-shoulder checks and arc-scanning to "slide" along walls and navigate complex structures just like a real player.

Slab & Stair Logic

Perfect collision mathematics. The AI accurately calculates combinations of half-slabs and stairs (even upside-down ones) and glides over them without breaking behavior.

Ledge Avoidance

NPCs dynamically detect drops and pits (3+ blocks deep). Instead of falling into danger, they will calculate a safe detour route around the ledge.

Water Physics (Swimming)

Advanced buoyancy system. NPCs have custom swimming logic, slowing down in water and surfacing to breathe/float using beautiful sine-wave bobbing rather than sinking like stones.

Hazard Avoidance (Lava & Fire)

Hazard avoidance radar recognizes Lava, Magma, and Fire as solid walls. NPCs will strictly ignore them as valid floor surfaces, preventing accidental deaths and the "Lava Walking" glitch.

Wooden Doors

Smart interaction. NPCs will automatically open wooden doors and fence gates in their path, maintaining a memory queue to ensure they are politely closed once the NPC moves safely away.

⚙️ TECHNICAL REQUIREMENTS:

• Game Version: Minecraft Bedrock v1.21.60 or higher.

📺 VIDEO SHOWCASE & TUTORIAL:

Watch the development log and full tutorial on my YouTube channel: https://www.youtube.com/@Huntunu

📜 TERMS OF USE:

© 2026 HUNTUNU. All rights reserved.

• Allowed: Use in personal worlds, roleplay maps, and YouTube showcases (please provide proper credit to Huntunu).
• Prohibited: Re-uploading this project to other sites, claiming the source code as your own, or commercial use.

HUNTUNU Scripts — NPC Pathmaker v1.1.6 (beta) (2026). 🚀