UniqueMeteorites 🌠

A Spigot/Paper 1.21 plugin that adds spectacular falling meteorites with custom loot and stunning visual effects!

✨ Features

🔥 Burning Meteorite - Spinning fire charge entity with massive particle trail
☁️ Giant Area Cloud - 4-block radius glowing orange cloud
🔥 Fire Trail - 10 burning entities trailing behind showing the path
📦 Animated Chest - Rises from underground with effects
💎 Custom Meteorite Loot - Space-themed items with unique names
⏱️ 45 Second Fall - Very slow! Plenty of time to watch
🌙 Auto Events - Every 3-4 nights automatically

🎮 Commands

/met test

Permission: meteor.test (default: op)
Spawns a meteorite near you. LOOK UP IMMEDIATELY! 👆

/met reload

Permission: meteor.reload (default: op)
Reloads the plugin configuration without restarting

💎 Meteorite Loot

All items are space-themed with custom names and lore:

Legendary (5%):

• ⭐ Meteorite Core - Nether Star (burning core of a fallen star)
• 🔥 Meteor Fragments - Fire Charges (burning pieces from space)
• 💎 Space Rock - Magma Blocks (solidified meteorite material)
• ✨ Cosmic Crystal - End Crystal (crystallized star essence)

Epic (15%):

• ✦ Stardust - Blaze Powder (fine powder from a meteor)
• ⭐ Space Dust - Glowstone Dust (luminous cosmic particles)
• ◆ Meteorite Scrap - Netherite Scrap (dense space metal)

Uncommon (30%):

• ◆ Cosmic Obsidian - Obsidian (hardened by space travel)
• ✦ Star Crystals - Prismarine Crystals (crystallized cosmic energy)

Common (50%):

• • Space Iron - Iron Ingots (metal from the meteorite)

Plus: Diamond block buried under the chest!

🎯 What You'll See

1. Spawn Alert:

   • Dragon roar + Wither spawn sounds
   • Title: "⭐ METEORITE! ⭐ LOOK UP NOW! 👆"
   • Chat messages with emojis

2. 45 Second Fall:

   • Giant burning fire charge spinning through the sky
   • Orange glowing cloud (4 blocks wide)
   • 10 fire entities trailing behind in a line
   • 2000+ particles per tick (flames, sparks, smoke, glow)
   • Light blocks marking the path
   • Atmospheric sounds (fire whooshing, crackling)
   • Very slow fall - plenty of time to enjoy!

3. Impact:

   • MASSIVE explosion with particles and sounds
   • Crater formation with blackstone/cobblestone
   • Diamond block buried in center

4. Chest Animation:

   • Chest rises from underground over 1 second
   • Glowing particles + amethyst chimes
   • Firework burst when fully spawned
   • Contains 4-8 meteorite items

⚙️ Configuration

Basic Settings:

# Event frequency (every 3-4 nights)
event:
  min-nights-interval: 3
  max-nights-interval: 4

# Fall speed (0.2 = 45 seconds)
meteorite:
  movement-speed: 0.2

# Visual effects
effects:
  particle-intensity: 40
  sound-volume: 0.9

Customizable Meteorite Items:

All meteorite loot is fully customizable in config.yml!

Example from config:

loot:
  legendary:
    enabled: true
    items:
      - type: NETHER_STAR
        amount: 1
        name: "§6§l⭐ §6Meteorite Core §6§l⭐"
        lore:
          - "§7The burning core of a fallen star"
          - "§eStill warm to the touch"
          - "§5§oLegendary"

You can:

• ✅ Change item types (NETHER_STAR, FIRE_CHARGE, etc.)
• ✅ Customize amounts (use ranges like 3-7)
• ✅ Edit names with color codes
• ✅ Add custom lore
• ✅ Enable/disable entire rarity tiers
• ✅ Add more items to each tier

📥 Installation

1. Download the JAR file
2. Place in plugins/ folder
3. Restart server
4. Done!

Requirements: Paper/Spigot 1.21 + Java 21

🐛 Troubleshooting

Can't see it?

• Look UP at the sky immediately!
• Spin in a circle while looking up
• Listen for dragon roar sound
• Try at night for best visibility
• Increase particle-intensity in config

No chest?

• Wait 1 second after impact
• Look in the crater center
• Check ground is not bedrock

Lag?

• Reduce particle-intensity to 20
• Set light-trail: false
• Increase movement-speed to 1.0

🎨 Technical

• Entities: 12 per meteorite (1 core + 1 cloud + 10 trail)
• Fall Time: 45 seconds (configurable - can make faster/slower)
• Performance: < 0.2 TPS impact
• Cleanup: Automatic entity/block removal

📝 Credits

Author: Flonxi
Version: 1.0
API: Paper/Spigot 1.21

---

Enjoy the meteor show! 🌠🔥✨