Changelog

Highlights

• Added synchronized custom engine sounds with an audible tuning preview for the mechanic and nearby players.
• Added a multiplayer vehicle push system for heavily damaged vehicles, including steering, stamina, terrain effects, and support for up to three players.
• Added Dyno result sharing with nearby players through a protected read-only tablet view.
• Added finer per-job tuning controls for individual upgrade stages, values, and paint ranges such as Chameleon colors.
• Improved Stancer synchronization, tuning preview protection, Parts Delivery notifications, and overall client performance.

Notable Changes

• Custom engine sounds are now replicated through the vehicle state so nearby players hear the selected sound. The engine continuously revs while an Engine Sound option is focused, making sounds easier to compare before purchase.
• Engine sound entries accept common field formats and case-insensitive matching while preserving the configured GTA audio name.
• Disabled vehicles can be pushed from the front or rear with E, steered with A/D, moved with W/S, and boosted with SHIFT.
• Vehicle pushing supports weight classes, slopes, stamina, helper bonuses, synchronized three-player formations, automatic cancellation, and a dedicated status HUD.
• Completed Dyno results can be shared with a player within 5m. The recipient's tablet opens directly to a read-only result and graph.
• Tuning profiles can enable or disable individual upgrade stages and use allowedValues or blockedValues for exact values and ranges.
• The Job Configurator now provides value controls and presets for Standard and Chameleon paint ranges without requiring manual JSON editing.
• Realistic Wheel Damage multipliers now update immediately after saving Job Configurator changes and support decimal values such as 0.1.
• Secondary tuning sections are grouped under a localized More menu, while the main categories and basket stay directly accessible.

Fixes and Improvements

• Unpaid tuning previews now freeze the connected vehicle and restore its original state if the player exits, changes driver, moves the vehicle, or leaves the workshop area.
• Stancer wheel size, wheel width, camber, track width, and suspension height remain more reliable after rim changes, installation, garage spawning, vehicle damage, stream-in, and driver changes.
• Parts Delivery notifications now validate that a delivery still exists before creating a waypoint. Valid notifications mark the pickup location instead of reopening the Parts Shop.
• Mechanic tablet apps are registered for mechanic jobs created only through /jobconfig, not only jobs listed in config.lua.
• Reduced idle client usage for Stancer updates, vehicle persistence, vehicle push detection, Parts Delivery checks, and self-service tuning interactions.
• Healthy vehicles can no longer be pushed only because their engine was switched off.

Highlights

• Added partial tuning-order refunds for individual uninstalled positions or all remaining uninstalled positions while keeping installed tuning paid.
• Added live inventory counters for every required part in the mechanic tablet's tuning-order details.
• Added per-job Nitro access overrides with inherit, enabled, and disabled modes.
• Added configurable account or inventory-item payouts for the stolen parts dealer.
• Added configurable Stancer slider scales, bounds, and defaults.
• Added an external HUD visibility hook for tuning sessions.

Notable Changes

• Refunded tuning positions now keep their amount, timestamp, and responsible employee for a complete audit trail.
• Order totals and statuses are recalculated after partial refunds, and refunded positions can no longer be installed.
• Server-side order locking prevents refund and installation actions from modifying the same order simultaneously.
• Required-part counters total matching items across all inventory slots and display (0) when an item is missing.
• Parts Delivery now waits for valid network IDs, recreates invalid delivery entities, retries client resolution, and requests a fresh sync when necessary.
• Delivery resolver threads are cancelled when deliveries are removed, preventing missing or resurrected pallets and repeated network-object warnings.
• Wheel size and width synchronization now handles late-streaming garage vehicles, delayed property restoration, changed wheel setups, and superseded state updates.
• Instant Tuning now has its own localized menu title while preserving the existing Admin Tuning, Self Service Tuning, RGB Controller, and Stance Kit titles.
• Stance wheel adjustments on Workshop Lifts now use the dedicated streamed tune/anim animation and continue when FiveM reports a custom clip duration of 0.0.
• Per-job Nitro access is enforced for boost use, Nitro Kit installation, installation callbacks, and state updates without restricting other workshop tuning features.
• Stolen parts dealer item payouts validate inventory capacity and restore the sold part if the payout item cannot be added.
• Saved vehicle-specific Stance values remain higher priority than configured slider defaults, while Reset Stance still restores the captured factory state.

Other Changes

• Added Config.Functions.SetExternalHudVisible(visible) so external HUDs can be hidden while tuning is open and restored through every central close path.
• External HUD export failures are logged without blocking the tuning menu.
• Existing tuningCostProfile.nitroAccess values remain supported as a compatibility fallback.
• Added detailed stolen parts dealer diagnostics for configurator updates, payout targets, inventory checks, framework results, and balances.
• Added validation for invalid Stancer scales and reversed slider bounds.
• Added the localized Instant Tuning title to every bundled mechanic locale and rebuilt the production NUI.

nitroAccess = "inherit" -- "inherit", "enabled", or "disabled"

dealer = {
    payoutType = "account", -- "account" or "item"
    account = "money",
    payoutItem = "black_money"
}

Config.StancerOptions = {
    scale = 100,
    bounds = {
        camber_front = { min = -45, max = 45 },
        camber_rear = { min = -45, max = 45 },
        track_width_front = { min = 0, max = 150 },
        track_width_rear = { min = 0, max = 150 },
        suspension_height = { min = -30, max = 30 }
    },
    defaults = {
        camber_front = 0,
        camber_rear = 0,
        track_width_front = 80,
        track_width_rear = 80,
        suspension_height = 0
    }
}

Config.Functions.SetExternalHudVisible = function(visible)
    exports["your_hud_resource"]:SetHudVisible(visible)
end

Highlights

• Added support for GTA V's VMT Lightbar tuning slot, including pricing, required items, previews, installation, localization, and persistence.
• Added automatic Workshop Lift detection for configured MLO/YMAP lift props and support for multiple lift model sets.
• Reworked Stance installation into a physical four-wheel Workshop Lift workflow for tuning orders and the usable Stance Kit.
• Added optional police dispatch alerts for successful wheel and catalytic converter thefts.

Notable Changes

• Stance changes are now installed at all four wheel positions while the vehicle is raised on a configured Workshop Lift.
• A localized Stance checklist and contextual radial actions track each completed wheel position before the selected Stance is applied and saved.
• Existing matching MLO/YMAP lift props can now be reused instead of spawning duplicate lift objects.
• Configured lift prop pairs can be discovered automatically without placing a workshop_lift point in Workshop Creator.
• Compatible vehicles now show Lightbar variants from modification slot 49 in the Bodywork tuning section; vehicles without variants remain unchanged.
• Repair Kits can now separately control normal vehicle damage, realistic wheel damage, and every mechanic wear part they restore.
• Persisted engine, brake, transmission, suspension, turbo, armor, and Custom Handling upgrades are restored more reliably after garage spawning.
• Self-service tuning markers are restored correctly when older Job Configurator data contains self_service_tuning.interaction=false.
• Successful parts thefts can send configurable police dispatches with custom jobs, title, message, and cooldown.

Other Changes

• Added Config.Functions.SendPartsTheftDispatch(source, data) so server owners can replace the default sky_jobs_base dispatch integration.
• Existing MLO lift props are preserved during cleanup, refreshes, and resource stops.
• Added periodic lift prop discovery for MLO objects that stream in after resource start.
• Added detailed stolen parts dealer payout diagnostics for the active payout account, inventory changes, framework payout result, and before/after balances.
• Added performance tuning values to vehicle persistence debug logs.

Config.WorkshopLiftSystem.creator.modelSets = {
    {
        name = "default",
        frameModel = "sky_carlift_platform",
        platformModel = "sky_carlift_frame"
    },
    -- Add additional MLO lift model pairs here.
}

Config.WorkshopLiftSystem.existingProps = {
    enabled = true,
    searchRadius = 1.2,
    zTolerance = 1.0,
    autoDiscover = {
        enabled = true,
        pairRadius = 1.4,
        zTolerance = 1.0,
        refreshIntervalMs = 30000
    }
}

lightbar = { enabled = true, modType = 49, cost = 5.58, items = { "body_kit" } }

dispatch = {
    enabled = true,
    jobs = { "police" },
    title = "Vehicle parts theft",
    message = "Suspicious vehicle parts theft reported near {plate}.",
    cooldownSeconds = 120
}

repairVehicleDamage = true,
fixRealisticWheelDamage = true,
repairWearParts = {
    tyres = true,
    brake_pads = true,
    suspension = true,
    spark_plugs = true,
    engine_oil = true,
    coolant = true,
    brake_fluid = true,
    transmission_fluid = true,
    clutch = true,
    air_filter = true,
    traction_battery = true,
    inverter = true,
    catalytic_converter = true
}

Highlights

• Added new admin and server-owner tools for repairs, rollover behavior, and delivery visibility.
• Improved Workshop Lift reliability and several mechanic install flows.
• Improved saved tuning reliability for job garage vehicles, Stancer, Custom Handling, and custom lights.

Notable Changes

• Admins can now use /repair, /repair me, or /repair [id] to fully repair a vehicle.
• Full repairs now also clear mechanic damage effects that could make a repaired vehicle still feel slow, stuck, or undriveable.
• Server owners can now disable GTA's default rollover recovery through Config.VehicleRolloverRecovery.
• Workshop Lifts now clean up old lift props better and recover raised vehicles after a sky_mechanicjob restart.
• Lift controls are easier to reach when standing beside the platform or vehicle.
• Parts Delivery now has a small optional timer HUD with remaining time, progress, status, and order reference.
• The delivery timer can be turned on/off and moved through the Job Configurator.
• Spoiler installs now happen at the rear of the vehicle and no longer require opening the hood.
• Underbody neon installs no longer ask for the lift step again if the vehicle is already raised.
• Job garage vehicles can now correctly save and load mechanic tuning such as Stancer, Custom Handling, RGB, Nitro, Anti-Lag, and Two-Step.
• Stancer reset and saved defaults are safer now, especially for vehicles that previously had broken wheel size or width values.
• Stancer changes should now sync more reliably for nearby players and no longer cause wheel scale issues after reset or parking out.
• Stancer is now ignored for unsupported vehicle types such as bikes, boats, helicopters, planes, and trains.
• Custom xenon colors now save with the correct RGB color, so red no longer comes back as green and yellow no longer comes back as cyan.
• RGB Controller changes now save automatically when the controller menu is closed.

Other Changes

• Added more debug information for Workshop Lift troubleshooting.

Config.VehicleRolloverRecovery = {
    disableGtaRecovery = true,
    rollThresholdDegrees = 65.0,
    maxSpeedKmh = 25.0,
    checkIntervalMs = 100
}

radialDistance = 4.5

timerHud = {
    enabled = true,
    position = {
        left = "50%",
        top = "3vh"
    }
}

Highlights

• Improved vehicle repair reliability so fix kit repairs now also reset mechanic wear consequences and limp-mode states.
• Stabilized Stancer defaults, persistence, wheel size, and wheel width handling across tuning, checkout, parking, and restarts.
• Added stronger RGB xenon and neon persistence guards so saved light settings are not overwritten by temporary stock-like vehicle reads.
• Added Workshop Lift debug diagnostics to help investigate invisible, duplicated, or incorrectly synced lift props.
• Improved Job Configurator integration by disabling the legacy Workshop Creator when the configurator flow is active.

Notable Changes

• Fixed normal fix_kit repairs so they clear transmission limp mode, electric limp mode, engine damage, undriveable state, and related wear effects.
• Fixed stale physical carry item states so mechanics can take parts from storage again without needing to reconnect.
• Updated the mileage HUD runtime toggle so it appears or disappears immediately for active drivers after Job Configurator changes.
• Reworked Stancer reset/default handling so vehicle defaults are captured once and custom stance changes are saved separately.
• Preserved persisted Stancer values when unstable native reads return stock-like values during save or restore windows.
• Improved Wheel Size and Wheel Width handling with dedicated Stancer option detection, tire/rim collider updates, and debug readback output.
• Protected saved xenon and underbody neon settings from being replaced by transient disabled/default live reads outside active tuning sessions.
• Added localized Workshop Creator disabled messages for all supported mechanic locale files.
• Added detailed debug-only lift logs for model names, hashes, entities, coordinates, nearby objects, cleanup, creator sync, and attach/detach broadcasts.

-Locales = {} -- edit translation in config/locales
-Config = {}

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.