TaskPlayAnim (0xEA47FE3719165B94) silently no-ops unless the anim dict is loaded first

Context

TaskPlayAnim does nothing if the animation dictionary isn't resident — and it fails silently, which is a common "why won't my animation play" trap.

The required preload

RequestAnimDict(dict)
while not HasAnimDictLoaded(dict) do Wait(0) end   -- BLOCK until loaded
TaskPlayAnim(ped, dict, name, 4.0, -4.0, duration, flag, 0.0, false, false, false)

Notes

• Always RequestAnimDict + busy-wait on HasAnimDictLoaded before calling.
• jo_libs passes 11 of the 13 documented params (omits the trailing taskFilter/p12).
• Blend-in / blend-out are 4.0 / -4.0 (positive in, negative out), not 8.0.

Verified

animation/client.lua:10-37 (the jo.animation.load(dict, true) blocking loader feeds straight into TaskPlayAnim).

Tags: task, taskplayanim, animdict, requestanimdict, ordering, companion-call
Category: natives
Source: jo_libs-fleet
Created: 2026-05-31T09:41:49.027Z