🌧️ ItemRainPro

ItemRainPro is a modern, highly configurable Paper/Spigot/Bukkit plugin (Minecraft 1.20+) that lets you create spectacular item rain events where items fall from the sky in randomized bursts, creating chaotic, fun, and visually impressive server-wide moments.

Designed for SMP servers, events, minigames, and content creators, ItemRainPro is fully server-side, lightweight, and optimized for performance.

✨ Features

🌧️ Custom Item Rain Events

Trigger powerful item rain events using a simple command:

/itemrain <items> <amount> [radius] [duration]

• Supports multiple items (comma-separated)
• Fully randomized sky drops
• Continuous item spawning during the event
• Adjustable intensity and duration

🎯 Fully Configurable System

ItemRainPro is completely driven by configuration files, giving you full control over gameplay behavior:

• Default radius and duration
• Drop rate per tick
• Spawn height offset
• Maximum items per second
• Global cooldown system
• Performance-safe limits (prevents overload)
• 🌍 Smart Spawn Mechanics

Items are spawned using an advanced randomized system:

• Random X/Z positions within radius
• Dynamic Y-level selection (sky-based spawning)
• Smooth continuous drops over time
• Realistic “falling rain” effect
• Configurable spawn density via drop rate

⚙️ Priority System for Settings

The plugin intelligently determines values in this order:

1. Command arguments (highest priority)
2. config.yml defaults
3. internal fallback values

This ensures maximum flexibility without breaking behavior.

📢 Event Lifecycle Announcements

ItemRainPro broadcasts immersive server messages during each phase:

• ⏳ Event starting countdown
• 🌧️ Event started announcement
• 🛑 Event ended notification

All messages support placeholders:

• %starter% → player who triggered the event
• %time% → countdown time remaining

💬 Language Support (language.yml)

Fully customizable messages:

• Starting event alerts
• Event activation broadcast
• Event ending notification

Example:

• ItemRain starts in %time% seconds!
• ItemRain has started!
• ItemRain has ended!

🔔 Discord Webhook Integration

Keep your community informed even outside Minecraft:

• Event start countdown notifications
• Event started alerts
• Event ended logs

Fully configurable webhook support via:

discord:
  enabled: true
  webhook-url: "YOUR_WEBHOOK_URL"

🔐 Permission System

Core Permission

• itemrain.use → Allows usage of /itemrain

Admin Control

• itemrain.admin → Full control over events, bypass cooldowns

Cooldown Bypass

• itemrain.bypass.cooldown → Ignores global cooldown restrictions

🧠 Tab Completion Support

Smart tab suggestions for smoother command usage:

• Amount, radius, duration suggestions
• Context-aware command hints
• Multi-level argument support

⚡ Performance Optimized

Built with efficiency in mind:

• No lag spikes during events
• Controlled spawn rates
• Maximum item cap protection
• Lightweight scheduler-based system

🎮 Use Cases

ItemRainPro is perfect for:

• SMP server events
• PvP chaos events
• Community fun nights
• Content creation & livestreams
• Minigame rewards or chaos modes

🚀 Requirements

• Paper/Spigot/Bukkit 1.20+
• Java 17+
• Server-side only (no client mods required)

❤️ Support

If you need help or want to suggest features, feel free to reach out.