FAQ

HZ-Weather unterstuetzt QBCore, ESX, QBX und den Standalone-Modus. Das Framework wird beim Start automatisch erkannt — keine manuelle Konfiguration erforderlich.

Ja. HZ-Weather ist vollstaendig kompatibel mit OneSync und OneSync Infinity. Die Wettersynchronisation nutzt GlobalState und State Bags fuer optimale Leistung.

Nein. Sie muessen alle anderen Wetterskripte deaktivieren, bevor Sie HZ-Weather verwenden. Zwei aktive Wetterskripte fuehren zu visuellen und Synchronisationskonflikten.

Zu stoppende Skripte: vSync, qb-weathersync, cd_easytime, esx_weather usw.

HZ-Weather ersetzt automatisch qb-weathersync und cd_easytime ueber die provide-Direktive und stellt deren exports fuer Abwaertskompatibilitaet bereit.

Nein. HZ-Weather ist auf minimalen Einfluss optimiert: 0,00 ms im Ruhezustand clientseitig, ~0,08 ms bei aktiven Ereignissen (Tornado, Tsunami). Der serverseitige Einfluss ist vernachlaessigbar.

• ox_lib v3.0+
• oxmysql v2.0+
• PolyZone

Pruefen Sie:

1. Der Ordner heisst exakt hz_weather


2. Das Skript befindet sich in Ihrem resources/-Verzeichnis (z. B. resources/[standalone]/hz_weather/)


3. Ihre Lizenz ist aktiv auf keymaster.fivem.net


4. Sie verwenden dasselbe FiveM-Konto, das mit Ihrem Tebex-Kauf verknuepft ist

Das ist normal, wenn Sie standalone (ohne Framework) arbeiten. Das Skript verwendet dann den Standalone-Modus.

Falls Sie ein Framework haben, stellen Sie sicher, dass es_extended oder qb-core in Ihrer server.cfg mit ensure vor hz_weather geladen wird.

Hz-Weather erstellt die Tabellen beim ersten Start automatisch. Falls dies fehlschlaegt:

1. Pruefen Sie, ob oxmysql laeuft und korrekt konfiguriert ist


2. Ueberpruefen Sie, ob Ihr Datenbankbenutzer die CREATE TABLE-Berechtigung hat


3. Importieren Sie als letzten Ausweg manuell sql/install.sql

1. Laden Sie die neueste Version von Keymaster herunter
2. Sichern Sie Ihren config/-Ordner
3. Ersetzen Sie alle Dateien ausser config/
4. Pruefen Sie den Changelog auf neue Konfigurationsparameter
5. Starten Sie die Ressource neu: ensure hz_weather

1. Pruefen Sie, ob Sie die ACE-Berechtigung haben: hz_weather.admin

   add_ace group.admin hz_weather.admin allow

1. Pruefen Sie auf kollidierende Ressourcen, die dieselbe Tastenkombination verwenden
2. Versuchen Sie, die Ressource neu zu starten: ensure hz_weather

• Stellen Sie sicher, dass die Datenbank erreichbar ist (ueberpruefen Sie den oxmysql-Status)
• Pruefen Sie die F8-Konsole auf JavaScript-Fehler
• Starten Sie die Ressource neu, um eine Datensynchronisation zu erzwingen

Pruefen Sie diese Einstellungen in config/config.lua:

• Config.DynamicWeather = true (muss aktiviert sein)


• Config.FreezeWeather = false (darf nicht eingefroren sein)


• Config.WeatherChangeInterval (Standard: 600 Sekunden = 10 Minuten)

exports['hz_weather']:setZoneWeather('all', 'XMAS')
-- Oder fuer eine bestimmte Zone:
exports['hz_weather']:setZoneWeather('Mount Chiliad', 'XMAS')

Entfernen oder deaktivieren Sie in config/weather_types.lua die schneebezogenen Wettertypen (SNOW, SNOWLIGHT, BLIZZARD, XMAS).

Oder entfernen Sie in den Jahreszeiten-Presets (config/seasons.lua) die Schneetypen aus allen Wettersequenzen.

Erhoehen Sie Config.ZoneTransitionDistance in config/config.lua. Der Standardwert ist 800.0 Meter. Ein hoeherer Wert erzeugt eine breitere Mischzone zwischen den Zonen.

Sie koennen auch Config.WeatherInfluence.enabled = true aktivieren, damit sich benachbarte Zonen natuerlich vermischen.

1. Stellen Sie sicher, dass PolyZone vor hz_weather in der server.cfg gestartet wird
2. Pruefen Sie die Serverkonsole auf Datenbankfehler
3. Ueberpruefen Sie, ob die Zonen in der Datenbank existieren (Tabelle hz_weather_zones)
4. Versuchen Sie, eine Zone ueber das Admin-Panel zu erstellen, um zu testen

exports['hz_weather']:createZone({
    name = 'ma_zone',
    label = 'Meine benutzerdefinierte Zone',
    center = vector3(x, y, z),
    radius = 1500.0,
    shape = 'circle',
    priority = 1,
    weather = 'CLEAR',
})

Jede Jahreszeit definiert eine Wettersequenz (z. B. Sommer = EXTRASUNNY -> CLEAR -> CLOUDS -> CLEARING), die automatisch durchlaufen wird. Jahreszeiten steuern auch die Temperaturbereiche und Windprofile.

Drei Zyklusmodi sind verfuegbar:

• disabled — Nur manuelle Steuerung (ueber Admin-Panel oder Befehle)


• auto — Rotation durch 4 Jahreszeiten auf einem Timer (Standard: 120 Minuten fuer den vollstaendigen Zyklus)


• realtime — Reale Kalendermonate werden auf Jahreszeiten abgebildet

Die Temperatur wird ueber die Wetter-Handy-Apps (LB Phone / QS Smartphone) und optional im HUD angezeigt. Die Einheit ist konfigurierbar in Config.TemperatureUnit — 'C' fuer Celsius oder 'F' fuer Fahrenheit.

Der realtime-Modus verwendet die Serverzeit (die Uhr Ihres Rechners). Wenn Ihr Server in UTC laeuft, folgen die Jahreszeiten dem UTC-Kalender. Passen Sie zur Einstellung die Zeitzone Ihres Server-Rechners an.

1. Pruefen Sie, ob Config.Tornado.Enabled = true und Config.Tsunami.Enabled = true in der Konfiguration stehen
2. Sie benoetigen die Admin-ACE-Berechtigung (hz_weather.admin)
3. Befehle: /tornado start, /tornado stop, /tsunami start, /tsunami stop

Passen Sie die Kraefte in config/config.lua an:

• Config.Tornado.PullForce — Anziehungskraft zum Zentrum


• Config.Tornado.LiftForce — Vertikale Auftriebskraft


• Config.Tornado.SpinForce — Rotationskraft

Der Tsunami verwendet LoadWaterFromPath — dieser native Aufruf erfordert einen gueltigen Wasserpfad. Ueberpruefen Sie, ob die Wasserdatendatei in der Ressource vorhanden ist und ob der Server diesen nativen Aufruf unterstuetzt.

Pruefen Sie, ob Config.GameplayEffects.VehicleTraction.enabled = true in der Konfiguration steht. Die Standardmodifikatoren sind: Regen 70%, Schnee 50%, Blizzard 30% der normalen Haftung.

Erhoehen Sie die Hysterese-Schwellenwerte in der Konfiguration:

• Config.GameplayEffects.PlayerEffects.ColdHysteresis — Temperaturband vor erneuter Kaelteausloesung


• Config.GameplayEffects.PlayerEffects.HeatHysteresis — Gleiches fuer Hitze

Jeder Gameplay-Effekt hat seinen eigenen Schalter in config/config.lua:

Config.GameplayEffects = {
    VehicleTraction = { enabled = true },
    ReducedVisibility = { enabled = true },
    AutoWipers = { enabled = true },
    AutoHeadlights = { enabled = true },
    PlayerEffects = { enabled = true },
    SpeedReduction = { enabled = true },
    AmbientSounds = { enabled = true },
    SyncedLightning = { enabled = true },
    Blackout = { enabled = true },
}

Setzen Sie enabled = false, um einzelne Effekte zu deaktivieren.

• LB Phone — Dedizierte Wetter-App (kostenlos, separate Ressource)
• QS Smartphone V3 — Dedizierte Wetter-App (kostenlos, separate Ressource)
• QS Smartphone V2 (Pro) — Legacy-Version (verwenden Sie die App v1.x)

QS Smartphone V3 verwendet ein eingebautes natives Wetter-App-System. Die HZ-Weather-App muss diesen nativen Eintrag ersetzen, was eine einzeilige Aenderung in der QS Smartphone-Konfigurationsdatei erfordert. Dies ist eine Einschraenkung der QS V3-Architektur, nicht von HZ-Weather.

Ja. Verwenden Sie die eigenstaendige map.html-Seite per Iframe:

<iframe src="https://cfx-nui-hz_weather/web/dist/map.html"
  style="width:100%;height:100%;border:none" />

Sie zeigt Zonen, Wetter, Temperatur, Wind und Jahreszeiteninformationen mit automatischer Aktualisierung an.