RealWeather

RealWeather is a powerful Paper plugin that synchronizes your Minecraft server's weather with real-world weather using the OpenWeather API. Experience realistic weather conditions based on any city in the world!

✨ Features

• 🌍 Real-Time Weather Sync - Get weather from any city worldwide via OpenWeather API
• ⚙️ Automatic Updates - Weather syncs automatically at configurable intervals (15-30 minutes recommended)
• 🎮 Manual Control - Force update weather anytime with commands
• 🗺️ Per-World Configuration - Choose which worlds should have synced weather
• ⛈️ Thunder Control - Toggle thunderstorms on/off even during rain
• ⏱️ Duration Multiplier - Extend or shorten weather duration (0.5x to 3x)
• 🔍 Debug Mode - Detailed logging for troubleshooting
• 🔐 LuckPerms Compatible - Full permission system support
• 🎨 Modern UI - Beautiful colored messages using MiniMessage API
• 🚀 Lightweight - Minimal performance impact, async API calls

📋 Requirements

• Server: Paper 1.21 or higher (Spigot not supported)
• Java: 21 or higher
• API Key: Free OpenWeather API key (Get one here)

📥 Installation

1. Download the latest RealWeather-X.X.X.jar from Releases
2. Place the JAR file in your server's plugins/ folder
3. Restart your server
4. Get a free API key from OpenWeather
5. Edit plugins/RealWeather/config.yml and insert your API key
6. Run /rw reload to apply changes
7. Use /rw update to test the weather sync

⚙️ Configuration

After first launch, edit plugins/RealWeather/config.yml:

# OpenWeather API settings
api:
  key: "YOUR_API_KEY_HERE"  # Get from https://openweathermap.org/api
  city: "Moscow"             # City name (supports multi-word cities)

# Worlds where weather synchronization applies
worlds:
  - "world"
  - "survival"

# Synchronization settings
sync:
  enabled: true    # Enable automatic weather updates
  interval: 15     # Update interval in minutes (15-30 recommended)

# Weather settings
weather:
  enable-thunder: true      # Enable thunderstorms during storms
  time-multiplier: 1.0      # Weather duration multiplier (1.0 = normal)

# Debug mode - logs detailed API information
debug: false

Configuration Options Explained

Option	Description	Default	Recommended
api.key	Your OpenWeather API key	YOUR_API_KEY_HERE	Get free key
api.city	City name for weather data	Moscow	Any valid city name
worlds	List of worlds to sync	[world, survival]	Your world names
sync.enabled	Enable automatic updates	true	true
sync.interval	Minutes between updates	15	15-30 (avoid API limits)
weather.enable-thunder	Enable thunder effects	true	true
weather.time-multiplier	Weather duration multiplier	1.0	0.5-3.0
debug	Enable debug logging	false	false (enable for troubleshooting)

🎮 Commands

All commands support tab completion!

Command	Description	Permission	Aliases
/rw reload	Reload configuration	realweather.reload	-
/rw update	Force update weather now	realweather.update	-
/rw info	Show plugin information	realweather.info	-
/rw toggle	Toggle automatic sync on/off	realweather.toggle	-
/rw setcity <city>	Change target city	realweather.setcity	-
/rw help	Show help message	realweather.use	-

Command Aliases: /realweather, /weather

Command Examples

/rw info                  # View current settings
/rw update                # Force weather update immediately
/rw setcity London        # Change to London weather
/rw setcity New York      # Works with multi-word cities
/rw toggle                # Disable/enable automatic sync
/rw reload                # Reload config after changes

🔐 Permissions

Perfect for LuckPerms, PermissionsEx, or any permission plugin!

Permission	Description	Default
realweather.admin	Full access to all commands	OP
realweather.reload	Reload configuration	OP
realweather.update	Force update weather	OP
realweather.info	View plugin information	Everyone
realweather.toggle	Toggle automatic sync	OP
realweather.setcity	Change city	OP
realweather.use	Basic command access	Everyone

LuckPerms Setup Example

# Give all permissions to admins
lp group admin permission set realweather.admin true

# Allow specific user to force updates
lp user PlayerName permission set realweather.update true

# Let all players view info
lp group default permission set realweather.info true

🌦️ Weather Conversion

RealWeather intelligently converts real-world weather to Minecraft weather:

Real Weather	OpenWeather Code	Minecraft Weather
☀️ Clear Sky	800	Clear
☁️ Cloudy	801-804	Clear
🌧️ Rain	500-531	Rain
🌦️ Drizzle	300-321	Rain
⛈️ Thunderstorm	200-232	Thunder (or Rain if disabled)
❄️ Snow	600-622	Rain (with snow particles)
🌫️ Fog/Mist	701-781	Clear