hz_lib
Présentation
hz_lib est la fondation partagée utilisée par toutes les ressources Hz-Scripts. Il détecté automatiquement l'environnement de votre serveur et fournit une API unifiée pour que chaque Hz-Script fonctionne immédiatement, quel que soit votre framework ou combinaison d'addons.Asset gratuit — hz_lib est disponible gratuitement sur le shop Hz-Scripts. Telechargez-le une fois et tous les scripts compatibles l'utiliseront automatiquement.
À quoi ça sert ?
Au lieu que chaque script embarque son propre code de détection de framework et d'adaptateur, hz_lib le gère de manière centralisée :
| Module | Ce qu'il détecte |
|---|---|
| Framework | ESX, QBCore, QBox, Ox Core, vRP, Standalone |
| Inventaire | ox\_inventory, qs-inventory, ps-inventory, codem, core, origen, tgiann, framework |
| Notifications | ox\_lib, okokNotify, mythic\_notify, codem, pNotify, framework, GTA natif |
| Target | ox\_target, qb-target, interact, TextUI intégré |
| Menu / UI | ox\_lib (complet), qb-menu + qb-input, ESX menu, fallback GTA natif |
| Dispatch | cd\_dispatch, ps-dispatch, qs-dispatch, rcore\_dispatch, emergencydispatch, intégré |
| Callbacks | Bidirectionnel (client-serveur) avec limitation de débit et timeout |
| Minijeux | Barre de progression, skill check, séquence |
/hzpanel) — chaque module HZ-Script déclare son schéma de config, et le panneau construit automatiquement un éditeur type en jeu pour tout modifier sans toucher aux fichiers ni redémarrer. Voir Panneau d'administration.
Avantages principaux
- Installation unique — Tous les Hz-Scripts partagent le même bridge, pas de code duplique
- Détection automatique — Laissez tout sur
'auto'et hz_lib détecte votre configuration - Override quand nécessaire — Forcez un système spécifique dans un seul fichier de config
- 60+ exports — Utilisez le bridge depuis vos propres scripts aussi
- Interface admin centralisée —
/hzpanelouvre un seul panneau pour chaque module HZ-Script (en savoir plus) - Thème unifie — changez l'accent, les surfaces, l'échelle des arrondis en un seul endroit, chaque NUI HZ se retinte en direct
- Zéro impact performance — La détection s'exécute une fois au démarrage, les exports sont instantanés
Systèmes supportes
Frameworks
| Framework | Ressource | Statut |
|---|---|---|
| ESX | es_extended | Complet |
| QBCore | qb-core | Complet |
| QBox | qbx_core | Complet |
| Ox Core | ox_core | Complet |
| vRP | vRP | Complet |
| Standalone | — | Complet |
Inventaires
| Inventaire | Ressource | Statut |
|---|---|---|
| ox\_inventory | ox_inventory | Complet |
| qs-inventory | qs-inventory | Complet |
| ps-inventory | ps-inventory | Complet |
| codem-inventory | codem-inventory | Complet |
| core\_inventory | core_inventory | Complet |
| origen\_inventory | origen_inventory | Complet |
| tgiann-inventory | tgiann-inventory | Complet |
| Framework natif | — | Basique |
Systèmes de menu
| Système de menu | Ressource | Fonctionnalités |
|---|---|---|
| ox\_lib | ox_lib | Context, Input, Alert, TextUI, Progress, Menu liste |
| qb-menu | qb-menu | Context, Input (via qb-input), TextUI (via qb-core) |
| ESX menu | esx_menu_default | Context, Menu liste, TextUI (via esx\_textui) |
| Natif | — | Saisie clavier GTA, texte d'aide, fallback basique |
Démarrage rapide
- Téléchargez hz_lib depuis le shop (gratuit)
- Placez-le dans votre dossier
resources/ - Ajoutez
ensure hz_libdans votreserver.cfgavant tout Hz-Script - Termine — tous les Hz-Scripts le détecteront automatiquement
Pour les développeurs
hz_lib expose 60+ exports que vous pouvez utiliser depuis vos propres scripts :
-- Framework
local job = exports['hz_lib']:GetPlayerJob()
-- Notifications
exports['hz_lib']:Notify('Hello!', 'success', 3000)
-- Inventory (server)
exports['hz_lib']:AddItem(source, 'bread', 5)
-- Menu (client)
exports['hz_lib']:ContextMenu('my_menu', 'My Menu', {
{ title = 'Option 1', onSelect = function() print('selected') end },
})
-- Callbacks
exports['hz_lib']:RegisterCallback('myResource:getData', function(source)
return { money = 1000 }
end)Consultez la référence complète Exports & API.