ВЕРСИИ (17)

# 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`.

## 🛠️ New in Version 1.0.6 (The Database & Admin Update) Version 1.0.6 is a major milestone focusing on automation, proper data persistence, and seamless GUI interactions for offline players. ### ⚙️ Automated Configuration Updates * **Smart Config Updater:** Integrated the `tchristofferson ConfigUpdater`. Your configuration files, GUIs, and language files will now **automatically update** to include new keys without wiping or resetting your old settings. * **Version Checker Fix:** Fixed the update-notification logic so it only triggers when a legitimately newer version is available. * **Localization Polish:** Fixed a broken parameter for the `player-never-played` message and correctly populated it across all 6 supported languages. ### 👥 Offline Player Support (Trust & Blacklists) * **Full Offline Support:** Trust lists and Blacklists now fully support offline players. * **Custom Player Heads:** Sockets and Player Blacklist GUIs will now correctly render the custom texture heads of offline players. * **GUI & Tab Click Fixes:** Resolved an issue with `NamespacedKey` handling when clicking offline players inside menus. * **Tab-Completion:** Offline players now appear in command autocompletion. Trying to target a non-existent player will now correctly yield the `player-never-played` error. ### 💾 Enterprise Database & MySQL Integration * **Full MySQL Support:** You can now choose between local storage or a centralized **MySQL database** to save and sync active drones across networks! * **Database Architecture Refactor:** The `DatabaseManager` has been completely rewritten to use separate, optimized tables. Table prefixes (like `drone_`) have been reverted to their clean, original names. * **Drone Deletion Fix:** Fixed a critical bug where drones destroyed in-game were not being dropped/purged from the database. * **Data Migration Command:** Added a powerful data conversion system (`/drone convert ...`) with full tab-completion to help you migrate data smoothly. ### 🐛 Miscellaneous Bug Fixes * **Socket Management GUI:** Fixed a bug where the `/drone socket manage` command did absolutely nothing. It now properly opens the management GUI as intended.

## 🔔 New in Version 1.0.5 (Update Notifications) This update ensures you never miss critical performance tweaks or feature additions by introducing an automated update tracker. ### 🌐 Version Checker System * **Automatic Update Alerts:** The plugin now checks the official repository upon server startup to see if a newer version of **DeliveryDrones** is available. * **Console & Admin Notifications:** If your server is running an outdated version, a clear warning message will be printed to the console (and sent to authorized admins upon joining) with a link to the latest release. * **Non-Blocking Operations:** The version check runs entirely asynchronously, meaning it will **never** delay your server startup or impact TPS.

## 🛡️ New in Version 1.0.4 (Control & Anti-Abuse Update) This update introduces essential server-management features: **Cooldowns** to prevent spam and **Self-Send Restrictions** to control drone behavior. ### ⏱️ Cooldown System You can now limit how frequently players can send drones. * **Player Cooldown (`send-cooldown-seconds-player`):** Set a waiting time (in seconds) between player-to-player drone shipments. * **Socket Cooldown (`send-cooldown-seconds-socket`):** Set a waiting time (in seconds) between sending drones to Sockets. * **Smart UI:** Cooldowns are tracked individually per player/socket, and a countdown message shows exactly how much time is left. ### 🚫 Self-Send Restrictions Prevent players from abusing the system as a local transport loophole. * **`allow-send-to-self-player` (Default: `false`):** Blocks players from sending drones to themselves. * **`allow-send-to-self-socket` (Default: `false`):** Blocks players from sending drones to sockets they own.

## 🛰️ New in Version 1.0.3 (Automation Update) Version 1.0.3 enhances the "Socket" and container integration system, giving players more flexibility in how they design their automated delivery hubs. ### 📦 Expanded Container Integration * **Configurable Search Radius:** Drones are no longer strictly limited to the block directly beneath them. They can now scan for valid containers (Chests, Hoppers, etc.) within a defined horizontal and vertical radius. * **Flexible Hub Design:** This allows for more creative landing pad designs where the storage doesn't have to be centered perfectly under the drone's landing point.

## ⚡ New in Version 1.0.2 (Performance Overhaul) This update introduces a massive refactor of the drone's movement and scanning logic. By moving away from expensive per-tick operations and constant teleportation, **DeliveryDrones 1.0.2** offers a significantly lighter footprint for high-population servers. ### 🚄 Optimized Flight Engine * **Velocity-Based Movement:** Drones now utilize `setVelocity()` for cruise flight. This allows the server to handle the physics naturally, ensuring Armor Stand entities only "tick" while in motion. * **Smart Snap Logic:** Teleportation is now strictly reserved for dimension shifts, final landing snaps, or emergency relocation, eliminating "jitter" and reducing packet overhead. ### 🎯 Intelligent Landing & Scanning * **Landing Spot Cache:** The `computeLandingFrom()` function now runs **once** per target change. Drones no longer re-calculate their landing spot every single tick during the descent. * **High-Speed Ground Scanning:** * **Highest-Block Shortcut:** Uses internal world heightmaps to find the ground instantly. * **Coarse-to-Fine Search:** Scans the landing area in broad steps before narrowing down, saving hundreds of iterations. * **Safety Failsafes:** Automatically skips scanning in unloaded chunks to prevent accidental "chunk-loading lag." ### 📊 Performance Impact | Logic | Old Method (1.0.1) | New Method (1.0.2) | Benefit | | --- | --- | --- | --- | | **Movement** | Per-tick Teleport | Physics-based Velocity | Lower CPU & smoother visuals | | **Pathfinding** | Every Tick | Cached on target change | Massive reduction in main-thread load | | **Scanning** | Dense Radius Scan | Coarse-to-Fine + Heightmap | Near-instant landing calculations |

# 📦 DeliveryDrones — Changelog & Feature Overview ## 🆕 New in Version 1.0.1 (Current Update) This update focuses on precision landing mechanics, safer player-following behaviors, and robust configuration options to ensure your drones never get stuck or lost. | Category | Feature / Change | Description | | --- | --- | --- | | **Landing** | Pre-Landing Safety Check | Drones now scan for a valid, safe landing point on the ground instead of hovering awkwardly mid-air. | | **Landing** | Precision Notifications | Status updates now display the exact `<distance>` in meters from you to the drone, replacing the old generic delivery radius. | | **Follow** | Airborne-Follow | Drones will perform an airborne-follow routine before attempting to land (triggered by large falls, controlled via `airborne-follow-min-height`). | | **Follow** | Instant Ground Relocate | If a player makes sudden ground contact while gliding (Elytra + Airborne), the drone instantly relocates to them (limited to once per delivery). | | **Config** | New Options | Added `follow-airborne-player-before-landing` and `airborne-follow-min-height` to the configuration file. | | **Docs** | Project Cleanup | Fully updated the README and Roadmap to match the 1.0.1 specification. | --- ## ✅ Core Features (Added since 1.0.0) If you are upgrading from an older beta or missed the 1.0.0 documentation, here is a breakdown of the powerful systems permanently integrated into the plugin: ### 🌍 World & Performance * **Cross-Dimension Flight:** Drones seamlessly travel across dimensions, delivering items between the Overworld, the Nether, and the End. * **Performance Optimizer:** Built-in throttling and particle-culling engines ensure zero server lag, even during high-density deliveries. * **Drone Persistence (`drones.yml`):** Active drones are saved automatically. If the server restarts or crashes, your drones resume their tasks upon startup. ### ⚙️ Mechanics & Automation * **Elytra-Follow (`follow-gliding-player`):** Drones dynamically track and chase players actively gliding with Elytra wings. * **Container Auto-Unload:** When a drone lands on a designated "Socket," it automatically unloads its inventory into chests or hoppers directly beneath it. * **Collection Animation:** A smooth, custom visual effect triggers the moment a player collects a drone. ### 🔒 Administration & Control * **Fine-Granular Permissions:** Take absolute control over who uses the system with specific nodes like `drone.send.players`, `drone.socket.place`, and more. * **Feature Toggles:** Easily enable or disable entire gameplay loops using `players-enabled` and `sockets-enabled` switches. * **The `/drone locate` Command:** Lost a drone? Run this command to generate a distinct particle trail leading directly to your landed drone (requires `drone.locate`). * **Localization Support:** Hardcoded messages are gone. The plugin natively supports multiple languages via `languages/*.yml` (`de`, `en`, `es`, `fr`, `ru`, `zh`).****