SkyDrops

<div align="center">

SkyDrops

A custom airdrops for your Minecraft server!

<img src="https://i.imgur.com/Ncs73SN.png" alt="Airdrop landing with a particle effect" />

</div>

Installation & Prerequisites

Prerequisites:

* Java 17 or higher * DecentHolograms (Required for all hologram functionality)

Quick Start:

1. Download the SkyDrops JAR. 2. Place the JAR into your server's `plugins/` directory. 3. Restart the server. 4. Configure global settings via `/skydrops settings`. 5. Define airdrop contents via `/skydrops edit-drops`.

Core Functionality

In-game Configuration

SkyDrops features a complete GUI-based settings editor, eliminating the need for manual file editing. All core parameters, including drop announcement times and scheduled intervals, are configurable in real-time.

<div align="center"> <img width="553" height="435" alt="In-game Settings Editor GUI showing 'Time before drop to announce'" src="https://i.imgur.com/C61vXmW.png" /> </div>

Drop Claim Mechanics

To secure an airdrop's contents, players must interact with the drop chest a pre-configured number of times. This introduces a controlled delay to the claim process.

<div align="center"> <img src="https://i.imgur.com/amHNphY.png" alt="Airdrop chest with a 'CLICK RIGHT' prompt and click counter" /> </div>

Commands

| Command | Permission | Description | | :--- | :--- | :--- | | `/skydrops settings` | `skydrops.ingame.settings` | Opens the GUI for global plugin configuration. | | `/skydrops edit-drops` | `skydrops.edit.drops` | Opens the GUI for modifying airdrop loot tables. | | `/skydrops reload` | `skydrops.command.reload` | Reloads all plugin configurations (non-drop-related). | | `/skydrops removedrops` | `skydrops.command.removedrops` | Removes all active, unclaimed airdrops from the world. | | `/skydrops spawn-drop <location>` | `skydrops.command.spawndrop` | Manually initiates an airdrop at the specified coordinate. | | `/skydrops set-next-location <location>` | `skydrops.command.setnextlocation` | Overrides the next scheduled airdrop location. |

Permissions

| Permission | Description | | :--- | :--- | | `skydrops.command.editdrops` | Grants access to the loot table editing GUI. | | `skydrops.command.reload` | Grants permission to reload configurations. | | `skydrops.command.removedrops` | Grants permission to forcefully remove active airdrops. | | `skydrops.command.spawndrop` | Grants permission for manual airdrop spawning. | | `skydrops.command.setnextlocation` | Grants permission to pre-define the next airdrop location. | | `skydrops.command.settings` | Grants access to the in-game settings GUI. |

For support or bug reporting, please reach out on Discord: open an issue or open an issue on GitHub.