GET_SCRIPT_TASK_STATUS

Namespace: TASKAPI set: clientGame: gta5editImprove

GET_SCRIPT_TASK_STATUS

0x77F1BEB8863288D5

0xB2477B23

// GetScriptTaskStatus
int GET_SCRIPT_TASK_STATUS(Ped ped, Hash taskHash);

Parameters:

ped:
The ped the task is running on
taskHash:
The hash of the task

Returns:

The status of the script-assigned task.

Gets the status of a spesifed script-assigned task on the given ped. The return value is always an int between 0-7.

You can set taskHash to SCRIPT_TASK_ANY to check if any task is active, it will return 1 for active, 3 for no active. SCRIPT_TASK_INVALID can be similarly used, it returns 7 if there are any active task, and 3 if there are no active tasks.

taskHash list: https://alloc8or.re/gta5/doc/enums/eScriptTaskHash.txt

Returns:

0 = WAITING_TO_START_TASK
1 = PERFORMING_TASK
2 = DORMANT_TASK
3 = VACANT_STAGE
7 = TASK_FINISHED_OR_NOT_FOUND

Examples:

local playerPed = PlayerPedId()
local coords = GetOffsetFromEntityInWorldCoords(playerPed, 0.0, 6.0, 0.0)
TaskGoStraightToCoord(playerPed, coords, 1.0, 5000, GetEntityHeading(playerPed), 0.15)

Citizen.CreateThread(function()
    while true do
        local taskStatus = GetScriptTaskStatus(PlayerPedId(), "SCRIPT_TASK_GO_STRAIGHT_TO_COORD")
        print(taskStatus)
        if taskStatus == 7 then print("task was finished!"); break end
        Citizen.Wait(250)
    end
end)