Chargement du contenu...
Bridge — API Client
Toutes les fonctions bridge côté client — données joueur, notifications, events lifecycle, clés, carburant et dispatch.
Toutes les fonctions bridge côté client — données joueur, notifications, events lifecycle, clés, carburant et dispatch.
Ces fonctions s'appellent côté client, sur lib.bridge.
| Fonction | Retour | Description |
|---|---|---|
getPlayerData() | BridgePlayerData? | Le joueur local (source, identifier, name, job). |
getMoney(moneyType?) | number | Solde d'un compte (cash défaut, bank, black). |
getInventory() | BridgeInventoryItem[] | Les items du joueur local. |
getGang() | BridgeGang? | Gang actuel (QBCore / QBox uniquement ; nil ailleurs). |
getPlayerData()BridgePlayerData?getMoney(moneyType?)numbercash défaut, bank, black).getInventory()BridgeInventoryItem[]getGang()BridgeGang?nil ailleurs).---@class BridgePlayerData
---@field source number
---@field identifier string
---@field name string
---@field job BridgeJobgetPlayerData() peut renvoyer nil si appelé avant que le joueur ait spawn. Utilise onPlayerLoaded pour t'exécuter au bon moment plutôt qu'au boot.
| Fonction | Retour | Description |
|---|---|---|
notify(data) | — | Affiche une notification — { type, content, title?, duration? }. |
notify(data){ type, content, title?, duration? }.| Fonction | Retour | Description |
|---|---|---|
onPlayerLoaded(cb) | — | Exécute cb() une fois le joueur spawn. |
onPlayerUnload(cb) | — | Exécute cb() au logout. |
onJobUpdate(cb) | — | Exécute cb(job) à chaque changement de métier. |
onCharacterSpawned() | — | Trigger (pas un listener) — à appeler après le choix du personnage pour notifier le framework. |
onPlayerLoaded(cb)cb() une fois le joueur spawn.onPlayerUnload(cb)cb() au logout.onJobUpdate(cb)cb(job) à chaque changement de métier.onCharacterSpawned()onPlayerLoaded fire une fois par session. Si tu redémarres ta ressource après le spawn, le callback ne se rejoue pas — vérifie ton état de connexion au boot pour couvrir ce cas.
| Fonction | Retour | Description |
|---|---|---|
giveVehicleKeys(vehicle) | — | Donne les clés du vehicle (entity handle). |
removeVehicleKeys(vehicle) | — | Retire les clés. |
hasVehicleKeys(vehicle) | boolean | Si le joueur a les clés (false sans système). |
giveVehicleKeys(vehicle)vehicle (entity handle).removeVehicleKeys(vehicle)hasVehicleKeys(vehicle)booleanfalse sans système).Routé via ton système see:keys ; la plaque est dérivée en interne.
| Fonction | Retour | Description |
|---|---|---|
getFuel(vehicle) | number | Niveau de carburant actuel (0–100). |
setFuel(vehicle, level) | — | Définit le carburant ; clampé 0–100, ignoré si level n'est pas un nombre. |
getFuel(vehicle)numbersetFuel(vehicle, level)level n'est pas un nombre.ox_fuel est piloté par un statebag ; le fallback native est local au client (pas de sync).
| Fonction | Retour | Description |
|---|---|---|
sendDispatch(data) | — | Envoie une alerte dispatch via ton système see:dispatch. |
sendDispatch(data)see:dispatch.data est optionnel — chaque champ a une valeur par défaut :
lib.bridge.sendDispatch({
message = 'Braquage en cours',
code = '10-90', -- défaut '10-35'
priority = 'high', -- défaut 'medium'
jobs = { 'police' }, -- défaut { 'police' }
coords = vec3(0, 0, 0), -- défaut : position de l'appelant
blip = { sprite = 161, color = 1, scale = 1.0 },
})lib.bridge.onPlayerLoaded(function()
local data = lib.bridge.getPlayerData()
print(data.name, data.job.name)
end)
lib.bridge.onJobUpdate(function(job)
if job.name == 'police' then
enablePoliceTools()
end
end)Les adapters tiers de clés, carburant et dispatch sont écrits depuis les API publiques mais pas encore vérifiés en jeu — voir Détection & config.