Mineforgian
Fancy Npc Movement Addon
A lightweight, performance-friendly patrol engine for FancyNpcs. Easily set dynamic back-and-forth walking routes for your NPCs using simple in-game commands.
- Загрузки
- 131
- Подписчики
- 2
- Обновлён
- 7 июня 2026 г.
- Лицензия
- CC0-1.0
Опубликован 6 июня 2026 г.
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 to start building your patrol path!
Ченджлог
1.1Релиз1.21.11 · 7 июня 2026 г.
🌟 v1.1 - The Terrain Snapping Update
This update introduces one of the most highly requested features for packet-based entity movement: Vertical Terrain Snapping! You can now configure your NPCs to respect changes in ground elevation, preventing them from awkwardly clipping through the floor on uneven paths.
🚀 New Features
Terrain Snapping: NPCs can now seamlessly walk up stairs, over half-slabs, across bridges, and down hills. The plugin actively scans the terrain above and below the NPC and dynamically snaps their Y-coordinate to the solid ground.
Per-NPC Toggles: Because some NPCs might be ghosts, birds, or floating spirits, terrain snapping is disabled by default. You can toggle it on a per-NPC basis using the new command.
💻 Command & Config Additions
New Command: /npcpatrol terrain <npc_name> <true/false>
Config Update: Terrain preferences are now permanently saved in the config.yml alongside the NPC's waypoints. Your NPCs will remember if they are supposed to follow the ground after a server restart.
Tab-Completion: The in-game autocomplete system has been fully updated to support the new terrain argument and boolean (true/false) suggestions.
⚠️ Important Note for Server Owners
Terrain snapping handles elevation (Y-axis) only.
Because these are packet-based NPCs and do not use the heavy, lag-inducing Minecraft AI pathfinding engine, they still walk in straight lines between waypoints.
If you place a giant wall directly between Point A and Point B, the NPC will not magically walk around it. You must place your waypoints around corners to properly guide your NPCs past large obstacles!
1.0-SNAPSHOTРелиз1.21.9, 1.21.10, 1.21.11 · 6 июня 2026 г.
✨ 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.
Комментарии
Загружаем…