Browse docs

Changelog

Full change history for Sky Mechanic Job.

May 15, 2026

LatestMay 15, 2026

Version 1.5.0

Before updating, make sure sky_base and sky_jobs_base are up to date.

Highlights

Added optional physical item carrying through Config.CarryItems, where delivered orders must be unpacked and parts become physical objects that mechanics carry through the workshop by hand or transport in bulk with pallets and forklifts.
Added workshop prop placement support, including configurable props such as cones, barriers, work lights, and parts boxes for better rp.

Notable Changes

Added a forklift to the default mechanic vehicle list for workshops that use physical delivery handling.
Added optional drivetrain swap whitelisting through Config.CustomHandlingOptions.drivetrainWhitelist for vehicles that are safe to switch between drivetrain presets.
Tuning orders are now scoped per workshop, and the vehicle registry now keeps each mechanic business separated correctly.
Added Kiminaze Advanced Parking integration to avoid duplicate vehicles during stance resets.
Improved install flows by skipping hood-opening steps on vehicles without a hood and hiding armor tuning on bikes.

Other Changes

Improved persistence for window tint, liveries, underbody neons, anti-lag state, and paint data.
Fixed vehicles becoming chrome, windows breaking unexpectedly, and braking issues on some addon vehicles.
Fixed stance synchronization for nearby players.
Refunds are now limited to unstarted orders, and refunded orders can now be deleted.
Added Russian translations.

Download sky_mechanicjob from the CFX Portal.
Create a backup.
Replace the /source folder.
Replace the /config/locales folder.
Replace fxmanifest.lua so version 1.5.0 is loaded.
Add the new workshop props and forklift vehicle entries from the updated Config.Jobs section if you want to use the new prop placement and delivery workflows.
Add interactionDistance to Config.Interactions.self_service_tuning and Config.Interactions.part_delivery if you want to customize those ranges:

interactionDistance = 2.5

Add Config.CarryItems from the new config if you want delivered parts to become physical objects that must be transported through the workshop.
Add the optional drivetrain whitelist if you use drivetrain swaps and want to restrict them to tested vehicle models:

Config.CustomHandlingOptions = {
    -- ...
    drivetrainWhitelist = {
        enabled = false,
        models = {
            -- "sultan",
            -- "elegy"
        }
    }
}

May 11, 2026

Version 1.4.0

Requires sky_base 1.14.0 or newer andsky_jobs_base 1.15.0 or newer. The admin permission system has been replaced - sky_base must be updated and the three bootstrap ACEs must be added to your server.cfg before ensure sky_base, otherwise /admintuning, /migrate, /workshopcreator, /setboss, and every other admin command will deny everyone except the server console.

Highlights

Added an Applied Tuning section to Vehicle Diagnostics App so mechanics can see and set installed tuning back to stock and receive configured install items back.
Tuning removal now uses the same install workflows as tuning installs, including wheel, brake, suspension, and simple checklist flows.
Added optional workshop-location enforcement for tuning installs and removals through Config.TuningWorkshopRequirement.
Added synced stance state so stance changes are visible to nearby players without them entering the vehicle.

Notable Changes

Command permissions now use sky_base ACE auto-wiring through Config.CommandPermissions, including the Workshop Creator permission.
Parts theft configuration was consolidated into Config.PartsTheft, including lug wrench item settings, stolen wheel item settings, and stolen parts dealer settings.
Instant tuning points can now force marker interaction through Config.InstantTuning.forceMarkerInteraction.
Vehicle lookup now includes a fallback for police vehicles, fixing car jack, wheel, nitro, and catalytic converter interactions on some vehicle classes.
Saved vehicle properties no longer re-apply persisted dirt level when vehicles are entered or tuning data is loaded.
Nitro HUD, order item images, and stolen parts dealer images now use the configured NUI item image base from sky_jobs_base.

Other Changes

Added Swedish translations.
Improved applied tuning loading for diagnostics.
Improved stance sync performance.

Download sky_mechanicjob from the CFX Portal.
Create a backup.
Replace the /source folder.
Replace the /config/locales folder.
Replace fxmanifest.lua so version 1.4.0 is loaded.
Update Config.CommandPermissions so command permissions are registered through sky_base ACE auto-wiring:

Config.CommandPermissions = {
    admintuning = { "god", "superadmin", "admin" },
    migrate = { "god", "superadmin", "admin" },
    workshopcreator = { "god", "superadmin", "admin" },
    debugwearzero = { "god", "superadmin", "admin" },
    debugwearzeroall = { "god", "superadmin", "admin" },
}

Replace Config.StolenPartsDealer with the new Config.PartsTheft section:

Config.PartsTheft = {
    item = "lug_wrench",
    removeItemAfterUse = false,
    stolenWheelItem = "wheels",
    catalyticConverterItem = "catalytic_converter",
    dealer = {
        account = "money",
        sellDistance = 5.0,
        items = {
            { name = "wheels", label = "Wheel", amount = 1, price = 120 },
            { name = "catalytic_converter", label = "Catalytic Converter", amount = 1, price = 600 }
        }
    }
}

Add forceMarkerInteraction to Config.InstantTuning:

Config.InstantTuning = {
    enabled = false,
    interactionDistance = 4.0,
    forceMarkerInteraction = true,
    priceMultiplier = 1.25,
    -- ...
}

Add Config.TuningWorkshopRequirement if you want tuning installs or removals to require a nearby self_service_tuning Workshop Creator point:

Config.TuningWorkshopRequirement = {
    requireForInstall = false,
    requireForRemoval = false,
    distance = 50.0
}

Replace the /config/locales folder.

May 11, 2026

Version 1.3.0

Before updating, make sure sky_base and sky_jobs_base is up to date.

Highlights

Refactored custom handling tuning so saved presets apply more reliably and no longer stack repeatedly on normal vehicle entry.
Persisted tuning is now applied when vehicles spawn, so vehicles can receive saved tuning before the player enters them.
Added lower-game-build electric vehicle support through Config.ElectricVehicleFallback.models.

Notable Changes

Added Config.CustomHandlingOptions.overwriteHandling for servers that use another handling editor which resets vehicle handling on every entry.
Custom handling now stores selected profiles instead of raw handling snapshots, making it safer with external handling resources.
Added support for fInitialDragCoeff and nInitialDriveGears in custom handling presets.
Instant tuning prices now use Config.InstantTuning.priceMultiplier.
Performance tuning menus now respect the configured maximum upgrade stage from Config.TuningCostProfile.
The tuning UI now receives explicit allowed values for limited upgrade stages instead of assuming every value between min and max is available.
Stance suspension height is now re-applied during stance runtime.

Other Changes

Fixed custom handling baseline capture before saved tuning is applied.
Fixed wheel damage and wheel theft detach handling so stolen wheels keep theft-specific brick behavior.

Download sky_mechanicjob from the CFX Portal.
Create a backup.
Replace the /source folder.
Replace fxmanifest.lua so source/server/vehicle_persistence.lua and version 1.3.0 are loaded.
Add priceMultiplier to Config.InstantTuning:

Config.InstantTuning = {
    enabled = false,
    interactionDistance = 4.0,
    priceMultiplier = 1.25,
    -- ...
}

Add overwriteHandling to Config.CustomHandlingOptions:

Config.CustomHandlingOptions = {
    enabled = true,
    -- Set this to true only when another handling editor/resource overwrites handling on every vehicle enter.
    -- WARNING: If no other handling script resets the vehicle handling first, this can multiply tuning again on each vehicle enter.
    overwriteHandling = false,
    -- ...
}

Add the electric vehicle fallback config if your server run below game build 3258:

Config.ElectricVehicleFallback = {
    models = {
        "airtug",
        "caddy",
        "caddy2",
        "caddy3",
        "cyclone",
        "cyclone2",
        "dilettante",
        "imorgon",
        "iwagen",
        "khamelion",
        "neon",
        "omnisegt",
        "powersurge",
        "raiden",
        "surge",
        "tezeract",
        "virtue",
        "voltic",
        "voltic2"
    }
}

May 9, 2026

Version 1.2.0

Before updating, make sure sky_base and sky_jobs_base is up to date.

Highlights

Added Vehicle Part Theft as a new criminal gameplay loop where catalytic converters and wheels can be stolen, sold, and repaired.
Added the stolen parts dealer interaction and UI so stolen wheels and catalytic converters can be sold to configured NPC dealers.
Added realistic theft consequences: stolen catalytic converters change vehicle sound and create smoke, while stolen wheels leave vehicles sitting on bricks.

Notable Changes

Added lug wrench theft selection so players can choose whether to steal a wheel or catalytic converter.
Added realistic catalytic converter removal and installation minigames using a jack, bolt interaction, and guided checklist flow.
Added wheel theft support using the existing wheel workflow, synced missing-wheel state, and inventory rewards.
Mechanics can repair stolen parts through diagnostics by replacing catalytic converters or missing wheels.
Added electric vehicle wear support for traction batteries and power inverters, including diagnostics labels and repair flows.
Tuning options can now be disabled individually and can define their own required install items directly in Config.TuningCostProfile.
Added Config.TuningCostProfile.freeVehicles for vehicles that should create free tuning orders.
Vehicle purchase price lookup is now configurable through Config.Functions.GetVehiclePurchasePrice.

Other Changes

Fixed vehicle paint saving and engine health restoration after re-entering vehicles.
Disabled stance support for motorbikes.
Self service tuning now always uses a marker instead of target.
Added lug_wrench.png, catalytic_converter.png, traction_battery.png, inverter.png, antilag_kit.png, and nitro_kit.png inventory images.
Added English, German, and French locale keys for part theft, catalytic converter work, wheel theft, stolen parts dealer, and electric vehicle wear parts.

Download sky_mechanicjob from the CFX Portal.
Create a backup.
Replace the /source folder.
Replace the /config/locales folder.
Replace the /html or built frontend files included with the resource so the catalytic converter minigame, lug wrench choice, and stolen parts dealer UI are available.
Replace fxmanifest.lua so the new client/server files and version 1.2.0 are loaded.
Copy the new inventory images from config/inventory into your inventory item image setup if your inventory requires item images.
Add the new theft and electric vehicle items to your mechanic shop items:

{ name = "traction_battery",   label = "Traction Battery",    price = 4200 },
{ name = "inverter",           label = "Power Inverter",      price = 1850 },

Add the new parts to Config.PartsDelivery.items:

{ name = "catalytic_converter", label = "Catalytic Converter", price = 1500, category = "Exhaust" },
{ name = "traction_battery",    label = "Traction Battery",    price = 4200, category = "Electronics" },
{ name = "inverter",            label = "Power Inverter",      price = 1850, category = "Electronics" },

Add the stolen parts dealer interaction to Config.Interactions:

stolen_parts_dealer = {
    public = true,
    interaction = true,
    unique = false,
    marker = {
        enabled = false,
        type = 1,
        offset = vector3(0.0, 0.0, 0.0)
    },
    blip = {
        enabled = false,
        name = "Parts Dealer",
        sprite = 500,
        color = 1
    },
    npc = {
        enabled = true,
        name = "Parts Dealer",
        pedHash = "s_m_m_autoshop_01",
        animation = {
            dict = "amb@world_human_leaning@male@wall@back@mobile@idle_a",
            name = "idle_a"
        }
    }
}

Add Config.StolenPartsDealer:

Config.StolenPartsDealer = {
    account = "money",
    sellDistance = 5.0,
    items = {
        { name = "wheels", label = "Wheel", amount = 1, price = 120 },
        { name = "catalytic_converter", label = "Catalytic Converter", amount = 1, price = 600 }
    }
}

Add or merge the new wear parts into Config.Wear.parts:

catalytic_converter = {
    kilometersToZero = 0,
    item = "catalytic_converter",
    removeAfterUse = true,
    flow = "catalytic_converter"
},
traction_battery = {
    kilometersToZero = 6000,
    item = "traction_battery",
    removeAfterUse = true,
    flow = "underbody_neon"
},
inverter = {
    kilometersToZero = 4500,
    item = "inverter",
    removeAfterUse = true,
    flow = "performance"
},

Add forceMarkerInteraction = true to Config.Interactions.self_service_tuning if you use marker-based self-service tuning.
Update Config.TuningCostProfile from the new config.
Add or merge Config.Functions.GetVehiclePurchasePrice from config/sv_functions.lua.
Add lug_wrench, catalytic_converter, traction_battery, and inverter to your inventory item definitions.
Add one or more stolen_parts_dealer points in Workshop Creator where stolen parts should be sold.

May 6, 2026

Version 1.1.0

Before updating, make sure sky_base and sky_jobs_base is up to date.

Highlights

Added configurable instant tuning locations that can apply tuning directly without creating a workshop order.
Added tuning order refund and completed-order delete actions in the mechanic tablet.
Added a fix_kit usable item workflow for repairing nearby vehicles, including realistic wheel damage repair support.

Notable Changes

Tuning prices can now use percentage-based or fixed money values through Config.TuningCostProfile.priceType.
Tuning cost config keys were standardized from percentage-specific names to generic cost fields.
The mechanic tablet now shows order status and payment method, and supports refunded order state.
Currency display is now configurable through locale files.
Custom handling tuning options now save correctly and show as applied in the tuning menu.
Fix kit repairs can reset realistic wheel damage when Config.VehicleCare.repair.fixRealisticWheelDamage is enabled.

Other Changes

Added fix_kit.png inventory image.
Added society_job, refunded_at, refunded_by_identifier, and refunded_by_name columns to sky_mechanic_tuning_orders.
Added English, German, and French locale keys for instant tuning, order refunds, order deletion, fix kit, and configurable currency symbols.
Updated French translations.
Fixed wheel damage repair behavior when using the fix kit.

Download sky_mechanicjob from the CFX Portal.
Create a backup.
Replace the /source folder.
Replace the /config/locales folder.
Replace the /html or built frontend files included with the resource so the updated tablet order actions and currency display are available.
Replace fxmanifest.lua so version 1.1.0 is loaded.
Copy config/inventory/fix_kit.png into your inventory item image setup if your inventory requires item images.
If you use custom locale files, copy the new instant tuning, order refund/delete, fix kit, and currency translation keys from the updated locale files.
Add fix_kit to your mechanic shop items:

{ name = "fix_kit", label = "Fix Kit", price = 650 },

Add fix_kit to Config.PartsDelivery.items if you use the Parts Shop:

{ name = "fix_kit", label = "Fix Kit", price = 650, category = "Service" },

Add the repair section to Config.VehicleCare:

Config.VehicleCare = {
    wash = {
        item = "wash_sponge",
        removeAfterUse = true
    },
    wax = {
        item = "vehicle_wax",
        removeAfterUse = true,
        cleanKilometers = 35
    },
    repair = {
        item = "fix_kit",
        removeAfterUse = true,
        durationMs = 10000,
        maxDistance = 6.0,
        fixRealisticWheelDamage = true
    }
}

Add Config.InstantTuning if you want direct tuning locations:

Config.InstantTuning = {
    enabled = false,
    interactionDistance = 4.0,
    label = "Instant Tuning",
    marker = {
        enabled = true,
        type = 1,
        offset = vector3(0.0, 0.0, 0.0)
    },
    blip = {
        enabled = false,
        name = "Instant Tuning",
        sprite = 72,
        color = 5
    },
    npc = {
        enabled = false
    },
    locations = {
        -- {
        --     coords = vector3(-337.02, -136.32, 39.01),
        --     heading = 0.0,
        --     label = "Instant Tuning"
        -- }
    }
}

Update Config.TuningCostProfile to the new pricing format in the new config.
Add fix_kit to your inventory item definitions if your inventory requires explicit item registration.
If Config.AutoExecuteQuery = false, run the updated import.sql manually so the tuning order refund columns are created.

Apr 30, 2026

Version 1.0.0

Before updating, make sure sky_base and sky_jobs_base is up to date.

Highlights

Added a realistic wheel damage system with synced wheel damage state, popped tyres, detached wheels, and handling penalties.
Added damaged-wheel repair support through the vehicle diagnostics repair flow.
Improved workshop car lift synchronization so raised vehicles and lift attachments stay consistent for other players.

Notable Changes

Wheel damage now reacts to collisions and hard landings, with configurable multipliers per vehicle class and off-road wheel type.
Wheel damage is synchronized through vehicle state bags and can be reset by mechanic repair actions.
Only one wheel can detach from a vehicle at a time to reduce vehicle physics issues.
Wheel damage runtime performance was improved and the default config was cleaned up.
Sponge and wax inventory item images were added for the vehicle care items introduced in the previous update.
Fixed lift vehicle sync and duplicate lift prop issues.

Other Changes

Added source/client/wheel_damage.lua and source/server/wheel_damage.lua.
Added source/server/lift.lua.
Added Config.WheelDamage.
Updated the diagnostics tablet flow for damaged wheel repairs.
Added wash_sponge.png and vehicle_wax.png inventory images.

Download sky_mechanicjob from the CFX Portal.
Create a backup.
Replace the /source folder.
Replace the /config/locales folder.
Replace the /html or built frontend files included with the resource so the updated diagnostics repair flow is available.
Replace fxmanifest.lua so source/client/wheel_damage.lua, source/server/wheel_damage.lua, source/server/lift.lua, and version 1.0.0 are loaded.
Copy config/inventory/wash_sponge.png and config/inventory/vehicle_wax.png into your inventory item image setup if your inventory requires item images.
Add the new wheel damage config to config/config.lua:

Config.WheelDamage = {
    enabled = true,
    multipliers = {
        default = 1.0,
        offroadWheels = 0.65,
        vehicleClasses = {
            [0] = 1.0,  -- Compacts
            [1] = 1.0,  -- Sedans
            [2] = 0.9,  -- SUVs
            [3] = 1.05, -- Coupes
            [4] = 1.05, -- Muscle
            [5] = 1.0,  -- Sports Classics
            [6] = 1.0,  -- Sports
            [7] = 1.1,  -- Super
            [8] = 0.0,  -- Motorcycles
            [9] = 0.7,  -- Off-road
            [10] = 0.85, -- Industrial
            [11] = 0.95, -- Utility
            [12] = 0.95, -- Vans
            [13] = 0.0,  -- Cycles
            [14] = 0.0,  -- Boats
            [15] = 0.0,  -- Helicopters
            [16] = 0.0,  -- Planes
            [17] = 0.85, -- Service
            [18] = 0.8,  -- Emergency
            [19] = 0.75, -- Military
            [20] = 0.85, -- Commercial
            [21] = 0.0,  -- Trains
            [22] = 1.0   -- Open Wheel
        }
    }
}

If you use custom diagnostics or wear repair config, make sure tyre repairs are allowed to use the updated wheel repair flow.

Apr 28, 2026

Version 0.6.0

Before updating, make sure sky_base and sky_jobs_base is up to date.

Highlights

Added vehicle wash and vehicle wax usable-item workflows, including dedicated wash/wax items, animations, particle effects, and a vehicle-care minigame.
Added realistic wheel-based brake and suspension install flows so brake and suspension work now uses jack, wheel detach, component install, wheel attach, and jack removal steps.
Added a configurable install duration and an on-screen progress bar for non-minigame install actions.

Notable Changes

Vehicle wax now keeps a clean vehicle clean for a configurable mileage window through Config.VehicleCare.wax.cleanKilometers.
Wash and wax items are now available in the mechanic shop and Parts Shop delivery catalog.
Brake pad and suspension wear repairs now use the wheel workflow instead of a simple repair flow.
Improved mechanic animations for under-hood repairs, engine swaps, oil draining, oil pouring, and underbody installs.
Added storage, locker, and trunk background images for the mechanic UI.
Fuel level is no longer overwritten when saving or restoring mechanic vehicle properties.

Other Changes

Added source/client/vehicle_care.lua and source/server/vehicle_care.lua.
Added Config.OrderInstall.nonMinigameDurationMs.
Added Config.VehicleCare for wash and wax item configuration.
Added English, German, and French translation keys for vehicle care and the new wheel checklist steps.
Fixed repaint workflow particle effects.
Updated the wheel attach minigame so brake and suspension workflows can reattach the existing wheel.

Download sky_mechanicjob from the CFX Portal.
Create a backup.
Replace the /source folder.
Replace the /config/locales folder.
Replace the /html or built frontend files included with the resource so the vehicle-care minigame, install progress bar, and storage backgrounds are available.
Replace fxmanifest.lua so source/client/vehicle_care.lua, source/server/vehicle_care.lua, config/img/**, and version 0.6.0 are loaded.
If the release package includes /config/img, copy it so the new storage, locker, and trunk background images are available.
If you use custom locale files, copy the new vehicle-care and wheel-checklist translation keys from the updated locale files.
Add the new wash and wax items to your mechanic shop items:

{ name = "wash_sponge", label = "Wash Sponge", price = 45 },
{ name = "vehicle_wax", label = "Vehicle Wax", price = 120 },

Add the new wash and wax items to Config.PartsDelivery.items if you use the Parts Shop:

{ name = "wash_sponge", label = "Wash Sponge", price = 45, category = "Service" },
{ name = "vehicle_wax", label = "Vehicle Wax", price = 120, category = "Service" },

Add the new install duration and vehicle care config sections to config/config.lua:

Config.OrderInstall = {
    nonMinigameDurationMs = 10000
}

Config.VehicleCare = {
    wash = {
        item = "wash_sponge",
        removeAfterUse = true
    },
    wax = {
        item = "vehicle_wax",
        removeAfterUse = true,
        cleanKilometers = 35
    }
}

Add wash_sponge and vehicle_wax to your inventory item definitions and item images if your inventory requires them.
If you use custom wear repair config, make sure brake pad and suspension repairs use the wheel flow.

Apr 27, 2026

Version 0.5.0

Before updating, make sure sky_base and sky_jobs_base is up to date.

Highlights

Added the Parts Shop tablet app for mechanic part orders, including catalog browsing, category filters, basket checkout, own-card and company-card payment, and order history.
Added Parts Delivery points for Workshop Creator so ordered parts arrive as physical delivery boxes at configured workshop locations.
Added tablet push notifications when part deliveries are ready to collect.

Notable Changes

Parts purchases can now be logged in the boss menu, including order UID, price, and ordered item summary.
Parts deliveries now support delivery ETA, pending/ready/claimed status tracking, claim history, and ready-delivery lookup by delivery point.
Delivery box props now scale by order size so larger orders use larger box piles.
Company-card checkout now uses the PURCHASE_SUPPLIES job permission and validates company balance before placing an order.
The Parts Shop app now reopens correctly after closing the tablet, and app permission routing was fixed.
Tuning freecam now blocks player controls while keeping camera look controls available.
Wheel lug nut indicators are easier to see in the wheel detach minigame.

Other Changes

Added the sky_mechanic_part_deliveries database table and automatic migration support.
Added English translation keys for Parts Shop, Parts Delivery, checkout errors, order history, and delivery notifications.
Fixed order history timestamps.
Improved delivery interaction logic.
Refined Parts Shop navbar, color theming, and overall design.

Download sky_mechanicjob from the CFX Portal.
Create a backup.
Replace the /source folder.
Replace the /config/locales folder.
Replace the /html or built frontend files included with the resource so the new Parts Shop tablet app is available.
Replace fxmanifest.lua so @sky_jobs_base/source/enums/Permission.lua, source/client/parts_delivery.lua, source/server/parts_delivery.lua, and version 0.5.0 are loaded.
If you use custom locale files, copy the new Parts Shop and Parts Delivery translation keys from the updated locale files.
Add the new Parts Delivery interaction to Config.Interactions:

part_delivery = {
    public = false,
    interaction = true,
    unique = false,
    marker = {
        enabled = false,
        type = 1,
        offset = vector3(0.0, 0.0, 0.0)
    },
    blip = {
        enabled = false,
        name = "Parts Delivery",
        sprite = 478,
        color = 5
    },
    npc = {
        enabled = false
    }
}

Add the new Config.PartsDelivery section to config/config.lua:

Config.PartsDelivery = {
    enabled = true,
    deliveryTimeSeconds = 900,
    paymentMethods = {
        own_card = true,
        company_card = true
    },
    boxModel = "prop_cs_cardbox_01",
    openDurationMs = 5500,
    interactionDistance = 2.0,
    stackHeight = 0.42,
    items = {
        { name = "body_kit",           label = "Body Kit",           price = 250,  category = "Exterior" },
        { name = "wheels",             label = "Wheels",             price = 300,  category = "Wheels" },
        { name = "spray_can",          label = "Spray Can",          price = 75,   category = "Paint" },
        { name = "engine",             label = "Engine",             price = 3500, category = "Performance" },
        { name = "brakes",             label = "Brakes",             price = 450,  category = "Performance" },
        { name = "transmission",       label = "Transmission",       price = 2200, category = "Performance" },
        { name = "turbo",              label = "Turbo",              price = 1800, category = "Performance" },
        { name = "antilag_kit",        label = "Anti-Lag Kit",       price = 950,  category = "Electronics" },
        { name = "suspension",         label = "Suspension",         price = 700,  category = "Handling" },
        { name = "armor_plating",      label = "Armor Plating",      price = 1600, category = "Exterior" },
        { name = "stance_kit",         label = "Stance Kit",         price = 850,  category = "Handling" },
        { name = "nitro_kit",          label = "Nitro Kit",          price = 1400, category = "Performance" },
        { name = "vehicle_lights",     label = "Vehicle Lights",     price = 550,  category = "Electronics" },
        { name = "spark_plugs",        label = "Spark Plugs",        price = 120,  category = "Service" },
        { name = "engine_oil",         label = "Engine Oil",         price = 90,   category = "Service" },
        { name = "engine_coolant",     label = "Engine Coolant",     price = 110,  category = "Service" },
        { name = "brake_fluid",        label = "Brake Fluid",        price = 85,   category = "Service" },
        { name = "transmission_fluid", label = "Transmission Fluid", price = 95,   category = "Service" },
        { name = "air_filter",         label = "Air Filter",         price = 140,  category = "Service" },
        { name = "rgb_controller",     label = "RGB Controller",     price = 650,  category = "Electronics" }
    }
}

Add a part_delivery point in Workshop Creator for every workshop that should receive part orders.
If Config.AutoExecuteQuery = false, run the updated import.sql manually so sky_mechanic_part_deliveries is created.

Apr 26, 2026

Version 0.4.0

Before updating, make sure sky_base and sky_jobs_base is up to date.

Highlights

Added synced custom xenon colors across players, including re-application when vehicles stream in or players join.
Added German and French translations.
Added a tuning menu reset button for stancing so vehicles can be restored to default stance values directly from the UI.

Notable Changes

Improved stancing persistence when leaving and re-entering vehicles, including wheel size, wheel width, camber, track width, suspension height, and wheel rotation values.
Improved performance for nitro, anti-lag, two-step, RGB effects, vehicle wear, and general in-vehicle idle loops.
Nitro now uses keymapping support through Config.Nitro.activationKey, with separate timing controls for active ticks, input checks, local effects, and remote effects.
Engine hoist props created through the Workshop Creator now spawn and sync more reliably from configured placement points.
Fixed unwanted neon installs during the order workflow.

Other Changes

Fixed stance reset behavior in the tuning menu.
Fixed engine hoist placement in the Workshop Creator flow.
Cleaned up stancing and nitro runtime logic for better maintainability.
Updated two-step default flame scale values.

Download sky_mechanicjob from the CFX Portal.
Create a backup.
Replace the /source folder.
Replace the /config/locales folder.
Replace fxmanifest.lua so the new source/client/xenon_sync.lua file and version metadata are loaded.
If you use custom locale files, copy the new translation keys from the updated locale files.
If you use custom config files, update Config.Interactions.self_service_tuning:

Config.Interactions = {
    self_service_tuning = {
        public = true,
        interaction = false,
        unique = false,
+       placementModel = "xs_prop_x18_engine_hoist_02a",
        marker = {
            enabled = false,
            type = 1,
        }
    }
}

Update Config.Nitro with the new keymapping and timing options:

Config.Nitro = {
    installDistance = 4.0,
    frontDistance = 2.2,
    maxLevel = 100,
+   activationKey = "LSHIFT",
    activationControl = 21,
    minSpeedKmh = 25.0,
    throttleThreshold = 0.85,
    drainPerSecond = 8.5,
    torqueMultiplier = 1.32,
    boostRampInPerSecond = 3.8,
    boostRampOutPerSecond = 2.4,
-   effectIntervalMs = 90,
+   activeTickMs = 25,
+   inputCheckIntervalMs = 120,
+   effectIntervalMs = 180,
+   remoteEffectIntervalMs = 320,
    purgeIntervalMs = 180,
    flameScale = 0.72,
    flameDurationMs = 110,
}

Update the default two-step flame scale values if you want the new defaults:

Config.TwoStep = {
-   flameScaleMin = 0.35,
-   flameScaleMax = 0.95,
+   flameScaleMin = 0.45,
+   flameScaleMax = 1.25,
}

Apr 22, 2026

Version 0.3.0

Before updating, make sure sky_base and sky_jobs_base is up to date.

Highlights

Added paid tuning revenue deposits into the mechanic society account through Config.TuningCostProfile.addRevenueToSociety.
Added a dedicated vehicle_lights item for light installations, including the item image and tablet/localization labels.
Neon, drivetrain, and suspension installs now use the workshop lift flow so mechanics must work below the raised vehicle.
Added client and server mileage exports via GetVehicleMileage.

Notable Changes

Default tuning install items are now consumed after use through Config.OrderRequiredItems.*.removeAfterUse = true.
Neon installation pricing is now included in the tuning cost profile.
Mileage HUD design has been refreshed for a more realistic in-vehicle look.
Vehicle plate labels now resolve correctly in mechanic state and interaction flows.
Shared tuning database helper logic was centralized to reduce duplicate server code.

Other Changes

Fixed a database migration primary-key error for vehicle profiles.
Fixed fxmanifest warnings.
Fixed a tablet navigation issue that could leave players stuck in the tablet.
Removed the unused NPC mechanic example from the default config.

Download sky_mechanicjob from the CFX Portal.
Create a backup.
Replace the /source folder.
Replace the /config/locales folder.
Replace fxmanifest.lua so the updated server/client file list is loaded.
Copy the new vehicle_lights.png item image from config/inventory into your inventory item image setup if needed.
If you use custom locale files, copy the new translation keys from the updated locale files.
Add the society revenue option to Config.TuningCostProfile:

Config.TuningCostProfile = {
+   addRevenueToSociety = true, -- Deposit paid tuning order money into the society account of the tuning job.
    fallbackVehicleValue = 50000,
    performanceStages = {
        -- ...
    }
}

Add vehicle_lights to the mechanic shop item list:

{ name = "vehicle_lights", label = "Vehicle Lights", price = 550 },

Update Config.OrderRequiredItems so install items are consumed and light installs use the new item:

Config.OrderRequiredItems = {
    bodywork = { item = "body_kit", removeAfterUse = true },
    wheels = { item = "wheels", removeAfterUse = true },
    colors = { item = "spray_can", removeAfterUse = true },
    engine = { item = "engine", removeAfterUse = true },
    brakes = { item = "brakes", removeAfterUse = true },
    transmission = { item = "transmission", removeAfterUse = true },
    turbo = { item = "turbo", removeAfterUse = true },
    antilag = { item = "antilag_kit", removeAfterUse = true },
    lights = { item = "vehicle_lights", removeAfterUse = true },
    suspension = { item = "suspension", removeAfterUse = true },
    armor = { item = "armor_plating", removeAfterUse = true },
    stancing = { item = "stance_kit", removeAfterUse = true },
    custom_tuning = { item = "stance_kit", removeAfterUse = true }
}

Add neon pricing entries inside Config.TuningCostProfile.customPricing:

neon_0 = 1.12,
neon_1 = 1.12,
neon_2 = 1.12,
neon_3 = 1.12,

If you use custom drivetrain or suspension config, add the lift-based install flow:

-- Drivetrain custom handling option
+ installFlow = "underbody_neon",

-- Suspension wear repair option
- flow = "performance"
+ flow = "underbody_neon"

If Config.AutoExecuteQuery = false, run the updated import.sql manually so the vehicle profile primary-key migration fix is applied.

Apr 20, 2026

Version 0.2.0

Before updating, make sure sky_base and sky_jobs_base is up to date.

Highlights

Added the Vehicles App to the mechanic tablet with searchable, paginated vehicle records, linked tuning orders, service history, tags, notes, and gallery image assignment.
Added automatic database migration support through Config.AutoExecuteQuery.
Added /migrate command for importing tuning data from previous mechanic scripts such as jg-mechanic.

Notable Changes

Vehicle history is now logged for order installs, nitro installs/refills, and wear repairs, including used items, mechanic details, duty state, and action metadata.
Tuning orders can now link back into the Vehicles App, and vehicle records only list vehicles that have mechanic orders.
Tablet apps now reopen and close more reliably, including direct order selection from linked vehicle records.
Self-service tuning now supports multiple placement points and requires the player to be the driver.
Added optional off-duty job configuration per mechanic job.
Xenon color changes now calculate order pricing correctly.

Other Changes

Added sky_mechanic_vehicle_profiles and sky_mechanic_vehicle_history database tables.
Added /migrate command permission.
Added Config.Interactions.self_service_tuning.unique.
Removed the example cardealer job from the default config.
Improved wear database readiness handling by moving schema setup into the shared mechanic migration flow.

Download sky_mechanicjob from the CFX Portal.
Create a backup.
Replace the /source folder.
Replace the /config/locales folder.
Replace fxmanifest.lua so the new client/server files are loaded.
If you use custom locale files, copy the new translation keys from the updated locale files.
Add in config/config.lua:

Config.AutoExecuteQuery = true -- Automatically creates/updates database tables on start. Set to false to disable.

Add offDutyJob to each mechanic job in Config.Jobs if you want off-duty job support:

offDutyJob = {
    enabled = false,
    job = "off_mechanic"
},

Update Config.Interactions.self_service_tuning:

Config.Interactions = {
    self_service_tuning = {
        public = true,
+       unique = false,
        marker = {
            enabled = true,
            type = 1,
        }
    }
}

Add the new command permission:

Config.CommandPermissions = {
    admintuning = { "god", "superadmin", "admin" },
    migrate = { "god", "superadmin", "admin" },
}

If Config.AutoExecuteQuery = false, run the updated import.sql manually so the new profile and history tables are created.
Optional: run /migrate once if you need to import tuning data from a previous mechanic script such as jg-mechanic.

Apr 15, 2026

Version 0.1.0

Highlights

Initial release of Sky Mechanic Job.
Added full workshop-based tuning flow with creator placement support through sky_jobs_base.
Added persistent tuning, tuning orders, mileage tracking, and vehicle wear.

Notable Changes

Added self-service tuning and mechanic workshop interactions.
Added engine swaps, repaint flow, wheel changes, workshop lifts, and engine hoists.
Added nitro, anti-lag, two-step, RGB controller support, and custom handling options.
Added persistent storage of tuning data in sky_mechanic_vehicle_tuning.
Added tuning order persistence in sky_mechanic_tuning_orders.

Other Changes

Added admin tools: /admintuning, /debugwearzero, /debugwearzeroall, and /workshopcreator.

Commands

Command reference for the Sky Mechanic Job resource.

Introduction

sky_base is a crucial component for all Sky-Systems scripts, designed to enhance performance, streamline configuration, and provide a unified framework for easier management. This guide will introduce you to sky_base and walk you through its configuration and use.