# RealTimeWeather

**RealTimeWeather** ist ein Bukkit/Spigot/Paper-Plugin, das echte Wetter- und Zeitdaten aus der realen Welt in deine Minecraft-Welt synchronisiert und live auf der Actionbar anzeigt – inklusive Temperatur, Wettericon, Luftfeuchtigkeit, Windstärke und Sonnenauf-/untergang.

## ⭐ Features

- Echte Wetter- und Uhrzeit-Synchronisation pro Welt
- Anzeige auf der Actionbar:  
  Datum, Uhrzeit, Wetter-Icon, Temperatur, Luftfeuchtigkeit 💧, Windgeschwindigkeit 🌬️, Sonnenaufgang 🌅 & Sonnenuntergang 🌇
- Eigene Location pro Spieler möglich (GUI & Befehl)
- Ingame-Vorhersage (5 Tage) als Command
- Wetterumschaltung auf Server synchron mit echten Wetterdaten (optional)
- Volle Mehrsprachigkeit über lang.yml
- Kompatibel mit Minecraft 1.19.x – 1.21.x

## 🔧 Installation

1. **Kopiere die Dateien:**<br>
   Die JAR nach `/plugins/` kopieren, Server neu starten.
2. **OpenWeatherMap API-Key** im `/plugins/RealTimeWeather/config.yml` eintragen:

api-key: "DEIN_OPENWEATHERMAP_API_KEY"

Registriere gratis unter https://openweathermap.org.

3. **Plugin starten/neu laden:**<br>
`reload` Befehl (`/wetter reload`) oder Server-Neustart.

## ⚙️ Kurzes Setup

- Die wichtigsten Einstellungen sind in der `config.yml` dokumentiert (siehe unten).
- Du kannst für jede Welt eigene Locations, Anzeige-Modi oder Wettertypen setzen.

## 🕹️ Kommandos

| Befehl                | Beschreibung                                 |
|-----------------------|-----------------------------------------------|
| `/wetter help`        | Alle Befehle und Kurzinfos anzeigen           |
| `/wetter reload`      | Konfiguration und Sprache neu laden           |
| `/wetter setlocation <city,country>` | Eigene Stadt für Anzeige wählen        |
| `/wetter query`       | Zeigt das aktuelle Wetter für dich an         |
| `/wetter info`        | Infos zum Plugin                              |
| `/wetter gui`         | Öffnet das GUI mit Schnell-Optionen           |
| `/weatherforecast`    | 5-Tage-Wetterprognose deiner Location         |
| `/toggleweather`      | Actionbar-Wetteranzeige für Welt (de)aktivieren |

## 📊 Live-Anzeige (Actionbar)

Beispiel:

08.08.2025 18:31 ☁️ 21.7°C | 💧 68% | 🌬️ 2.5 m/s | 🌅 05:48 | 🌇 21:34

´´´yaml
## 📝 Beispiel-config.yml

api-key: "DEIN_API_KEY_HIER"
update-interval: 60

defaults:
enabled: true
location: "Berlin,de"
units: "metric"
time-format: "24h"
display-actionbar: true
display-weather-icon: true

display-position / padding-right werden zentriert ignoriert
display-position: "top-right"
padding-right: 100
sync-in-game-weather: true

worlds:
world:
enabled: true
location: "Berlin,de"
units: "metric"
time-format: "24h"
display-actionbar: true
display-weather-icon: true
display-position: "top-left"
padding-right: 50
sync-in-game-weather: true
world_nether:
enabled: false
location: "Berlin,de"
units: "metric"
time-format: "24h"
display-actionbar: true
display-weather-icon: false
display-position: "top-right"
padding-right: 150
sync-in-game-weather: false
´´´


## 🧑‍💻 Erweiterungen

- Anzeige von Feuchtigkeit, Wind & Sonnenzeiten kann leicht deaktiviert/angepasst werden (siehe Actionbar-Code).
- Ländercodes und Städte werden in OpenWeatherMap-Syntax verwendet, z. B. `London,gb`, `Frankfurt,de`.

## ❤️ Lizenz

[MIT License](LICENSE)

---

> Fragen, Feature-Wünsche oder Bugreports gerne als Gitea-Issue!