UnqiueMeteorites

UniqueMeteorites 🌠

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

✨ Features

🔥 Auto Events - Spinning fire charge entity with massive particle trail ☁️ Auto Events - 4-block radius glowing orange cloud 🔥 Auto Events - 10 burning entities trailing behind showing the path 📦 Auto Events - Rises from underground with effects 💎 Auto Events - Space-themed items with unique names ⏱️ Auto Events - Very slow! Plenty of time to watch 🌙 Auto Events - Every 3-4 nights automatically

🎮 Commands

``` /met test ``` LOOK UP IMMEDIATELY! `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%):

- ✨ Cosmic Crystal - Nether Star (burning core of a fallen star) - ✨ Cosmic Crystal - Fire Charges (burning pieces from space) - ✨ Cosmic Crystal - Magma Blocks (solidified meteorite material) - ✨ Cosmic Crystal - End Crystal (crystallized star essence)

Epic (15%):

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

Uncommon (30%):

- ✦ Star Crystals - 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. Very slow fall - Giant Very slow fall spinning through the sky - Very slow fall (4 blocks wide) - Very slow fall trailing behind in a line - Very slow fall (flames, sparks, smoke, glow) - Very slow fall marking the path - Very slow fall (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

UP - 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

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

📝 Credits

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

---

Enjoy the meteor show! 🌠🔥✨