1
0
Fork 0
forked from Simnation/Main
Main/resources/[carscripts]/jg-dealerships/framework/cl-functions.lua
2025-08-04 20:32:58 +02:00

415 lines
No EOL
15 KiB
Lua

---@param text string
function Framework.Client.ShowTextUI(text)
SetTimeout(1, function()
if (Config.DrawText == "auto" and GetResourceState("jg-textui") == "started") or Config.DrawText == "jg-textui" then
exports["jg-textui"]:DrawText(text)
elseif (Config.DrawText == "auto" and GetResourceState("ox_lib") == "started") or Config.DrawText == "ox_lib" then
exports["ox_lib"]:showTextUI(text, {
position = "left-center"
})
elseif (Config.DrawText == "auto" and GetResourceState("okokTextUI") == "started") or Config.DrawText == "okokTextUI" then
exports["okokTextUI"]:Open(text, "lightblue", "left")
elseif (Config.DrawText == "auto" and GetResourceState("ps-ui") == "started") or Config.DrawText == "ps-ui" then
exports["ps-ui"]:DisplayText(text, "primary")
elseif Config.Framework == "QBCore" then
exports["qb-core"]:DrawText(text)
else
error("You do not have a TextUI system set up!")
end
end)
end
function Framework.Client.HideTextUI()
if (Config.DrawText == "auto" and GetResourceState("jg-textui") == "started") or Config.DrawText == "jg-textui" then
exports["jg-textui"]:HideText()
elseif (Config.DrawText == "auto" and GetResourceState("ox_lib") == "started") or Config.DrawText == "ox_lib" then
exports["ox_lib"]:hideTextUI()
elseif (Config.DrawText == "auto" and GetResourceState("okokTextUI") == "started") or Config.DrawText == "okokTextUI" then
exports["okokTextUI"]:Close()
elseif (Config.DrawText == "auto" and GetResourceState("ps-ui") == "started") or Config.DrawText == "ps-ui" then
exports["ps-ui"]:HideText()
elseif Config.Framework == "QBCore" then
exports["qb-core"]:HideText()
else
error("You do not have a TextUI system set up!")
end
end
---@param msg string
---@param type? "success" | "warning" | "error"
---@param time? number
function Framework.Client.Notify(msg, type, time)
type = type or "success"
time = time or 5000
if (Config.Notifications == "auto" and GetResourceState("okokNotify") == "started") or Config.Notifications == "okokNotify" then
exports["okokNotify"]:Alert("Dealerships", msg, time, type)
elseif (Config.Notifications == "auto" and GetResourceState("ps-ui") == "started") or Config.Notifications == "ps-ui" then
exports["ps-ui"]:Notify(msg, type, time)
elseif (Config.Notifications == "auto" and GetResourceState("ox_lib") == "started") or Config.Notifications == "ox_lib" then
exports["ox_lib"]:notify({
title = "Dealerships",
description = msg,
type = type
})
else
if Config.Framework == "QBCore" then
return QBCore.Functions.Notify(msg, type, time)
elseif Config.Framework == "Qbox" then
exports.qbx_core:Notify(msg, type, time)
elseif Config.Framework == "ESX" then
return ESX.ShowNotification(msg, type)
end
end
end
RegisterNetEvent("jg-dealerships:client:notify", function(...)
Framework.Client.Notify(...)
end)
function Framework.Client.ToggleHud(toggle)
DisplayHud(toggle)
DisplayRadar(toggle)
end
--
-- Vehicle Functions
--
---@param vehicle integer
---@return table|false props
function Framework.Client.GetVehicleProperties(vehicle)
if GetResourceState("jg-mechanic") == "started" then
return exports["jg-mechanic"]:getVehicleProperties(vehicle)
else
if Config.Framework == "QBCore" then
return QBCore.Functions.GetVehicleProperties(vehicle)
elseif Config.Framework == "Qbox" then
return lib.getVehicleProperties(vehicle) or false
elseif Config.Framework == "ESX" then
return ESX.Game.GetVehicleProperties(vehicle)
end
end
return false
end
---@param vehicle integer
---@param props table
function Framework.Client.SetVehicleProperties(vehicle, props)
if GetResourceState("jg-mechanic") == "started" then
return exports["jg-mechanic"]:setVehicleProperties(vehicle, props)
else
if Config.Framework == "QBCore" then
return QBCore.Functions.SetVehicleProperties(vehicle, props)
elseif Config.Framework == "Qbox" then
return lib.setVehicleProperties(vehicle, props)
elseif Config.Framework == "ESX" then
return ESX.Game.SetVehicleProperties(vehicle, props)
end
end
end
---@param vehicle integer
---@return number fuelLevel
function Framework.Client.VehicleGetFuel(vehicle)
if not DoesEntityExist(vehicle) then return 0 end
if (Config.FuelSystem == "LegacyFuel" or Config.FuelSystem == "ps-fuel" or Config.FuelSystem == "lj-fuel" or Config.FuelSystem == "cdn-fuel" or Config.FuelSystem == "hyon_gas_station" or Config.FuelSystem == "okokGasStation" or Config.FuelSystem == "nd_fuel" or Config.FuelSystem == "myFuel" or Config.FuelSystem == "rcore_fuel" or Config.Fuelsystem == "qs-fuelstations") then
return exports[Config.FuelSystem]:GetFuel(vehicle)
elseif Config.FuelSystem == "ti_fuel" then
local level, type = exports["ti_fuel"]:getFuel(vehicle)
TriggerServerEvent("jg-dealerships:server:save-ti-fuel-type", Framework.Client.GetPlate(vehicle), type)
return level
elseif Config.FuelSystem == "ox_fuel" or Config.FuelSystem == "Renewed-Fuel" then
return GetVehicleFuelLevel(vehicle)
elseif Config.FuelSystem == "rcore_fuel" then
return exports.rcore_fuel:GetVehicleFuelPercentage(vehicle)
else
return 65 -- or set up custom fuel system here...
end
end
---@param vehicle integer
---@param fuel number
function Framework.Client.VehicleSetFuel(vehicle, fuel)
if not DoesEntityExist(vehicle) then return false end
if (Config.FuelSystem == "LegacyFuel" or Config.FuelSystem == "ps-fuel" or Config.FuelSystem == "lj-fuel" or Config.FuelSystem == "cdn-fuel" or Config.FuelSystem == "hyon_gas_station" or Config.FuelSystem == "okokGasStation" or Config.FuelSystem == "nd_fuel" or Config.FuelSystem == "myFuel" or Config.FuelSystem == "Renewed-Fuel" or Config.FuelSystem == "rcore_fuel" or Config.FuelSystem == "qs-fuelstations") then
exports[Config.FuelSystem]:SetFuel(vehicle, fuel)
elseif Config.FuelSystem == "ti_fuel" then
local fuelType = lib.callback.await("jg-dealerships:server:get-ti-fuel-type", false, Framework.Client.GetPlate(vehicle))
exports["ti_fuel"]:setFuel(vehicle, fuel, fuelType or nil)
elseif Config.FuelSystem == "ox_fuel" then
Entity(vehicle).state.fuel = fuel
elseif Config.FuelSystem == "rcore_fuel" then
exports.rcore_fuel:SetVehicleFuel(vehicle, fuel)
else
-- Setup custom fuel system here
end
end
---@param plate string
---@param vehicleEntity integer
---@param origin "testDrive"|"purchase"
function Framework.Client.VehicleGiveKeys(plate, vehicleEntity, origin)
if not DoesEntityExist(vehicleEntity) then return false end
if Config.VehicleKeys == "qb-vehiclekeys" then
TriggerEvent("vehiclekeys:client:SetOwner", plate)
elseif Config.VehicleKeys == "jaksam-vehicles-keys" then
TriggerServerEvent("vehicles_keys:selfGiveVehicleKeys", plate)
elseif Config.VehicleKeys == "mk_vehiclekeys" then
exports["mk_vehiclekeys"]:AddKey(vehicleEntity)
elseif Config.VehicleKeys == "qs-vehiclekeys" then
local model = GetDisplayNameFromVehicleModel(GetEntityModel(vehicleEntity))
exports["qs-vehiclekeys"]:GiveKeys(plate, model)
elseif Config.VehicleKeys == "wasabi_carlock" then
exports.wasabi_carlock:GiveKey(plate)
elseif Config.VehicleKeys == "cd_garage" then
TriggerEvent("cd_garage:AddKeys", plate)
elseif Config.VehicleKeys == "okokGarage" then
TriggerServerEvent("okokGarage:GiveKeys", plate)
elseif Config.VehicleKeys == "t1ger_keys" then
TriggerServerEvent("t1ger_keys:updateOwnedKeys", plate, true)
elseif Config.VehicleKeys == "MrNewbVehicleKeys" then
exports.MrNewbVehicleKeys:GiveKeys(vehicleEntity)
elseif Config.VehicleKeys == "Renewed" then
exports["Renewed-Vehiclekeys"]:addKey(plate)
elseif Config.VehicleKeys == "mx_carkeys" then
if origin == "testDrive" then
exports["mx_carkeys"]:createTempKey(vehicleEntity, plate, 2)
else
exports["mx_carkeys"]:buyVehicle(vehicleEntity, plate, 2)
end
elseif Config.VehicleKeys == "tgiann-hotwire" then
if origin == "testDrive" then
exports["tgiann-hotwire"]:SetNonRemoveableIgnition(vehicleEntity, true)
else
exports["tgiann-hotwire"]:GiveKeyPlate(plate, true)
end
else
-- Setup custom key system here...
end
end
---@param plate string
---@param vehicleEntity integer
---@param origin "vehicleSale"|"testDrive"
function Framework.Client.VehicleRemoveKeys(plate, vehicleEntity, origin)
if not DoesEntityExist(vehicleEntity) then return false end
if Config.VehicleKeys == "qs-vehiclekeys" then
local model = GetDisplayNameFromVehicleModel(GetEntityModel(vehicleEntity))
exports["qs-vehiclekeys"]:RemoveKeys(plate, model)
elseif Config.VehicleKeys == "wasabi_carlock" then
exports.wasabi_carlock:RemoveKey(plate)
elseif Config.VehicleKeys == "t1ger_keys" then
TriggerServerEvent("t1ger_keys:updateOwnedKeys", plate, false)
elseif Config.VehicleKeys == "MrNewbVehicleKeys" then
exports.MrNewbVehicleKeys:RemoveKeys(vehicleEntity)
elseif Config.VehicleKeys == "Renewed" then
exports["Renewed-Vehiclekeys"]:removeKey(plate)
elseif Config.VehicleKeys == "mx_carkeys" then
exports["mx_carkeys"]:removeVehicleKey(vehicleEntity)
else
-- Setup custom key system here...
end
end
---@param vehicle integer
---@return string|false plate
function Framework.Client.GetPlate(vehicle)
local plate = GetVehicleNumberPlateText(vehicle)
if not plate or plate == nil or plate == "" then return false end
if GetResourceState("brazzers-fakeplates") == "started" then
local originalPlate = lib.callback.await("jg-dealerships:server:brazzers-get-plate-from-fakeplate", false, plate)
if originalPlate then plate = originalPlate end
end
local trPlate = string.gsub(plate, "^%s*(.-)%s*$", "%1")
return trPlate
end
---@param vehicle integer
---@return string|number|false model
function Framework.Client.GetModelColumn(vehicle)
if Config.Framework == "QBCore" or Config.Framework == "Qbox" then
return vehicle.vehicle or tonumber(vehicle.hash) or false
elseif Config.Framework == "ESX" then
if not vehicle or not vehicle.vehicle then return false end
if type(vehicle.vehicle) == "string" then
if not json.decode(vehicle.vehicle) then return false end
return json.decode(vehicle.vehicle).model
else
return vehicle.vehicle.model
end
end
return false
end
-- Get a nice vehicle label from either QBCore shared or GTA natives
---@param model string | number
function Framework.Client.GetVehicleLabel(model)
if type(model) == "string" then
if Config.Framework == "QBCore" and QBCore.Shared.Vehicles then
local vehShared = QBCore.Shared.Vehicles[model]
if vehShared then
return vehShared.brand .. " " .. vehShared.name
end
end
if Config.Framework == "Qbox" and exports.qbx_core:GetVehiclesByName() then
local vehShared = exports.qbx_core:GetVehiclesByName()[model]
if vehShared then
return vehShared.brand .. " " .. vehShared.name
end
end
end
local hash = type(model) == "string" and joaat(model) or model
local makeName = GetMakeNameFromVehicleModel(hash)
local modelName = GetDisplayNameFromVehicleModel(hash)
local label = GetLabelText(makeName) .. " " .. GetLabelText(modelName)
if makeName == "CARNOTFOUND" or modelName == "CARNOTFOUND" then
label = tostring(model)
else
if GetLabelText(modelName) == "NULL" and GetLabelText(makeName) == "NULL" then
label = (makeName or "") .. " " .. (modelName or "")
elseif GetLabelText(makeName) == "NULL" then
label = GetLabelText(modelName)
end
end
return label
end
---Returns vehicle stats in a table format
---@param model string model (archetype) name
function Framework.Client.GetVehicleStats(model)
local vehicle = joaat(model) -- convert to hash
local class = GetVehicleClassFromName(vehicle)
local mult, pmult, tmult = 1, 1000, 800
if class == 14 or class == 15 or class == 16 then
mult, pmult, tmult = 0.1, 10, 8
end
local brake = GetVehicleModelMaxBraking(vehicle) * mult
local handling = ((GetVehicleModelMaxBraking(vehicle) + GetVehicleModelMaxBrakingMaxMods(vehicle)) * GetVehicleModelMaxTraction(vehicle)) * mult
local topSpeed = math.ceil(GetVehicleModelEstimatedMaxSpeed(vehicle) * 2.2369)
if Config.SpeedUnit == "kph" then topSpeed = math.ceil(GetVehicleModelEstimatedMaxSpeed(vehicle) * 3.6) end
local power = math.ceil(GetVehicleModelAcceleration(vehicle) * pmult)
local torque = math.ceil(GetVehicleModelAcceleration(vehicle) * tmult)
-- If you are really unhappy with the values being returned from the game, you could write something
-- like the following to overwrite the values to custom ones, by writing something like:
--
-- if model == "adder" then
-- return {
-- brake = 1.0,
-- handling = 7.0,
-- topSpeed = 150,
-- power = 900,
-- torque = 800
-- }
-- end
return {
brake = brake,
handling = handling,
topSpeed = topSpeed,
power = power,
torque = torque
}
end
--
-- Player Functions
--
function Framework.Client.GetPlayerData()
if Config.Framework == "QBCore" then
return QBCore.Functions.GetPlayerData()
elseif Config.Framework == "Qbox" then
return exports.qbx_core:GetPlayerData()
elseif Config.Framework == "ESX" then
return ESX.GetPlayerData()
end
end
function Framework.Client.GetPlayerIdentifier()
if Config.Framework == "QBCore" or Config.Framework == "Qbox" then
return Globals.PlayerData.citizenid
elseif Config.Framework == "ESX" then
return Globals.PlayerData.identifier
end
end
---@param type "cash" | "bank" | "money" | string
function Framework.Client.GetBalance(type)
if type == "custom" then
-- Add your own custom balance system here
elseif Config.Framework == "QBCore" then
return QBCore.Functions.GetPlayerData().money[type]
elseif Config.Framework == "Qbox" then
return exports.qbx_core:GetPlayerData().money[type]
elseif Config.Framework == "ESX" then
if type == "cash" then type = "money" end
for i, acc in pairs(ESX.GetPlayerData().accounts) do
if acc.name == type then
return acc.money
end
end
return 0
end
end
---@param society string
---@param type "job"|"gang"
---@return number balance
function Framework.Client.GetSocietyBalance(society, type)
local balance = lib.callback.await("jg-dealerships:server:get-society-balance", false, society, type)
return balance
end
function Framework.Client.GetPlayerJob()
local player = Framework.Client.GetPlayerData()
if not player or not player.job then return {} end
if Config.Framework == "QBCore" or Config.Framework == "Qbox" then
return {
name = player.job.name,
label = player.job.label,
grade = player.job.grade.level
}
elseif Config.Framework == "ESX" then
return {
name = player.job.name,
label = player.job.label,
grade = player.job.grade
}
end
end
function Framework.Client.GetPlayerGang()
if Config.Framework == "QBCore" or Config.Framework == "Qbox" then
local player = Framework.Client.GetPlayerData()
if not player or not player.gang then return {} end
return {
name = player.gang.name,
label = player.gang.label,
grade = player.gang.grade.level
}
elseif Config.Framework == "ESX" then
error("ESX does not natively support gangs.");
end
end