Changelog

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.

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

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

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

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

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.

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

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

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

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.

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

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

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

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

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

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.

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

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

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

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

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.

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.