Dépannage et FAQ
Diagnostiquer ox_target — menu absent, option invisible, action refusée, messages F8 et console du moteur, intégrations qui ne répondent pas et questions fréquentes.
Avant tout : ouvrez F8 (client) et la console serveur, puis reproduisez le problème. Le moteur préfixe ses messages par [ox_target].
Le menu ne s’ouvre pas
- Vérifiez que la ressource s’appelle exactement
ox_targetet qu’elle démarre (ensure ox_target) après ox_lib. - La touche par défaut est Alt gauche ; un joueur a pu la changer dans Paramètres › Raccourcis clavier › FiveM.
- Le ciblage ne s’ouvre pas quand le menu pause est ouvert ou qu’une autre interface a le focus NUI, et il se ferme pendant une barre de progression ox_lib.
- Une ressource peut l’avoir désactivé avec
exports.ox_target:disableTargeting(true).
Une option n’apparaît pas
Vérifiez dans cet ordre :
- F8 au démarrage :
builtin inconnu,le builtin '…' n’est pas utilisable dans la liste '…',option sans 'name' ignorée. - Fonctionnalité :
Config.Features.<clé>vaut-ellefalse? - Permission : la valeur de
permissionexiste-t-elle dansConfig.Permissions? Votre groupe y donne-t-il accès ? Attendez jusqu’àConfig.Security.permissionRefreshms après un changement de groupe. - Sous-menu : la valeur de
menuest-elle égale auopensd’une catégorie de la même liste ? - Distance : êtes-vous plus près que la
distancede l’option ? - Métier, items, groupes : le bridge lit-il votre métier ? Avec
Config.Frameworksurox,ndoustandalone, aucun métier n’est lu sans hookGetPlayerJob. - Disponibilité : clés, facture, apparence et météo exigent une intégration disponible ou le hook correspondant.
- Conditions de jeu : crevaison (arme blanche en main, à pied), coffre (déverrouillé, libre, assez proche), crochetage et réparation (à pied).
Une action est refusée
| Message affiché | Cause côté serveur |
|---|---|
| Vous n’avez pas la permission… | Permission refusée (no_permission). |
| Votre métier ne permet pas… | jobs de l’action non satisfait. |
| Il vous manque l’objet requis. | item absent de l’inventaire lu par le bridge. |
| La cible est trop loin. | Distance au-delà de maxDistance + distanceTolerance. |
| Cible invalide. | Joueur ou entité inexistant, mauvais type de cible, ou auto-ciblage interdit. |
| Cette fonctionnalité est désactivée. | Fonctionnalité à false, ou intégration indisponible. |
| Données invalides. | Arguments refusés par le schéma args. |
| (rien) | Cooldown en cours ou limite par seconde dépassée. |
Les refus suspects (action inconnue, cible falsifiée, arguments invalides, rafale) sont affichés dans la console serveur si Config.Security.logSuspicious = true, ou transmis à votre hook OnSuspiciousActivity.
Messages console
| Message | Signification |
|---|---|
nom d'option en double '…' dans la liste '…' |
Deux options portent le même name ; renommez l’une d’elles. |
l'option '…' n'a aucune action |
Ni onSelect, ni type, ni builtin. |
erreur dans l'option '…' |
Votre callback ou l’export appelé a levé une erreur. |
action '…' invalide (handler manquant) |
Action serveur sans handler. |
l'action '…' est intégrée et ne peut pas être remplacée |
Nom d’action réservé. |
requête suspecte de … |
Voir le tableau précédent. |
FAQ
Faut-il redémarrer le serveur après une modification ?
Non : restart ox_target suffit pour les fichiers config*.lua. Les ressources qui ajoutent des options via les exports doivent ensuite être redémarrées. Pour une convar, voir Convars.
La copie d’emote répond toujours « Le joueur ne fait aucune emote à copier. »
Votre script d’emotes ne renvoie pas le nom de l’emote en cours. Définissez le hook client GetCurrentEmote.
Le revive affiche un succès mais rien ne se passe.
Le message self_revived est envoyé par le serveur dès la validation, sans attendre le script médical. Vérifiez Config.MedicalScript et vos hooks.
Le menu météo n’apparaît pas.
Permission weather, fonctionnalité weather et intégration disponible côté client : av_weather démarré, ou un hook client SetLocalRain / SetLocalFreeze.
Les libellés des portes de véhicule sont en français même avec ox_lib en anglais.
Ils viennent de locales/*.json, choisi par la langue d’ox_lib. Dans l’archive, locales/en.json contient lui aussi des textes français.
La fenêtre Pierre Feuille Ciseaux reste en français.
Ses textes viennent des clés rps_ui_* du fichier locales/<langue>.json choisi par ox_lib. Dans l’archive, locales/en.json les contient en français : traduisez-les dans ce fichier, puis restart ox_target.
La console affiche un avertissement de version.
Le script serveur d’origine (server/main.lua, protégé) appelle lib.versionCheck('overextended/ox_target'), qui compare la version déclarée aux publications d’Overextended. Ce message ne concerne pas les mises à jour MrPoulpi Labs.
Le contour n’apparaît pas sur un véhicule.
Le contour est réservé aux entités qui ont des options spécifiques (modèle, entité). Les options de VehicleInteractions s’appliquent à tous les véhicules et n’en déclenchent pas.
Si le problème persiste, préparez un ticket : Support.