Dépannage commun

Les erreurs d'installation les plus fréquentes, valables pour tous les scripts TC.

#Le script ne démarre pas

#« Could not find dependency … »

Une ressource listée en dépendance n'est pas démarrée. Vérifie dans le server.cfg que oxmysql, ox_lib et tc-ui sont bien ensure avant le script (voir l'ordre de démarrage).

#La console parle de licence, d'escrow ou d'asset

L'escrow FiveM refuse de charger la ressource.

Vérifie que ta clé sv_licenseKey a été créée avec le compte Cfx.re qui possède le script.
Si tu viens d'ajouter le script à ton compte, redémarre entièrement le serveur.
Vérifie que tu n'as pas modifié un fichier chiffré (client/, server/, shared/). Seuls config.lua, bridge/, web/, sql/ et install/ sont modifiables.

#Erreur mentionnant `tc` (valeur nil)

Le global tc vient de tc-ui. Cause habituelle : tc-ui n'est pas démarré, démarre après le script, ou son dossier a été renommé. Il doit s'appeler exactement tc-ui.

#Le framework n'est pas détecté

Le framework doit être démarré avant le script (la détection est faite au chargement).
Active Config.Bridge.Debug = true et relis la console au démarrage.
Si la détection se trompe, force-la : Config.Bridge.Framework = 'esx' (ou 'qbcore', 'qbox', 'vision').

#Les commandes staff répondent « accès refusé »

Hors Vision : ajoute add_ace group.admin command allow et ton identifiant dans un groupe (voir Installation générale), ou ajoute ton identifiant dans Config.Bridge.Admins.
Vision : il te faut une des permissions listées dans la page Commandes du script.
Après modification du server.cfg ou du config.lua, redémarre la ressource (restart tc-xxx).

#Base de données

Symptôme	Cause probable	Solution
Erreur `oxmysql` au démarrage	Chaîne de connexion incorrecte	Vérifie `mysql_connection_string` dans le `server.cfg`
« Table … doesn't exist »	Création automatique impossible (droits SQL)	Importe le `install.sql` du script (page Base de données)
Accents cassés	Mauvais jeu de caractères	Utilise `utf8mb4` pour la base et la connexion

Le compte SQL doit avoir le droit CREATE pour que les tables soient créées automatiquement.

#L'interface (NUI) est vide ou ne s'ouvre pas

Vérifie que tc-ui est démarré (ensure tc-ui) et sans erreur.
Ouvre la console F8 en jeu : une erreur rouge indique quelle ressource pose problème.
Un script qui capte le focus souris en permanence peut gêner : teste en le coupant temporairement.

#Après une mise à jour

Remplace le dossier du script et celui de tc-ui.
Conserve ton config.lua (compare-le avec le nouveau pour récupérer les options ajoutées).
Redémarre les ressources, ou le serveur si tu as aussi changé de licence.

#Je ne trouve pas mon erreur

Reprends la page Dépannage du script concerné, qui liste les cas propres à chaque fonctionnalité. Si l'erreur persiste, contacte-nous avec : le nom du script et sa version, ton framework et ton inventaire, et le texte exact de l'erreur dans la console.