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 - **4 Loot Tiers** — Common, Rare, Epic, and Legendary drops each with their own loot pools, intervals, and effects - **Fully Configurable** — intervals, spawn boundaries, chest type, loot tables, messages, and more all in `config.yml` - **Enchanted Loot** — armour and tools spawn with appropriate enchantments based on tier - **World Announcements** — all players are notified when a drop lands, with coordinates - **Title Overlays** — configurable title screen alerts for Rare, Epic, and Legendary drops - **Fireworks** — Legendary drops trigger a fireworks display on landing - **Lightning Effects** — Epic and Legendary drops strike lightning on spawn - **Despawn Timer** — unclaimed drops despawn after a configurable time - **Looting Detection** — announces which player claimed the drop - **Enable/Disable Toggle** — 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 | |---|---|---| | **Common** | 40 hours | Iron armour set, tools, food, arrows | | **Rare** | 52 hours | Diamond armour set, tools, bow, shield, XP | | **Epic** | 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.*