API et exports publics

But : ajouter des options depuis vos propres ressources et enregistrer des actions serveur sans modifier ox_target. Où : dans le code de vos ressources, pas dans les fichiers d’ox_target.

Exports client

Ces exports sont définis dans client/api.lua. Les options s’écrivent au format natif (voir plus bas), pas au format simplifié de config_interactions.lua.

Les options ajoutées par une ressource lui appartiennent : remove… ne retire que les options de la ressource appelante, et elles sont supprimées automatiquement à l’arrêt de cette ressource. Ajouter une option avec un name déjà utilisé par la même ressource remplace l’ancienne.

Format natif des options

exports.ox_target:addModel({ 'prop_vend_soda_01', 'prop_vend_soda_02' }, {
    {
        name = 'ma_ressource:soda',
        label = 'Acheter une boisson',
        icon = 'fa-solid fa-bottle-water',
        distance = 1.5,
        items = 'money',
        onSelect = function(data)
            TriggerServerEvent('ma_ressource:acheterSoda', data.coords)
        end,
    },
})

ma_ressource est un nom d’exemple. Champs natifs reconnus : name, label, icon, iconColor, distance, bones, offset, absoluteOffset, offsetSize, groups, items, anyItem, canInteract, onSelect, export, event, serverEvent, command. La NUI de cette édition lit aussi description et separatorAfter.

Sous-menus au format natif : openMenu = 'nom' sur l’option parente (ajoutez isCategory = true pour afficher la flèche) et menuName = 'nom' sur les options enfants. Les cases à cocher (type = 'checkbox') ne sont pas disponibles via les exports : leur état est géré par le moteur pour les seules options de config_interactions.lua.

onSelect reçoit ici les données natives d’ox_target (entity, coords, distance, zone et les champs de l’option), pas l’objet target du format simplifié. Avec serverEvent, entity est converti en network ID.

Export serveur

exports.ox_target:registerAction(name, def)

• name : chaîne ; def : table au format de Config.ServerActions (voir Hooks et actions serveur).
• Retourne true si l’action est enregistrée, false si def.handler n’est pas une fonction ou si name désigne une action intégrée.
• Une action enregistrée par une ressource est retirée à l’arrêt de cette ressource.
• Un nom déjà utilisé par une action personnalisée (y compris de Config.ServerActions) est remplacé.

CreateThread(function()
    local ok = exports.ox_target:registerAction('mon_garage:sortir', {
        permission = 'everyone',
        jobs = { 'mechanic' },
        target = 'vehicle',
        maxDistance = 4.0,
        cooldown = 3000,
        handler = function(ctx)
            TriggerEvent('mon_garage:sortirVehicule', ctx.source, ctx.netId)
        end,
    })
    if not ok then
        print('registerAction refusé')
    end
end)

Démarrez votre ressource après ox_target. Côté client, déclenchez l’action avec une option type = 'server_action', action = 'mon_garage:sortir' dans config_interactions.lua : l’événement réseau interne du moteur n’est pas une API publique et n’est pas documenté.

Événements publics

Compatibilité qtarget et qb-target

La ressource déclare provide 'qtarget' et provide 'qb-target'. Les exports suivants sont convertis vers l’API ox_target :

• qtarget : AddBoxZone, AddPolyZone, AddCircleZone, RemoveZone, AddTargetBone, AddTargetEntity, RemoveTargetEntity, AddTargetModel, RemoveTargetModel, Ped, RemovePed, Vehicle, RemoveVehicle, Object, RemoveObject, Player, RemovePlayer.
• qb-target : les mêmes zones et cibles, plus AddGlobalPed, AddGlobalVehicle, AddGlobalObject, AddGlobalPlayer et leurs Remove….
• AddEntityZone et RemoveTargetBone de qb-target ne sont pas pris en charge (sans effet).

Ces conversions viennent du moteur d’origine ; testez chaque script qui les utilise.

Erreurs fréquentes

• Utiliser menu / opens dans un export : ignorés ; utilisez menuName / openMenu.
• Appeler un export avant le démarrage d’ox_target : erreur « No such export ». Corrigez l’ordre des ensure.
• Attendre une case à cocher via export : non pris en charge, passez par config_interactions.lua.