HZ Scripts

Installation

Etape 1 — Telechargement

HZ-Bridge est un asset gratuit. Telechargez-le depuis le shop Hz-Scripts ou votre FiveM Keymaster :

  1. Connectez-vous sur keymaster.fivem.net
  2. Allez dans Granted Assets
  3. Telechargez HZ-Bridge
HZ-Bridge est requis par toutes les ressources Hz-Scripts. Si vous l'avez deja installe, vous n'avez qu'a le mettre a jour quand une nouvelle version est publiee.

Etape 2 — Fichiers

  1. Extrayez l'archive
  2. Placez le dossier HZ-Bridge dans votre repertoire resources/
server/
├── resources/
│   ├── [standalone]/
│   │   ├── HZ-Bridge/
│   │   │   ├── bridge/
│   │   │   ├── modules/
│   │   │   │   ├── callback/
│   │   │   │   ├── dispatch/
│   │   │   │   ├── framework/
│   │   │   │   ├── inventory/
│   │   │   │   ├── menu/
│   │   │   │   ├── minigame/
│   │   │   │   ├── notify/
│   │   │   │   └── target/
│   │   │   ├── shared/
│   │   │   ├── config.lua
│   │   │   └── fxmanifest.lua
Le nom du dossier doit etre HZ-Bridge (sensible a la casse sur les serveurs Linux).

Etape 3 — server.cfg

Ajoutez HZ-Bridge a votre server.cfg avant tout Hz-Script qui en depend :

# Framework (si applicable)
ensure es_extended

ensure qb-core



HZ-Bridge (avant tous les Hz-Scripts)

ensure HZ-Bridge


Vos Hz-Scripts

ensure HZ-Television
ensure HZ-Weather

ensure hz-phone
L'ordre de demarrage est critique ! HZ-Bridge doit demarrer apres votre framework mais avant tout Hz-Script qui l'utilise.

Etape 4 — Configuration (optionnel)

Ouvrez config.lua pour personnaliser la detection. Par defaut, tout est regle sur 'auto' et fonctionne directement.

Consultez la page Configuration pour toutes les options.

Etape 5 — Verification

Demarrez votre serveur et verifiez la console pour :

[HZ Bridge] v1.0.0 | Framework: qbcore | Inventory: ox_inventory | Notify: ox_lib | Dispatch: builtin | Target: ox_target | Menu: ox_lib
Termine ! Si vous voyez la ligne de detection avec vos systemes correctement identifies, HZ-Bridge fonctionne. Tous les Hz-Scripts l'utiliseront desormais automatiquement.

Mise a jour

  1. Telechargez la derniere version depuis Keymaster
  2. Remplacez tous les fichiers (il n'y a pas de config utilisateur a conserver — config.lua est minimal)
  3. Redemarrez : ensure HZ-Bridge, puis redemarrez vos Hz-Scripts
Les mises a jour de HZ-Bridge sont retrocompatibles. Vos Hz-Scripts existants continueront de fonctionner apres une mise a jour.

Depannage

HZ-Bridge ne detecte pas mon framework
  • Assurez-vous que votre framework (es_extended, qb-core, qbx_core) est ensure avant HZ-Bridge
  • Verifiez que le nom de la ressource est exact (sensible a la casse)
  • Si vous voulez forcer un framework, definissez HZBridge.Framework = 'esx' (ou 'qbcore', etc.) dans config.lua
Un script dit "HZ-Bridge not found"
  • Verifiez que HZ-Bridge est dans votre server.cfg avec ensure HZ-Bridge
  • Assurez-vous que le dossier est nomme exactement HZ-Bridge
  • HZ-Bridge doit demarrer avant le script qui en a besoin
Mauvais systeme detecte

Si l'auto-detection choisit le mauvais systeme (par ex. le mauvais inventaire), vous pouvez le forcer dans config.lua :

HZBridge.Inventory = 'ox_inventory'  -- Force specific inventory