Changelog

Highlights

• Reliable parts deliveries - partial deliveries preserve their remaining items, pallets keep their targets after movement, carried boxes clean up correctly, and failures return a clear result.
• Server-side mechanic integrations - trusted server resources can repair vehicles or wheel damage, inspect and repair wear/condition, check whether tuning exists, and react to completed mechanic operations.
• Global Stance control - Stance can be disabled as one complete feature and reacts to Job Configurator changes without a resource restart.
• Per-location vehicle-class enforcement - self-service tuning points can apply their configured class whitelist before opening.

Notable Changes

• Test-drive vehicles are excluded from persistent wear and wheel-damage processing.
• Full repairs preserve custom native engine audio and reapply saved Stance values.
• Orphaned tyre damage, tuning state, welding animations, delivery-box movement, and billing-spec updates are handled more consistently.
• Workshop lifts and Stance items respond to live configuration changes.
• Ordered item and vehicle image sources are used throughout shops, diagnostics, tuning, and dealer views.
• Added a complete Serbian locale.

Other Changes

• Removed obsolete tyre-reset SQL guidance; no database reset is part of this release.
• Added focused regression checks for engine audio, install animations, server integrations, and Stance gating.

Changed Files

• sky_mechanicjob/config/config.lua
• sky_mechanicjob/config/locales/*
• sky_mechanicjob/fxmanifest.lua
• sky_mechanicjob/source/* — delete and reinsert

Highlights

• Unpaid public tuning orders - workshops that hide public prices can now accept an unpaid customer order for a mechanic to review and invoice later instead of showing zero-cost work.
• Lift bypass for unsuitable vehicles - configurable vehicle classes and models, including motorcycles by default, can complete lift-dependent service work without forcing them onto a workshop lift.
• Better workshop lift placement - creator lifts support gizmo placement, initialize vehicle control before lifting, and handle order/service actions more reliably.
• Clearer drivetrain tuning - the active drivetrain and drivetrain presets are visible in the correct Handling and Performance sections.

Notable Changes

• Custom wheels are installed and displayed correctly in tuning flows.
• Parts deliveries use the active job's delivery bay instead of another workshop's location.
• Public-order price visibility now clearly distinguishes paid self-service orders from mechanic-invoiced unpaid orders.
• Nitro no longer repeats a missing-system notification while the control key is held.
• Missing Base or Jobs Base dependencies are reported clearly during startup.

Other Changes

• Restored German characters and refreshed the setup documentation.
• Updated the resource version to 1.21.0.

 Config.OrderInstall = {
+    liftBypassVehicleClasses = { 8 },
+    liftBypassVehicleModels = {}
 }

 Config.CustomHandlingOptions = {
-    drivetrainWhitelist = {
-        -- old vehicle restrictions
-    },
 }

ensure sky_base
ensure sky_jobs_base
ensure sky_mechanicjob

Highlights

• Fake plates survive compatible garage storage - new compatibility helpers let garage resources resolve the real stored plate while Police, radar, dispatch, and visible UI can continue to see the active fake plate.
• Safer RGB controller tuning - mechanics can only edit installed neon directions, unavailable controls are disabled, and vehicles without compatible neon are rejected clearly.
• Workshop management in Job Configurator - workshop entries now have a dedicated creator section with localized labels and job-aware filtering.
• Optional mechanic-first repair policy - repair-kit use by non-mechanics can be blocked while a mechanic is on duty, with a clear localized message.

Notable Changes

• Added the Full Dark theme across Mechanic tablet apps.
• Fake plate state can be restored after compatible garage flows instead of being lost during storage.
• Vehicle ownership queries now use owned_vehicles on ESX and player_vehicles on QB-based frameworks.
• Custom chrome paint is hidden and rejected when the active tuning profile does not allow it.
• Mechanic item and vehicle artwork now supports PNG and WebP fallbacks.

Other Changes

• Added public compatibility files and setup guidance for fake-plate-aware garage resources.
• Updated the resource version to 1.20.0.

Highlights

• Complete fake plate system - mechanics can create and install temporary display plates with ownership, distance, engine, duplicate, cooldown, expiry, crash-loss, blacklist, and audit controls.
• Synchronized engine-sound previews - preview revs are relayed to nearby players so engine-sound tuning can be evaluated together before purchase.
• Safer workshop deletion - jobs with active deliveries, tuning work, invoices, or vehicle service obligations cannot be removed until their operational records are resolved.

Notable Changes

• Framework-spawned vehicles now restore broken tyres, doors, and windows along with their other saved properties.
• Overdue delivery orders are promoted when ready orders are fetched, and on-duty staff receive refreshed ready pallets.
• Duplicate vehicle-lift props are prevented after reconnects and creator-owned lift props disappear when their creator entry is deleted.
• The mechanic tablet closes correctly after invoice payment.
• Sliders update visually when a tuning option is reset to its default.
• Registered Job Configurator defaults now cover the complete current mechanic configuration.
• Added an administrator command permission for resetting an active fake plate.

Other Changes

• Added configurable optional risk and illegal-market rules for fake plates.
• Added audit storage and default item records for blank plates, fake-plate kits, plate scanners, and plate printers.
• Updated the resource version to 1.19.0.

Highlights

• Tyre repairs now follow each damaged wheel. Missing and burst tyres are tracked individually, mechanics work on the affected side with the car jack, and Vehicle Diagnostics shows the remaining tyre condition and repair progress.
• Optional vehicle-fire integration with Sky Fire Job. Critical engine damage and severe frontal impacts can create configurable vehicle fires when sky_firejob is available, while mechanic repairs clear matching fire and entrapment states.
• Safer Job Configurator defaults and imports. Shipped defaults remain stable even when local config files are customized, and existing local values can be imported deliberately through the matching jobs-base workflow.

Notable Changes

• Added configurable workshop map blips, including station labels, sprite, color, scale, display mode, and short-range behavior.
• Added optional mechanic notifications when customers place self-service tuning orders, with an optional vehicle plate in the message.
• Added configurable non-minigame installation rules for large vehicles and selected vehicle models.
• Vehicle washing and waxing now support large vehicles more reliably.
• Tire smoke color changes now preview live during tuning, with smoother preview updates and restoration when the preview is cancelled.
• Added /fix as an admin repair alias.
• Instant Tuning now consistently rejects Stance wheel-size and wheel-width options when those features are disabled.

Other Changes

• Improved tyre repair restoration so unrelated body, engine, window, door, dirt, and remaining wheel damage are preserved correctly.
• Improved oil-leak diagnostics for frontal-impact and active-leak flows.
• Wear, oil-leak, fire, and wheel-damage effects no longer apply to invulnerable vehicles.
• Pressing the Nitro control no longer shows a missing-installation notification when Nitro is disabled for the current job.
• Job Configurator fire settings are hidden automatically when the optional Fire Job integration is unavailable.
• Workshop Creator-owned settings remain sourced from customer configuration during generated-default builds.

Highlights

• Billing was expanded as one complete workflow. Mechanic billing now supports protected default prices, Bossmenu custom positions, editable custom invoice prices, saved labels, and cleaner Billing settings inside the Job Configurator.
• Order parts can be taken from job storage. Mechanic jobs can choose whether tuning-order parts are consumed from the player's inventory or from the workshop's shared storage.
• Vehicle and Nitro systems were tightened up. Wheel tasks now follow the real vehicle wheel count, diagnostics repairs have a safer vehicle-class fallback, pushed vehicles align better with stance height, and external Nitro HUDs have a supported API.

Notable Changes

• Added a Custom position dropdown to the mechanic tablet Billing app for boss-created custom prices.
• Custom invoice positions support editable prices when custom prices are enabled and are stored as normal invoice items.
• Added a new inventory image for engine_sound_kit.
• Added the per-job Order item source setting for Player inventory or Storage.
• Storage mode shows combined job-storage item amounts in Orders and consumes installed parts directly from storage.
• Mechanic default billing rows are now protected in Bossmenu and keep their labels and prices synchronized.
• Mechanic billing price controls are shown inside the Billing settings page instead of a separate Billing Prices tab.
• Added Config.Nitro.externalUpdateIntervalMs in config/adv_config.lua for external Nitro HUD update timing.
• Vehicle wheel tasks now adapt to the real vehicle wheel count, so motorcycles use front/rear tasks while cars keep four wheel positions.
• Vehicle persistence was adjusted to avoid engine sound dropouts and fuel HUD value jumps while driving.
• Vehicle push animations now stay aligned better on vehicles with raised stance settings.
• Vehicle Diagnostics repairs now work better on server artifacts where the server cannot read the vehicle class directly.
• Added an external Nitro HUD API for resources that want to display their own Nitro interface.

Highlights

• Configurable Instant Tuning. Administrators can now control the performance stages, appearance modifications, wheel types, special options, and individual values available at global Instant Tuning locations. Client menus use the dedicated profile, and purchases are validated by the server.
• Workshop vehicle specializations. Each mechanic workshop can be limited to selected GTA vehicle classes. The restriction applies to tuning, removal, diagnostics repairs, and order installation, while an empty selection continues to allow every class.
• Configurable vehicle fluid leaks. Severely damaged engine-oil or transmission-fluid parts can create fluid trails while driving. Heavy frontal impacts can also create an immediate spill and start a configurable timed leak for combustion vehicles.

Notable Changes

• Existing Job Configurator entries are migrated automatically to add engine_sound_kit to the normal mechanic shop and tablet Parts Shop. The migration is idempotent and preserves custom items and prices.
• Added configurable thresholds, probabilities, intervals, speed and distance limits for wear-based oil leaks under Config.OilLeaks.
• Added configurable frontal-impact detection using impact speed, speed loss, vehicle damage, optional front deformation, trigger chance, cooldown, leak duration, and spill radius.
• Added all vehicle fluid leak and frontal-impact settings to the global in-game Job Configurator under Vehicle Fluid Leaks.
• Added configurable provider routing plus SetFluidLeakProvider and ResetFluidLeakProvider client exports for external spill systems.
• Added inventory definitions for engine_sound_kit to the ox_inventory, qs-inventory, QB-Core, and ESX documentation examples.

Fixes and Improvements

• Fixed custom xenon RGB colors reverting to white after server restarts or garage cycles. Persisted indexed and custom colors are now reapplied after late garage property updates, and transient white values no longer overwrite the saved color.
• Fixed txAdmin vehicle repair leaving Vehicle Diagnostics parts damaged. Repairing the occupied vehicle now restores all wear parts, clears catalytic-converter damage when required, and synchronizes the repaired state to clients.
• Fixed mechanic debug messages appearing while sky_base debug mode was disabled. Debug helpers now consistently use the shared gated logger without suppressing production warnings or errors.
• Fixed /debugwearzero engine_oil being interpreted as a vehicle plate. The command now supports both /debugwearzero [part] for the current vehicle and /debugwearzero [plate] [part].
• Improved frontal-impact detection with a short sampling window and removed reliance on GTA's short-lived collision flag.

Config.Jobs = {
    {
        name = "mechanic",
        -- Empty accepts every vehicle class. Example restriction: { 8, 9 }.
        allowedVehicleClasses = {},
        -- ... existing job settings ...
    }
}

Config.OilLeaks = {
    enabled = true,
    integration = {
        mode = "automatic", -- use "disabled" to stop provider output
        resource = "sky_mechanicjob",
        serverEvent = "sky_mechanicjob:fluidLeaks:createFromVehicle"
    },
    minSpeedKmh = 8.0,
    intervalSeconds = 8,
    minDistance = 7.5,
    radius = 1.25,
    frontalImpact = {
        enabled = true,
        debug = false,
        minImpactSpeedKmh = 40.0,
        minSpeedDropKmh = 18.0,
        minBodyHealthLoss = 5.0,
        minEngineHealthLoss = 5.0,
        minFrontDeformation = 0.0,
        forwardMotionRatio = 0.7,
        chance = 1.0,
        leakDurationSeconds = 180,
        cooldownSeconds = 15,
        radius = 1.15
    },
    parts = {
        engine_oil = {
            threshold = 15.0,
            criticalThreshold = 3.0,
            chance = 0.45,
            criticalChance = 0.9
        },
        transmission_fluid = {
            threshold = 8.0,
            criticalThreshold = 2.0,
            chance = 0.2,
            criticalChance = 0.55
        }
    }
}

Highlights

• Self-service engine sound orders. Customers can now buy custom engine sounds through self-service tuning, fulfilled as a mechanic tablet order. The install flow opens the hood, plays a mechanic work animation, applies the selected sound, and closes the hood. A new engine_sound_kit item is required for the order.
• Configurable engine sound prices. Each custom engine sound can have its own fixed price, including fallback and stock-restoration prices. Prices show correctly in the tuning basket and respect the instant-tuning price multiplier.
• Physical brake installs. Normal and ceramic brake tuning now use the same workshop-lift workflow as stance installs — the vehicle must be raised, and the mechanic is guided through all four wheel positions with brake-specific checklist and radial text before the install completes.
• Plate installs at the plate. License-plate tuning (plate holder, vanity plate, plate style) now requires the mechanic to stand at the front or rear license plate instead of the vehicle side, with a dedicated checklist step, a contextual radial action, and front/rear distance checks.

Notable Changes

• Stance wheel size & width toggles — separate mechanic feature toggles for Stance wheel size and wheel width, disabled by default. When off (via config.lua or the in-game Job Configurator), the related Stance sliders are removed from tuning menus and their values are ignored everywhere, so wheel-scale tuning is not applied.
• Engine sound preview no longer touches the radio — applying or previewing a custom engine sound no longer turns the GTA vehicle radio on or switches stations. A dedicated EngineSounds.disableVehicleRadio toggle optionally suppresses only the normal vehicle radio, without changing the custom engine audio itself.
• Plate install positioning — new Config.OrderInstall.plateInstallDistance and plateInstallSideTolerance tune how close and how centered on the plate the mechanic must stand for plate installs.

Fixes and Improvements

• Fixed engine hoist props not always appearing after a server start or player join until sky_mechanicjob was restarted — the hoist props are now re-synced and respawned reliably during startup.
• Fixed custom engine sounds not always persisting for tuning orders or after a vehicle was spawned from a garage — live engine-sound state is now saved and reapplied after restore, so late garage writes can't leave the vehicle on stock audio.
• Fixed mechanic paint and persisted tuning not applying immediately to vehicles spawned through Quasar AdvancedGarages map parking — saved paint, stance, RGB, and performance tuning are now reapplied before the player enters the vehicle.
• Fixed vehicle mileage resetting when a player drove a vehicle and then disconnected or restarted the resource without a normal driver-exit — mileage is now saved periodically while driving and once more on resource stop.
• Migrated internal item add/remove calls to the new sky_base inventory signature (slot + metadata).

 Config.EngineSounds = {
     -- ... existing settings ...
+    defaultPrice = 5000,
+    stockPrice = 5000,
+    requiredItem = "engine_sound_kit",
+    disableVehicleRadio = true, -- keep the normal GTA radio off while applying a custom engine sound
     sounds = {
-        { audioName = "MONSTER", label = "Monster" },
+        { audioName = "MONSTER", label = "Monster", price = 5000 },
         -- ... add a per-sound `price` to each entry (falls back to defaultPrice if omitted) ...
     }
 }

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.