☄ 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 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 [player]	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:

# 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:

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:

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 target-radius blocks, so events always happen where people can see them.

How do I stop meteors temporarily? Run /ms toggle (persists across restarts) or set enabled: false and /ms reload.

---

📄 License & Credits

Built by PolaPlugs — Powered by polafy.com

Enjoy the show. ☄