Overview
TC Mechanic
Complete mechanic workshop: customer orders with preview, tablet, step-by-step fitting, paint booth, diagnostics and wear.
VisionESXQBCoreQboxStandalonev1.7.2
tc-mechanic is a complete mechanic workshop for Vision, ESX, QBCore, Qbox or standalone. Customers configure their vehicle with a live preview, mechanics carry out each step on the vehicle, and everything is tuned in game.
#Features
- Customer orders with live preview (orbital camera), summary, then order. The price is always recalculated by the server.
- Workshop tablet (
/atelier): dashboard, filterable orders, detail with quote and steps. - Step-by-step fitting: the part is picked from stock, carried in hand, then fitted from a blue circle on the ground with animation, mini-game and/or progress bar.
- Paint booth: spray gun in hand, colour is deposited progressively on the vehicle.
- Wheels and tyres, wheel by wheel: rims, tyres (sidewall, drift, bulletproof), smoke.
- Diagnostics with automatic quote: damage and component wear analysed, prices calculated, the customer accepts or refuses.
- Progressive wear (oil, engine, tyres, brakes, suspension, battery, spark plugs) with a real effect on driving: power loss, grip, stalling, punctures…
- Built-in billing (bank or cash) into the job account, or framework invoice.
- All gameplay tuned in game: prices, durations, mini-games, wear, grade permissions, hand-held props.
- No streamed assets, no custom props, no items: only base GTA props and animations.
#Secure architecture
The server is authoritative:
- No price, property or vehicle state is accepted from the client without checks.
- Validated steps: part carried, point and distance checked, vehicle without driver, immobilised and locked during work, minimum duration enforced.
- Actions limited by grade, rate-limited callbacks, abnormal attempts written to the “security” journal.
- Wear data (
tc_wear,tc_extras,tc_order) is written by the server only.
#Dependencies
| Resource | Status | Role |
|---|---|---|
oxmysql | required | Database |
ox_lib | required (manifest) | Callbacks, vehicle properties |
tc-ui | required | Interface, notifications, progress, mini-games |
Framework core, es_extended, qb-core or qbx_core | one of the four, otherwise standalone | Players, jobs, money, society |
ox_target / qb-target | optional | Interaction at points (otherwise marker + E) |
tc-compta | optional | Partner contracts (Config.Integrations.compta) |
tc-logs | optional | Journal copy to Discord (Config.Integrations.logs) |
object_gizmo | optional (non-Vision) | Gizmo placement of points |
#Frameworks
| Framework | Detection | Notes |
|---|---|---|
| Vision | core | Managed points, core invoice and society account |
| Qbox | qbx_core | Identifier = citizenid |
| QBCore | qb-core | Identifier = citizenid |
| ESX | es_extended | Identifier = identifier |
| Standalone | none | To complete through Config.Bridge.Standalone |
#Pages
InstallationStep by step, from `server.cfg` to the first points.ConfigurationEvery `config.lua` option.CommandsCommands, access and management panel.Workshop flowFrom customer to invoice, step by step.BillingPayment modes and society account.WearThe wear system and its effects.Exports & APIWhat your scripts can call.DatabaseThe full SQL.TroubleshootingFrequent errors.
#In this section
InstallationInstall tc-mechanic step by step: resources, server.cfg, minimal configuration and creating workshop points.ConfigurationThe config.lua options explained, and the full file.Commands and managementCommands, access rights and the in-game management panel (/mecagestion).Workshop flowFrom customer to invoice: order, take-over, fitting, diagnostics, billing and follow-up.BillingBilling modes (auto, builtin, invoice, none), society account and internal cash box.Vehicle wearPer-plate tracking, server calculation, effects on driving and maintenance.Exports and APIWhat your other scripts can call or read: OpenTablet, statebags, commands.DatabaseThe full tc-mechanic SQL, ready to import.TroubleshootingFrequent tc-mechanic errors: server not responding, billing blocked, vehicle not found…