ItemRainPro

[!(https://wsrv.nl/?url=https%3A%2F%2Fcdn.jsdelivr.net%2Fnpm%2F%40intergrav%2Fdevins-badges%403%2Fassets%2Fcozy%2Fdonate%2Fkofi-singular_vector.svg&n=-1)](https://ko-fi.com/alekkss_/tip)

# 🌧️ 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.

!(https://cdn.modrinth.com/data/cached_images/1b739a3528386c7bc8baff3959b170ecf0ec10f8.png)

## ✨ Features ### 🌧️ Custom Item Rain Events

Trigger powerful item rain events using a simple command:

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

!(https://dhozvkf4o988s.cloudfront.net/2egxg%2Fpreview%2F78052190%2Fmain_large.gif?response-content-disposition=inline%3Bfilename%3D%22main_large.gif%22%3B&response-content-type=image%2Fgif&Expires=1778340773&Signature=DJXFR6uGUzaEzVRa3eyNp33SArbERkEbezaDil~MTwrxkyweE6VLfRYM5Lcm9rIr~P-oNlMDN6MNFHRF3CZPpWPCn06xJW8QmXtzwj8LdBek9VfyvAo-T4plV3RQE6B3suSRz3G571a9MNehDrKZkNWzhmQPTm1N2dbXTMflM9rA8SV~HS4PB-qgQt-mJS0WFrU2yMCBg6F7zxtBaJkKcP87ZbjNeA54wFCXHt1BqiJZUZEwVwvs1IhYLRntfq4g3ISAw0bqEAsk--Z9vfcMpHj-xIHJg5HUF~vRwCrXtltP4KdOMr5aftVrs2hS2ywg97iyhlCtLDYIns6aFwxSLw__&Key-Pair-Id=APKAJT5WQLLEOADKLHBQ)

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

!(https://cdn.modrinth.com/data/cached_images/4032e32b165ecaf7266b228082671d60094ad3e7.png)

## 💬 Language Support (language.yml)

Fully customizable messages:

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

• ```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

!(https://cdn.modrinth.com/data/cached_images/2bc03a5c35a1f74951c3420947d4785f6ca3c4d0_0.webp)

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.