Browse docs

Installation

Install Sky Mechanic Job, prepare its dependencies and database, and complete the first server setup.

Requirements

Before installing Sky Mechanic Job, update both required resources from the same CFX Portal account:

sky_base
sky_jobs_base

Keep both dependencies up to date when updating the mechanic resource. Start your framework, inventory and targeting resources before the Sky resources.

Install the resource

Deploy the files

Place the sky_mechanicjob resource in your server resources directory. Do not rename its resource folder.

Configure the start order

Add the resource to server.cfg after its dependencies:

server.cfg

# Framework, SQL, inventory, target and configured integrations first
ensure sky_base
ensure sky_jobs_base
ensure sky_mechanicjob

Prepare the database

Config.AutoExecuteQuery is enabled by default in config/config.lua. With this option enabled, the resource creates and updates its mechanic tables automatically.

If you disable automatic queries, import the included import.sql manually before starting the resource.

The mechanic resource uses these tables:

sky_mechanic_vehicle_tuning
sky_mechanic_tuning_orders
sky_mechanic_vehicle_profiles
sky_mechanic_vehicle_history
sky_mechanic_part_deliveries
sky_mechanic_invoices
sky_mechanic_invoice_items
sky_mechanic_fake_plate_audit

With the shared vehicle-storage update, confirmed tuning writes standard colours and mods directly to owned_vehicles.vehicle on ESX or player_vehicles.mods on QBCore/Qbox, before the vehicle is parked. Mechanic-specific systems remain in the Mechanic tables.

Follow the Garage Integration setup guide before testing. It tells you which file to open for ESX, QBCore or Qbox and shows the exact blocks to copy and paste. It also explains the differences between MSK versions. You keep your garage's normal vehicle functions.

The database update keeps a backup of old tuning data in legacy_properties. If you disabled automatic database setup, import the updated import.sql before starting the server.

Add inventory items

Add the mechanic items required by the features you enable. Ready-to-use definitions and a feature-by-feature item list are available on the Inventory Items page. The default configuration also enables fake plates, so register fake_plate_kit, blank_plate, and plate_printer, complete the Fake Plate Integration, or disable Config.FakePlates.enabled.

Copy the supplied PNG files from sky_mechanicjob/config/inventory into your inventory image folder. drift_tyres, fake-plate items, and any item-based dealer currency need icons supplied by your own inventory pack.

Configure media uploads when used

Tablet applications that save images or videos use the shared provider in sky_jobs_base/config/webhooks.lua. Configure FiveManage, Qbox CDN, or a custom adapter as described in Media Providers before enabling a media workflow.

Disable duplicate salaries

Set framework salary values for every mechanic grade to 0 when Sky Jobs Base manages salaries. Leaving both salary systems active can produce duplicate payments.

If you keep framework or external payroll instead, set Config.Salary.enabled = false in sky_jobs_base/config/config.lua.

Configure administrator access

Install the global permissions bootstrap, assign your administrator group, and review the Permissions page.

Grant boss permissions

Run /setboss once for the highest mechanic grade after a fresh installation or after clearing sky_job_permissions.

For example, a mechanic job whose highest grade is 4 should be configured with /setboss mechanic 4.

Configure the job

Restart the server, run /jobconfig, and select Mechanic Jobs. Configure jobs and enabled systems before creating workshop points.

Build the workshop

With the default Config.UseJobConfigurator = true, open Mechanic Jobs → Workshops in /jobconfig and place the interactions needed by your configuration. /workshopcreator is available only when Config.UseJobConfigurator is disabled. Follow the Workshop Setup page to avoid missing delivery, lift, or tuning points.

First-start checklist

The server console shows no missing dependency or database errors.
/jobconfig lists Mechanic Jobs and its Workshops section opens for an administrator.
The mechanic job and its highest grade exist in the framework.
Required items exist in the selected inventory.
The mechanic tablet shows the expected applications.
A test vehicle can create and complete a tuning order.
After buying a colour change or tuning part, park the car and take it out again. Check that it looks correct before entering and stays the same after entering.

Most day-to-day settings are managed through /jobconfig when Config.UseJobConfigurator is enabled. Static and advanced settings remain in the open config directory.

Next steps

Support

Need help? Our support team is always ready to assist.

Join Discord

Overview

Start here for an overview of Sky Mechanic Job, its main systems, setup path, and documentation sections.

Configuration

Understand the Job Configurator, feature toggles, static settings, and safe configuration workflow.