HZ-Bridge
Presentation
HZ-Bridge est la fondation partagee utilisee par toutes les ressources Hz-Scripts. Il detecte automatiquement l'environnement de votre serveur et fournit une API unifiee pour que chaque Hz-Script fonctionne immediatement, quel que soit votre framework ou combinaison d'addons.Asset gratuit — HZ-Bridge est disponible gratuitement sur le shop Hz-Scripts. Telechargez-le une fois et tous les scripts compatibles l'utiliseront automatiquement.
A quoi ca sert ?
Au lieu que chaque script embarque son propre code de detection de framework et d'adaptateur, HZ-Bridge le gere de maniere centralisee :
| Module | Ce qu'il detecte |
|---|---|
| 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 integre |
| Menu / UI | ox\_lib (complet), qb-menu + qb-input, ESX menu, fallback GTA natif |
| Dispatch | cd\_dispatch, ps-dispatch, qs-dispatch, rcore\_dispatch, emergencydispatch, integre |
| Callbacks | Bidirectionnel (client-serveur) avec limitation de debit et timeout |
| Minijeux | Barre de progression, skill check, sequence |
/hzpanel) — chaque module HZ-Script declare son schema de config, et le panneau construit automatiquement un editeur type en jeu pour tout modifier sans toucher aux fichiers ni redemarrer. Voir Panneau d'administration.
Avantages principaux
- Installation unique — Tous les Hz-Scripts partagent le meme bridge, pas de code duplique
- Detection automatique — Laissez tout sur
'auto'et HZ-Bridge detecte votre configuration - Override quand necessaire — Forcez un systeme specifique dans un seul fichier de config
- 60+ exports — Utilisez le bridge depuis vos propres scripts aussi
- Interface admin centralisee —
/hzpanelouvre un seul panneau pour chaque module HZ-Script (en savoir plus) - Theme unifie — changez l'accent, les surfaces, l'echelle des arrondis en un seul endroit, chaque NUI HZ se retinte en direct
- Zero impact performance — La detection s'execute une fois au demarrage, les exports sont instantanes
Systemes 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 |
Systemes de menu
| Systeme de menu | Ressource | Fonctionnalites |
|---|---|---|
| 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 |
Demarrage rapide
- Telechargez HZ-Bridge depuis le shop (gratuit)
- Placez-le dans votre dossier
resources/ - Ajoutez
ensure HZ-Bridgedans votreserver.cfgavant tout Hz-Script - Termine — tous les Hz-Scripts le detecteront automatiquement
Pour les developpeurs
HZ-Bridge expose 60+ exports que vous pouvez utiliser depuis vos propres scripts :
-- Framework
local job = exports['HZ-Bridge']:GetPlayerJob()
-- Notifications
exports['HZ-Bridge']:Notify('Hello!', 'success', 3000)
-- Inventory (server)
exports['HZ-Bridge']:AddItem(source, 'bread', 5)
-- Menu (client)
exports['HZ-Bridge']:ContextMenu('my_menu', 'My Menu', {
{ title = 'Option 1', onSelect = function() print('selected') end },
})
-- Callbacks
exports['HZ-Bridge']:RegisterCallback('myResource:getData', function(source)
return { money = 1000 }
end)
Consultez la reference complete Exports & API.
