FAQ

HZ-Weather supporte QBCore, ESX, QBX et le mode Standalone. Le framework est détecté automatiquement au démarrage — aucune configuration manuelle nécessaire.

Oui. HZ-Weather est entièrement compatible avec OneSync et OneSync Infinity. La synchronisation météo utilise GlobalState et les state bags pour des performances optimales.

Non. Vous devez désactiver tous les autres scripts météo avant d'utiliser HZ-Weather. Avoir deux scripts météo actifs causera des conflits visuels et de synchronisation.

Scripts à arrêter : vSync, qb-weathersync, cd_easytime, esx_weather, etc.

HZ-Weather remplace automatiquement qb-weathersync et cd_easytime via la directive provide et expose leurs exports pour la rétrocompatibilité.

Non. HZ-Weather est optimisé pour un impact minimal : 0.00 ms au repos côté client, ~0.08 ms pendant les événements actifs (tornade, tsunami). L'impact côté serveur est négligeable.

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

Verifiez que :

1. Le dossier s'appelle exactement hz_weather


2. Le script est dans votre répertoire resources/ (ex: resources/[standalone]/hz_weather/)


3. Votre licence est activé sur keymaster.fivem.net


4. Vous utilisez le même compte FiveM lié à votre achat Tebex

C'est normal si vous êtes en standalone (sans framework). Le script utilisera le mode standalone.

Si vous avez un framework, assurez-vous que es_extended ou qb-core est ensure avant hz_weather dans votre server.cfg.

Hz-Weather crée les tables automatiquement au premier démarrage. Si ça échoue :

1. Vérifiez que oxmysql tourne et est configure correctement


2. Vérifiez que votre utilisateur de base de données a les permissions CREATE TABLE


3. En dernier recours, importez manuellement sql/install.sql

1. Téléchargez la dernière version depuis Keymaster
2. Sauvegardez votre dossier config/
3. Remplacez tous les fichiers sauf config/
4. Consultez le Changelog pour les nouveaux paramètres de config
5. Redémarrez la ressource : ensure hz_weather

1. Vérifiez que vous avez la permission ACE : hz_weather.admin

   add_ace group.admin hz_weather.admin allow

1. Vérifiez les ressources en conflit utilisant le même raccourci
2. Essayez de redémarrer la ressource : ensure hz_weather

• Assurez-vous que la base de données est accessible (vérifiez le statut d'oxmysql)
• Vérifiez la console F8 pour les erreurs JavaScript
• Redémarrez la ressource pour forcer une synchronisation des données

Vérifiez ces réglages dans config/config.lua :

• Config.DynamicWeather = true (doit être activé)


• Config.FreezeWeather = false (ne doit pas être gelé)


• Config.WeatherChangeInterval (défaut : 600 secondes = 10 minutes)

exports['hz_weather']:setZoneWeather('all', 'XMAS')
-- Ou pour une zone specifique :
exports['hz_weather']:setZoneWeather('Mount Chiliad', 'XMAS')

Dans config/weather_types.lua, supprimez ou désactivez les types de météo liés à la neige (SNOW, SNOWLIGHT, BLIZZARD, XMAS).

Ou dans les presets de saisons (config/seasons.lua), supprimez les types neige de toutes les séquences météo.

Augmentez Config.ZoneTransitionDistance dans config/config.lua. La valeur par défaut est 800.0 mètres. Une valeur plus élevée crée une zone de mélange plus large entre les zones.

Vous pouvez aussi activer Config.WeatherInfluence.enabled = true pour que les zones voisines se mélangent naturellement.

1. Assurez-vous que PolyZone est démarre avant hz_weather dans server.cfg
2. Vérifiez la console serveur pour les erreurs de base de données
3. Vérifiez que les zones existent en base de données (table hz_weather_zones)
4. Essayez de créer une zone depuis le panneau admin pour tester

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

Chaque saison définit une séquence météo (ex: Été = EXTRASUNNY → CLEAR → CLOUDS → CLEARING) qui cycle automatiquement. Les saisons contrôlent aussi les plages de température et les profils de vent.

Trois modes de cycle sont disponibles :

• disabled — Contrôle manuel uniquement (via panneau admin ou commandes)


• auto — Rotation à travers 4 saisons sur un timer (défaut : 120 minutes pour le cycle complet)


• realtime — Fait correspondre les mois réels du calendrier aux saisons

La température est affichée via les applications météo téléphone (LB Phone / QS Smartphone) et optionnellement dans le HUD. L'unité est configurable dans Config.TemperatureUnit — 'C' pour Celsius ou 'F' pour Fahrenheit.

Le mode realtime utilise le temps serveur (l'horloge de votre machine). Si votre serveur est en UTC, les saisons suivent le calendrier UTC. Pour ajuster, configurez le fuseau horaire de votre machine serveur.

1. Vérifiez que Config.Tornado.Enabled = true et Config.Tsunami.Enabled = true dans la config
2. Vous avez besoin de la permission ACE admin (hz_weather.admin)
3. Commandes : /tornado start, /tornado stop, /tsunami start, /tsunami stop

Ajustez les forces dans config/config.lua :

• Config.Tornado.PullForce — force d'attraction vers le centre


• Config.Tornado.LiftForce — force de levée verticale


• Config.Tornado.SpinForce — force de rotation

Le tsunami utilise LoadWaterFromPath — cette fonction native nécessite un chemin d'eau valide. Vérifiez que le fichier de données d'eau est présent dans la ressource et que le serveur supporte cette fonctionnalité native.

Vérifiez que Config.GameplayEffects.VehicleTraction.enabled = true dans la config. Les modificateurs par défaut sont : pluie 70%, neige 50%, blizzard 30% de l'adherence normale.

Augmentez les seuils d'hysterese dans la config :

• Config.GameplayEffects.PlayerEffects.ColdHysteresis — bande de température avant de re-declencher le froid


• Config.GameplayEffects.PlayerEffects.HeatHysteresis — idem pour la chaleur

Chaque effet de gameplay a son propre toggle dans 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 },
}

Mettez enabled = false pour désactiver individuellement.

• LB Phone — Application météo dédiée (gratuite, ressource séparée)
• QS Smartphone V3 — Application météo dédiée (gratuite, ressource séparée)
• QS Smartphone V2 (Pro) — Version legacy (utilisez la v1.x de l'app)

QS Smartphone V3 utilise un système d'application météo native intégré. L'app HZ-Weather doit remplacer cette entrée native, ce qui nécessite une modification d'une ligne dans le fichier config de QS Smartphone. C'est une limitation de l'architecture de QS V3, pas de HZ-Weather.

Oui. Utilisez la page map.html autonome via iframe :

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

Elle affiche les zones, la météo, la température, le vent et les infos de saison avec rafraîchissement automatique.