SAirDrop

━━━━━━━━━━━━━━━━━━━━
SAirDrop – Epic Airdrop Events for Your Server
━━━━━━━━━━━━━━━━━━━━

SAirDrop is a lightweight and powerful Minecraft plugin that brings exciting automated airdrop events to your server.

With timed crate drops, fully customizable rewards, fireworks, holograms, and easy-to-use commands, it creates fun competition for players and keeps your server engaging.

Whether you run a Survival, Skyblock, Factions, or Prison server, SAirDrop can seamlessly add a new layer of excitement and reward progression.

Unlike many other plugins, SAirDrop is designed to be simple for administrators and fun for players. Drop locations can be set anywhere on the map, crates are fully configurable with unique loot and enchantments, and events can be scheduled automatically. Players will love racing to find and open crates while fireworks and holograms make the event feel alive and professional.

━━━━━━━━━━━━━━━━━━━━
► Main Features Explained
━━━━━━━━━━━━━━━━━━━━

■ Scheduled Airdrops

Configure exact times for your events in config.yml (e.g. 12:00, 18:00). The plugin automatically starts events without staff interaction.

■ Custom Drop Locations

Use /sairdrop setdrop <id> to define where crates can spawn. Administrators have full control over placement.

■ Random Multi-Crate Events

Use /airdrop startwith <amount> to instantly start events with multiple random crates.

Example:

If you configured 100 spawn locations and use:

/airdrop startwith 10

the plugin will randomly choose 10 different locations and spawn crates there automatically. Every event feels unique and unpredictable.

■ Multiple Crate Types

Four crate tiers are supported by default:

• Basic

• Rare

• Epic

• Legendary

Each has configurable spawn chances, block type, and name style.

■ Fully Customizable Loot

Edit rewards.yml to define items, amounts, chances, custom names, lore, enchants, custom model data, NBT data, item flags, voucher/plugin items, metadata, and many other special item properties.

Players can win anything from simple ingots to epic custom gear.

■ Interactive Editor GUI

No need to edit files manually – use /sairdrop edit to open an in-game inventory editor where you can drag & drop rewards.

■ Firework Effects

Crates are highlighted with fireworks at regular intervals, making them easy to find and adding atmosphere.

■ Automatic Broadcast Messages

SAirDrop can automatically announce:

• Crate coordinates

• Which player collected a crate

• What reward they received

• How many crates are still remaining

This keeps events competitive and engaging for all players.

■ PlaceholderAPI Support

SAirDrop integrates with PlaceholderAPI to display event information on scoreboards, tab lists, and chat.

■ Cooldown System

Prevents abuse by limiting how fast players can open crates.

■ Reload Command

Apply changes instantly with /sairdrop reload, no need to restart your server.

━━━━━━━━━━━━━━━━━━━━
► Available Placeholders (PlaceholderAPI)
━━━━━━━━━━━━━━━━━━━━

%sairdrop_next%

→ Shows the exact time (HH:mm) of the next airdrop.

%sairdrop_next_formatted%

→ Shows formatted countdown until the next drop (e.g. 0h 12m 45s).

These placeholders are perfect for scoreboards, holograms, or tablists to keep your players excited for the next event.

━━━━━━━━━━━━━━━━━━━━
► Getting Started
━━━━━━━━━━━━━━━━━━━━

[1] Drop the plugin into your /plugins folder

[2] Restart your server

[3] Use /sairdrop setdrop <id> to place drop locations

[4] Edit rewards.yml or use /sairdrop edit to set crate rewards

[5] Configure airdrop times in config.yml (e.g. 12:00, 18:00)

[6] Watch players race for epic loot

━━━━━━━━━━━━━━━━━━━━
► Example Configuration
━━━━━━━━━━━━━━━━━━━━

airdrop:
Start:
Time:
- "12:00"
- "18:00"

Crates:
Legendary:
enabled: true
Appearance: "&6&lLEGENDARY &fCrate"
Block: "ENDER_CHEST"
Spawn-chance: 10

━━━━━━━━━━━━━━━━━━━━
► Example Reward (Legendary)
━━━━━━━━━━━━━━━━━━━━

- item: NETHERITE_SWORD
amount: 1
chance: 30
name: "&6&lLEGENDARY BLADE"

enchants:
SHARPNESS: 5
LOOT_BONUS_MOBS: 2

━━━━━━━━━━━━━━━━━━━━
► Supported Versions
━━━━━━━━━━━━━━━━━━━━

Supports Minecraft 1.18.x – 1.21.x with official Folia support.

Fully compatible with:

■ Survival

■ Skyblock

■ Factions

■ Prison

■ Creative

■ And more

━━━━━━━━━━━━━━━━━━━━
► Need Help?
━━━━━━━━━━━━━━━━━━━━

Join our community for support, suggestions, and updates:

https://dsc.gg/solar-studios