OnClientElementStreamIn - Revision history

Srslyyyy: /* Example */

2025-02-08T23:19:06Z

Example

← Older revision		Revision as of 23:19, 8 February 2025
Line 16:		Line 16:
	This example shows you how to tell player that another player was streamed in and the distance between them and said player		This example shows you how to tell player that another player was streamed in and the distance between them and said player
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	~~addEventHandler~~( ~~"onClientElementStreamIn", root,~~		function onClientElementStreamIn()
	~~function~~ ()		local validElement = isElement(source)
	if getElementType(source) == "player" ~~and~~ isPedDead(source) == false ~~then~~
	local x, y, z = getElementPosition(localPlayer)		if (not validElement) then
	local xh, xy, xz = getElementPosition(source)		return false
	local ~~distance~~ = getDistanceBetweenPoints3D(x, y, z, xh, xy, xz )		end
	outputChatBox( "A player has just streamed in. Distance to the player: " .. ~~tostring(distance) .."."~~ )
	~~end~~		local elementType = getElementType(source)
	end		local playerType = (elementType == "player")
	)
			if (not playerType) then
			return false
			end

			local pedDead = isPedDead(source)

			if (pedDead) then
			return false
			end

			local localX, localY, localZ = getElementPosition(localPlayer)
			local playerX, playerY, playerZ = getElementPosition(source)
			local distanceBetweenPlayers = getDistanceBetweenPoints3D(localX, localY, localZ, playerX, playerY, playerZ)

			outputChatBox("A player has just streamed in. Distance to the player: "..distanceBetweenPlayers)
			end
			addEventHandler("onClientElementStreamIn", root, onClientElementStreamIn)
	</syntaxhighlight>		</syntaxhighlight>

	==See Also==		==See Also==
	===Client element events===		===Client element events===

Dutchman101: Add additional unexpected behavior info & suggested workaround

2023-01-22T03:51:00Z

Add additional unexpected behavior info & suggested workaround

← Older revision		Revision as of 03:51, 22 January 2023
Line 5:		Line 5:
	Be aware that this event triggers for local player (as itself being the element that got streamed in) when said local player spawns, as this is the creation of entity local ped.		Be aware that this event triggers for local player (as itself being the element that got streamed in) when said local player spawns, as this is the creation of entity local ped.

	__NOTOC__ {{Note\|This event also triggers for a remote player that dies in front of local player, even if they respawn far away.. the moment they do so, this event will be triggered, and if you'd measure distance between local and said remote player (that spawned far away) it would output the distance at which they died in front of local player, e.g 2 metres. This is bug-prone behavior and likely incorrect, to be fixed in the future, but for now be aware.}}		__NOTOC__ {{Note\|This event also triggers for a remote player that dies in front of local player, even if they respawn far away.. the moment they do so, this event will be triggered, and if you'd measure distance between local and said remote player (that spawned far away) during this event, it would output the distance at which they died in front of local player, e.g 2 metres. This is bug-prone behavior and likely incorrect, to be fixed in the future, but for now be aware. The 'low distance' aspect of this (which could worsen your results) is caused by the split second that their ped elements may 'flash' past its wasted location during the respawning process. For now you can work around these side effect (both, or the distance aspect.. results may vary based on randomness) by adding an isPedDead check inside the event, checking source (said remote player), as this delays the onClientElementIn until after full respawn has taken place. The below script example incorporates this workaround}}

	==Parameters==		==Parameters==
Line 18:		Line 18:
	addEventHandler( "onClientElementStreamIn", root,		addEventHandler( "onClientElementStreamIn", root,
	function ()		function ()
	if getElementType(source) == "player" then		if getElementType(source) == "player" and isPedDead(source) == false then
	local x, y, z = getElementPosition(localPlayer)		local x, y, z = getElementPosition(localPlayer)
	local xh, xy, xz = getElementPosition(source)		local xh, xy, xz = getElementPosition(source)

Dutchman101: t

2023-01-22T03:12:38Z

← Older revision		Revision as of 03:12, 22 January 2023
Line 4:		Line 4:

	Be aware that this event triggers for local player (as itself being the element that got streamed in) when said local player spawns, as this is the creation of entity local ped.		Be aware that this event triggers for local player (as itself being the element that got streamed in) when said local player spawns, as this is the creation of entity local ped.
	It also triggers for a remote player that dies in front of local player, even if they respawn far away.. the moment they do so, this event will be triggered, and if you'd measure distance between local and said remote player (that spawned far away) it would output the distance at which they died in front of local player, e.g 2 metres. This is bug-prone behavior and likely incorrect, to be fixed in the future, but for now be aware.
			__NOTOC__ {{Note\|This event also triggers for a remote player that dies in front of local player, even if they respawn far away.. the moment they do so, this event will be triggered, and if you'd measure distance between local and said remote player (that spawned far away) it would output the distance at which they died in front of local player, e.g 2 metres. This is bug-prone behavior and likely incorrect, to be fixed in the future, but for now be aware.}}

	==Parameters==		==Parameters==

Dutchman101: unexpected behavior note

2023-01-22T03:10:13Z

unexpected behavior note

← Older revision		Revision as of 03:10, 22 January 2023
Line 4:		Line 4:

	Be aware that this event triggers for local player (as itself being the element that got streamed in) when said local player spawns, as this is the creation of entity local ped.		Be aware that this event triggers for local player (as itself being the element that got streamed in) when said local player spawns, as this is the creation of entity local ped.
			It also triggers for a remote player that dies in front of local player, even if they respawn far away.. the moment they do so, this event will be triggered, and if you'd measure distance between local and said remote player (that spawned far away) it would output the distance at which they died in front of local player, e.g 2 metres. This is bug-prone behavior and likely incorrect, to be fixed in the future, but for now be aware.

	==Parameters==		==Parameters==

Dutchman101: Add info

2023-01-22T02:56:40Z

Add info

← Older revision		Revision as of 02:56, 22 January 2023
Line 2:		Line 2:
	__NOTOC__		__NOTOC__
	This event is triggered whenever a physical element is streamed in. This is triggered for all elements that are streamable, such as players, peds, vehicles, objects and markers. When this event is triggered, that element is guaranteed to be physically created as a GTA object.		This event is triggered whenever a physical element is streamed in. This is triggered for all elements that are streamable, such as players, peds, vehicles, objects and markers. When this event is triggered, that element is guaranteed to be physically created as a GTA object.

			Be aware that this event triggers for local player (as itself being the element that got streamed in) when said local player spawns, as this is the creation of entity local ped.

	==Parameters==		==Parameters==

Dutchman101: Example

2023-01-22T02:44:53Z

Example

← Older revision		Revision as of 02:44, 22 January 2023
Line 10:		Line 10:

	==Example==		==Example==
	This example shows you how to tell player that ~~a marker~~ was streamed in and the distance between player ~~and the marker.~~		This example shows you how to tell player that another player was streamed in and the distance between them and said player
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	addEventHandler( "onClientElementStreamIn", root,		addEventHandler( "onClientElementStreamIn", root,
	function ( )		function ()
	if getElementType( source ) == "~~marker~~" then		if getElementType(source) == "player" then
	local ~~myPosTab~~ = { getElementPosition( localPlayer ) };		local x, y, z = getElementPosition(localPlayer)
	local ~~markerPosTab~~ = { getElementPosition( source ) };		local xh, xy, xz = getElementPosition(source)
	local distance = getDistanceBetweenPoints3D( ~~unpack( myPosTab )~~, ~~unpack( markerPosTab )~~ );		local distance = getDistanceBetweenPoints3D(x, y, z, xh, xy, xz )
	outputChatBox( "A ~~marker~~ has just streamed in. Distance to the ~~marker~~: " .. tostring( distance ) .."." );		outputChatBox( "A player has just streamed in. Distance to the player: " .. tostring(distance) .."." )
	end		end
	end		end
	);		)
	</syntaxhighlight>		</syntaxhighlight>
	==See Also==		==See Also==

Toliak: Add parameters section (without parameters)

2021-07-20T18:29:31Z

Add parameters section (without parameters)

← Older revision		Revision as of 18:29, 20 July 2021
Line 2:		Line 2:
	__NOTOC__		__NOTOC__
	This event is triggered whenever a physical element is streamed in. This is triggered for all elements that are streamable, such as players, peds, vehicles, objects and markers. When this event is triggered, that element is guaranteed to be physically created as a GTA object.		This event is triggered whenever a physical element is streamed in. This is triggered for all elements that are streamable, such as players, peds, vehicles, objects and markers. When this event is triggered, that element is guaranteed to be physically created as a GTA object.

			==Parameters==
			No parameters.

	==Source==		==Source==

XLive at 14:50, 19 July 2020

2020-07-19T14:50:18Z

← Older revision		Revision as of 14:50, 19 July 2020
Line 9:		Line 9:
	This example shows you how to tell player that a marker was streamed in and the distance between player and the marker.		This example shows you how to tell player that a marker was streamed in and the distance between player and the marker.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	addEventHandler( "onClientElementStreamIn", ~~getRootElement( )~~,		addEventHandler( "onClientElementStreamIn", root,
	function ( )		function ( )
	if getElementType( source ) == "marker" then		if getElementType( source ) == "marker" then
	local myPosTab = { getElementPosition( ~~getLocalPlayer( )~~ ) };		local myPosTab = { getElementPosition( localPlayer ) };
	local markerPosTab = { getElementPosition( source ) };		local markerPosTab = { getElementPosition( source ) };
	local distance = getDistanceBetweenPoints3D( unpack( myPosTab ), unpack( markerPosTab ) );		local distance = getDistanceBetweenPoints3D( unpack( myPosTab ), unpack( markerPosTab ) );

Myonlake: /* Source */

2018-04-02T22:25:16Z

Source

← Older revision		Revision as of 22:25, 2 April 2018
Line 4:		Line 4:

	==Source==		==Source==
	The [[event system#Event source\|source]] of this event is the [[element]] that streamed in		The [[event system#Event source\|source]] of this event is the [[element]] that streamed in.

	==Example==		==Example==

Braunson: /* Issues */

2014-08-27T05:05:14Z

Issues

← Older revision		Revision as of 05:05, 27 August 2014
Line 20:		Line 20:
	);		);
	</syntaxhighlight>		</syntaxhighlight>
	~~==Issues==~~
	~~{{Issues\|~~
	~~{{Issue\|7724\|onClientElementStreamIn triggers twice when entering a vehicle}}~~
	}}
	==See Also==		==See Also==
	===Client element events===		===Client element events===