Changelog

Highlights

• Improved mechanic tuning, carry-item, parts delivery, and instant tuning flows.
• Added Engine Hoist support for engine installs.
• Added better Instant Tuning management through the Job Configurator.

Notable Changes

• Fixed engine installs so carried engines and inventory engines are both handled correctly.
• Fixed moved parts delivery pallets so they can still be unpacked.
• Fixed tuning freecam focus so players can return to the tuning UI more reliably.
• Fixed tuning basket removal so other preview changes are not lost.
• Fixed unpaid light previews so they are restored when tuning is closed.
• Added stancer support to the applied tuning list in the mechanic tablet.
• Added an admin full vehicle repair export.
• Improved customer name display by preferring in-game character names.
• Fixed self-service tuning so it creates mechanic orders again.

Highlights

• Added shared in-game job configurator support for mechanic jobs, features, interactions, pricing/settings, parts delivery, wear, wheel damage, vehicle care, and carry-item settings.

Notable Changes

• Fixed Nitro, Anti-Lag, and Two-Step backfire effects on tuned exhausts through shared vehicle effect handling.
• Added config/adv_config.lua and moved advanced/static settings out of the main config/config.lua.

Changes

• Fixed vehicle color handling so selected paint, custom colors, pearlescent, wheel, dashboard, and interior colors are kept more reliably after tuning and restoring vehicles.
• Reworked Stancer saving and loading so stance changes stay synced better, while self-service previews no longer save unpaid changes before checkout.

Highlights

• Stancer persistence was fully stabilized across re-enter, garage outpark, impound retrieval, menu close/reopen, and resource restart.
• Vehicle restore timing and guard flow were cleaned up to stop duplicate overwrite waves and workshop flicker behavior.
• Core runtime systems (Anti-Lag, Nitro, Two-Step, Self-Service pricing, Instant Tuning access) were unified and made more reliable.

Notable Changes

• Stancer persistence overhaul:
  • Added session snapshot + dirty-state handling to prevent transient GTA defaults from overwriting tuned stance.
  • Added immediate debounced save for camber, track width, suspension height, wheel size, and wheel width.
  • Added stronger delayed stance stability checks for suspension/camber/track after restore.
• Persistence stability fixes:
  • Fixed runtime blockers around sanitizePlate and lastKnownStanceByPlate.
  • Fixed local guard scope/order in vehicle persistence to prevent purchase callback instability.
  • Reduced broad reapply storms and duplicate late restore paths.
• Self-Service / Instant Tuning:
  • Public self-service pricing visibility is now controlled by Config.TuningCostProfile.publicUsersSeePrices.
  • Instant tuning now supports global and per-location job restrictions (mechanicOnly, allowedJobs/jobs) with client/server enforcement.
• Two-Step / Anti-Lag / Nitro runtime:
  • Anti-Lag moved to config-driven runtime balancing.
  • Two-Step now includes configurable launch-control behavior and improved trigger consistency.
  • Nitro got live HUD/progress sync improvements, better hide behavior, and stronger config runtime control.

Other Changes

• Reduced repeated paint apply bursts and restore spam in heavy spawn/re-enter windows.
• Improved tuning close behavior so unpaid preview/reset flows do not persist unintended changes.
• Reduced mechanic debug console noise by gating noisy traces behind debug mode.
• Improved diagnostics tyre-item validation to enforce server-authoritative repair item checks.

Config.AntiLag = {
    defaultEnabled = false,
    activationRpm = 0.72,
    minGear = 1,
    burstIntervalMinMs = 45,
    burstIntervalMaxMs = 120,
    flameDurationMs = 70,
    flameScaleMin = 0.45,
    flameScaleMax = 1.25,
    defaultFlameScaleLevel = 7,
    defaultVolumeLevel = 5,
    turboPressureSpikeEnabled = false,
    turboPressureSpike = 25.0
}

Config.Nitro = {
    item = "nitro_kit",
    mechanicOnly = true,
    maxBottles = 3,
    activationKey = "LSHIFT",
    minSpeedKmh = 25.0,
    drainPerSecond = 8.5,
    powerMultiplier = 32.0,
    torqueMultiplier = 1.32,
    purgeEnabled = true,
    notifyOnVehicleEnter = true,
    maxLevel = 100,
    saveIntervalMs = 1000,
    hudUpdateIntervalIdleMs = 350,
    hudUpdateIntervalActiveMs = 80,
    installDurationMs = 10000,
    installDistance = 6.0,
    installFrontDistance = 2.6,
    effectIntervalMs = 75,
    remoteEffectIntervalMs = 150,
    flameScale = 1.0,
    flameDurationMs = 90,
    purgeScale = 0.85,
    purgeDurationMs = 120,
    purgeTickIntervalMs = 90,
    purgeHoldDurationMs = 220,
    emptyHudHideDelayMs = 850,
    boostRampInPerSecond = 3.2,
    boostRampOutPerSecond = 2.2,
    throttleThreshold = 0.15,
    activeTickMs = 25,
    inputCheckIntervalMs = 60,
    screenShake = true,
    shakeIntervalMs = 240,
    hud = {
        enabled = true,
        position = {
            left = "50%",
            top = "3vh"
        }
    }
}

Config.TwoStep = {
    enabled = true,
    useFootBrake = true,
    useHandbrake = false,
    maxSpeedKmh = 25.0,
    minGear = 0,
    maxGear = 2,
    rpmWindowMin = 0.08,
    rpmWindowMax = 0.95,
    burstIntervalMinMs = 55,
    burstIntervalMaxMs = 115,
    flameDurationMs = 130,
    flameScaleMin = 0.7,
    flameScaleMax = 1.8,
    defaultFlameScaleLevel = 10,
    defaultVolumeLevel = 8,
    turboPressureSpikeEnabled = true,
    turboPressureSpike = 28.0,
    launchControl = {
        enabled = true,
        holdHandbrake = true,
        rpmTarget = 0.72,
        holdTorqueMultiplier = 0.12,
        releaseRampMs = 90,
        releaseTorqueStartMultiplier = 0.9
    }
}

Config.InstantTuning = {
    -- ...
    mechanicOnly = false,
    allowedJobs = nil, -- Example: { "mechanic", "tuner" }
    locations = {
        {
            coords = vector3(-337.02, -136.32, 39.01),
            heading = 0.0,
            label = "Instant Tuning",
            mechanicOnly = true,
            allowedJobs = { "mechanic" }
        }
    }
}

Config.TuningCostProfile = {
    addRevenueToSociety = true,
    publicUsersSeePrices = true,
    -- ...
}

Highlights

• Reworked vehicle persistence and restore handling to make tuning states more stable after garage, impound, outpark, re-enter, and restart flows.
• Improved paint, pearlescent, wheel color, xenon, RGB, and livery synchronization to reduce color resets and duplicated visual apply behavior.
• Improved stance persistence for critical values such as camber, suspension, track width, wheel size, and wheel width.

Notable Changes

• Added stronger one-shot restore guards so vehicles are not repeatedly overwritten after spawning or entering.
• Reduced aggressive restore waves and apply storms that caused marker, menu, or workshop flickering.
• Cleaned overlapping spawn, enter, delayed restore, and restart apply paths.
• Improved Self-Service tuning flow so purchases, snapshots, and applied vehicle states stay more consistent.
• Improved support for native liveries and mod slot 48 liveries while removing duplicate livery entries.

Other Changes

• Reduced random stancer resets after seat changes, vehicle re-enter, garage, and impound transitions.
• Improved persistence fallback for critical stance and vehicle appearance values.
• Reduced repeated paint apply bursts after full vehicle restore.
• Softened runtime stabilization to avoid unnecessary continuous forcing.
• Decoupled broad global vehicle apply triggers such as entityCreated.
• General cleanup of restore, save, load, and apply logic.

Config.CustomHandlingOptions = {
    -- ...
    overwriteHandling = false
}

Config.InstantTuning = {
    -- ...
    priceMultiplier = 1.25
}

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

Config.Interactions = {
    self_service_tuning = {
        -- ...
        forceMarkerInteraction = true
    }
}

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.

interactionDistance = 2.5

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

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.