️ RandomRain
RandomRain is a Minecraft Bukkit/Spigot plugin that causes random block items to fall from the sky around players. It supports both manual and automatic activation, with configurable settings and sound effects.

✨ Features

• Trigger random item/block rain using a command.
  
  
• Items fall randomly within a configurable radius around players.
  
  
• Automatic rain every 10 minutes if at least one player is online.
  
  
• Configurable duration, radius, and items per tick.
  
  
• Plays rain sound during the event.
  
  
• Automatically removes all dropped items 5 seconds after rain ends.
  
  
• Supports command execution by players and console.
  
  
• Ability to manually stop rain at any time.

Commands
/randomrain [duration] [radius] [items_per_tick]
Starts a random rain event.

• All parameters are optional:
  • duration (seconds) — how long the rain lasts. Default: 15
    
    
  • radius (blocks) — radius around players where items fall. Default: 15
    
    
  • items_per_tick — how many items drop each tick. Default: 1
• If executed by the console, rain occurs for all online players.

Example: /randomrain 20 10 3

/randomrain stop

• Immediately stops the rain.
  
  
• Stops the rain sound.
  
  
• Removes all dropped items.

/randomrain help
Displays a help message with command usage instructions.

Permissions

• randomrain.use — Allows use of the /randomrain command (start/stop).

⚙️ Configuration (config.yml)

duration_seconds: 15
radius_blocks: 15
items_per_tick: 1

• duration_seconds: Duration of the rain in seconds.
  
  
• radius_blocks: Radius around players where items fall.
  
  
• items_per_tick: Number of items dropped per tick (every 0.1 seconds).

Messages (messages.yml)
You can customize all plugin messages with color codes (&), including:

• no-permission — Shown when a player lacks permission.
  
  
• rain-start — Broadcast when rain starts.
  
  
• rain-ended — Broadcast when rain ends.
  
  
• rain-stopped — Shown when rain is manually stopped.
  
  
• no-rain-active — Shown if you try to stop rain when none is active.
  
  
• no-players-online — Shown when console tries to start rain but no players are online.

⚙️ How It Works

1. Every 10 minutes, the plugin checks if any players are online.
   
   
2. If at least one player is online and no rain is currently active, it automatically starts a rain.
   
   
3. During rain:
   • Random block items (excluding fluids, potions, anvils, etc.) fall from 20 blocks above players.
     
     
   • Rain sound is played for affected players.
4. When the rain ends, all dropped items are cleared after 5 seconds to avoid clutter or lag.

Installation

1. Download the latest RandomRain.jar.
   
   
2. Place it in your server’s plugins folder.
   
   
3. Start or reload the server.
   
   
4. Edit config.yml and messages.yml as desired.
   
   
5. Use the /randomrain command manually or wait for automatic rain every 10 minutes.

Support
For support or feature requests, please contact the plugin author.

Enjoy raining blocks in your Minecraft world! ☔