mirror of
https://github.com/jimathy/jim_bridge.git
synced 2026-08-17 14:06:02 +01:00
249 lines
9.7 KiB
Lua
249 lines
9.7 KiB
Lua
local inProgress = false
|
|
local storedPID = nil
|
|
|
|
--- Displays a progress bar using the configured progress bar system.
|
|
---
|
|
--- This function handles displaying a progress bar to the player using the specified progress bar system (e.g., ox, qb, esx, gta).
|
|
--- It supports shared progress bars between players, animations, camera effects, and more.
|
|
---
|
|
---@param data table A table containing the progress bar configuration.
|
|
--- - **label** (`string`): The text label to display on the progress bar.
|
|
--- - **time** (`number`): The duration of the progress bar in milliseconds.
|
|
--- - **dict** (`string`, optional): The animation dictionary to use.
|
|
--- - **anim** (`string`, optional): The animation name to play.
|
|
--- - **task** (`string`, optional): The task scenario to perform.
|
|
--- - **flag** (`number`, optional): The animation flag.
|
|
--- - **dead** (`boolean`, optional): Whether to allow the progress bar when the player is dead. Default is `false`.
|
|
--- - **cancel** (`boolean`, optional): Whether the progress bar can be canceled by the player. Default is `true`.
|
|
--- - **icon** (`string`, optional): The icon to display (for qb progress bar).
|
|
--- - **cam** (`number`, optional): The camera handle to use.
|
|
--- - **shared** (`table`, optional): Data for shared progress bars.
|
|
--- - **pid** (`number`): The player ID to share the progress bar with.
|
|
--- - **label** (`string`): The label to display on the shared progress bar.
|
|
---
|
|
--- @return boolean `true` if the progress bar completed successfully, or `false` if it was canceled.
|
|
---
|
|
---@usage
|
|
--- ```lua
|
|
--- local success = progressBar({
|
|
--- label = "Processing...",
|
|
--- time = 5000,
|
|
--- dict = "amb@world_human_hang_out_street@female_hold_arm@base",
|
|
--- anim = "base",
|
|
--- flag = 49,
|
|
--- cancel = true,
|
|
--- })
|
|
--- ```
|
|
function progressBar(data)
|
|
local ped = PlayerPedId()
|
|
if data.shared then
|
|
debugPrint("^6Bridge^7: ^6Sharing progressBar to player^7: ^6"..data.shared.pid.."^7")
|
|
storedPID = data.shared.pid
|
|
TriggerServerEvent(getScript()..":server:sharedProg:Start", data)
|
|
end
|
|
local result = nil
|
|
if data.cam then startTempCam(data.cam) end
|
|
if Config.System.ProgressBar == "ox" then
|
|
local options = {
|
|
duration = debugMode and 1000 or data.time,
|
|
label = data.label,
|
|
position = data.position or "bottom",
|
|
useWhileDead = data.dead or false,
|
|
canCancel = data.cancel or true,
|
|
anim = {
|
|
dict = data.dict,
|
|
clip = data.anim,
|
|
flag = (data.flag == 8 and 32 or data.flag) or nil,
|
|
scenario = data.task
|
|
},
|
|
disable = {
|
|
combat = data.combat or true,
|
|
move = data.disableMovement or false,
|
|
car = data.disableMovement or false,
|
|
mouse = data.mouse or false
|
|
},
|
|
}
|
|
if data.prop and data.prop.model then
|
|
options.prop = {
|
|
model = data.prop.model,
|
|
pos = data.prop.pos or vec3(0, 0, 0),
|
|
rot = data.prop.rot or vec3(0, 0, 0),
|
|
bone = data.prop.bone or 0
|
|
}
|
|
end
|
|
if data.propTwo and data.propTwo.model then
|
|
options.propTwo = {
|
|
model = data.propTwo.model,
|
|
pos = data.propTwo.pos or vec3(0, 0, 0),
|
|
rot = data.propTwo.rot or vec3(0, 0, 0),
|
|
bone = data.propTwo.bone or 0
|
|
}
|
|
end
|
|
if data.progressType == "circle" then
|
|
if exports[OXLibExport]:progressCircle(options) then
|
|
result = true
|
|
else
|
|
result = false
|
|
end
|
|
end
|
|
if not data.progressType or data.progressType == "bar" then
|
|
if exports[OXLibExport]:progressBar(options) then
|
|
result = true
|
|
else
|
|
result = false
|
|
end
|
|
end
|
|
|
|
elseif Config.System.ProgressBar == "qb" then
|
|
Core.Functions.Progressbar("progbar",
|
|
data.label,
|
|
debugMode and 1000 or data.time,
|
|
data.dead or false,
|
|
data.cancel or true,
|
|
{
|
|
disableMovement = data.disableMovement or false,
|
|
disableCarMovement = data.disableMovement or false,
|
|
disableMouse = data.disableMouse or false,
|
|
disableCombat = data.disableCombat or true,
|
|
},
|
|
{
|
|
animDict = data.dict,
|
|
anim = data.anim,
|
|
flags = data.flag or 32,
|
|
task = data.task
|
|
},
|
|
{}, {},
|
|
function()
|
|
result = true
|
|
end, function()
|
|
result = false
|
|
end, data.icon)
|
|
|
|
elseif Config.System.ProgressBar == "esx" then
|
|
ESX.Progressbar(data.label, debugMode and 1000 or data.time, {
|
|
FreezePlayer = true,
|
|
animation = {
|
|
type = data.anim,
|
|
dict = data.dict,
|
|
scenario = data.task,
|
|
},
|
|
onFinish = function()
|
|
result = true
|
|
end,
|
|
onCancel = function()
|
|
result = false
|
|
end
|
|
})
|
|
|
|
elseif Config.System.ProgressBar == "red" then
|
|
-- Currently only uses jim-redui if you choose this option
|
|
if exports["jim_bridge"]:redProgressBar({
|
|
label = data.label,
|
|
time = debugMode and 1000 or data.time,
|
|
dict = data.dict,
|
|
anim = data.anim,
|
|
flag = data.flag or 32,
|
|
task = data.task,
|
|
disableMovement = data.disableMovement or false,
|
|
cancel = data.cancel or true,
|
|
}) then
|
|
result = true
|
|
else
|
|
result = false
|
|
end
|
|
|
|
elseif Config.System.ProgressBar == "gta" then
|
|
if exports["jim_bridge"]:gtaProgressBar({
|
|
label = data.label,
|
|
time = debugMode and 1000 or data.time,
|
|
dict = data.dict,
|
|
anim = data.anim,
|
|
flag = data.flag or 32,
|
|
task = data.task,
|
|
disableMovement = data.disableMovement or false,
|
|
cancel = data.cancel or true,
|
|
}) then
|
|
result = true
|
|
else
|
|
result = false
|
|
end
|
|
|
|
end
|
|
|
|
while result == nil do
|
|
Wait(10)
|
|
end
|
|
|
|
-- Cleanup
|
|
FreezeEntityPosition(ped, false)
|
|
lockInv(false)
|
|
if data.cam then
|
|
stopTempCam(data.cam)
|
|
end
|
|
if result == false and data.shared then
|
|
debugPrint("^6Bridge^7: ^2Sending cancel to ^6"..storedPID.."^7")
|
|
TriggerServerEvent(getScript().."server:sharedProg:cancel", storedPID)
|
|
end
|
|
storedPID = nil
|
|
if result == false then
|
|
currentToken = nil
|
|
TriggerServerEvent(getScript()..":clearAuthToken")
|
|
end
|
|
if result == true and data.request then
|
|
TriggerServerEvent(getScript()..":clearAuthToken")
|
|
currentToken = triggerCallback(AuthEvent)
|
|
end
|
|
return result
|
|
end
|
|
|
|
--- Stops the current progress bar.
|
|
---
|
|
--- This function cancels the progress bar based on the configured progress bar system, handling any necessary cleanup.
|
|
function stopProgressBar()
|
|
if Config.System.ProgressBar == "ox" then
|
|
exports[OXLibExport]:cancelProgress()
|
|
elseif Config.System.ProgressBar == "qb" then
|
|
TriggerEvent("progressbar:client:cancel")
|
|
elseif Config.System.ProgressBar == "gta" or Config.System.ProgressBar == "red" then
|
|
exports["jim_bridge"]:stopProgressBar()
|
|
end
|
|
end
|
|
|
|
-- System to handle sending/sharing progress bars between players --
|
|
-- For example, healing someone --
|
|
|
|
|
|
--- Server event handler for starting a shared progress bar.
|
|
--- This event is triggered when a player wants to start a progress bar on another player.
|
|
--- It adjusts the data to prevent loops and sends the data to the target client.
|
|
RegisterNetEvent(getScript()..":server:sharedProg:Start", function(data)
|
|
local pid = data.shared.pid -- Get player ID from the client
|
|
data.label = data.shared.label -- Set progress bar label to the shared label
|
|
data.cancel = false -- Make it so it can't be canceled
|
|
data.dead = true -- Allow progress bar even if player is dead
|
|
data.shared = nil -- Remove shared info to prevent loops
|
|
data.anim = nil -- Remove animation so players don't share it
|
|
debugPrint("^6Bridge^7: ^6"..source.." ^2is sending shared progressBar to player^7, ^6"..pid.."^7")
|
|
TriggerClientEvent(getScript()..":client:sharedProg:Start", pid, data)
|
|
end)
|
|
|
|
--- Client event handler for starting a shared progress bar.
|
|
--- This event is triggered when the server wants the client to start a shared progress bar.
|
|
RegisterNetEvent(getScript()..":client:sharedProg:Start", function(data)
|
|
debugPrint("^6Bridge^7: ^2You have been sent a progressBar^7")
|
|
progressBar(data)
|
|
end)
|
|
|
|
--- Server event handler for canceling a shared progress bar.
|
|
--- This event is triggered when a progress bar is canceled and the server needs to notify the other player.
|
|
RegisterNetEvent(getScript()..":server:sharedProg:Cancel", function(pid)
|
|
debugPrint("^6Bridge^7: ^2Sending cancel progressBar to ^6"..pid.."^7")
|
|
TriggerClientEvent(getScript()..":client:sharedProg:Cancel", pid)
|
|
end)
|
|
|
|
--- Client event handler for canceling a shared progress bar.
|
|
--- This event is triggered when the server wants the client to cancel a shared progress bar.
|
|
RegisterNetEvent(getScript()..":client:sharedProg:Cancel", function()
|
|
debugPrint("^6Bridge^7: ^2Receiving cancel progressBar^7")
|
|
stopProgressBar()
|
|
end) |