Configuration
Tous les réglages sont dans config.lua. Par défaut, tout est sur 'auto' — vous n'avez besoin de modifier les réglages que si l'auto-detection ne fonctionne pas pour votre configuration.
Framework
HZBridge.Framework = 'auto'
| Option | Description |
|---|
'auto' | Auto-détection (recommande) |
'esx' | Forcer ESX |
'qbcore' | Forcer QBCore |
'qbox' | Forcer QBox (QBX) |
'ox' | Forcer Ox Core |
'vrp' | Forcer vRP |
'standalone' | Sans framework |
Ordre de détection : qbx_core > qb-core > es_extended > ox_core > vRP > standalone
Inventaire
HZBridge.Inventory = 'auto'
| Option | Description |
|---|
'auto' | Auto-détection (recommande) |
'ox_inventory' | Forcer ox\_inventory |
'qs-inventory' | Forcer qs-inventory |
'ps-inventory' | Forcer ps-inventory |
'codem-inventory' | Forcer codem-inventory |
'core_inventory' | Forcer core\_inventory |
'origen_inventory' | Forcer origen\_inventory |
'tgiann-inventory' | Forcer tgiann-inventory |
'framework' | Utiliser l'inventaire natif du framework |
Notifications
HZBridge.Notifications = 'auto'
| Option | Description |
|---|
'auto' | Auto-détection (recommande) |
'ox_lib' | Forcer les notifications ox\_lib |
'okok' | Forcer okokNotify |
'mythic' | Forcer mythic\_notify |
'codem' | Forcer codem-notification |
'pnotify' | Forcer pNotify |
'framework' | Utiliser les notifications du framework |
'gta' | Texte natif GTA V |
Target / Interaction
HZBridge.Target = 'auto'
| Option | Description |
|---|
'auto' | Auto-détection (recommande) |
'ox_target' | Forcer ox\_target |
'qb-target' | Forcer qb-target |
'interact' | Forcer le système interact |
'builtin' | Fallback TextUI intégré |
HZBridge.Menu = 'auto'
| Option | Description | Fonctionnalités |
|---|
'auto' | Auto-détection (recommande) | — |
'ox_lib' | Forcer ox\_lib | Context, Input, Alert, TextUI, Progress, Menu |
'qb-menu' | Forcer qb-menu | Context, Input (qb-input), TextUI (qb-core) |
'esx' | Forcer le menu ESX | Context, Menu liste, TextUI |
'native' | Fallback GTA natif | Saisie clavier, texte d'aide (limite) |
Ordre de détection : ox_lib > qb-menu > esx_menu_default > native
Le fallback 'native' fournit des fonctionnalités basiques mais limitées. Pour la meilleure expérience, installez ox\_lib ou qb-menu.
Dispatch
HZBridge.Dispatch = 'auto'
| Option | Description |
|---|
'auto' | Auto-détection (recommande) |
'cd_dispatch' | Forcer cd\_dispatch |
'ps-dispatch' | Forcer ps-dispatch |
'qs-dispatch' | Forcer qs-dispatch |
'rcore_dispatch' | Forcer rcore\_dispatch |
'emergencydispatch' | Forcer emergencydispatch |
'builtin' | Notification + blip intégrés |
Callbacks
HZBridge.Callback = {
Timeout = 15000, -- ms before timeout (default 15s)
RateLimit = 50, -- max requests/second per player (0 = disabled)
}
| Paramètre | Type | Description |
|---|
Timeout | integer | Millisecondes avant qu'un callback expire |
RateLimit | integer | Requêtes max par seconde par joueur (0 = illimité) |
Debug
HZBridge.Debug = false
Passez à true pour activer les logs détaillés avec le préfixe [HZ Bridge] dans la console. Utile pour diagnostiquer les problèmes de détection.
Exemple complet
HZBridge = {}
HZBridge.Framework = 'auto'
HZBridge.Inventory = 'auto'
HZBridge.Notifications = 'auto'
HZBridge.Dispatch = 'auto'
HZBridge.Target = 'auto'
HZBridge.Menu = 'auto'
HZBridge.Callback = {
Timeout = 15000,
RateLimit = 50,
}
HZBridge.Debug = false
Recommandation : Laissez tout sur 'auto' sauf si vous avez une raison spécifique de forcer un système. L'auto-detection est fiable et couvre toutes les configurations courantes.
