Skip to content
San Andreas Online Docs

setPedChatWith

Client-side
SA:O APINative ped tasks and gang tags

Pair two NPCs and GTA makes them face each other and perform its original conversation behavior, with one character leading and the other replying.

Syntax

bool setPedChatWith(ped thePed, ped partner, bool leadSpeaker [, bool updateDirection = true, bool conversationEnabled = true])

GTA task mapping

ORIGINAL GTA TASK 0677
CTaskComplexPartnerChat

SCM equivalent: TASK_CHAT_WITH_CHAR

The task is queued through GTA's script-command event path. With conversationEnabled=false, San Andreas Online preserves PartnerChat's native timed SimpleChat/StandStill fallback.

Arguments

thePedped

Living streamed ped simulated by this client.

partnerped

Distinct living streamed conversation partner.

leadSpeakerbool

Whether the first ped leads the conversation.

updateDirectionbooloptional · default true

Allow the task to turn the speakers toward each other.

conversationEnabledbooloptional · default true

Enable the native conversation exchange.

Returns

true when the native task was queued; false when either ped, streaming state, liveness, simulation ownership, or task construction is invalid.

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:setChatWith(partner, leadSpeaker, updateDirection, conversationEnabled)

Where this comes from

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

Continue exploring

Read the system guide →
setPedGoTo Send an NPC straight toward a nearby coordinate. GTA handles the walk or run, slows the NPC down, and stops it inside the arrival radius. setPedNavigateTo Give an NPC a destination and GTA's pedestrian pathfinder takes over: it chooses a route through the native path network, goes around buildings, walks or runs naturally, slows down, and stops near the target. setPedStandStill Queues GTA's simple stand-still task on a simulated ped.

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