UnqiueMeteorites

# 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: ```yaml # 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:** ```yaml 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!** 🌠🔥✨