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

# 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.