# AdvancedDeliveryDrones v1.1.6 🚀 ### ✨ Improvements * Animals are now automatically deselected if they move too far away, making deliveries smoother and preventing accidental selections. * Improved the draft creation process so your selected animals and settings stay exactly as you left them. ### 🛠️ Fixes * Fixed an issue where some configuration settings could reset unexpectedly. * Fixed compatibility with WorldGuard, even if it isn't installed on your server. * Improved overall compatibility and stability with optional plugin integrations. If you habe any problem with the plugin please report them on my discord! ❤️

✨ Version 1.1.5 🔄 Database Migration: - Async conversion during reload... - MySQL: transfers only if connection is active. 💾 Backup System: - New command: /drone data backup - Saves all configs and data for later restoration. 🛡️ Admin Control Center & Logs: - Drone Logs: Track who sent what, when, with detailed info (mobs, items). - Control Center: Overview of all active drones with cancel/delete options. ⚙️ Crafting Requirement (Optional): - Players must craft a specific item before sending a drone. - Item is consumed upon drone dispatch. - Fully customizable crafting recipe.

# Changelog v1.1.4 — Webmaps, Custom Models & Flags This major update brings massive integrations for external plugins! Track your drones live on webmaps, customize your GUIs with premium texture plugins, secure your regions with WorldGuard flags, and manage multiple active drones smoothly via the new ID system. ## ✨ New Features * **Custom Model Support (Nexo, ItemsAdder, Oraxen):** Added full support for custom item models inside the GUI. You can now seamlessly use textures and models from **Nexo**, **ItemsAdder**, and **Oraxen** to make your interface look unique. * **Live Webmap Tracking (BlueMap & Pl3xMap):** Added livemap hooks! You can now track your drones in real-time as they fly across your server using **BlueMap** or **Pl3xMap**. * **Advanced WorldGuard Flags:** Expanded the WorldGuard hook by adding custom regional flags. You can now selectively block or allow specific drone functionalities in different areas of your world. * **Drone ID System & Persistence:** * Implemented a unique ID system for drone management. * You can now cancel specific drones using `/drone cancel <ID>` instead of canceling all of them at once. * Added full **Tab-Completion** support for drone IDs. --- > ℹ️ **Note for Admins:** To use the webmaps or Worldguard flags, ensure that the respective hooks are enabled in your updated `config.yml`. The new WorldGuard flags will register automatically upon reload.

# Changelog v1.1.3 — WorldGuard & Blacklists Update This update introduces advanced administrative control features via WorldGuard and customized blacklists, alongside several critical user interface hotfixes in the socket management and drone systems. ## ✨ New Features * **Advanced WorldGuard Hook:** Added powerful integration features to seamlessly detect, respect, and manage drone actions within specific WorldGuard regions. * **Menu Item Blacklist:** Implemented a dedicated item blacklist functionality directly inside the compose menu interface. * **Mob Type Blacklist:** Added an explicit mob-type blacklist configuration for all mob-sending drones. ## 🛠 Bug Fixes * **Socket Management GUI:** Fixed an issue where clicking on an empty slot within the socket management user interface would accidentally force the editor window to open. * **Mob-Sending Drone Inventory Lock:** Resolved a bug that completely blocked players from putting items into slots after interacting with the mob-sending menu, even when no active selection was made. * **UI State Deselection:** Updated the `compose-hub-items-disabled` handling logic to explicitly deselect previous states first, preventing lingering UI states. --- > ⚠️ **Note for Admins:** Please check your `config.yml` to set up the new blacklist nodes and fine-tune your new WorldGuard region filters!

# 🚀 Version 1.1.2 — The Drone Mob-Transport Update! I have completely overhauled the mob-sending system! I added a brand-new GUI menu that makes transporting animals and creatures via drones much smarter, more visual, and highly flexible. Here is everything new in this release: ### 🗺️ Brand-New Mob Selection Menu & Pagination (GUI) Instead of manually registering mobs, you can now open an intuitive menu that lists all mobs within a specific radius around you. * **Smart Pagination System:** If there are more mobs in the area than available slots in the menu, a pagination system is automatically initialized, allowing you to easily page through the list. * **Visual Feedback:** Mobs selected in the GUI will have a distinct glint effect (enchantment glow) applied to them. * **Auto-Select:** Any mobs that you already have leashed when opening the menu will be automatically pre-selected for you. ### ⛓️ Leash Mechanics & Balancing I have tied the mob-sending mechanics much closer to vanilla behavior and your configurations: * **Leash Consumption:** Sending mobs now actively consumes leashes from your inventory. * **Destination Guarantee:** Even if a player sends a mob without leashing it beforehand, the mob is guaranteed to spawn at the destination safely leashed to the drone. * **Configuration Limits:** The `max-leashed-animals-per-drone: 1` limit (via config or permission) is still strictly enforced. * **New Filter Option:** By setting `leashable-only: true`, you can restrict the system so that players can only send animals that are theoretically leashable in vanilla Minecraft. ### 💾 Brand-New NBT Persistence System (`persist-nbt-data`) I implemented a completely new NBT storage system from scratch! If you set `persist-nbt-data: true` in your configuration, it unlocks the following powerful features: * **Exact Clones:** All custom NBT data of the mob (such as color, age, effects, traits, and health) will be saved and perfectly restored when spawning at the destination. * **Dynamic Placeholders:** Numerous new placeholders have been added to the `gui.yml` to help identify the correct mobs in the GUI. *Note: These placeholders will only work if NBT persistence is enabled!* --- *Found any bugs or have feedback? Please open an issue on my GitHub repository!*

# 🚀 DeliveryDrones Update — Storage GUI, Animal Modes & Improvements This update brings highly requested quality-of-life features, flexible configuration options for server administrators, and crucial bug fixes for custom skull textures and localization. Here is everything new in this release! --- ## ✨ New Features ### 📦 Storage Preview & Preparation GUI * **Safe Loading:** Added a dedicated GUI that allows players to place items into the drone for storage or preparation and close the interface safely **without automatically launching the drone**. This makes managing large shipments much easier and safer! ### ⚙️ Advanced Behavior Configuration I have expanded the configuration file with powerful new settings to customize your server's drone mechanics: * **Animal Return Mode (`animal-return-mode`):** You can now define how drones behave when an animal delivery is aborted (due to a player being offline, cancellation, or declination). * `FLY`: The drone realistically flies back to its original send point. * `TELEPORT`: The drone instantly teleports back to the send point. * **Direct Inventory Sending (`open-inventory-on-send`):** Added the ability to completely bypass the standard compose-hub GUI. * When set to `true`, interacting with a drone opens its package inventory directly, and closing the interface automatically dispatches the drone. --- ## 🛠️ Fixes & Tweaks * **Full GUI Customization:** Resolved an issue where several parts of the user interface were hardcoded. All remaining elements have been properly moved to `gui.yml`, allowing for 100% full translation and customization! * **Custom Skull Support:** Fixed and stabilized the Base64 texture support for custom player skulls within the `gui.yml` configuration. Custom heads will now load reliably without skin-fetching delays. ---

## 🛠️ Bug Fixes * **Socket Name Conflict:** Fixed an issue where two sockets could mistakenly be created with the identical name. * **Lead Collection Fix:** Resolved a bug where the receiver wouldn't correctly obtain the leads when collecting an animal drone. * **Global Filling:** Restored the ability to adjust the global filling settings. * **Exploit Fix:** Fixed a glitch that allowed players to remove a drone's head during the collection animation. ## 🔑 New Permissions * `drone.leashed.max.N` – Allows a player or LuckPerms group to send up to `N` leashed animals via drone. * `drone.sockets.max.N` – Allows a player or LuckPerms group to place up to `N` sockets. * `drone.send.max.N` – Allows a player or LuckPerms group to send up to `N` drones. ## 📊 New Placeholders The placeholders now support dynamic targeting. You can replace `outgoing_1` with `incoming_1` or target a specific drone directly using `id_<uuid>`. ### Base Placeholder Options | Placeholder Type | Description | | :--- | :--- | | `%deliverydrones_[target]_items_summary%` | Grouped item overview *(e.g., 3x Diamond, 10x Iron Ingot)* | | `%deliverydrones_[target]_items_list%` | Slot-by-slot item list | | `%deliverydrones_[target]_items_total%` | Total count of all items combined | | `%deliverydrones_[target]_animals_summary%` | Grouped animal overview *(e.g., 2x Cow, 1x Pig)* | | `%deliverydrones_[target]_animals_list%` | Full list of animals *(e.g., Cow, Pig, Cow)* | | `%deliverydrones_[target]_contents_summary%` | Combined items and animals summary | | `%deliverydrones_[target]_item_1_name%` | Name of the first item | | `%deliverydrones_[target]_item_1_amount%` | Amount of the first item | | `%deliverydrones_[target]_animal_1_name%` | Name of the first animal | ### Additional Utility Fields You can also use these existing utility fields with any target: * `%deliverydrones_[target]_item_count%` – Total number of unique item stacks. * `%deliverydrones_[target]_animal_count%` – Total number of animals. * `%deliverydrones_[target]_has_items%` – Returns if the drone contains any items. * `%deliverydrones_[target]_has_animals%` – Returns if the drone contains any animals. > 💡 **How to use `[target]`:** > * Replace with `outgoing_<number>` (e.g., `outgoing_1`) for sent drones. > * Replace with `incoming_<number>` (e.g., `incoming_1`) for arriving drones. > * Replace with `id_<uuid>` (e.g., `id_123e4567-e89b-12d3-a456-426614174000`) for a specific drone. ## ✨ Features * **Custom Skull Support:** Added Base64 support for custom player skulls within the `gui.yml` configuration.

# 🚀 Update Log — Version 1.0.9 ## ✨ New Features * **In-Game Config Editor:** Added a powerful, in-game configuration editor featuring a paginated GUI and chat input support. * **Metrics Integration:** Added full support for **bStats** to gather anonymous usage statistics. * **Notification Control:** Added the `config-editor-messages` option to dynamically toggle and control the display of editor notifications. ## ⚡ Performance Boost * **Massive Optimization:** Drastically reduced CPU usage from **4% down to just ~0.08%**, making the plugin incredibly lightweight and efficient. ## 🔧 Optimizations & GUI Updates * **Streamlined `gui.yml`:** Significantly shortened the file configuration by introducing global slot filling and universal back buttons. * **Localization:** Fully translated `gui.yml` into **English** and fixed language keys for the config editor messages. * **Visual Polish:** Updated GUI colors to perfectly match the existing message color scheme (Gold, Green, Red, Yellow, Gray). ## ⚠️ Known Issue > ⚠️ **Note on `gui.yml`:** > The global `fill-item` configuration is currently not working as intended and is locked to the default item for now. This will be fully fixed in the next update!

# 📊 Stats & Placeholders: Version 1.0.8 This update brings full **PlaceholderAPI (PAPI)** support! You can now display live drone data, delivery countdowns, and socket information in your scoreboards, tab lists, or custom menus. ### 🔌 PlaceholderAPI Integration Use the `deliverydrones` identifier to pull real-time data from the plugin. * **Player Stats:** Show players how many drones are heading their way or how much time is left on their sending cooldown. * **Live Tracking:** Display ETAs (Estimated Time of Arrival), current distances, or sender names in your HUD. * **Socket Info:** Show socket locations, owner names, and trusted player lists. * **Smart Names:** The plugin automatically converts messy UUIDs into clean player names for a better UI experience. ### 📝 Example Usage You can use these placeholders immediately in any PAPI-compatible plugin: * `%deliverydrones_incoming_flying_count%` — How many drones are currently flying to me? * `%deliverydrones_incoming_1_eta%` — Seconds until my next delivery lands. * `%deliverydrones_cooldown_player_remaining%` — Time until I can send another drone. ### 🛠️ Technical Highlights * **Index System:** Use `%deliverydrones_outgoing_1_...%` for your first drone, `_2_` for the second, and so on. * **Config Mirrors:** Almost every setting from your `config.yml` (like speed, radius, or inventory size) is now available as a placeholder. * **Global Totals:** Monitor the total number of active, flying, or landed drones across the entire server.

# 🚀 Drone Update: Version 1.0.7 This update gives your delivery drones a makeover, ensures smoother flight paths, and cleans up the "under the hood" mechanics for better performance (about 4% less cpu usage). ### 🎨 Custom Drone Appearance You are no longer stuck with the default player-head look. You now have full control over the drone's design: * **Custom Models:** Use your own items from **Nexo**, **Oraxen**, or **ItemsAdder** as the drone model. * **Toggleable Glow:** You can now easily turn the drone's glowing outline on or off in the `config.yml`. * **Classic Look:** If you don't use custom model plugins, the drone will still use the classic player-head texture by default. ### ✈️ Improved Flight (No more lagging!) I have overhauled the flight logic to make deliveries feel more natural and less taxing on your server: * **Smart Pathing:** The drone now calculates its route once at the start. It only recalculates if the target moves, which saves a lot of CPU power. * **Smooth Gliding:** Instead of "bouncing" through the air, the drone now glides smoothly from point A to point B. This fixes the "jittery" movement seen on some game clients. * **Stable Visuals:** The drone’s internal stand is now rock-solid during flight to prevent any visual flickering. --- ### 🛠️ Upgrade Guide After updating, please check your `config.yml`. The following new settings are available: 1. **Provider:** Tell the plugin which system provides your model (`NONE`, `NEXO`, `ORAXEN`, or `ITEMSADDER`). 2. **Item-ID:** Enter the ID of your custom item here. 3. **Glow:** Set `glowing-enabled` to `true` or `false`.