NPC Pathmaker (v1.1.3 Add-on Transition) - 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:

• 🚀 Add-on Transition: Now 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: 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 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 (Home) before resting.
• 🗺️ Particle Path Mapping: Route waypoints are connected by animated particle lines in Edit Mode, providing a clean and non-intrusive visualization.
• 🛡️ In-Game Permission Manager: Manage team roles (Admin vs. Editor) directly through an in-game UI. Admins can lock sensitive "Arrival Commands" from regular editors.
• 📍 Waypoint Event Editor: Set up to 80 waypoints per NPC. Each point is an independent event trigger with custom wait times, animations, and console commands.
• 🚀 Zero-Lag "Staggered" Engine: Processes NPC logic in a staggered frequency to allow for 50+ active NPCs with zero impact on server TPS.

🛠️ QUICK START GUIDE

First Launch & Admin Setup

Run /scriptevent huntunu:setup_admin 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.

Spawning NPCs

You can spawn NPCs normally using the /summon npc command, by using the secret spawn egg (/give @s spawn_egg 1 51), or by using 'Pick Block' on an existing NPC in Creative mode.

Control Center

Tap any NPC with a Stick (Magic Tool) to open their individual Control Center for general settings and waypoint adjustments.

Edit Mode & Route Building

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!

Starting the NPC

Once your path is set, go to General Settings in the Control Center and toggle "Movement Active", or 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.

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 using beautiful sine-wave bobbing rather than sinking like stones.

Lava Avoidance

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.20 or higher.
• Experimental Toggles: You MUST enable "Beta APIs" (Script API) in your world settings for this add-on to function.

📺 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.3 (2026). 🚀