Meteoriti

Meteors that actually fly — a real bezier flight path, kinetic-energy-based terrain destruction, procedural craters, and screen shake on impact. Beyond the physics, it's a small platform: any meteor type can carry loot, spawn guardians, infect the land, or turn its impact site into a zone regular players can't enter.

Everything you'd want to tweak often — loot, guardians, drop schedules, restricted zones, even particles and sounds — is configured in-game through /meteor menu. No server restarts, no YAML editing.

[hr]
✨ Features

Meteors

• Realistic bezier-curve flight with kinetic-energy-based block destruction — punches through terrain until it runs out of "energy," not an instant explosion
• Procedural, jagged craters (Perlin noise) with debris, shockwave rings, and knockback
• Auto-switches between full visual simulation and a lightweight mode when no player is nearby — an idle auto-spawner costs almost nothing
• Optional "solid body" meteors that leave an actual boulder in the crater
• Meteor showers (/meteor shower) with an automatic day/night time-lapse
• Auto-spawner: random meteors near random online players
• Optional pre-impact warning (sound + text, configurable delay)

Loot & guardians

• Any meteor type can drop a loot chest at its impact site
• Contents edited visually — opens a real chest interface, place items like a normal chest. Full NBT/enchants/custom names supported
• Optional guardian mobs (7 hostile types, configurable count) around the chest

Scheduled auto-drops

• Any type can fall automatically N times per day/week/month, fully automatic
• Configurable announcement: chat, action bar, boss bar, or silent — with optional coordinates

Infection system

• Optional per-type infection: impact sites spread outward, converting terrain to obsidian/basalt/dead coral organically
• A redstone-based shield is needed to safely mine infected blocks — without one: mining fatigue, blindness, chance of a hostile "Void Mite"
• Infected zones persist across restarts

Restricted zones

• Any type can be flagged "not free" — its impact creates a zone regular players can't enter
• Temporary (auto-expires) or permanent (admin-only removal)
• Real, guaranteed knockback with a "time remaining" message
• Bypass permission for staff: meteoriti.zone.bypass

Full in-game GUI
/meteor menu — every meteor type's materials, particles, sounds, explosion physics, infection, warnings, camera shake, loot, guardians, schedule, and zones, all editable with instant apply.

Other

• config.yml (hand-editable, fully commented) + GUI-managed overrides layer — GUI saves never strip your config comments
• Bundled localization: Ukrainian and English out of the box
• Async GitHub-based update checker — never auto-installs, just notifies

[hr]
️ Commands
All under /meteor (permission meteoriti.use, default: op)

• /meteor spawn <type> — spawn a single meteor near you
• /meteor shower <type> <count> <seconds> <radius> — start a meteor shower
• /meteor time <speed> / time stop — day/night time-lapse
• /meteor autospawn start [min] [max] / stop — toggle the auto-spawner
• /meteor menu — open the in-game configuration GUI
• /meteor reload config / reload plugin — reload config/language or fully restart
• /meteor update — check GitHub for a newer version
• /meteor zone list / zone clear — manage restricted zones
• /meteor infection status / infection clear — manage infection zones
• /meteor help — command list in-game

[hr]
Bundled meteor types

• main — Ender-touched, portal particles, strong proximity damage
• fast — fire, quick and lightweight
• slow — ice, slow, minimal damage
• giant — colossal impact, 15-block debris cluster, huge crater
• white — festive variant of main
• zaraza — plague meteor, infection enabled, long camera shake

All fully editable in config.yml — add as many custom types as you want.

[hr]
Requirements
Paper or a Paper fork (Purpur, etc.), Minecraft 1.21+, Java 21+. Not compatible with vanilla/Spigot-only servers (uses Paper-specific APIs).

[hr]

DISCORD - https://discord.gg/2dPFvFDRCH