Dépannage
Erreurs fréquentes de tc-contextmenu : le menu ne s'ouvre pas, une option n'apparaît pas, /gestioncontexte refusé.
#Le curseur n'apparaît pas
- Vérifie que
tc-contextmenuettc-uisont démarrés. - La touche par défaut est Alt gauche (
LMENU). Vérifie dans Paramètres → Touches → FiveM qu'elle n'est pas prise par un autre raccourci. - Avec
Config.OpenMode = 'hold', il faut maintenir la touche. - Si un autre script désactive le curseur (
disable(true)), appelleexports['tc-contextmenu']:disable(false).
#Le clic droit n'ouvre rien
- Il n'y a peut-être aucune option pour cette cible. Avec le pack intégré (
Config.Pack.Enabled = true), les joueurs, véhicules et objets ont déjà des options. - Vérifie
Config.RayDistanceetConfig.DefaultDistance: la cible est peut-être trop loin de ton personnage. - Cible un objet précis plutôt que le vide : la surbrillance indique ce qui est visé.
#Mon option n'apparaît pas
| Cause | Vérification |
|---|---|
| Mauvais type de cible | types / target.types : un ped n'est pas un player |
| Modèle non listé | models : ajoute le nom ou le hash exact |
| Condition non remplie | require : métier / grade, objet, onDuty, inVehicle… |
| Distance | distance (ou Config.DefaultDistance) |
| Option désactivée | Interrupteur Activée dans /gestioncontexte |
| Script non démarré | Les options par code disparaissent quand le script s'arrête |
Utilise Capturer une cible dans /gestioncontexte pour remplir automatiquement le type et le modèle exacts.
#/gestioncontexte est refusé
Voir Installation générale : ACE command pour ton groupe, ou ton identifiant dans Config.Bridge.Admins, ou la permission de Config.ManageAce si tu l'as définie.
#Une action server_export ne fait rien
Le serveur revalide tout à partir de la définition en base : métier, objets, ACE, distance et modèle. Si l'un ne correspond pas, l'action est refusée. Augmente Config.ServerDistanceTolerance si la distance est la cause.
#Une action ne peut pas être créée
Le type est peut-être désactivé dans Config.AllowedActionTypes. Remets-le à true.
#Options du pack Vision absentes
Sur Vision, les options « staff » et « dev » dépendent des permissions du core (contextmenu, dev, devcontextmenu…). Sur les autres frameworks, seules les options génériques sont proposées et l'admin est vérifié par le serveur (ACE / groupe).
#Performances
Le script ne doit rien coûter au repos. Mesure avec resmon 1 (F8) : si tc-contextmenu consomme alors que le menu est fermé, vérifie qu'aucun autre script n'appelle en boucle ses exports.