Installation

Pre-requis

Dependance	Version minimum	Lien	Cout
HZ-Bridge	v1.0.0+	Boutique Hz-Scripts	Gratuit
ox\_lib	v3.0.0+	overextended/ox\_lib	Gratuit
oxmysql	v2.0.0+	overextended/oxmysql	Gratuit
PolyZone	latest	mkafrin/PolyZone	Gratuit

HZ-Bridge est une dependance partagee gratuite utilisee par toutes les ressources Hz-Scripts. Installez-la une seule fois — si vous l'avez deja depuis un autre Hz-Script, pas besoin de la retelecharger (gardez-la juste a jour).

Hz-Weather Pro est standalone — il fonctionne avec QBCore, ESX, QBX, ou sans framework du tout. La detection du framework est geree automatiquement par HZ-Bridge.

Etape 1 — Telechargement

Apres votre achat sur Tebex, telechargez le script depuis votre FiveM Keymaster :

Connectez-vous sur keymaster.fivem.net
Allez dans Granted Assets
Telechargez HZ-Weather

Important : utilisez le meme compte FiveM que celui lie a votre licence Tebex. Le script est protege par escrow et necessite une licence valide.

Etape 2 — Fichiers

Extrayez l'archive
Placez le dossier HZ-Weather dans votre repertoire de ressources

server/
├── resources/
│   ├── [standalone]/
│   │   ├── HZ-Weather/
│   │   │   ├── client/
│   │   │   ├── server/
│   │   │   ├── classes/
│   │   │   ├── config/
│   │   │   │   ├── config.lua
│   │   │   │   ├── seasons.lua
│   │   │   │   ├── weather_types.lua
│   │   │   │   ├── zones.lua
│   │   │   │   └── locales/
│   │   │   │       ├── en.lua
│   │   │   │       └── fr.lua
│   │   │   ├── compatibility/
│   │   │   ├── web/
│   │   │   │   └── dist/
│   │   │   ├── sql/
│   │   │   │   └── install.sql
│   │   │   └── fxmanifest.lua

Le nom du dossier doit etre HZ-Weather (sensible a la casse sur les serveurs Linux).

Etape 3 — Base de donnees

Hz-Weather utilise oxmysql et cree ses tables automatiquement au premier demarrage. Aucune importation SQL manuelle n'est necessaire.

Tables creees automatiquement :

Table	Fonction
`hz_weather_config`	Surcharges de config persistantes
`hz_weather_zones`	Definitions des zones meteo
`hz_weather_seasons`	Etat du cycle de saisons
`hz_weather_history`	Historique meteo (analytics)
`hz_weather_blackout`	Etat du blackout

Si vous preferez creer les tables manuellement, vous pouvez importer sql/install.sql — mais c'est optionnel.

Etape 4 — server.cfg

Ajoutez le script a votre server.cfg apres votre framework et vos dependances :

# Dependances (requises)
ensure ox_lib
ensure oxmysql
ensure PolyZone

Framework (optionnel — un des suivants)
ensure qb-core
ensure es_extended

HZ-Bridge (avant tous les Hz-Scripts)
ensure HZ-Bridge

Hz-Weather Pro
ensure HZ-Weather

L'ordre de demarrage est important ! HZ-Bridge doit demarrer apres votre framework mais avant HZ-Weather. L'ordre complet est : Framework → Dependances → HZ-Bridge → HZ-Weather.

Etape 5 — Permission admin

Hz-Weather utilise une permission ACE pour l'acces admin. Ajoutez ceci a votre server.cfg :

add_ace group.admin hz_weather.admin allow

Ou accordez-la a un joueur specifique :

add_ace identifier.license:xxxxxxxx hz_weather.admin allow

Le nom de la permission est configurable dans config/config.lua :

Config.AdminPermission = 'hz_weather.admin'

Etape 6 — Configuration

Editez les fichiers dans config/ selon votre serveur :

Fichier	Fonction
`config/config.lua`	Configuration principale (meteo, temps, effets, catastrophes)
`config/seasons.lua`	Presets et durees du cycle de saisons
`config/zones.lua`	Definitions des zones meteo par defaut
`config/locales/en.lua`	Traductions anglaises
`config/locales/fr.lua`	Traductions francaises

Voir la page Configuration pour un detail complet de chaque option.

Etape 7 — Compatibilite

Hz-Weather remplace ces ressources automatiquement via la directive provide dans le fxmanifest.lua :

qb-weathersync (synchronisation meteo QBCore)
cd_easytime (CD Easy Time)

Vous pouvez sans risque supprimer ou arreter ces ressources — HZ-Weather expose les memes exports et evenements pour une retrocompatibilite complete.

Compatibilite vSync

HZ-Weather inclut une couche de compatibilite vSync qui intercepte les evenements vSync:toggle, vSync:updateWeather, et vSync:requestSync. Cela signifie que les scripts qui dependent de vSync (garages, interieurs, etc.) fonctionnent automatiquement sans aucune modification de code.

Par exemple, les garages qui forcent la meteo CLEAR a l'interieur et appellent vSync:requestSync a la sortie se resynchroniseront correctement avec la meteo de zone de HZ-Weather.

Desactivez tous les autres scripts meteo avant d'utiliser Hz-Weather Pro. Avoir deux scripts meteo en cours d'execution causera des conflits visuels. Scripts a arreter : vSync, qb-weathersync, cd_easytime, esx_weather, etc.

Etape 8 — Verification

Demarrez (ou redemarrez) votre serveur
Connectez-vous en jeu
Ouvrez le panneau d'administration
Verifiez la console serveur pour :

[Hz-Weather Pro] v1.0.0 initialized — Framework: standalone
[Hz-Weather Pro] Database ready — X zones loaded

C'est termine ! Si le panneau admin s'ouvre et que la console ne montre aucune erreur, le script est pret. Rendez-vous sur Configuration pour tout personnaliser.

Mise a jour

Sauvegardez votre dossier config/
Remplacez tous les fichiers sauf config/
Redemarrez la ressource : ensure HZ-Weather

Vos surcharges de configuration en base de donnees sont preservees automatiquement entre les mises a jour.

Depannage

Le script ne demarre pas

Verifiez que :

Le dossier s'appelle exactement HZ-Weather
Le script est liste dans votre server.cfg avec ensure
Votre licence FiveM est valide sur Keymaster
HZ-Bridge est demarre avant HZ-Weather
Les dependances (ox_lib, oxmysql, PolyZone) demarrent avant le script

Erreur "Framework not detected"

La detection du framework est geree par HZ-Bridge. Assurez-vous que :

HZ-Bridge est ensure avant HZ-Weather
Votre framework (es_extended, qb-core, qbx_core) est ensure avant HZ-Bridge
Les noms de ressources correspondent exactement (sensible a la casse)
Si aucun framework n'est present, le script tourne en mode standalone — c'est normal
Voir Configuration HZ-Bridge si la detection automatique choisit le mauvais framework

Le panneau admin ne s'ouvre pas

Verifiez que vous avez la permission ACE : hz_weather.admin
Verifiez les ressources en conflit utilisant le meme raccourci
Essayez de redemarrer la ressource : ensure HZ-Weather

La meteo ne change pas

Assurez-vous que Config.DynamicWeather = true
Assurez-vous que Config.FreezeWeather = false
Verifiez qu'aucune autre ressource meteo ne tourne encore

Les zones ne se chargent pas

Assurez-vous que PolyZone est demarre avant HZ-Weather
Verifiez la console serveur pour les erreurs de base de donnees
Verifiez que oxmysql tourne et que votre connexion a la base fonctionne

Les commandes tornade / tsunami ne fonctionnent pas

Assurez-vous que Config.Tornado.Enabled = true et Config.Tsunami.Enabled = true dans la config
Vous avez besoin de la permission ACE admin
Utilisez /tornado start ou /tsunami start

Vous ne trouvez pas votre reponse ? Rejoignez notre Discord et ouvrez un ticket !