☀️ RealWeather - Real World Weather in Minecraft

Transform your Minecraft server with realistic weather synced from any city in the world! RealWeather brings the real world into your game using the OpenWeather API.

🌟 Why RealWeather?

🌍 Real-Time Sync - Weather updates from any city worldwide
⚙️ Fully Automatic - Set it and forget it with configurable intervals
🎮 Full Control - Override with manual commands anytime
🗺️ Multi-World - Choose which worlds get synced weather
⛈️ Customizable - Control thunder, duration, and more
🚀 Lightweight - Async API calls, zero lag

⚡ Quick Start

Install plugin in plugins/ folder
Get free API key at OpenWeather
Edit config.yml with your API key and city
Run /rw reload and /rw update
Enjoy realistic weather!

🎮 Commands

/rw info - View current settings
/rw update - Force weather update
/rw reload - Reload configuration
/rw toggle - Enable/disable auto-sync
/rw setcity <city> - Change city

Full tab completion support!

🔐 Permissions

Perfect for LuckPerms, PermissionsEx, and more!

realweather.admin - Full access (OP)
realweather.info - View info (Everyone)
realweather.update - Force updates (OP)
realweather.reload - Reload config (OP)
realweather.setcity - Change city (OP)

⚙️ Configuration

api:
  key: "YOUR_API_KEY_HERE"
  city: "Moscow"

worlds:
  - "world"
  - "survival"

sync:
  enabled: true
  interval: 15  # minutes

weather:
  enable-thunder: true
  time-multiplier: 1.0

debug: false

🌦️ Weather Types

Real weather intelligently converts to Minecraft:

☀️ Clear/Cloudy → Clear Sky
🌧️ Rain/Drizzle → Rain
⛈️ Thunderstorm → Thunder Storm
❄️ Snow → Rain with snow particles
🌫️ Fog/Mist → Clear

💡 Features

✅ Automatic Updates - Weather syncs every 15-30 minutes ✅ Manual Control - Force update anytime with commands ✅ Per-World Config - Choose which worlds sync ✅ Thunder Toggle - Enable/disable storms ✅ Duration Control - Extend or shorten weather (0.5x-3x) ✅ Debug Mode - Detailed logging for troubleshooting ✅ Async Operations - No server lag from API calls ✅ Smart Caching - Respects API rate limits ✅ Modern UI - Beautiful colored messages ✅ LuckPerms Ready - Full permission support

📋 Requirements

Server: Paper 1.21+
Java: 21+
API Key: Free at OpenWeather

🔗 Links

📚 Full Documentation
🐛 Report Issues
🔑 Get API Key
💬 Discord: [Your Discord]

📊 Performance

RAM Usage: ~2MB
API Response: <500ms
Free API Limit: 1,000 calls/day
Recommended Interval: 15-30 minutes
No Database: Simple YAML config

🎯 Perfect For

Survival servers wanting realistic weather
Roleplay servers needing immersion
City-themed servers matching real locations
Adventure maps set in real places
Any server wanting dynamic weather!

💬 Support

Need help? Have suggestions?

Open an issue on GitHub
Join our Discord community
Check the full README for detailed guides

Bring the real world into Minecraft! ⛅