🌦️ Atmosync

Synchronize Minecraft weather with real-world weather.

Atmosync is a lightweight Paper plugin that synchronizes Minecraft weather with real-world weather using Open-Meteo.

✨ Features

• 🌍 Real-world weather synchronization
• 🏙️ City + country location search
• 📍 Manual coordinates
• 🌧️ Clear weather & rain
• ⛈️ Thunderstorms
• ❄️ Snow detection
• 🌎 Configurable Minecraft world
• ⏱️ Configurable update interval
• 🔄 Manual weather updates
• ♻️ Configuration reload
• ⌨️ Tab completion
• 🔑 No API key required

⚙️ Configuration

📍 Location

Atmosync can find your location using a city and country:

location:
  city: "Moscow"
  country: "Russia"

You can also use exact coordinates:

location:
  city: "Moscow"
  country: "Russia"

  coordinates:
    enabled: true
    latitude: 55.75204
    longitude: 37.61781

Tip: Manual coordinates are especially useful for small villages or locations that cannot be found through the city search.

🌎 World

Choose which Minecraft world should receive the synchronized weather:

world:
  name: "world"

⏱️ Update Interval

The weather update interval is configured in seconds:

weather:
  update-interval: 300

💬 Commands

/atmosync status

Displays the current Atmosync configuration and weather information, including:

• Configured location
• Minecraft world
• Location mode
• Current weather
• Current temperature

This command is available to all players.

/atmosync update

Manually requests a new weather update from Open-Meteo.

Requires OP.

The weather request is performed asynchronously so it does not block the Minecraft server.

/atmosync reload

Reloads the Atmosync configuration and restarts the weather synchronization task using the new settings.

Requires OP.

⌨️ Tab Completion

Atmosync provides tab completion for its commands.

Administrative commands such as update and reload are only suggested to operators.

🌦️ How It Works

Real World → Open-Meteo → Atmosync → Minecraft World

Atmosync periodically checks the current weather at your configured location and applies the corresponding weather conditions to Minecraft.

Weather data is retrieved asynchronously, while Minecraft world changes are safely performed on the server's main thread.

🌨️ Weather Detection

Atmosync uses Open-Meteo weather codes to determine the current weather condition.

Supported conditions include:

• ☀️ Clear
• 🌧️ Rain
• ⛈️ Thunderstorms
• ❄️ Snow

Minecraft precipitation is then updated according to the detected weather condition.

📦 Requirements

• Minecraft: 1.21.1
• Server: Paper
• Java: 21

🌐 Weather Data

Atmosync uses Open-Meteo for weather and geocoding data.

No API key or account is required.

Open-Meteo

🔐 Security

Administrative commands are restricted to server operators.

Players without operator permissions cannot use:

• /atmosync update
• /atmosync reload

🚧 Development Status

Atmosync 1.0.0 is the first public release.

The plugin is actively being developed, and more features and improvements are planned.

📄 License

See the project's repository for license information.