reupload

README.md

@@ -0,0 +1,75 @@
+![Main Banner](https://cdn.discordapp.com/attachments/688864735646580762/1178975479861104710/QM-main_2.png?ex=6690e8fa&is=668f977a&hm=fb8c29b6587b5f2571120960f5f85564912b1284f0f0341ca5aef2df3f6c72f2&)
+
+## __Features:__
+➢ Tire loss on impact <br>
+➢ Reduces torque based on current health <br>
+➢ Prevents crazy handling from low fuel <br>
+➢ Disables vehicle after heavy collisions <br>
+➢ Disables controls while airborne/flipped <br>
+➢ Repair/Wash item integration (clean, tire, engine) <br>
+
+*Idle -* `0.0ms` <br>
+*Driving -* `0.0ms ~ 0.02ms` <br>
+
+## __Dependencies:__
+* [ox_lib](https://github.com/overextended/ox_lib)
+* [ox_inventory](https://github.com/overextended/ox_inventory) *(Optional)*
+
+## ***ox_inventory***:
+```lua
+    ["cleaningkit"] = {
+        label = "Cleaning Kit",
+        weight = 250,
+        stack = true,
+        close = true,
+        description = "A microfiber cloth with some soap will let your car sparkle again!",
+        client = {
+            image = "cleaningkit.png",
+        },
+        server = {
+            export = 'vehiclehandler.cleaningkit'
+        }
+    },
+
+    ["tirekit"] = {
+        label = "Tire Kit",
+        weight = 250,
+        stack = true,
+        close = true,
+        description = "A nice toolbox with stuff to repair your tire",
+        client = {
+            image = "tirekit.png",
+        },
+        server = {
+            export = 'vehiclehandler.tirekit'
+        }
+    },
+
+    ["repairkit"] = {
+        label = "Repairkit",
+        weight = 2500,
+        stack = true,
+        close = true,
+        description = "A nice toolbox with stuff to repair your vehicle",
+        client = {
+            image = "repairkit.png",
+        },
+        server = {
+            export = 'vehiclehandler.repairkit',
+        }
+    },
+
+    ["advancedrepairkit"] = {
+        label = "Advanced Repairkit",
+        weight = 5000,
+        stack = true,
+        close = true,
+        description = "A nice toolbox with stuff to repair your vehicle",
+        client = {
+            image = "advancedkit.png",
+        },
+        server = {
+            export = 'vehiclehandler.advancedrepairkit',
+        }
+    },
+```

client.lua

@@ -0,0 +1,169 @@
+local ox_lib, msg_lib = lib.checkDependency('ox_lib', '3.17.0')
+if not ox_lib then print(msg_lib) return end
+
+if GetResourceState('ox_inventory') == 'started' then
+    local ox_inv, msg_inv = lib.checkDependency('ox_inventory', '2.39.1')
+    if not ox_inv then print(msg_inv) return end
+end
+
+local Class = require 'modules.handler'
+local Settings = lib.load('data.vehicle')
+local Handler = nil
+
+local function startThreads(vehicle)
+    if not vehicle then return end
+    if not Handler or Handler:isActive() then return end
+
+    Handler:setActive(true)
+
+    local oxfuel = Handler:isFuelOx()
+    local units = Handler:getUnits()
+    local class = GetVehicleClass(vehicle) or false
+    local speedBuffer, healthBuffer, bodyBuffer, roll, airborne = {0.0,0.0}, {0.0,0.0}, {0.0,0.0}, 0.0, false
+
+    CreateThread(function()
+        while (cache.vehicle == vehicle) and (cache.seat == -1) do
+
+            -- Retrieve latest vehicle data
+            bodyBuffer[1] = GetVehicleBodyHealth(vehicle)
+            healthBuffer[1] = GetVehicleEngineHealth(vehicle)
+            speedBuffer[1] = GetEntitySpeed(vehicle) * units
+
+            -- Driveability handler (health, fuel)
+            local fuelLevel = oxfuel and Entity(vehicle).state.fuel or GetVehicleFuelLevel(vehicle)
+            if healthBuffer[1] <= 0 or fuelLevel <= 6.4 then
+                if IsVehicleDriveable(vehicle, true) then
+                    SetVehicleUndriveable(vehicle, true)
+                end
+            end
+
+            -- Reduce torque after half-life
+            if not Handler:isLimited() then
+                if healthBuffer[1] < 500 then
+                    Handler:setLimited(true)
+
+                    CreateThread(function()
+                        while (cache.vehicle == vehicle) and (healthBuffer[1] < 500) do
+                            local newtorque = (healthBuffer[1] + 500) / 1100
+                            SetVehicleCheatPowerIncrease(vehicle, newtorque)
+                            Wait(1)
+                        end
+
+                        Handler:setLimited(false)
+                    end)
+                end
+            end
+
+            -- Prevent rotation controls while flipped/airborne
+            if Settings.regulated[class] then
+                if speedBuffer[1] < 2.0 then
+                    if airborne then airborne = false end
+                    roll = GetEntityRoll(vehicle)
+                else
+                    airborne = IsEntityInAir(vehicle)
+                end
+
+                if (roll > 75.0 or roll < -75.0) or airborne then
+                    SetVehicleOutOfControl(vehicle, false, false)
+                end
+            end
+
+            -- Damage handler
+            local bodyDiff = bodyBuffer[2] - bodyBuffer[1]
+            if bodyDiff >= 1 then
+
+                -- Calculate latest damage
+                local bodyDamage = bodyDiff * Settings.globalmultiplier * Settings.classmultiplier[class]
+                local vehicleHealth = healthBuffer[1] - bodyDamage
+
+                -- Update engine health
+                if vehicleHealth ~= healthBuffer[1] and vehicleHealth > 0 then
+                    SetVehicleEngineHealth(vehicle, vehicleHealth)
+                elseif vehicleHealth ~= 0 then
+                    SetVehicleEngineHealth(vehicle, 0.0) -- prevent negative engine health
+                end
+
+                -- Prevent negative body health
+                if bodyBuffer[1] < 0 then
+                    SetVehicleBodyHealth(vehicle, 0.0)
+                end
+
+                -- Prevent negative tank health (explosion)
+                if GetVehiclePetrolTankHealth(vehicle) < 0 then
+                    SetVehiclePetrolTankHealth(vehicle, 0.0)
+                end
+            end
+
+            -- Impact handler
+            local speedDiff = speedBuffer[2] - speedBuffer[1]
+            if speedDiff >= Settings.threshold.speed then
+
+                -- Handle wheel loss
+                if Settings.breaktire then
+                    if bodyDiff >= Settings.threshold.tire then
+                        math.randomseed(GetGameTimer())
+                        Handler:breakTire(vehicle, math.random(0, 1))
+                    end
+                end
+
+                -- Handle heavy impact
+                if speedDiff >= Settings.threshold.heavy then
+                    SetVehicleUndriveable(vehicle, true)
+                    SetVehicleEngineHealth(vehicle, 0.0) -- Disable vehicle completely
+                end
+            end
+
+            -- Store data for next cycle
+            bodyBuffer[2] = bodyBuffer[1]
+            healthBuffer[2] = healthBuffer[1]
+            speedBuffer[2] = speedBuffer[1]
+
+            Wait(100)
+        end
+
+        Handler:setActive(false)
+
+        -- Retrigger thread if admin spawns a new vehicle while in one
+        if cache.vehicle and cache.seat == -1 then
+            if Handler:isLimited() then Handler:setLimited(false) end
+            startThreads(cache.vehicle)
+        end
+    end)
+end
+
+lib.onCache('seat', function(seat)
+    if seat == -1 then
+        startThreads(cache.vehicle)
+    end
+end)
+
+lib.callback.register('vehiclehandler:adminfuel', function(newlevel)
+    if not Handler or not Handler:isActive() then return end
+    return Handler:adminfuel(newlevel)
+end)
+
+lib.callback.register('vehiclehandler:adminwash', function()
+    if not Handler or not Handler:isActive() then return end
+    return Handler:adminwash()
+end)
+
+lib.callback.register('vehiclehandler:adminfix', function()
+    if not Handler or not Handler:isActive() then return end
+    return Handler:adminfix()
+end)
+
+lib.callback.register('vehiclehandler:basicwash', function()
+    if not Handler then return end
+    return Handler:basicwash()
+end)
+
+lib.callback.register('vehiclehandler:basicfix', function(fixtype)
+    if not fixtype or type(fixtype) ~= 'string' then return end
+    if not Handler then return end
+    return Handler:basicfix(fixtype)
+end)
+
+CreateThread(function()
+    Handler = Class:new()
+    startThreads(cache.vehicle)
+end)

data/progress.lua

@@ -0,0 +1,67 @@
+return {
+    ['cleankit'] = {
+        label = "Cleaning vehicle",
+        duration = math.random(10000, 20000),
+        position = 'bottom',
+        useWhileDead = false,
+        canCancel = true,
+        disable = {
+            car = true,
+            move = true,
+            combat = true,
+            mouse = false,
+        },
+    },
+    ['tirekit'] = {
+        label = "Repairing tires",
+        duration = math.random(10000, 20000),
+        position = 'bottom',
+        useWhileDead = false,
+        canCancel = true,
+        disable = {
+            car = true,
+            move = true,
+            combat = true,
+            mouse = false,
+        },
+        anim = {
+            dict = "anim@amb@clubhouse@tutorial@bkr_tut_ig3@",
+            clip = "machinic_loop_mechandplayer",
+            flag = 10
+        },
+    },
+    ['smallkit'] = {
+        label = "Repairing vehicle",
+        duration = math.random(15000, 20000),
+        position = 'bottom',
+        useWhileDead = false,
+        canCancel = true,
+        disable = {
+            car = true,
+            move = true,
+            combat = true,
+            mouse = false,
+        },
+        anim = {
+            dict = "mini@repair",
+            clip = "fixing_a_player"
+        },
+    },
+    ['bigkit'] = {
+        label = "Repairing vehicle",
+        duration = math.random(25000, 30000),
+        position = 'bottom',
+        useWhileDead = false,
+        canCancel = true,
+        disable = {
+            car = true,
+            move = true,
+            combat = true,
+            mouse = false,
+        },
+        anim = {
+            dict = "mini@repair",
+            clip = "fixing_a_player"
+        },
+    }
+}