OnPlayerZoneChange - Revision history

IManGaaX at 20:01, 10 November 2025

2025-11-10T20:01:12Z

← Older revision		Revision as of 20:01, 10 November 2025
Line 38:		Line 38:
	end		end
	addEvent(zoneEventName, false) -- disable remote triggering so players couldn't trigger this event on server (& vice-versa)		addEvent(zoneEventName, false) -- disable remote triggering so players couldn't trigger this event on server (& vice-versa)
	setTimer(checkPlayersZone, ~~1000~~, 0)		setTimer(checkPlayersZone, 500, 0)

	local function clearPlayersZone()		local function clearPlayersZone()
Line 72:		Line 72:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	addEventHandler("onPlayerZoneChange", root, function(oldZone, newZone)		addEventHandler("onPlayerZoneChange", root, function(oldZone, newZone)
	outputChatBox("Your Zone is Changed from "..(oldZone).." to "..(newZone)..".", source, 255, 255, 0)		outputChatBox("Your Zone is Changed from '"..(oldZone).."' to '"..(newZone).."'.", source, 255, 255, 0)
	end)		end)
	</syntaxhighlight>		</syntaxhighlight>

IManGaaX: correct mistakes

2025-11-10T19:56:52Z

correct mistakes

← Older revision		Revision as of 19:56, 10 November 2025
Line 47:		Line 47:
	</section>		</section>

	'''~~Authors~~:''' [[User:IManGaaX\|Youssef Maged (iManGaaX)]]		'''Author:''' [[User:IManGaaX\|Youssef Maged (iManGaaX)]]

	==Examples==		==Examples==
Line 56:		Line 56:

	addEventHandler("onClientResourceStart", resourceRoot, function()		addEventHandler("onClientResourceStart", resourceRoot, function()
	local firstZone = ~~getElementZoneName~~(~~localPlayer~~)		local px, py, pz = getElementPosition(localPlayer)
			local firstZone = getZoneName(px, py, pz)
	myCurrentZoneLabel = guiCreateLabel(0, 0, 0.20, 0.02, firstZone, true)		myCurrentZoneLabel = guiCreateLabel(0, 0, 0.20, 0.02, firstZone, true)
	end)		end)

IManGaaX at 19:47, 8 June 2025

2025-06-08T19:47:47Z

← Older revision		Revision as of 19:47, 8 June 2025
Line 60:		Line 60:
	end)		end)

	addEventHandler("~~onPlayerZoneChange~~", root, function(_, newZone)		addEventHandler("onClientPlayerZoneChange", root, function(_, newZone)
	if (source == localPlayer) then		if (source == localPlayer) then
	guiSetText(myCurrentZoneLabel, newZone)		guiSetText(myCurrentZoneLabel, newZone)

Srslyyyy at 15:05, 1 May 2025

2025-05-01T15:05:14Z

← Older revision		Revision as of 15:05, 1 May 2025
Line 47:		Line 47:
	</section>		</section>

	'''Authors:''' [[User:IManGaaX\|Youssef Maged (iManGaaX)]]~~, Srslyyyy~~		'''Authors:''' [[User:IManGaaX\|Youssef Maged (iManGaaX)]]

	==Examples==		==Examples==

IManGaaX at 05:50, 28 April 2025

2025-04-28T05:50:06Z

← Older revision		Revision as of 05:50, 28 April 2025
Line 47:		Line 47:
	</section>		</section>

	'''~~Author~~:''' [[User:IManGaaX\|Youssef Maged (iManGaaX)]]		'''Authors:''' [[User:IManGaaX\|Youssef Maged (iManGaaX)]], Srslyyyy

	==Examples==		==Examples==

IManGaaX at 05:48, 28 April 2025

2025-04-28T05:48:27Z

← Older revision		Revision as of 05:48, 28 April 2025
Line 70:		Line 70:
	<section name="Server" class="server" show="true">		<section name="Server" class="server" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	addEventHandler("onPlayerZoneChange", root, function(_, newZone)		addEventHandler("onPlayerZoneChange", root, function(oldZone, newZone)
	outputChatBox("Your Zone is Changed to "..(newZone)..".", source, 255, 255, 0)		outputChatBox("Your Zone is Changed from "..(oldZone).." to "..(newZone)..".", source, 255, 255, 0)
	end)		end)
	</syntaxhighlight>		</syntaxhighlight>

IManGaaX at 05:47, 28 April 2025

2025-04-28T05:47:28Z

IManGaaX at 05:46, 28 April 2025

2025-04-28T05:46:32Z

← Older revision		Revision as of 05:46, 28 April 2025
Line 44:		Line 44:
	end		end
	addEventHandler(localPlayer and "onClientPlayerQuit" or "onPlayerQuit", root, clearPlayersZone)		addEventHandler(localPlayer and "onClientPlayerQuit" or "onPlayerQuit", root, clearPlayersZone)

	~~-- example for server:~~

	~~function onPlayerZoneChange(oldZone, newZone)~~
	~~iprint(source, oldZone, newZone)~~
	~~end~~
	~~addEventHandler("onPlayerZoneChange", root, onPlayerZoneChange)~~
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>
Line 58:		Line 51:
	==Examples==		==Examples==
	This example will make label with the full zone name of the player, '''onPlayerZoneChange''' is function is change the label text to new zone when the player enter a new zone.		This example will make label with the full zone name of the player, '''onPlayerZoneChange''' is function is change the label text to new zone when the player enter a new zone.
	~~{{RequiredFunctions\|getElementZoneFullName}}~~
	<section name="Client" class="client" show="true">		<section name="Client" class="client" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
Line 64:		Line 56:

	addEventHandler("onClientResourceStart", resourceRoot, function()		addEventHandler("onClientResourceStart", resourceRoot, function()
	local ~~text~~ = ~~getElementZoneFullName~~(localPlayer)		local firstZone = getElementZoneName(localPlayer)
	myCurrentZoneLabel = guiCreateLabel(0, 0, 0.20, 0.02, ~~text~~, true)		myCurrentZoneLabel = guiCreateLabel(0, 0, 0.20, 0.02, firstZone, true)
	end)		end)

	addEventHandler("onPlayerZoneChange", root, function()		addEventHandler("onPlayerZoneChange", root, function(_, newZone)
	if (source == localPlayer) then		if (source == localPlayer) then
	~~local newText = getElementZoneFullName(localPlayer)~~		guiSetText(myCurrentZoneLabel, newZone)
	guiSetText(myCurrentZoneLabel, ~~newText~~)
	end		end
	end)		end)

IManGaaX at 05:43, 28 April 2025

2025-04-28T05:43:56Z

← Older revision		Revision as of 05:43, 28 April 2025
Line 77:		Line 77:
	</section>		</section>
	This example will out put in the chat the new zone full name when the player enter a new zone.		This example will out put in the chat the new zone full name when the player enter a new zone.
	~~{{RequiredFunctions\|getElementZoneFullName}}~~
	<section name="Server" class="server" show="true">		<section name="Server" class="server" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	addEventHandler("onPlayerZoneChange", root, function()		addEventHandler("onPlayerZoneChange", root, function(_, newZone)
	~~local~~ newZone ~~= getElementZoneFullName(source~~)
	outputChatBox("Your Zone is Changed to "..(newZone)..".", source, 255, 255, 0)		outputChatBox("Your Zone is Changed to "..(newZone)..".", source, 255, 255, 0)
	end)		end)

Srslyyyy: /* Parameters */

2025-04-22T21:33:16Z

Parameters

← Older revision		Revision as of 21:33, 22 April 2025
Line 4:		Line 4:

	==Parameters==		==Parameters==
	~~No parameters~~.		<syntaxhighlight lang="lua">
			string oldZone, string newZone
			</syntaxhighlight>
			*'''oldZone:''' old zone of [[player]].
			*'''newZone:''' new zone of [[player]].

	==Source==		==Source==

← Older revision		Revision as of 05:47, 28 April 2025
Line 21:		Line 21:

	local function checkPlayersZone()		local function checkPlayersZone()
	local playersTable = getElementsByType("player")		local playersTable = getElementsByType("player")

	for playerID = 1, #playersTable do		for playerID = 1, #playersTable do
	local playerElement = playersTable[playerID]		local playerElement = playersTable[playerID]
	local playerX, playerY, playerZ = getElementPosition(playerElement)		local playerX, playerY, playerZ = getElementPosition(playerElement)
	local playerZoneNow = getZoneName(playerX, playerY, playerZ, zoneCitiesOnly)		local playerZoneNow = getZoneName(playerX, playerY, playerZ, zoneCitiesOnly)
	local playerZoneSaved = playersZone[playerElement]		local playerZoneSaved = playersZone[playerElement]
	local playerZoneNeedsUpdate = (playerZoneSaved and playerZoneSaved ~= playerZoneNow)		local playerZoneNeedsUpdate = (playerZoneSaved and playerZoneSaved ~= playerZoneNow)

	if (playerZoneNeedsUpdate) then		if (playerZoneNeedsUpdate) then
	triggerEvent(zoneEventName, playerElement, playerZoneSaved, playerZoneNow)		triggerEvent(zoneEventName, playerElement, playerZoneSaved, playerZoneNow)
	end		end

	playersZone[playerElement] = playerZoneNow		playersZone[playerElement] = playerZoneNow
	end		end
	end		end
	addEvent(zoneEventName, false) -- disable remote triggering so players couldn't trigger this event on server (& vice-versa)		addEvent(zoneEventName, false) -- disable remote triggering so players couldn't trigger this event on server (& vice-versa)
Line 41:		Line 41:

	local function clearPlayersZone()		local function clearPlayersZone()
	playersZone[source] = nil		playersZone[source] = nil
	end		end
	addEventHandler(localPlayer and "onClientPlayerQuit" or "onPlayerQuit", root, clearPlayersZone)		addEventHandler(localPlayer and "onClientPlayerQuit" or "onPlayerQuit", root, clearPlayersZone)