NativeHub
All NativesModelsArtifactsCFXVehicle

Not affiliated with Rockstar Games or Take-Two Interactive. FiveM and Cfx.re are trademarks of their respective owners. cfxnatives.dev is an independent community project.

Maintained by uz-scripts

© 2026 cfxnatives.dev

contact@cfxnatives.dev
NETWORKClient
Artifact25963
Data sourced from jgscripts artifact-db

NetworkAddPedToSynchronisedScene

Docs
NetworkAddPedToSynchronisedScene(ped, netScene, animDict, animClip, blendInSpeed, blendOutSpeed, syncedSceneFlags, ragdollFlags, moverBlendInDelta, ikFlags)

Description

Adds a ped to a networked synchronised scene.

Synchronized scene playback flags (Also works in other NETWORK_ADD_*_TO_SYNCHRONISED_SCENE natives):

| Value | Name | Notes | | :-------: | :---------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------: | | `0` | None | No flag set. | | `1` | USE_PHYSICS | Allows the ped to have physics during the scene. | | `2` | TAG_SYNC_OUT | The task will do a tag synchronized blend out with the movement behaviour of the ped. | | `4` | DONT_INTERRUPT | The scene will not be interrupted by external events. | | `8` | ON_ABORT_STOP_SCENE | The scene will be stopped if the scripted task is aborted. | | `16` | ABORT_ON_WEAPON_DAMAGE | The scene will be stopped if the ped is damaged by a weapon. | | `32` | BLOCK_MOVER_UPDATE | The task will not update the mover. | | `64` | LOOP_WITHIN_SCENE | Animations within this scene will be looped until the scene is finished. | | `128` | PRESERVE_VELOCITY | The task will keep it's velocity when the scene is cleaned up/stopped. Do note that the `USE_PHYSICS` flag must also be present. | | `256` | EXPAND_PED_CAPSULE_FROM_SKELETON | The task will apply the `ExpandPedCapsuleFromSkeleton` reset flag to the ped (See [`SET_PED_RESET_FLAG`](#\_0xC1E8A365BF3B29F2)). | | `512` | ACTIVATE_RAGDOLL_ON_COLLISION | The ped will be ragdoll if it comes in contact with an object. | | `1024` | HIDE_WEAPON | The ped's current weapon will be hidden during the scene. | | `2048` | ABORT_ON_DEATH | The synchronised scene will be aborted if the ped dies. | | `4096` | VEHICLE_ABORT_ON_LARGE_IMPACT | If the scene is running on a vehicle, then it will be aborted if the vehicle takes a heavy collision with another vehicle. | | `8192` | VEHICLE_ALLOW_PLAYER_ENTRY | If the scene is on a vehicle, it allows players to enter it. | | `16384` | PROCESS_ATTACHMENTS_ON_START | Attachments will be processed at the start of the scene. | | `32768` | NET_ON_EARLY_NON_PED_STOP_RETURN_TO_START | A non-ped entity will be returned to their starting position if the scene finishes early. | | `65536` | SET_PED_OUT_OF_VEHICLE_AT_START | If the ped is in a vehicle when the scene starts, it will be set out of the vehicle. | | `131072` | NET_DISREGARD_ATTACHMENT_CHECKS | Attachment checks will be disregarded when the scene is running. |

These flags can be combined with the | operator.

Parameters

NameTypeDescription
pedPedPed handle to add.
netSceneintNetwork scene handle (Returned by [`NETWORK_CREATE_SYNCHRONISED_SCENE`](#\_0x7CD6BC4C2BBDD526))
animDictchar*Dictionary of the animation that the ped will play. Network synchronised scenes don't require the animation dictionary to be loaded, unlike [`TASK_SYNCHRONIZED_SCENE`](#\_0xEEA929141F699854).
animClipchar*Clip name from the anim dictionary that the ped will play.
blendInSpeedfloatBlend in speed. The lower the value, the slower the blend in speed is. Default is `8.0`.
blendOutSpeedfloatBlend out speed. This should be the negative value of `blendInSpeed`. Default is `-8.0`.
syncedSceneFlagsintSynchronized scene flags bit field from the above table.
ragdollFlagsintRagdoll blocking flags. Default is `0`.
moverBlendInDeltafloatDetermines the rate at which the mover blends in to the scene. Useful for ensuring a seamless entry onto a synchronized scene. Default is `1000.0`.
ikFlagsintInverse kinematics flags. Default is `0`.
🚶Quick Snippet: Get Ped Handle
ped

Use this to get the player ped handle for this native.

-- Get the player's ped handle (client-side)
local ped = PlayerPedId()
print("Ped handle: " .. ped)

-- For a specific player's ped (server-side):
-- local targetPed = GetPlayerPed(source)
🚶

Ped Models

View All
Mp M Freemode 0 1
mp_m_freemode_01
Player Zero
player_zero
Ig Agatha
ig_agatha
S M Y Cop 0 1
s_m_y_cop_01
S M M Gaffer 0 1
s_m_m_gaffer_01
G M M Armboss 0 1
g_m_m_armboss_01
A C Boar
a_c_boar
A M M Bevhills 0 1
a_m_m_bevhills_01

Returns

void

This native does not return a value.

Server Artifacts

Data sourced from jgscripts artifact-db
Recommended25963
Known Issues24
25987-25988Node.js sandboxing seems to be causing issues for people - best to avoid for now
21547Multiple (unconfirmed) reports of server-sided natives throwing errors or causing crashes; best to avoid
17462Failed build, ignore
16276Multiple reports of issues loading JS within resources
14583-14716Crash when using the new onEntityBucketChange
14583-14862Timeouts due to latency units being in nanoseconds
13759-13890Mumble (voice) external connections blocked by default
13380-13458Server crashing due to integer encoding (PR#3235)
13079Failed Linux build (works OK if using Windows!)
12933-13045Still crashes (sometimes) when restarting resources due to Node.js 22
12913-12932Causes a crash when restarting Node.js 22
12767os.date() appends null terminator; can break Lua scripts
12651Failed Linux build, ignore
12509Failed build, ignore
12255Unconfirmed, but several reports of server-side issues that don't persist when downgrading; best to avoid
12160-12165Cannot use entity native calls in entityRemoved
12151Crashing if using newest title update (TU)
12092-12135SetPlayerModel may cause SIGSEGV crashes on some clients due to changes in player handling. 12031 and below works fine.
12078-12083Some clients will fail to connect with 'ReadBulk of header failed' error
10930Failed build, ignore
10268-10309sv_experimentalNetGameEventHandler enabled by default; can cause server crashing and reports of issues downgrading after upgrading
10191GetVehicleNumberPlateText server native broken, will cause issues with scripts involving vehicles
10072Crashing when players join
8509State bags not replicated to clients

CommunitySnippets

No snippets yet. Be the first to contribute!