Dépannage

Erreurs fréquentes de tc-mechanic : serveur qui ne répond pas, facturation bloquée, véhicule introuvable…

Commence toujours par /mecadiag (staff ou console) : il affiche le framework, le mode de facturation, la caisse, les points et les véhicules suivis détectés.

#« Le serveur ne répond pas » à l'ouverture de la tablette ou du configurateur

Vérifie que le framework est démarré avant tc-mechanic (détection au chargement) et que tc-ui et ox_lib sont bien lancés.
Active Config.Bridge.Debug = true, redémarre le script et lis la console : le framework doit être affiché.
Si la détection est fausse, force-la : Config.Bridge.Framework = 'esx' (ou 'qbcore', 'qbox', 'vision').

#La facturation est bloquée

Le message précise la cause ; /mecadiag la détaille.

Cause	Solution
Aucune caisse société utilisable	Règle `Config.Bridge.Society`, ou utilise la caisse interne (`internal`)
Aucun système de factures en `invoice`	Fournis `Config.Bridge.Standalone.createInvoice`, ou passe en `builtin`
Montant refusé en espèces	Il dépasse `Config.CashLimit` : paiement par banque

#« Véhicule introuvable » / impossible de commander

Le véhicule doit être possédé : il doit exister dans la table définie dans Config.Vehicles.
Vérifie les noms de table et de colonnes sur ta base ESX / QBCore / Qbox (plate, owner / citizenid, vehicle / mods…).
Le joueur doit être le propriétaire (ou copropriétaire sur Vision), selon le réglage propriété du véhicule de l'onglet Général.

#Je ne suis pas reconnu comme mécanicien

Ton métier doit figurer dans Config.MechanicJobs, ou avoir un type égal à Config.JobType.
Le réglage service obligatoire (onglet Général) exige d'être en service.
Vérifie le grade minimum de l'action dans l'onglet Permissions.

#`/mecagestion` refusé

Hors Vision : ACE command, groupe admin ou Config.Bridge.Admins (voir Installation générale).
Vision : permission gestion_mecano.

#Aucun point n'apparaît / pas d'invite à l'atelier

Crée les points dans /mecagestion → Points et vérifie qu'ils sont activés.
Sans ox_target / qb-target, l'invite est un marqueur + touche E (Config.Bridge.InteractKey).
Vérifie Config.Distances.Point.

#Doublons avec un autre système de personnalisation

Désactive les points « Custom » de l'ancien système (core Vision, scripts ESX/QB) dans les ateliers, puis garde uniquement les points tc-mechanic.

#L'usure n'a pas d'effet

Elle ne s'applique qu'aux véhicules enregistrés et aux types de Config.WearVehicleTypes.
Les effets démarrent sous le seuil réglé dans l'onglet Usure & effets.

#Points à valider après installation

Le mode de facturation effectivement détecté (/mecadiag) et la caisse société utilisée.
Les noms de tables / colonnes de tes véhicules (Config.Vehicles).
Les noms de tes métiers mécaniciens (Config.MechanicJobs).