FancyNpcMovementsAddon is a lightweight, robust expansion plugin built specifically for server owners using FancyNpcs. Because packet-based NPCs do not have standard Minecraft AI or pathfinding engines, this addon steps in to handle smooth, coordinated movement without putting a heavy strain on your server's CPU.

With this addon, you can transform your static NPCs into living, breathing town guards, wandering merchants, or roaming dungeon mobs that pace back and forth along routes that you design completely in-game.

✨ Core Features

🗺️ Dynamic In-Game Waypoints: Walk to a location, type a command, and instantly map out your NPC’s walking path. No complex text coordinate configuration required.

🏓 Ping-Pong Routing: NPCs smoothly transition through your custom waypoints. Once they reach the end of their path, they automatically reverse order and walk backward to the start point, looping infinitely.

🛑 Intelligent Click-to-Pause: If a player right-clicks a patrolling NPC, the NPC will pause its movement for 10 seconds to interact with the player before seamlessly resuming its route.

⚡ Double-Packet Debounce Shield: Built to intercept double-interaction client packets. When a player right-clicks your NPC, its configured actions (like opening a GUI or running a command) trigger exactly once—no duplicate menu openings or spammed messages.

📋 Full Autocomplete / Tab-Completion: Includes an intelligent tab-completer that auto-fills commands and dynamically grabs the names of all your registered FancyNpcs.

💾 Persistent Saving: All patrol paths and global speed settings automatically save directly to a config.yml on the fly and reload instantly whenever the server reboots or reloads.

⚙️ Platform Compatibility

Because this plugin relies directly on the advanced packet injection system used by FancyNpcs, it requires a modern, high-performance server environment.

Supported ✅: Paper, Folia.

Unsupported ❌: Vanilla Spigot or CraftBukkit (FancyNpcs does not support Spigot natively).

Requirements: Minecraft 1.21 - 1.21.x and Java 21 or higher.

🛠️ Installation & Setup

Ensure you have the latest FancyNpcs (Java 21 Backport version) installed on your Paper server.

Drop FancyNpcMovementsAddon.jar into your server’s plugins folder.

Restart your server.

(Optional) To completely eliminate the arm-swing/punching animation when the NPC moves, open your plugins/FancyNpcs/config.yml file and set swing_arm_on_update to false.

Stand where you want a route to begin, and use /npcpatrol addpoint <YourNPCName> to start building your patrol path!