m-Tablet Mechanic Records is a custom app addon for m-Tablet, built for roleplay servers that need a workshop vehicle registry inside the tablet. Mechanic staff browse every server-owned vehicle, log repairs with parts and labor costs, and attach internal workshop notes linked by plate, without leaving the tablet UI.
Requires m-Tablet.
Main Highlights
- Server-wide vehicle list with search by plate, model, or owner name.
- Per-vehicle workshop file with overview, repair history, and internal notes.
- Job-based access via Config.MechanicJobs; the app registers on the tablet only for allowed jobs.
- Boss grade can delete notes and repairs created by other staff (Config.BossGrade).
- Repair logging with type, description, parts cost, labor cost, mileage, and status workflow.
- Localized repair statuses (completed, in_progress, scheduled, cancelled) in locales/.
- English and Portuguese locales for UI and server messages.
- Optional Discord webhooks in server/webhooks.lua (notes, repairs, general).
- Automatic database setup on resource start (oxmysql).
- QBCore/Qbox and ESX support via bridge/framework/ (same pattern as m-Tablet).
Vehicle List And Search
Mechanics open the app to a dashboard showing total vehicles on the server, repairs logged this month, and notes on file. A search field filters the live list by plate, stored vehicle data, citizen identifier, or owner name (framework-dependent). Each row shows plate, display name, owner, and garage when available. Vehicle images load from the official FiveM docs set using the resolved spawn name; unknown models fall back to a styled placeholder.
Vehicle Detail
Selecting a vehicle opens a detail view with tabs for Overview, Repairs, and Notes. Overview displays plate, model label (including Qbox hash-to-spawn resolution), owner, garage, vehicle state (in garage / out), and repair statistics: total jobs, total billed, and last service date. Staff stay on the current tab after saving a note or repair (no forced jump back to overview).
Workshop Notes
Staff add internal notes per plate with author and timestamp. Notes support delete with a confirmation modal. Authors can remove their own entries; boss-grade staff can remove any note. Empty states and loading feedback match the rest of the m-Tablet addon suite.
Repair Logging
Repairs are recorded with configurable type (Config.RepairTypes), free-text description, parts cost, labor cost, optional mileage at service, and status (Config.RepairStatuses). Total cost is calculated server-side. Each entry shows mechanic name, date, status label (localized), and billed amount. Delete requires confirmation; permission rules mirror notes (own entry or boss grade).
Access And Permissions
Only players whose job appears in Config.MechanicJobs receive the app on the tablet and can call server callbacks. All other players are denied at the server. Config.BossGrade sets the minimum job grade that may delete another staff member’s notes or repairs. The client unregisters the app automatically when the player leaves an allowed mechanic job.
Localization
Set Config.Locale to en or pt. App title and description come from locales/en.lua and locales/pt.lua unless overridden with Config.AppName / Config.AppDescription. UI copy, repair status labels, garage state text, dates, and server notifications (notes added, repair deleted, access errors, etc.) follow the active locale.
Discord Logs
Enable webhooks in server/webhooks.lua (enabled = true) and set URLs for notes, repairs, and optional general. Events include new notes and new repair logs with plate, author, and relevant fields. Webhook configuration stays out of config.lua for easier per-server setup.
Framework Bridge
Vehicle and player data are read through bridge/init.lua and bridge/framework/qbcore or bridge/framework/esx. QBCore/Qbox uses player_vehicles with hash-to-model resolution via shared vehicle data. ESX uses owned_vehicles with owner names from users. No duplicate server/framework.lua — one implementation per framework folder.
Configuration
- Config.MechanicJobs — jobs that see and use the app.
- Config.BossGrade — grade required to delete others’ notes/repairs.
- Config.ListLimit — maximum vehicles returned per search (default 500).
- Config.RepairTypes / Config.RepairStatuses — dropdown options in the repair modal.
- Config.AppIcon, Config.AppColor, Config.AppCategory, Config.StoreApp — tablet launcher presentation.
Requirements
- m-Tablet (required).
- ox_lib.
- oxmysql.
- QBCore/Qbox (qb-core) or ESX (es_extended).
