🌧️ 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:
- Command arguments (highest priority)
- config.yml defaults
- 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.
