Interactions

But : écrire et comprendre chaque option du menu. Fichier à modifier : config_interactions.lua (côté client). Redémarrez la ressource après modification : les options sont construites une seule fois, au démarrage.

Les listes

Les options d’une liste s’affichent dans l’ordre du fichier. Sur un véhicule, les options d’origine d’ox_target (portes, capot, coffre) apparaissent avant celles de VehicleInteractions, puis viennent les options de modèle et les options de zone.

Champs communs

Types d’action

Une option déclare son action avec onSelect, un type ou un builtin. Si onSelect est présent, il est prioritaire.

Pour client_event et server_event, un champ args = { … } ajoute des arguments après l’objet transmis. Pour server_event, l’objet transmis est { serverId, netId, coords, name, kind }.

Objet target

Les callbacks onSelect, les événements client_event, les exports et la fonction args d’une server_action reçoivent :

{
    name = 'check_plate', label = 'Lire la plaque', icon = 'fa-solid fa-id-card',
    onSelect = function(target)
        print(target.kind, target.plate, target.netId)
    end
},

Builtins

Les builtins sont des fonctionnalités intégrées. Chacun n’est accepté que dans certaines listes : ailleurs, le moteur l’ignore avec un avertissement. Les builtins sensibles gardent leur permission serveur même si vous retirez le champ permission de l’entrée.

Dans les listes Modèles et Zones, seul weather_menu est accepté : les autres builtins déclarent des listes précises qui n’incluent pas ces deux types.

Modèles

Config.ModelInteractions = {
    {
        models = { 'prop_atm_01', 'prop_atm_02' },
        options = {
            { name = 'atm_use', label = 'Utiliser le distributeur', icon = 'fa-solid fa-money-bill', type = 'client_event', event = 'ma_banque:ouvrirAtm' },
        },
    },
}

ma_banque:ouvrirAtm est un nom d’exemple. models accepte des noms ou des hashs. Les options de modèle activent le contour (ox_target:drawOutline) sur ces objets.

Zones

Config.ZoneInteractions = {
    {
        shape = 'box', name = 'pd_duty', coords = vec3(441.0, -981.0, 30.7), size = vec3(1.5, 1.5, 2.0), rotation = 0,
        options = {
            { name = 'pd_duty', label = 'Prendre son service', icon = 'fa-solid fa-clipboard', jobs = { 'police' }, type = 'server_event', event = 'mon_pd:service' },
        },
    },
    {
        shape = 'sphere', coords = vec3(-1037.5, -2737.8, 20.2), radius = 1.2,
        options = {
            { name = 'info_desk', label = 'Accueil', icon = 'fa-solid fa-circle-info', type = 'command', command = 'aide' },
        },
    },
}

Champs lus par le registre : shape, coords, size, radius, rotation, debug, drawSprite, name et options. Seules 'box' et 'sphere' sont prises en charge : toute autre valeur de shape est traitée comme une boîte. Les zones polygonales existent via l’export addPolyZone (voir API) mais pas via Config.ZoneInteractions.

Format simplifié et format natif

config_interactions.lua utilise un format simplifié, traduit par le moteur vers le format natif d’ox_target :

Dans vos propres ressources, les exports d’ox_target (addGlobalVehicle, addModel…) attendent le format natif : menuName et openMenu, pas menu et opens. Les champs type, builtin, permission et jobs n’y existent pas.

Erreurs fréquentes

• Option invisible : permission absente de Config.Permissions, menu sans catégorie correspondante, ou fonctionnalité désactivée.
• Builtin dans la mauvaise liste : F8 affiche « le builtin ‘…’ n’est pas utilisable dans la liste ‘…’ ».
• enabled = function() qui dépend du joueur : évaluée au démarrage, avant que le personnage soit chargé. Utilisez canInteract pour une condition dynamique.
• server_event pour une action sensible : le serveur ne vérifie rien ; utilisez une server_action.