Early development

📦 Advanced Delivery Drones

Version 1.0.5

Licensed under the Apache 2.0 License.

Physical drone deliveries for Minecraft Paper servers: visible flight, package inventories, sockets, animal transport, blacklists, Discord webhooks, and fully configurable GUIs.

🗺️ Roadmap

• ✅ Hierarchical permission system — fine-grained permissions for all commands
• ✅ Feature toggles — enable/disable sockets and player-to-player deliveries
• ✅ Translation files — languages/*.yml (de_DE, en_EN, es_ES, fr_FR, ru_RU, zh_CN)
• ✅ Cross-dimension delivery — drones between Overworld, Nether, and End
• ✅ Landing improvements (1.0.1) — elytra/airborne follow, pre-landing safety check, distance-based landing notification
• 📋 Future: Mysql support for Database saving

✨ Features

🚁 Physical drone flight

• Armor-stand drone with custom skull texture flies from sender to target in real time
• Launch animation (optional): rise, spin, particles, and sound (launch-animation.*)
• Startup phase: slow acceleration for startup-seconds at startup-speed
• Cruise: main speed via speed (blocks per tick)
• Approach: slower final segment inside approach-distance at approach-speed
• Smooth landing: eased descent into the delivery zone (not an instant snap)
• Pre-landing safety check: landing spot is recomputed once before touchdown so the drone does not hover in unsafe air
• Virtual progress continues when chunks are unloaded; the drone reappears at the correct position when the chunk loads again
• Admin coordinate sends can preload the destination chunk before arrival
• Cross-dimension flight: arc path between worlds (Overworld ↔ Nether ↔ End)

🪂 Elytra & airborne follow (player deliveries)

• Elytra follow (follow-gliding-player): while the receiver glides, the drone tracks them in the air; when they land, the target is relocated once and the drone lands there
• Airborne follow (follow-airborne-player-before-landing): before landing, if the receiver is significantly in the air (e.g. long fall, not a normal jump), the drone follows until they touch the ground, relocates once, then lands — controlled by airborne-follow-min-height (default 5 blocks above solid ground)

📦 Package & inventory

• Compose GUI (9–54 slots, multiple of 9) — close to send
• Receiver opens the package after landing (right-click drone)
• Preview incoming drones read-only (/drone preview <uuid>) with item and animal summary
• Despawn timer starts after landing (despawn-time-minutes)
• Despawn modes: DELETE (remove contents) or COLLECT (return unopened items to sender)
• Collection animation when the receiver picks up the drone (collection-animation.enabled)

🎨 Hologram & boss bar

• Hologram above landed drones: recipient name + despawn countdown (hologram.*)
• Boss bar for the receiver: distance and ETA (bossbar.*)

✨ Particles & sound

• Configurable particle trail (including DUST:R,G,B:SIZE)
• Flight sound while airborne (flight-sound)
• Receiver beacon particles after landing

📍 Locate landed drones

• /drone locate — particle trail toward your nearest landed drone in the current world (locate-particles.*, permission drone.locate)

🚫 Receive toggle, decline & cancel

• Toggle whether you accept drones (/drone toggle, GUI)
• Decline all incoming deliveries — items returned to senders (/drone decline)
• Cancel your own outgoing drones (/drone cancel)
• Clickable chat links for cancel and preview

🔢 Limits & worlds

• Max active outgoing drones per sender (max-active-per-sender)
• Blocked worlds list (blocked-worlds)

⚙️ Feature toggles

• players-enabled — allow/disable player-to-player deliveries (GUI + commands)
• sockets-enabled — allow/disable socket system

⛔ Player blacklist

• Block specific players from sending direct deliveries to you
• Commands and GUI (/drone blacklist …)

🏗 Delivery sockets

• Place personal delivery points (/drone socket place <name>)
• Send to any socket by global name (/drone socket send <name>)
• Trust list: trusted players may pick up socket deliveries
• Per-socket blacklist for blocked senders
• Rename, relocate, remove; management GUI (/drone socket manage)
• Exact landing on socket coordinates
• Container integration: auto-unload package into hoppers/chests below the socket (container-integration.*)
• Pending returns if the socket owner is unreachable (socket-pending-returns.yml)

🐾 Animal transport

• Optional leashed-animal delivery (carry-leashed-animals)
• Send-mode GUI: animals only vs items
• Animals removed on send, respawned at delivery; invulnerable in transit
• Limits via max-leashed-animals-per-drone

🔔 Discord webhooks

• Optional notifications: sent, delivered, declined/cancelled, expired
• Embeds with items/animals (discord.* in config.yml)

🖥 GUIs (gui.yml)

• Main menu: send, preview, socket manage, toggle, decline, blacklist
• Player & socket target selection
• Socket edit: rename (sign UI), relocate, trust, blacklist, delete
• Blacklist add/remove player pickers
• Send-mode inventory (animals vs items)
• Live reload via /drone reload (no restart)

💾 Persistence & safety

• players.yml — receive toggle
• blacklists.yml — player blacklists
• sockets.yml — sockets, trust, socket blacklists
• socket-pending-returns.yml — stranded socket deliveries
• drones.yml — active in-flight/landed drones (survives restarts where applicable)
• Server restart: returns items/animals to senders, cleans orphaned entities
• Receiver offline / dimension change: outgoing drone cancelled, items returned
• Flying drone armor stand cannot be manipulated

⚡ Performance

• PerformanceOptimizer: throttling when many drones are active
• Distance-culled particles and rate-limited boss bar / hologram updates
• Chunk preload and flight path math cached per drone

🌐 Languages

• Messages in plugins/AdvancedDeliveryDrones/languages/ (not in config.yml)
• Select locale via language: in config.yml (de_DE, en_EN, es_ES, fr_FR, ru_RU, zh_CN)
• MiniMessage formatting; reload with /drone reload
• Landing notification shows distance to the drone in metres (<distance>), not delivery radius

🎮 Commands

Root command: /drone (players only — opens the main GUI when run without arguments).

📤 Sending & receiving

⛔ Player blacklist

🏗 Sockets

🛠 Admin

Parent permissions (drone.send, drone.use, drone.socket, drone.admin, drone.blacklist) grant their children — see plugin.yml.

🔐 Permissions

⚙️ Configuration