HZ Scripts

Installation

Étape 1 — Téléchargement

hz_lib 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. Téléchargez hz_lib
hz_lib est requis par toutes les ressources Hz-Scripts. Si vous l'avez déjà installé, vous n'avez qu'a le mettre à jour quand une nouvelle version est publiée.

Étape 2 — Fichiers

  1. Extrayez l'archive
  2. Placez le dossier hz_lib dans votre répertoire resources/
server/
├── resources/
│   ├── [standalone]/
│   │   ├── hz_lib/
│   │   │   ├── bridge/
│   │   │   ├── modules/
│   │   │   │   ├── callback/
│   │   │   │   ├── dispatch/
│   │   │   │   ├── framework/
│   │   │   │   ├── inventory/
│   │   │   │   ├── menu/
│   │   │   │   ├── minigame/
│   │   │   │   ├── notify/
│   │   │   │   └── target/
│   │   │   ├── shared/
│   │   │   ├── config.lua
│   │   │   └── fxmanifest.lua
Le nom du dossier doit être hz_lib (sensible à la casse sur les serveurs Linux).

Étape 3 — server.cfg

Ajoutez hz_lib à votre server.cfg avant tout Hz-Script qui en dépend :

# Framework (si applicable)
ensure es_extended
# ensure qb-core

# hz_lib (avant tous les Hz-Scripts)
ensure hz_lib

# Vos Hz-Scripts
ensure hz_television
ensure hz_weather
# ensure hz-phone

L'ordre de démarrage est critique ! hz_lib doit démarrer après votre framework mais avant tout Hz-Script qui l'utilise.

Étape 4 — Configuration (optionnel)

Ouvrez config.lua pour personnaliser la détection. Par défaut, tout est règle sur 'auto' et fonctionne directement.

Consultez la page Configuration pour toutes les options.

Étape 5 — Vérification

Démarrez votre serveur et vérifiez 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 détection avec vos systèmes correctement identifies, hz_lib fonctionne. Tous les Hz-Scripts l'utiliseront désormais automatiquement.

Mise à jour

  1. Téléchargez la dernière version depuis Keymaster
  2. Remplacez tous les fichiers (il n'y a pas de config utilisateur à conserver — config.lua est minimal)
  3. Redémarrez : ensure hz_lib, puis redémarrez vos Hz-Scripts
Les mises à jour de hz_lib sont rétrocompatibles. Vos Hz-Scripts existants continueront de fonctionner après une mise à jour.

Dépannage

hz_lib ne détecte pas mon framework
  • Assurez-vous que votre framework (es_extended, qb-core, qbx_core) est ensure avant hz_lib
  • Vérifiez que le nom de la ressource est exact (sensible à la casse)
  • Si vous voulez forcer un framework, définissez HZBridge.Framework = 'esx' (ou 'qbcore', etc.) dans config.lua
Un script dit "hz_lib not found"
  • Verifiez que hz_lib est dans votre server.cfg avec ensure hz_lib
  • Assurez-vous que le dossier est nommé exactement hz_lib
  • hz_lib doit démarrer avant le script qui en a besoin
Mauvais système détecté

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

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