TasksClient

taskPlayAnimAdvanced

TASK_PLAY_ANIM_ADVANCED0x83CDB10EA29B370B

The GTA V native TASK_PLAY_ANIM_ADVANCED of the TASK namespace, as LS:MP client scripts call it: the global function taskPlayAnimAdvanced, in JavaScript and in Lua.

SignatureJavaScript
taskPlayAnimAdvanced(
  ped: Ped,
  animDict: string,
  animName: string,
  posX: number,
  posY: number,
  posZ: number,
  rotX: number,
  rotY: number,
  rotZ: number,
  animEnterSpeed: number,
  animExitSpeed: number,
  duration: number,
  flag: any,
  animTime: number,
  rotOrder: number,
  ikFlags: number
): void
SignatureLua
taskPlayAnimAdvanced(
  ped: Ped,
  animDict: string,
  animName: string,
  posX: number,
  posY: number,
  posZ: number,
  rotX: number,
  rotY: number,
  rotZ: number,
  animEnterSpeed: number,
  animExitSpeed: number,
  duration: integer,
  flag: any,
  animTime: number,
  rotOrder: integer,
  ikFlags: integer
)

Usage

JavaScript
taskPlayAnimAdvanced(
  ped, animDict, animName, posX, posY, posZ, rotX, rotY, rotZ, animEnterSpeed, animExitSpeed,
  duration, flag, animTime, rotOrder, ikFlags
);
Lua
taskPlayAnimAdvanced(
    ped, animDict, animName, posX, posY, posZ, rotX, rotY, rotZ, animEnterSpeed, animExitSpeed,
    duration, flag, animTime, rotOrder, ikFlags
)

Three consecutive numbers can be given as one vector: { x, y, z } (or [x, y, z]) in JavaScript, a Vector3 in Lua.

JavaScript · with vectors
taskPlayAnimAdvanced(
  ped, animDict, animName, pos, rot, animEnterSpeed, animExitSpeed, duration, flag, animTime,
  rotOrder, ikFlags
);
Lua · with vectors
taskPlayAnimAdvanced(
    ped, animDict, animName, pos, rot, animEnterSpeed, animExitSpeed, duration, flag, animTime,
    rotOrder, ikFlags
)

Parameters

ParameterTypeJavaScriptLua
pedPednumberinteger
animDictstringstringstring
animNamestringstringstring
posXfloatnumbernumber
posYfloatnumbernumber
posZfloatnumbernumber
rotXfloatnumbernumber
rotYfloatnumbernumber
rotZfloatnumbernumber
animEnterSpeedfloatnumbernumber
animExitSpeedfloatnumbernumber
durationintnumberinteger
flagAnyanyany
animTimefloatnumbernumber
rotOrderintnumberinteger
ikFlagsintnumberinteger

Returns

Nothing. In JavaScript the call evaluates to undefined.

Notes

From the community native database. Names are LS:MP’s; samples may be written for C++ or another framework.

It's similar to taskPlayAnim, except the first 6 floats let you specify the initial position and rotation of the task. (Ped gets teleported to the position).

Full list of animation dictionaries and anims by DurtyFree: https://github.com/DurtyFree/gta-v-data-dumps/blob/master/animDictsCompact.json

Reference

Namespace
Tasks TASK
In the game
void TASK_PLAY_ANIM_ADVANCED(Ped ped, const char* animDict, const char* animName, float posX, float posY, float posZ, float rotX, float rotY, float rotZ, float animEnterSpeed, float animExitSpeed, int duration, Any flag, float animTime, int rotOrder, int ikFlags)
Hash
0x83CDB10EA29B370B

Open in the interactive natives reference