☀️ 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

1. Install plugin in plugins/ folder
2. Get free API key at OpenWeather
3. Edit config.yml with your API key and city
4. Run /rw reload and /rw update
5. 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! ⛅

Made with ❤️ by EGN | Powered by OpenWeather API