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

Spawn Alert:
- Dragon roar + Wither spawn sounds
- Title: "⭐ METEORITE! ⭐ LOOK UP NOW! 👆"
- Chat messages with emojis
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!
Impact:
- MASSIVE explosion with particles and sounds
- Crater formation with blackstone/cobblestone
- Diamond block buried in center
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

Download the JAR file
Place in plugins/ folder
Restart server
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! 🌠🔥✨

UnqiueMeteorites