Skip to content
MTA:SA Neon Documentation

setPedTurnToFace

Client-side
NEON APINative ped tasks and gang tags

Available in Neon, not standard MTA

Queues GTA's native body-turn task so an owned ped faces another live ped.

Syntax

bool setPedTurnToFace(ped thePed, ped targetPed)

GTA task mapping

ORIGINAL GTA TASK 0639
CTaskComplexTurnToFaceEntityOrCoord

SCM equivalent: TASK_TURN_CHAR_TO_FACE_CHAR

Neon uses GTA's entity constructor with the opcode's 0.5 heading-rate multiplier and 0.2-radian completion tolerance. The task builds its own AchieveHeading subtask.

Arguments

thePedped

Living streamed ped simulated by this client.

targetPedped

Distinct living streamed ped to track while turning.

Returns

true when GTA accepted the scripted task; false for invalid peds, streaming, liveness, ownership, or task construction.

Ownership and lifecycle

Low-level ped task calls require the client that simulates the living, streamed ped. Driving tasks also require control of the streamed vehicle. They do not create lifecycle handles; the optional native-task-runtime adds server-owned route epochs and reconstruction for drive_to routes. Gang-tag ownership is resource-exclusive, survives object streaming and recreation, and is released automatically when the owner stops.

OOP aliases

  • ped:setTurnToFace(targetPed)

Where this comes from

SOURCECLuaPedDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaPedDefs.cpp INTRODUCED / EXTENDED2cccbbbccRead the commit and why the change was made TEST RESOURCE tagging-up-turf test-resources/tagging-up-turf
RELATED NEON APIS

Continue exploring

Read the system guide →
setPedGoTo Replaces the owned ped's primary task with GTA's native go-to-and-stand-still task. setPedChatWith Starts GTA's native partner-chat task between two distinct peds. setPedStandStill Queues GTA's simple stand-still task on a simulated ped.

← Back to the Neon Lua API · How Native ped tasks and gang tags works →