Files
RealTimeWeather/README.md
2025-08-09 20:51:42 +00:00

109 lines
3.4 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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!