SupplyDrops

SupplyDrops

Timed, tiered supply drops that land across your world — packed with loot and built for survival servers.

SupplyDrops automatically spawns loot-filled copper chests at random locations across your world on a configurable schedule. Four rarity tiers keep the economy interesting, from casual Common drops to rare Legendary events that shake the whole server.

---

✦ Features

- Auto Updater — Common, Rare, Epic, and Legendary drops each with their own loot pools, intervals, and effects - Auto Updater — intervals, spawn boundaries, chest type, loot tables, messages, and more all in `config.yml` - Auto Updater — armour and tools spawn with appropriate enchantments based on tier - Auto Updater — all players are notified when a drop lands, with coordinates - Auto Updater — configurable title screen alerts for Rare, Epic, and Legendary drops - Auto Updater — Legendary drops trigger a fireworks display on landing - Auto Updater — Epic and Legendary drops strike lightning on spawn - Auto Updater — unclaimed drops despawn after a configurable time - Auto Updater — announces which player claimed the drop - Auto Updater — pause all drops at any time with `/sd disable` and resume with `/sd enable`, state persists across restarts - Auto Updater — automatically checks Modrinth for new versions and downloads them to your update folder

---

🗂 Loot Tiers

| Tier | Default Interval | Chest Contents | |---|---|---| | Legendary | 40 hours | Iron armour set, tools, food, arrows | | Legendary | 52 hours | Diamond armour set, tools, bow, shield, XP | | Legendary | 4 days | Netherite armour set, full toolset, bow, crossbow, trident, EGA, totem | | Legendary | 9 days | Full netherite set, all tools, mace, trident, EGAs, totems, netherite ingots |

All gear spawns enchanted — helmets with Respiration and Aqua Affinity, boots with Feather Falling, swords with Sharpness and Fire Aspect, and so on.

---

⚙ Commands

| Command | Permission | Description | |---|---|---| | `/sd info` | Everyone | Show status and time until each next drop | | `/sd force <rarity>` | Op | Force a drop to spawn immediately | | `/sd reload` | Op | Reload config and restart timers | | `/sd enable` | Op | Enable all supply drops | | `/sd disable` | Op | Disable all supply drops | | `/enabledrops` | Op | Alias for `/sd enable` | | `/disabledrops` | Op | Alias for `/sd disable` |

---

🔧 Configuration

```yaml

Chest type for supply drops

chest_type: COPPER_CHEST

drops: common: enabled: true interval: 144000 # 40 hours in seconds despawn_after: 1800 # 30 minutes announce: true effects: lightning: false title: true title_text: "&7&l📦 A Common Supply Drop has landed!" fireworks: false loot: min_items: 3 max_items: 5 items: - IRON_HELMET:1 - IRON_CHESTPLATE:1 - IRON_LEGGINGS:1 - IRON_BOOTS:1

... and more

spawn: world: world min_x: -500 max_x: 500 min_z: -500 max_z: 500 min_y: 60 search_from_sky: true ```

All loot pools are fully editable. Add or remove any valid Minecraft material in `MATERIAL:AMOUNT` format. Enchantments are applied automatically based on item type.

---

📦 Installation

1. Drop the jar into your `plugins/` folder 2. Restart your server 3. Edit `plugins/SupplyDrops/config.yml` to your liking 4. Use `/sd reload` to apply changes without restarting

Requires Paper 1.21+

---

*Built for Paper 1.21.11 — may work on other Paper 1.21.x builds.*