AdvancedDeliveryDrones

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`).****