Présentation
TC Mécanique
Atelier mécanique complet : commandes clients avec aperçu, tablette, pose pièce par pièce, peinture, diagnostic et usure.
VisionESXQBCoreQboxStandalonev1.7.2
tc-mechanic est un atelier mécanique complet pour Vision, ESX, QBCore, Qbox ou standalone. Les clients configurent leur véhicule avec un aperçu en direct, les mécaniciens réalisent chaque étape sur le véhicule, et tout se règle en jeu.
#Fonctionnalités
- Commandes clients avec aperçu en direct (caméra orbitale), récapitulatif puis commande. Le prix est toujours recalculé par le serveur.
- Tablette atelier (
/atelier) : tableau de bord, commandes filtrables, détail avec devis et étapes. - Pose pièce par pièce : la pièce est récupérée au stock, portée en main, puis posée depuis un cercle bleu au sol avec animation, mini-jeu et/ou barre de progression.
- Poste peinture : pistolet en main, la couleur se dépose progressivement sur le véhicule.
- Roues et pneus roue par roue : jantes, pneus (flanc, drift, pare-balles), fumée.
- Diagnostic avec devis automatique : dégâts et usure des composants analysés, prix calculés, le client accepte ou refuse.
- Usure progressive (huile, moteur, pneus, freins, suspensions, batterie, bougies) avec effet réel sur la conduite : perte de puissance, adhérence, calages, crevaisons…
- Facturation intégrée (banque ou espèces) vers la caisse du job, ou facture du framework.
- Réglage de tout le gameplay en jeu : tarifs, durées, mini-jeux, usure, permissions par grade, accessoires tenus en main.
- Aucun stream, aucun prop personnalisé, aucun item : uniquement des props et animations GTA de base.
#Architecture sécurisée
Le serveur fait autorité :
- Aucun prix, aucune propriété, aucun état de véhicule n'est accepté du client sans contrôle.
- Étapes validées : pièce portée, point et distance vérifiés, véhicule sans conducteur, immobilisé et verrouillé pendant les travaux, durée minimale imposée.
- Actions limitées par grade, callbacks limités en fréquence, tentatives anormales inscrites au journal « sécurité ».
- Les données d'usure (
tc_wear,tc_extras,tc_order) sont écrites uniquement par le serveur.
#Dépendances
| Ressource | Statut | Rôle |
|---|---|---|
oxmysql | obligatoire | Base de données |
ox_lib | obligatoire (manifeste) | Callbacks, propriétés de véhicule |
tc-ui | obligatoire | Interface, notifications, progression, mini-jeux |
Framework core, es_extended, qb-core ou qbx_core | un des quatre, sinon standalone | Joueurs, jobs, argent, société |
ox_target / qb-target | optionnel | Interaction aux points (sinon marqueur + E) |
tc-compta | optionnel | Contrats partenaires (Config.Integrations.compta) |
tc-logs | optionnel | Copie du journal sur Discord (Config.Integrations.logs) |
object_gizmo | optionnel (hors Vision) | Placement des points au gizmo |
#Frameworks
| Framework | Détection | Notes |
|---|---|---|
| Vision | core | Points managés, facture et caisse société du core |
| Qbox | qbx_core | Identifiant = citizenid |
| QBCore | qb-core | Identifiant = citizenid |
| ESX | es_extended | Identifiant = identifier |
| Standalone | aucun | À compléter via Config.Bridge.Standalone |
#Pages
InstallationPas à pas, du `server.cfg` aux premiers points.ConfigurationToutes les options de `config.lua`.CommandesCommandes, accès et panneau de gestion.Parcours atelierDu client à la facture, étape par étape.FacturationModes de paiement et caisse société.UsureLe système d'usure et ses effets.Exports & APICe que tes scripts peuvent appeler.Base de donnéesLe SQL complet.DépannageErreurs fréquentes.
#Dans cette section
InstallationInstaller tc-mechanic pas à pas : ressources, server.cfg, configuration minimale et création des points d'atelier.ConfigurationLes options de config.lua expliquées, et le fichier complet.Commandes et gestionCommandes, droits d'accès et panneau de gestion en jeu (/mecagestion).Parcours atelierDu client à la facture : commande, prise en charge, réalisation, diagnostic, facturation et suivi.FacturationModes de facturation (auto, builtin, invoice, none), caisse société et caisse interne.Usure des véhiculesSuivi par plaque, calcul serveur, effets sur la conduite et entretien.Exports et APICe que tes autres scripts peuvent appeler ou lire : OpenTablet, statebags, commandes.Base de donnéesLe SQL complet de tc-mechanic, prêt à importer.DépannageErreurs fréquentes de tc-mechanic : serveur qui ne répond pas, facturation bloquée, véhicule introuvable…