Convars — ox_target | MrPoulpi Labs

Toutes les convars lues par ox_target dans l’archive 1.17.2 — valeurs, défauts, exemples server.cfg, priorité sur Config.UI.vignette et conséquences sur le contour et la fermeture.

But : régler la touche, le mode d’ouverture, le clic, le contour et la vignette. Fichier : server.cfg.

Liste complète

Cette liste vient de toutes les lectures GetConvar / GetConvarInt de l’archive, pas seulement du README (qui n’en cite que huit).

Convar	Valeurs	Défaut	Effet
`ox_target:defaultHotkey`	`nom de touche`	`LMENU`	Touche clavier par défaut du raccourci ox_target (lib.addKeybind). FiveM mémorise le raccourci de chaque joueur : la valeur ne s’applique qu’aux joueurs qui ne l’ont pas encore personnalisé. Lu par : `client/main.lua`
`ox_target:toggleHotkey`	`0 \| 1`	`0`	1 : une pression ouvre, une autre ferme. Toute autre valeur : maintenir la touche. Lu par : `client/main.lua`
`ox_target:leftClick`	`0 \| 1`	`1`	1 : le clic gauche verrouille le menu sur la cible ; sinon le clic droit. Le clic droit déverrouille. Lu par : `client/main.lua`
`ox_target:centerCursor`	`0 \| 1`	`1`	1 : le curseur est replacé au centre de l’écran à chaque ouverture. Lu par : `client/main.lua`
`ox_target:closeOnSelect`	`0 \| 1`	`1`	1 : le ciblage se ferme après une option qui n’ouvre pas de sous-menu. Lu par : `client/main.lua`
`ox_target:drawOutline`	`0 \| 1`	`1`	1 : contour sur les entités qui ont des options spécifiques (modèle, entité réseau ou locale), jamais sur les peds. Lu par : `client/main.lua`
`ox_target:outlineColor`	`R,G,B,A`	`255,255,255,255`	Quatre entiers R,G,B,A séparés par des virgules ; une composante illisible vaut 255. Lu par : `client/main.lua`
`ox_target:outlineDistance`	`integer`	`5`	Utilisée seulement quand la plus grande distance des options spécifiques de l’entité vaut 0. Avec cette archive, les options générées ont toujours une distance : ce convar n’a d’effet que si vous leur donnez distance = 0. Lu par : `client/main.lua`
`ox_target:vignette`	`-1 \| 0 \| 1`	`-1`	Non défini (-1) : Config.UI.vignette décide. 1 : vignette affichée. Toute autre valeur : vignette masquée. Lu par : `client/state.lua`
`ox_target:defaults`	`0 \| 1`	`1`	1 : charge les options portes / capot / coffre d’ox_target, sauf si Config.Features.vehicleDoors = false. Lu par : `client/defaults.lua`
`ox_target:drawSprite`	`integer`	`24`	Nombre maximal de points de zone dessinés par image ; 0 les désactive. Lu par : `client/utils.lua`
`ox_target:debug`	`0 \| 1`	`0`	1 : marqueur de visée et options de démonstration (zones près du commissariat, modèle police, globales). Lu par : `client/main.lua, client/debug.lua`

Comment les définir

Les convars sont lues côté client, au démarrage du script : déclarez-les avec setr (convar répliquée vers les clients), avant ensure ox_target.

setr ox_target:defaultHotkey LMENU
setr ox_target:toggleHotkey 0
setr ox_target:leftClick 1
setr ox_target:centerCursor 1
setr ox_target:closeOnSelect 1
setr ox_target:drawOutline 1
setr ox_target:outlineColor 140,180,215,255
setr ox_target:vignette 1
ensure ox_target

Les valeurs booléennes sont lues avec GetConvarInt : écrivez 0 ou 1, pas true / false. Pour la plupart, seule la valeur 1 active l’option (toggleHotkey, debug) ou au contraire tout ce qui n’est pas 1 la désactive (leftClick, centerCursor, closeOnSelect, drawOutline, defaults).

Après une modification : redémarrez le serveur, ou exécutez la ligne setr dans la console puis restart ox_target.

Priorité de la vignette

ox_target:vignette est lue avec une valeur par défaut de -1 :

convar absente (-1) : Config.UI.vignette décide ;
convar à 1 : vignette affichée, quel que soit Config.UI.vignette ;
convar à toute autre valeur (0…) : vignette masquée.

Touche par défaut

ox_target:defaultHotkey est la touche proposée par défaut au raccourci FiveM « ox_target ». FiveM mémorise les raccourcis de chaque joueur : un joueur qui a déjà le raccourci garde sa touche, et peut la changer dans Paramètres › Raccourcis clavier › FiveM.

Contour et distance de contour

Le contour n’apparaît que sur une entité qui possède des options spécifiques (options de modèle, d’entité réseau ou d’entité locale), jamais sur les PNJ ni les joueurs, et jamais pour les seules options globales (tous les véhicules, tous les objets). La distance retenue est la plus grande distance de ces options. ox_target:outlineDistance ne sert que si cette valeur vaut 0 : avec cette archive, les options générées ont toujours une distance, donc ce convar n’a d’effet que si vous leur donnez distance = 0.

Fermeture après sélection

Avec closeOnSelect à 1, le ciblage se ferme après une option qui n’ouvre pas de sous-menu. Les catégories gardent le menu ouvert. Les cases à cocher ne passent pas par cette fermeture : le menu reste ouvert après un clic sur une case.

Erreurs fréquentes

set au lieu de setr : la convar n’est pas visible côté client, la valeur par défaut s’applique.
setr ox_target:toggleHotkey true : true n’est pas un entier ; la valeur lue ne vaut pas 1 et le mode bascule reste inactif.
Couleur de contour avec espaces : setr ox_target:outlineColor 140, 180, 215, 255 ne transmet que le premier mot (140,) ; les composantes manquantes valent 255. Écrivez 140,180,215,255.