🌠 Starfall

Starfall brings celestial events to your Minecraft server. Witness meteors streak across the night sky and crash into the world, leaving behind star shards loot and permanent craters for players to discover.

✨ Features

🌌 Natural Events

• Nightly Phenomenon: Falling stars naturally spawn during night time in configured worlds
• Smart Targeting: Meteors target areas near players, ensuring discoverability
• Visual Spectacle: Beautiful particle trails and explosion effects
• Immersive Audio: Custom sound effects for meteors and impacts

🗺️ Exploration & Discovery

• Permanent Craters: Meteors create lasting impact sites filled with volcanic materials
• Compass Tracking: Use /starfall compass to point your compass to the nearest impact site
• Coordinate Locator: Use /starfall locate to find exact coordinates and distances

💎 Valuable Loot

• Star Shards: Collectible prismarine crystals with enchanted glow
• Fallen Star Core: Rare nether star drops with special properties

⚙️ Server Management

• Fully Configurable: Control spawn rates, cooldowns, crater sizes, and more
• World Management: Enable/disable starfalls in specific worlds
• Admin Commands: Force meteor events with /starfall now
• Permission Support: starfall.use and starfall.admin permissions

🎮 Commands

• /starfall compass - Points your compass to nearest impact site
• /starfall locate - Shows coordinates of nearest impact site
• /starfall now - Forces a starfall event (admin)

🔧 Configuration

Easily customize everything in the config.yml:

# How often to run the starfall check loop (ticks). 20 ticks = 1 second.
check-interval-ticks: 200

# Probability per check to spawn a star if it is night and cooldown passed.
chance-per-check: 0.12

# Minimum seconds between starfalls in the same world.
world-cooldown-seconds: 300

# Radius of the impact crater.
crater-radius: 4

# How many recent sites to remember per world (used by /starfall compass and locate).
max-sites-remembered: 5

# Worlds where starfalls are active. If empty, all NORMAL worlds are used.
enabled-worlds:
  - world

# Shard drop range from a single impact.
shards:
  min: 2
  max: 6

# Chance for a rare Fallen Star Core to drop from an impact.
core-drop-chance: 0.08

# Runtime data. Do not edit manually unless you know what you're doing.
sites: {}