Changelog

Highlights

• Added a wheel damage system that can damage, pop, and detach wheels from collisions, hard landings, and vehicle class/wheel-type multipliers.
• Added mechanic repair support for damaged tyres through the Diagnostics App and the existing wheel workflow.
• Improved car lift vehicle synchronization so attached vehicles are synced to nearby players through the server.

Notable Changes

• Wheel damage is synced through vehicle state bags and server-side validation, including distance checks and mechanic-only reset handling.
• Wheel damage is configurable with Config.WheelDamage.enabled, default multipliers, off-road wheel multipliers, and per-vehicle-class multipliers.
• Only one wheel can detach at a time to reduce vehicle physics issues.
• Tyre repairs can skip the detach step when the wheel is already detached by wheel damage.
• The Diagnostics App now shows damaged tyres as repairable even when normal tyre wear is otherwise full.
• Car lift attachment and detachment events now sync to nearby players and avoid duplicated lift props.

Other Changes

• Added inventory images for wash_sponge and vehicle_wax.

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
        }
    }
}

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.

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

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

Config.OrderInstall = {
    nonMinigameDurationMs = 10000
}

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

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.

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
    }
}

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" }
    }
}

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.

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

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,
}

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

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.

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

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

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 }
}

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

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

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

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.

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

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

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

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

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.