Skip to content
MTA:SA Neon Documentation

setPedSuffersCriticalHits

Client-side
NEON APINative ped tasks and gang tags

Available in Neon, not standard MTA

Persists GTA's critical-hit policy on a script ped without enabling the broader story-protection tuple.

Syntax

bool setPedSuffersCriticalHits(ped thePed, bool suffersCriticalHits)

GTA task mapping

NATIVE GTA BEHAVIOR 0446
No CTask is created

SCM equivalent: SET_CHAR_SUFFERS_CRITICAL_HITS

This does not create a CTask. GTA stores the setting as the inverse no-critical-hits bit; Neon keeps the requested positive policy on the MTA ped and reapplies it after recreation.

Arguments

thePedped

Script ped only; players are rejected.

suffersCriticalHitsbool

true to allow critical hits, false to set GTA's inverse no-critical-hits bit.

Returns

true when the client-local policy was stored; false for a player or invalid element.

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.

Important behavior
  • The policy may be set while the native ped is streamed out and is reapplied after native recreation.
  • This is a last-writer-wins local override, not a resource lease. Set the intended value explicitly before relinquishing a surviving ped.

Where this comes from

SOURCECLuaPedDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaPedDefs.cpp INTRODUCED / EXTENDED73c9589c4Read the commit and why the change was made TEST RESOURCE drive-thru test-resources/drive-thru
RELATED NEON APIS

Continue exploring

Read the system guide →
setPedMissionActor Persists GTA's PED_MISSION classification on a script-created ped across native model recreation. isPedMissionActor Reports the locally persisted mission-actor policy, including while the native model is streamed out. acquirePedNativeEventProfile Exclusively leases one of Neon's stock native-event adapters for a script ped.

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