Changelog

Highlights

• Added persistent electronic tuning for anti-lag variants, two-step, throttle response, wheelie behavior, engine output, idle speed, interior lighting, headlight brightness, radio power, brake lights, horn high beams, automatic hazards, and preset or custom RGB mood lighting with intensity and disable control.
• Added staged brake overheating with configurable vehicle and brake-upgrade multipliers, glowing discs, critical sparks, short brake fade, and a debug display.
• Added a parts-delivery mode that can place the complete collected order directly into the player's inventory instead of using the physical pallet flow.
• Changed the former Anti-Lag Kit into one ECU Tuning Kit that supplies anti-lag, two-step, and every new electronic upgrade.

Notable Changes

• Improved tuning orders so required item quantities are visible, carried repair items can be consumed, advanced installations work with parts delivery disabled, and live prices refresh after Job Configurator changes.
• Improved vehicle repair and service persistence so self-service work and Quasar parking retain completed repairs without overwriting unrelated vehicle data.
• Improved workshop deliveries so the pallet appears at the configured spawn position and direct-inventory collection grants the full validated order once.
• Fixed an issue where seated customers could be removed from their vehicle during billing and where a partially paid invoice could remain open after completion.
• Added system-actor entries to vehicle history so automated service actions remain distinguishable from employee changes.
• Improved fake plates so a qualifying collision can detach the plate even when body-health loss is small.

Other Changes

• Improved xenon synchronization, repaired-window updates, transactional stance changes, and wheel geometry so nearby clients see the same vehicle state without changing door angles.
• Removed the lingering limp-mode speed cap after the underlying vehicle condition recovers.
• Improved the tuning interface with functional categories, dedicated ECU artwork, clearer removal/order details, shared form controls, and consistent FiveM CEF rendering.
• Updated bundled translations for ECU tuning, brake heat, parts delivery, exhaust work, catalytic converters, invoices, and vehicle-state messages.

Changed Files

• sky_mechanicjob/compat/fakeplates_realplate_native.lua
• sky_mechanicjob/config/adv_config.lua
• sky_mechanicjob/config/config.lua
• sky_mechanicjob/config/inventory/ecu_tuning_kit.png
• sky_mechanicjob/config/locales/*
• sky_mechanicjob/config/sv_functions.lua
• sky_mechanicjob/fxmanifest.lua
• sky_mechanicjob/import.sql
• sky_mechanicjob/source/* — delete and reinsert

Config.ToggleFeatures.electronicTuning = true
Config.ToggleFeatures.brakeOverheating = true

Config.BrakeOverheating = {
    simulationIntervalMs = 100,
    visualDistance = 55.0,
    maximumVisibleVehicles = 16,
    minimumSpeedKmh = 25.0,
    referenceSpeedKmh = 120.0,
    heatGainPerSecond = 8.0,
    coolingPerSecond = 0.34,
    coolingDelayMs = 5000,
    heatUp = {
        classes = {
            [0] = 0.9, [1] = 1.0, [2] = 1.1, [3] = 1.0, [4] = 1.0, [5] = 0.9,
            [6] = 0.85, [7] = 0.8, [8] = 0.5, [9] = 0.9, [10] = 0.7, [11] = 0.7,
            [12] = 1.0, [17] = 1.0, [18] = 0.7, [19] = 0.7, [20] = 1.0, [22] = 0.8
        },
        brakeUpgrade = { [-1] = 1.0, [0] = 0.8, [1] = 0.65, [2] = 0.6 }
    },
    cooldown = {
        classes = {
            [0] = 1.0, [1] = 1.0, [2] = 1.0, [3] = 1.0, [4] = 1.1, [5] = 1.1,
            [6] = 1.15, [7] = 1.25, [8] = 1.5, [9] = 1.0, [10] = 1.0, [11] = 1.0,
            [12] = 1.0, [17] = 1.0, [18] = 1.15, [19] = 1.15, [20] = 1.0, [22] = 1.25
        },
        brakeUpgrade = { [-1] = 1.0, [0] = 1.1, [1] = 1.25, [2] = 1.5 }
    },
    stages = { warm = 35.0, hot = 60.0, critical = 85.0 },
    glow = {
        [1] = { radius = 0.16, red = 255, green = 105, blue = 20, intensity = 0.45 },
        [2] = { radius = 0.19, red = 255, green = 65, blue = 8, intensity = 0.7 },
        [3] = { radius = 0.22, red = 255, green = 32, blue = 3, intensity = 1.0 }
    },
    sparks = {
        asset = "des_scaffolding",
        effect = "ent_ray_scaf_spark_bursts",
        scale = 0.5,
        minimumIntervalMs = 180,
        maximumIntervalMs = 420
    },
    brakeFade = {
        chancePerSecond = 0.45,
        minimumDurationMs = 300,
        maximumDurationMs = 700,
        cooldownMs = 1800
    },
    wheelBones = {
        "wheel_lf", "wheel_rf", "wheel_lr", "wheel_rr",
        "wheel_lm1", "wheel_rm1", "wheel_lm2", "wheel_rm2"
    },
    excludedVehicleClasses = { [13] = true, [14] = true, [15] = true, [16] = true, [21] = true }
}

('antilag_kit', 'Anti-Lag Kit', 2000, 0, 1)

('ecu_tuning_kit', 'ECU Tuning Kit', 2000, 0, 1)

Highlights

• Improved the built-in frontend fallback catalogue so missing translated tuning, delivery, invoice, registry, and tablet keys remain readable.

Notable Changes

• Fixed an issue where a complete 1.24.0 feature installation could still show blank or placeholder Mechanic labels.

Other Changes

• Updated the package manifest for the 1.24.1 compatibility set.

Changed Files

• sky_mechanicjob/config/locales/*
• sky_mechanicjob/fxmanifest.lua

Highlights

• Cross-job vehicle records - mechanics can create richer owner/model/color records and share selected profiles read-only with other jobs.
• Quantity-aware tuning parts - performance stages can require increasing quantities instead of one item for every level, including repeated legacy item entries.
• Improved invoice and delivery workflows - invoice registry history, normalized timestamps, custom quantities, stacked delivered parts, customer subscription names, and clearer delivery pallets are supported.
• Tyre-only persistence - JG garage tyre saves sanitize bounded tyre fields, require a persisted owned plate when ownership checks are enabled, and update only tyre data without overwriting other tuning properties.

Notable Changes

• Advanced pricing can keep selected parts-shop categories available without an active tuning order; Service items are enabled by default.
• Vehicle records support editing for their owner job and read-only access for configured share targets.
• Tuning orders can source quantities from job storage, enforce price caps consistently, and show clearer item labels and dark-mode surfaces.
• Subscription lists retain customer names and vehicle history includes owner-scoped invoice entries.
• Wheel size/width scaling was removed; normal Stancer camber, track width, suspension, and alignment remain.

Other Changes

• Dropdown, opacity, delivery, subscription, invoice, registry, pricing, tuning, and locale behavior was corrected.
• The Tuning menu includes dedicated Extras artwork in the rebuilt interface.
• Custom tuning diagnostics now follow the shared Base logging path.
• Tyre persistence updates only tyre-related fields in the stored property document so ordinary tyre saves preserve unrelated tuning data.
• Database schemas now inherit the active database character set and collation; no new inventory item or streamed asset is required.

Changed Files

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

Removed Config Paths

• Config.ToggleFeatures.stanceWheelSize
• Config.ToggleFeatures.stanceWheelWidth
• Config.WheelSizeOptions
• Config.Jobs[*].tuningCostProfile.optionCostByOptionId.wheel_size
• Config.Jobs[*].tuningCostProfile.optionCostByOptionId.wheel_width

local mechanic_sharing_defaults = {
    enabled = true,
    records = {
        vehicleRecords = { enabled = true, jobs = {}, groups = { "mechanic" } }
    }
}

Config.TuningCostProfile.advancedPricing.alwaysAvailableShopItems = {
    enabled = true,
    categories = { "Service" }
}

ALTER TABLE `sky_mechanic_subscriptions`
    ADD COLUMN IF NOT EXISTS `customer_name` VARCHAR(120) NULL AFTER `identifier`;

ALTER TABLE `sky_mechanic_vehicle_profiles`
    ADD COLUMN IF NOT EXISTS `owner_name` VARCHAR(120) NULL,
    ADD COLUMN IF NOT EXISTS `owner_identifier` VARCHAR(120) NULL,
    ADD COLUMN IF NOT EXISTS `model` VARCHAR(64) NULL,
    ADD COLUMN IF NOT EXISTS `color` VARCHAR(120) NULL,
    ADD COLUMN IF NOT EXISTS `shared_with_jobs` LONGTEXT NULL,
    ADD COLUMN IF NOT EXISTS `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
    ADD COLUMN IF NOT EXISTS `updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;

Highlights

• Server-authoritative advanced pricing - optional quotes combine supplier share, margin, labor, difficulty, vehicle class, mechanic grade, stock, demand, tax, discount caps, and price limits; class-based prices, order-bound procurement, returns, refunds, and workshop profit analytics use the same validated calculation. Public server exports are CreatePricingQuote, GetPricingQuote, ValidatePricingQuote, GetPricingAnalytics, and GetSupplierCatalog; server integrations can observe sky_mechanicjob:server:pricingQuoteCreated, sky_mechanicjob:server:pricingQuoteExpired, and sky_mechanicjob:server:supplierStockChanged.
• Extended workshop billing - invoices support estimates, deposits, partial payments, manual lines, due dates, reminders and fees, tax, per-grade limits, cancellation permissions, analytics, and optional recipient-name privacy. Public server exports are CreateInvoice, CreateEstimate, GetInvoice, GetPlayerInvoices, PayInvoice, RespondToEstimate, SendInvoiceReminder, CancelInvoice, and GetBillingAnalytics; server integrations can observe sky_mechanicjob:server:invoiceCreated, sky_mechanicjob:server:invoiceStatusChanged, sky_mechanicjob:server:invoiceOverdue, sky_mechanicjob:server:invoicePaymentRecorded, sky_mechanicjob:server:estimateResponded, sky_mechanicjob:server:invoiceReminderSent, and sky_mechanicjob:server:invoiceCancelled.
• Customer and company subscriptions - configurable workshop memberships provide one strongest non-stacking discount, personal or job-wide ownership, society payment, expiry, a configurable NPC terminal, and workshop-specific models; the responsive tablet app is marked New, its runtime is loaded explicitly, and its SVG assets plus public NPC setup documentation are included. Server integrations can resolve the effective discount through GetSubscriptionDiscount.
• Parts deliveries in the tablet - the old single-order timer HUD was replaced with a synchronized overview of every workshop delivery, while configured carriers can sprint with delivery boxes.

Notable Changes

• External LB Tablet and RoadPad surfaces support authorization, inherited sessions, retries, message relay, safe routes, lifecycle return/close, and tuning focus preservation; their runtime module is loaded explicitly.
• Drift tuning now requires the dedicated drift_tyres item instead of a stance kit; the item is included in shop defaults and SQL inventory seeds.
• Oil absorbent and brooms are stocked in mechanic shops, including migration into existing configurator-managed shops without duplicates.
• Vehicle persistence batches orphan-tyre cleanup, reapplies tuning after a server/client startup handshake, avoids shutdown-time saves, preserves add-on stance baselines, and restores stance after garage retrieval.
• Motorcycle tuning exposes rear-wheel changes instead of treating the vehicle as front-wheel-only.
• The public server-authoritative /antilag command toggles the persisted state only when Anti-Lag is enabled, the player is the driver of their own vehicle, and that vehicle has an installed Anti-Lag kit; every rejected requirement returns a clear result.
• Self-service validation follows creator-defined workshop points rather than static job locations.
• Plates in Config.TuningRestrictions.blockedPlates are rejected by mechanic, self-service, instant, and admin tuning flows.
• Owned vehicles can send rate-limited maintenance reminders when wear reaches the configured threshold.
• Oil-leak relays use the configured integration resource and now ship with the Fire resource as the default target; an unavailable provider rejects the relay and writes an English debug diagnostic with its resource state.

Other Changes

• All newly added and revised user-facing feedback received locale coverage; Italian was added.
• Shared input, selection, switch, checkbox, range, and date-range controls were made responsive and theme-consistent.
• Regression coverage was expanded across the release's server, client, persistence, UI, and integration paths.

Changed Files

• sky_mechanicjob/README.md
• sky_mechanicjob/config/adv_config.lua
• sky_mechanicjob/config/config.lua
• sky_mechanicjob/config/locales/*
• sky_mechanicjob/fxmanifest.lua
• sky_mechanicjob/import.sql
• sky_mechanicjob/source/* — delete and reinsert

-- Config.Jobs[*].shop
{ name = "drift_tyres", label = "Drift Tyres", price = 500 },
{ name = "oil_absorbent", label = "Oil Absorbent", price = 35 },
{ name = "broom", label = "Broom", price = 25 },

-- Config.Jobs[*].partsDeliveryShop
{ name = "drift_tyres", label = "Drift Tyres", price = 500, category = "Wheels" },
{ name = "oil_absorbent", label = "Oil Absorbent", price = 35, category = "Service" },
{ name = "broom", label = "Broom", price = 25, category = "Service" },

Config.PartsDelivery = {
    deliveryTimeSeconds = 60,
    allowsprint = true,
    paymentMethods = {
        own_card = true,
        company_card = true
    },
    openDurationMs = 5500
}

Config.TuningRestrictions = {
    blockedPlates = {
        -- "POLICE01",
        -- "EMS01"
    }
}

Config.MaintenanceNotifications = {
    enabled = true,
    dueThresholdPercent = 25,
    cooldownMinutes = 180
}

subscription_terminal = {
    public = true,
    interaction = true,
    interactionDistance = 2.5,
    unique = false,
    marker = {
        enabled = false,
        type = 1,
        offset = vector3(0.0, 0.0, 0.0)
    },
    blip = {
        enabled = false,
        name = "Workshop Memberships",
        sprite = 446,
        color = 5
    },
    npc = {
        enabled = true,
        name = "Workshop Memberships",
        pedHash = "s_m_m_autoshop_01",
        scenario = "WORLD_HUMAN_CLIPBOARD"
    }
},

Config.Subscriptions = {
    enabled = true,
    allowJobSubscriptions = true,
    currency = "bank",
    maximumModels = 12,
    maximumDurationsPerModel = 6,
    npc = {
        pedModel = "s_m_m_autoshop_01",
        scenario = "WORLD_HUMAN_CLIPBOARD",
        emote = {
            dict = "",
            clip = ""
        }
    },
    models = {
        {
            id = "basic",
            label = "Basic",
            description = "A reliable discount for regular maintenance and tuning.",
            discountPercent = 10,
            enabled = true,
            durations = {
                { days = 14, price = 2500, jobPrice = 10000 },
                { days = 30, price = 4500, jobPrice = 18000 }
            }
        },
        {
            id = "premium",
            label = "Premium",
            description = "The best workshop discount for frequent customers.",
            discountPercent = 20,
            enabled = true,
            durations = {
                { days = 14, price = 4500, jobPrice = 18000 },
                { days = 30, price = 8000, jobPrice = 32000 }
            }
        }
    }
}

billingSettings = {
    enabled = true,
    maxDiscountPercent = 15,
    allowImmediatePayment = true,
    allowCustomPrices = true,
    allowManualItems = true,
    allowEstimates = true,
    allowPartialPayments = true,
    depositPercent = 30,
    minimumPartialPayment = 100,
    defaultDueDays = 7,
    estimateLifetimeHours = 24,
    reminderGraceDays = 2,
    reminderFee = 250,
    maximumReminders = 3,
    taxPercent = 0,
    minimumInvoiceAmount = 100,
    maximumInvoiceAmount = 250000,
    maximumManualItems = 20,
    analyticsPeriodDays = 30,
    allowAnalytics = false,
    gradeRules = {
        { grade = 0, maximumInvoiceAmount = 15000, maximumDiscountPercent = 5, allowEstimates = true, allowManualItems = false, allowCancellation = false, allowReminders = false, allowAnalytics = false },
        { grade = 1, maximumInvoiceAmount = 50000, maximumDiscountPercent = 10, allowEstimates = true, allowManualItems = true, allowCancellation = false, allowReminders = false, allowAnalytics = false },
        { grade = 2, maximumInvoiceAmount = 125000, maximumDiscountPercent = 15, allowEstimates = true, allowManualItems = true, allowCancellation = true, allowReminders = true, allowAnalytics = true },
        { grade = 3, maximumInvoiceAmount = 250000, maximumDiscountPercent = 15, allowEstimates = true, allowManualItems = true, allowCancellation = true, allowReminders = true, allowAnalytics = true }
    }
},

Config.Billing = {
    enabled = true,
    showRecipientName = false,
    maxDiscountPercent = 15,
    allowImmediatePayment = true,
    allowCustomPrices = true,
    requireOnDutyWork = true,
    allowManualItems = true,
    allowEstimates = true,
    allowPartialPayments = true,
    depositPercent = 30,
    minimumPartialPayment = 100,
    defaultDueDays = 7,
    estimateLifetimeHours = 24,
    reminderGraceDays = 2,
    reminderFee = 250,
    maximumReminders = 3,
    taxPercent = 0,
    minimumInvoiceAmount = 100,
    maximumInvoiceAmount = 250000,
    maximumManualItems = 20,
    analyticsPeriodDays = 30,
    allowAnalytics = false,
    gradeRules = {}
}

Config.TuningCostProfile.advancedPricing = {
    enabled = false,
    supplierSharePercent = 65.0,
    roundingStep = 50,
    defaultMarginPercent = 25.0,
    minimumMarginPercent = 10.0,
    maximumMarginPercent = 35.0,
    minimumRetailPrice = 100,
    maximumRetailPrice = 150000,
    taxPercent = 0.0,
    quoteLifetimeMinutes = 30,
    maximumDiscountPercent = 15.0,
    returnRefundPercent = 80.0,
    analyticsPeriodDays = 30,
    previewCostPercent = 10.0,
    previewCompactVehicleValue = 40000,
    previewSportsVehicleValue = 80000,
    previewSuperVehicleValue = 120000,
    inventory = {
        enabled = true,
        baseStock = 40,
        lowStockThreshold = 10,
        lowStockMarkupPercent = 20.0,
        demandMarkupPerUnitPercent = 0.5,
        maximumDemandMarkupPercent = 25.0,
        restockPerDay = 5,
        demandDecayPerDay = 3
    },
    difficultyRules = {
        { key = "simple", laborFee = 0 },
        { key = "standard", laborFee = 250 },
        { key = "complex", laborFee = 750 },
        { key = "expert", laborFee = 1500 }
    },
    categoryRules = {
        { key = "bodywork", supplierSharePercent = 60.0, marginPercent = 25.0, laborFee = 500, difficulty = "standard", minimumPrice = 100, maximumPrice = 60000 },
        { key = "engine", supplierSharePercent = 75.0, marginPercent = 20.0, laborFee = 2500, difficulty = "expert", minimumPrice = 500, maximumPrice = 150000 },
        { key = "brakes", supplierSharePercent = 70.0, marginPercent = 20.0, laborFee = 1200, difficulty = "complex", minimumPrice = 300, maximumPrice = 80000 },
        { key = "transmission", supplierSharePercent = 75.0, marginPercent = 20.0, laborFee = 2000, difficulty = "expert", minimumPrice = 500, maximumPrice = 120000 },
        { key = "suspension", supplierSharePercent = 70.0, marginPercent = 22.0, laborFee = 1500, difficulty = "complex", minimumPrice = 300, maximumPrice = 90000 },
        { key = "armor", supplierSharePercent = 80.0, marginPercent = 15.0, laborFee = 3000, difficulty = "expert", minimumPrice = 1000, maximumPrice = 150000 },
        { key = "wheels", supplierSharePercent = 60.0, marginPercent = 25.0, laborFee = 750, difficulty = "standard", minimumPrice = 200, maximumPrice = 60000 },
        { key = "stancing", supplierSharePercent = 65.0, marginPercent = 25.0, laborFee = 1000, difficulty = "complex", minimumPrice = 300, maximumPrice = 70000 },
        { key = "turbo", supplierSharePercent = 75.0, marginPercent = 20.0, laborFee = 1800, difficulty = "expert", minimumPrice = 500, maximumPrice = 120000 },
        { key = "antilag", supplierSharePercent = 70.0, marginPercent = 25.0, laborFee = 1400, difficulty = "complex", minimumPrice = 400, maximumPrice = 90000 },
        { key = "lights", supplierSharePercent = 55.0, marginPercent = 30.0, laborFee = 400, difficulty = "simple", minimumPrice = 100, maximumPrice = 40000 },
        { key = "colors", supplierSharePercent = 50.0, marginPercent = 30.0, laborFee = 350, difficulty = "simple", minimumPrice = 100, maximumPrice = 40000 },
        { key = "custom_tuning", supplierSharePercent = 70.0, marginPercent = 25.0, laborFee = 1600, difficulty = "complex", minimumPrice = 300, maximumPrice = 100000 }
    },
    vehicleClassRules = {
        { classId = 0, marginAdjustmentPercent = -3.0, laborMultiplier = 0.8 },
        { classId = 1, marginAdjustmentPercent = -2.0, laborMultiplier = 0.9 },
        { classId = 2, marginAdjustmentPercent = 0.0, laborMultiplier = 1.0 },
        { classId = 3, marginAdjustmentPercent = -1.0, laborMultiplier = 0.95 },
        { classId = 4, marginAdjustmentPercent = 0.0, laborMultiplier = 1.0 },
        { classId = 5, marginAdjustmentPercent = 1.0, laborMultiplier = 1.1 },
        { classId = 6, marginAdjustmentPercent = 3.0, laborMultiplier = 1.3 },
        { classId = 7, marginAdjustmentPercent = 5.0, laborMultiplier = 1.5 },
        { classId = 8, marginAdjustmentPercent = -2.0, laborMultiplier = 0.8 },
        { classId = 9, marginAdjustmentPercent = 1.0, laborMultiplier = 1.2 },
        { classId = 10, marginAdjustmentPercent = 1.0, laborMultiplier = 1.2 },
        { classId = 11, marginAdjustmentPercent = 0.0, laborMultiplier = 1.0 },
        { classId = 12, marginAdjustmentPercent = 0.0, laborMultiplier = 1.0 },
        { classId = 13, marginAdjustmentPercent = -4.0, laborMultiplier = 0.6 },
        { classId = 14, marginAdjustmentPercent = 2.0, laborMultiplier = 1.3 },
        { classId = 15, marginAdjustmentPercent = 4.0, laborMultiplier = 1.5 },
        { classId = 16, marginAdjustmentPercent = 4.0, laborMultiplier = 1.5 },
        { classId = 17, marginAdjustmentPercent = 0.0, laborMultiplier = 1.0 },
        { classId = 18, marginAdjustmentPercent = 0.0, laborMultiplier = 1.0 },
        { classId = 19, marginAdjustmentPercent = 3.0, laborMultiplier = 1.4 },
        { classId = 20, marginAdjustmentPercent = 2.0, laborMultiplier = 1.3 },
        { classId = 21, marginAdjustmentPercent = 0.0, laborMultiplier = 1.0 },
        { classId = 22, marginAdjustmentPercent = 3.0, laborMultiplier = 1.4 }
    },
    mechanicGradeRules = {
        { grade = 0, label = "Apprentice", marginAdjustmentPercent = -5.0, laborMultiplier = 0.9, maximumDiscountPercent = 5.0 },
        { grade = 1, label = "Mechanic", marginAdjustmentPercent = 0.0, laborMultiplier = 1.0, maximumDiscountPercent = 10.0 },
        { grade = 2, label = "Senior Mechanic", marginAdjustmentPercent = 3.0, laborMultiplier = 1.1, maximumDiscountPercent = 15.0 },
        { grade = 3, label = "Master Mechanic", marginAdjustmentPercent = 5.0, laborMultiplier = 1.2, maximumDiscountPercent = 15.0 }
    }
}

Config.TuningCostProfile.priceType = "percentage"
Config.TuningCostProfile.vehicleClassPricing = {
    [0] = { priceType = "percentage", multiplier = 1.0 },
    [1] = { priceType = "percentage", multiplier = 1.0 },
    [2] = { priceType = "percentage", multiplier = 1.0 },
    [3] = { priceType = "percentage", multiplier = 1.0 },
    [4] = { priceType = "percentage", multiplier = 1.0 },
    [5] = { priceType = "percentage", multiplier = 1.0 },
    [6] = { priceType = "percentage", multiplier = 1.0 },
    [7] = { priceType = "percentage", multiplier = 1.0 },
    [8] = { priceType = "percentage", multiplier = 1.0 },
    [9] = { priceType = "percentage", multiplier = 1.0 },
    [10] = { priceType = "percentage", multiplier = 1.0 },
    [11] = { priceType = "percentage", multiplier = 1.0 },
    [12] = { priceType = "percentage", multiplier = 1.0 },
    [13] = { priceType = "percentage", multiplier = 1.0 },
    [14] = { priceType = "percentage", multiplier = 1.0 },
    [15] = { priceType = "percentage", multiplier = 1.0 },
    [16] = { priceType = "percentage", multiplier = 1.0 },
    [17] = { priceType = "percentage", multiplier = 1.0 },
    [18] = { priceType = "percentage", multiplier = 1.0 },
    [19] = { priceType = "percentage", multiplier = 1.0 },
    [20] = { priceType = "percentage", multiplier = 1.0 },
    [21] = { priceType = "percentage", multiplier = 1.0 },
    [22] = { priceType = "percentage", multiplier = 1.0 }
}

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