FAQ

Hz-Weather Pro supporte QBCore, ESX, QBX et le mode Standalone. Le framework est detecte automatiquement au demarrage — aucune configuration manuelle necessaire.

Oui. Hz-Weather Pro est entierement compatible avec OneSync et OneSync Infinity. La synchronisation meteo utilise GlobalState et les state bags pour des performances optimales.

Non. Vous devez desactiver tous les autres scripts meteo avant d'utiliser Hz-Weather Pro. Avoir deux scripts meteo actifs causera des conflits visuels et de synchronisation.

Scripts a arreter : vSync, qb-weathersync, cd_easytime, esx_weather, etc.

Hz-Weather Pro remplace automatiquement qb-weathersync et cd_easytime via la directive provide et expose leurs exports pour la retrocompatibilite.

Non. Hz-Weather Pro est optimise pour un impact minimal : 0.00 ms au repos cote client, ~0.08 ms pendant les evenements actifs (tornade, tsunami). L'impact cote serveur est negligeable.

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

Verifiez que :

1. Le dossier s'appelle exactement HZ-Weather


2. Le script est dans votre repertoire resources/ (ex: resources/[standalone]/HZ-Weather/)


3. Votre licence est active sur keymaster.fivem.net


4. Vous utilisez le meme compte FiveM lie a votre achat Tebex

C'est normal si vous etes 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 cree les tables automatiquement au premier demarrage. Si ca echoue :

1. Verifiez que oxmysql tourne et est configure correctement


2. Verifiez que votre utilisateur de base de donnees a les permissions CREATE TABLE


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

1. Telechargez la derniere version depuis Keymaster
2. Sauvegardez votre dossier config/
3. Remplacez tous les fichiers sauf config/
4. Consultez le Changelog pour les nouveaux parametres de config
5. Redemarrez la ressource : ensure HZ-Weather

1. Verifiez que vous avez la permission ACE : hz_weather.admin

   add_ace group.admin hz_weather.admin allow

1. Verifiez les ressources en conflit utilisant le meme raccourci
2. Essayez de redemarrer la ressource : ensure HZ-Weather

• Assurez-vous que la base de donnees est accessible (verifiez le statut d'oxmysql)
• Verifiez la console F8 pour les erreurs JavaScript
• Redemarrez la ressource pour forcer une synchronisation des donnees

Verifiez ces reglages dans config/config.lua :

• Config.DynamicWeather = true (doit etre active)


• Config.FreezeWeather = false (ne doit pas etre gele)


• Config.WeatherChangeInterval (defaut : 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 desactivez les types de meteo lies a la neige (SNOW, SNOWLIGHT, BLIZZARD, XMAS).

Ou dans les presets de saisons (config/seasons.lua), supprimez les types neige de toutes les sequences meteo.

Augmentez Config.ZoneTransitionDistance dans config/config.lua. La valeur par defaut est 800.0 metres. Une valeur plus elevee cree une zone de melange plus large entre les zones.

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

1. Assurez-vous que PolyZone est demarre avant HZ-Weather dans server.cfg
2. Verifiez la console serveur pour les erreurs de base de donnees
3. Verifiez que les zones existent en base de donnees (table hz_weather_zones)
4. Essayez de creer 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 definit une sequence meteo (ex: Ete = EXTRASUNNY → CLEAR → CLOUDS → CLEARING) qui cycle automatiquement. Les saisons controlent aussi les plages de temperature et les profils de vent.

Trois modes de cycle sont disponibles :

• disabled — Controle manuel uniquement (via panneau admin ou commandes)


• auto — Rotation a travers 4 saisons sur un timer (defaut : 120 minutes pour le cycle complet)


• realtime — Fait correspondre les mois reels du calendrier aux saisons

La temperature est affichee via les applications meteo telephone (LB Phone / QS Smartphone) et optionnellement dans le HUD. L'unite 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. Verifiez 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 levee verticale


• Config.Tornado.SpinForce — force de rotation

Le tsunami utilise LoadWaterFromPath — cette fonction native necessite un chemin d'eau valide. Verifiez que le fichier de donnees d'eau est present dans la ressource et que le serveur supporte cette fonctionnalite native.

Verifiez que Config.GameplayEffects.VehicleTraction.enabled = true dans la config. Les modificateurs par defaut 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 temperature 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 desactiver individuellement.

• LB Phone — Application meteo dediee (gratuite, ressource separee)
• QS Smartphone V3 — Application meteo dediee (gratuite, ressource separee)
• QS Smartphone V2 (Pro) — Version legacy (utilisez la v1.x de l'app)

QS Smartphone V3 utilise un systeme d'application meteo native integre. L'app HZ-Weather doit remplacer cette entree native, ce qui necessite 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 meteo, la temperature, le vent et les infos de saison avec rafraichissement automatique.