MeteorShowers

# ☄ MeteorShowers **Survival-friendly random meteor shower events with warnings, craters, and loot.** MeteorShowers adds dramatic, dynamic meteor events to your world without wrecking your builds. Meteors are announced ahead of time, streak down as a chunky glowing mass, explode into a controllable crater, and reward nearby players with configurable loot — including a custom **Meteorite Fragment**. Everything is tunable, and every default is chosen to stay grief-safe. > Powered by (https://polafy.com) --- ## ✨ Features - **⏱ Automatic random events** — Meteors fall on a randomized timer you control (default every 5–20 minutes). - **📢 Advance warnings** — Players get a heads-up broadcast (default 30s out) plus a final impact-imminent alert 5 seconds before landing. Optionally reveal exact coordinates. - **☄ Chunky falling meteor** — The meteor is rendered as a solid sphere of falling blocks (not a single cube) with a smooth velocity-driven descent and particle trail. Fully resizable. - **💥 Grief-safe impacts** — Low default explosion power, optional block-breaking craters, and fire spread disabled by default to protect builds. - **⚔ Configurable loot table** — Drop iron, gold, diamonds, netherite scrap, enchanted gear, golden apples, and more — each with its own drop chance and stack range. - **🌟 Custom Meteorite Fragment** — A fully customizable named/lored collectible item that drops from impacts. - **🎯 Player-targeted spawning** — Meteors land within a configurable radius of players, so events always feel relevant. - **🛠 Full admin control** — Toggle, reload, and manually summon meteors in-game. - **🎨 Fully customizable messages** — Every broadcast and response supports color codes and placeholders. --- ## 📥 Installation 1. Download `MeteorShowers-1.0.0.jar`. 2. Drop it into your server's `plugins/` folder. 3. Restart the server (or run a plugin loader). 4. Edit `plugins/MeteorShowers/config.yml` to taste and run `/ms reload`. **Requirements** | | | |---|---| | **Platform** | Paper / Spigot | | **Minecraft** | 1.21+ | | **Dependencies** | None | --- ## 🎮 Commands Base command: `/meteorshowers`  •  Aliases: `/ms`, `/meteor` | Command | Description | |---|---| | `/ms toggle` | Enable or disable automatic meteor showers (persisted to config). | | `/ms reload` | Reload the configuration from disk. | | `/ms summon ` | Summon a meteor near the given player (or yourself if omitted). | --- ## 🔑 Permissions | Permission | Description | Default | |---|---|---| | `meteorshowers.admin` | Access to all MeteorShowers admin commands. | `op` | --- ## ⚙ Configuration A quick tour of the key settings in `config.yml`: ```yaml # Master switch (also toggled by /ms toggle) enabled: true # Random minutes between automatic events min-interval-minutes: 5 max-interval-minutes: 20 # Impact behaviour (kept low & grief-safe by default) explosion-power: 3.0 # Vanilla TNT is 4.0 explosion-breaks-blocks: true # false = visuals + damage + loot only fire-spread: false # Damage falloff around the impact damage-radius: 10 damage-amount: 6.0 # half-hearts at the center # Warnings warning-seconds-before: 30 broadcast-coordinates: true # Where meteors can land relative to players target-radius: 40 # Visible meteor body meteor-size: 1.5 # ~19-block clump; 2.5 = larger boulder meteor-block: MAGMA_BLOCK # NETHERRACK, BLACKSTONE, BASALT, OBSIDIAN... ``` ### Loot table Each entry defines a `material`, a `chance` (0.0–1.0), a `min`/`max` stack size, and an optional `enchant: true` to roll a random enchantment: ```yaml loot-table: - material: IRON_INGOT chance: 0.9 min: 2 max: 8 - material: DIAMOND chance: 0.35 min: 1 max: 3 - material: DIAMOND_SWORD chance: 0.15 min: 1 max: 1 enchant: true ``` ### Custom Meteorite Fragment A signature collectible that drops from impacts — fully renameable and re-lorable: ```yaml meteorite-fragment: enabled: true chance: 1.0 min: 1 max: 4 material: NETHER_STAR name: "&b☄ Meteorite Fragment" lore: - "&7A shard of stone forged in" - "&7the cold void between worlds." - "&8Fallen from the sky." ``` ### Messages & placeholders All messages support `&` color codes. Available placeholders: | Placeholder | Meaning | |---|---| | `{coords}` | Impact coordinates | | `{world}` | World name | | `{seconds}` | Seconds until impact | | `{player}` | Target player name (summon messages) | --- ## ❓ FAQ **Will meteors destroy my builds?** By default the explosion power is low (`3.0`) and fire spread is off. Set `explosion-breaks-blocks: false` for zero terrain damage — you'll still get the falling visuals, damage, and loot. **Can I make bigger meteors?** Yes — raise `meteor-size` (try `2.0`–`2.5`). Keep it modest to avoid spawning too many falling-block entities at once. **Do meteors only fall near players?** Yes. They target players within `