ВЕРСИИ (3)

# 🌟 v1.2 - The Advanced Pathing & Immersion Update This massive update turns the plugin from a simple movement utility into a more highly customizable, immersive patrol engine. I have overhauled the pathing mathematics, introduced per-NPC configurations, and added dynamic behaviors to make your worlds feel truly alive. ## 🚀 New Features * **Smooth Turns:** Say goodbye to robotic, sharp points! You can now enable "smooth" mode, which calculates curving paths around your waypoints. * **Continuous Looping Patrols:** Instead of strictly ping-ponging back and forth (A → B → C → B → A), you can now set routes to continuously loop (A → B → C → A). * **Waypoint Waiting & Dynamic Scanning:** NPCs can now be configured to pause for a set amount of seconds upon reaching a waypoint. You can set a global default, or assign specific wait times to individual waypoints (e.g., walk right through points A and B, but wait 10 seconds at point C). Pair this with **Dynamic Scanning**, and your NPCs will actively look around while they stand guard! * **Interactive Player Tracking:** When a player right-clicks an NPC, the NPC doesn't just freeze, it dynamically turns its head to track and look at the player's eyes for the entire duration of the pause, making them feel like living characters. The math dynamically adjusts to the scale of your NPC, ensuring giants and tiny creatures look right at your face. * **Per-NPC Speeds:** The global speed setting has been removed. You can now configure individual walking speeds for every single NPC. * **Customizable Interaction Pauses:** The pause duration when a player clicks an NPC is now completely configurable. Change the duration on a per-NPC basis, or disable the click-to-pause feature entirely. ## 💻 Command & Config Additions **Command Restructure:** All commands have been standardized to a cleaner, per-NPC format: `/npcpatrol <action> <npc_name> [args]` **New Commands & Toggles:** * `/npcpatrol speed <npc_name> <number>` *(e.g., 0.2)* * `/npcpatrol wait <npc_name> <seconds> [waypoint_index]` *(Leave index blank for default, or specify an index to override a single point)* * `/npcpatrol interact <npc_name> <true/false>` * `/npcpatrol interacttime <npc_name> <seconds>` * `/npcpatrol smooth <npc_name> <true/false>` * `/npcpatrol scan <npc_name> <true/false>` * `/npcpatrol loop <npc_name> <true/false>` **System Updates:** * **Config Migration:** The `config.yml` now saves all of these new settings directly under each specific NPC's profile. * **Expanded Tab-Completion:** The autocomplete system fully supports all new commands, automatically suggesting valid numbers, waypoint indexes, and `true/false` booleans depending on the context. ## ⚠️ Important Notes for Server Owners **Command Syntax Change:** If you are updating from v1.1, note that the `/npcpatrol speed` command now requires an NPC name before the number, as speeds are no longer global! **Smooth Turns & Loops:** For the mathematical spline generator to create beautiful, smooth curves or perfect loops, an NPC's path **must have a minimum of 3 waypoints**. **Native "Turn to Player" Conflict:** Ensure that FancyNpcs' native `turn_to_player` setting is set to **false** for any NPC assigned to a patrol route. If the native tracking is left enabled, the base plugin and this movement addon will constantly fight over the NPC's head position packets. This will cause severe, rapid head stuttering both while the NPC is walking and when a player clicks them. Use this addon's built-in interaction pause and tracking instead! **A Note on "Smooth" Routing Stutter:** Packet-based NPCs do not benefit from native Minecraft client-side interpolation (the magic that makes standard zombies and players look perfectly smooth when they walk). Because the `smooth` toggle mathematically generates dozens of tight "micro-waypoints" to simulate a curve, your client may occasionally "stutter" or rigidly snap the NPC as it rounds a corner at high speeds. This is a normal limitation of manipulating packets rather than real AI. If the visual stutter bothers you, simply disable `smooth` routing for that specific NPC!

# 🌟 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!

✨ **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.