OnPlayerChat - Revision history

Srslyyyy: /* Examples */

2024-05-03T16:02:28Z

Examples

← Older revision		Revision as of 16:02, 3 May 2024
Line 47:		Line 47:
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>



	<section name="Example 2" class="server" show="true">		<section name="Example 2" class="server" show="true">

Srslyyyy: /* Examples */

2024-05-03T16:02:17Z

Examples

← Older revision		Revision as of 16:02, 3 May 2024
Line 22:		Line 22:

	<section name="Example 1" class="server" show="true">		<section name="Example 1" class="server" show="true">
	This example limits receiving of chat messages to ~~a spherical~~ area around the player who sent the message, also blocking action and team text.		This example limits receiving of chat messages to area around the player who sent the message, also blocking action and team text.

	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
Line 34:		Line 34:
	end		end

			local playerName = getPlayerName(source)
	local playerX, playerY, playerZ = getElementPosition(source) -- get position of player who sent the message		local playerX, playerY, playerZ = getElementPosition(source) -- get position of player who sent the message
	local playerInterior = getElementInterior(source) -- get interior of same player		local playerInterior = getElementInterior(source) -- get interior of same player
	local playerDimension = getElementDimension(source) -- dimension as well		local playerDimension = getElementDimension(source) -- dimension as well
	local nearbyPlayers = getElementsWithinRange(playerX, playerY, playerZ, chatRadius, "player", playerInterior, playerDimension) -- get nearby players within given radius		local nearbyPlayers = getElementsWithinRange(playerX, playerY, playerZ, chatRadius, "player", playerInterior, playerDimension) -- get nearby players within given radius
			local messageToOutput = playerName..": "..messageText

	outputChatBox(~~messageText~~, nearbyPlayers, 255, 255, 255, true) -- output message to them		outputChatBox(messageToOutput, nearbyPlayers, 255, 255, 255, true) -- output message to them
	cancelEvent() -- block the original message by cancelling this event		cancelEvent() -- block the original message by cancelling this event
	end		end

Srslyyyy: /* Examples */

2024-05-03T15:50:52Z

Examples

← Older revision		Revision as of 15:50, 3 May 2024
Line 67:		Line 67:
	local red, green, blue = getPlayerNametagColor(source)		local red, green, blue = getPlayerNametagColor(source)
	outputChatBox(getPlayerName(source)..": #FFFFFF"..message, root, red, green, blue, true )		outputChatBox(getPlayerName(source)..": #FFFFFF"..message, root, red, green, blue, true )
	outputServerLog("CHAT: "..getPlayerName(source)..": "..message)-- Because we cancelled the onPlayerChat event, we need to log chat manually.		outputServerLog("CHAT: "..getPlayerName(source)..": "..message) -- Because we cancelled the onPlayerChat event, we need to log chat manually.
	end		end
	end		end

Srslyyyy: /* Examples */

2024-05-03T15:50:39Z

Examples

← Older revision		Revision as of 15:50, 3 May 2024
Line 53:		Line 53:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	--This function is executed when a player joins, it sets the player's name-tag color to a random color.		--This function is executed when a player joins, it sets the player's name-tag color to a random color.

	local function playerJoin()		local function playerJoin()
	local red, green, blue = math.random (50, 255), math.random (50, 255), math.random (50, 255)		local red, green, blue = math.random (50, 255), math.random (50, 255), math.random (50, 255)
Line 60:		Line 61:

	--This function is executed when a player says something in chat, it outputs the player's message, with their nick colored to match their name tag color.		--This function is executed when a player says something in chat, it outputs the player's message, with their nick colored to match their name tag color.

	local function playerChat(message, messageType)		local function playerChat(message, messageType)
	if messageType == 0 then --Global (main) chat		if messageType == 0 then --Global (main) chat
Line 65:		Line 67:
	local red, green, blue = getPlayerNametagColor(source)		local red, green, blue = getPlayerNametagColor(source)
	outputChatBox(getPlayerName(source)..": #FFFFFF"..message, root, red, green, blue, true )		outputChatBox(getPlayerName(source)..": #FFFFFF"..message, root, red, green, blue, true )
	outputServerLog("CHAT: "..getPlayerName(source)..": "..message)--~~NOTE: Beacuse~~ we cancelled the onPlayerChat event, we need to log chat manually.		outputServerLog("CHAT: "..getPlayerName(source)..": "..message)-- Because we cancelled the onPlayerChat event, we need to log chat manually.
	end		end
	end		end
Line 81:		Line 83:
	killPed ( source, source ) -- Kills that player that typed the string 'kill'		killPed ( source, source ) -- Kills that player that typed the string 'kill'
	end		end
	end ~~--End of the function~~		end
	addEventHandler("onPlayerChat", root, onChat)		addEventHandler("onPlayerChat", root, onChat)
	</syntaxhighlight>		</syntaxhighlight>

Srslyyyy: /* Examples */

2024-05-03T15:49:33Z

Examples

← Older revision		Revision as of 15:49, 3 May 2024
Line 25:		Line 25:

	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	-- define our chat radius		local chatRadius = 20 -- define our chat radius
	~~local chatRadius = 20 --units~~

	~~-- define a handler that will distribute the message to all nearby players~~		function onPlayerChatSendMessageToNearbyPlayers(messageText, messageType)
	function ~~sendMessageToNearbyPlayers~~(~~message~~, messageType)		local normalMessage = (messageType == 0) -- we will only send normal chat messages, action and team types will be ignored
	-- we will only send normal chat messages, action and team types will be ignored
	~~if messageType == 0 then~~
	~~-- get the chatting player's position~~
	~~local posX1, posY1, posZ1 = getElementPosition(source)~~

	-- ~~loop through all player and check distance~~		if (not normalMessage) then -- it's not normal message
	~~for id, player in ipairs(getElementsByType("player"))~~ do		return false -- do not continue
	local ~~posX2~~, ~~posY2~~, ~~posZ2~~ = getElementPosition(player)		end
	~~if getDistanceBetweenPoints3D~~(~~posX1~~, ~~posY1~~, ~~posZ1~~, ~~posX2~~, ~~posY2~~, ~~posZ2~~) ~~<= chatRadius then~~
	outputChatBox(~~message~~, ~~player~~)		local playerX, playerY, playerZ = getElementPosition(source) -- get position of player who sent the message
	~~end~~		local playerInterior = getElementInterior(source) -- get interior of same player
	~~end~~		local playerDimension = getElementDimension(source) -- dimension as well
	~~end~~		local nearbyPlayers = getElementsWithinRange(playerX, playerY, playerZ, chatRadius, "player", playerInterior, playerDimension) -- get nearby players within given radius
	-- block the original message by cancelling this event
	~~cancelEvent()~~		outputChatBox(messageText, nearbyPlayers, 255, 255, 255, true) -- output message to them
			cancelEvent() -- block the original message by cancelling this event
	end		end
	~~-- attach our new chat handler to onPlayerChat~~		addEventHandler("onPlayerChat", root, onPlayerChatSendMessageToNearbyPlayers)
	addEventHandler( "onPlayerChat", root, ~~sendMessageToNearbyPlayers~~ )
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>

Myonlake at 11:21, 5 August 2021

2021-08-05T11:21:59Z

← Older revision		Revision as of 11:21, 5 August 2021
Line 10:		Line 10:
	*'''message''': a [[string]] representing the message typed into the chat.		*'''message''': a [[string]] representing the message typed into the chat.
	*'''messageType''': an [[int]] value representing the message type:		*'''messageType''': an [[int]] value representing the message type:
	**'''0''': normal message		{{Message Types}}
	**'''1''': action message (/me)
	**'''2''': team message

	==Source==		==Source==

XLive at 07:24, 4 November 2020

2020-11-04T07:24:06Z

← Older revision		Revision as of 07:24, 4 November 2020
Line 89:		Line 89:
	end		end
	end --End of the function		end --End of the function
	addEventHandler("onPlayerChat", ~~getRootElement()~~, onChat)		addEventHandler("onPlayerChat", root, onChat)
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>

XLive at 07:19, 4 November 2020

2020-11-04T07:19:10Z

← Older revision		Revision as of 07:19, 4 November 2020
Line 49:		Line 49:
	end		end
	-- attach our new chat handler to onPlayerChat		-- attach our new chat handler to onPlayerChat
	addEventHandler( "onPlayerChat", ~~getRootElement()~~, sendMessageToNearbyPlayers )		addEventHandler( "onPlayerChat", root, sendMessageToNearbyPlayers )
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>

Luxy.c: Fixed incorrect argument provided to an example (nearbyPlayer)

2019-01-22T15:53:15Z

Fixed incorrect argument provided to an example (nearbyPlayer)

← Older revision		Revision as of 15:53, 22 January 2019
Line 41:		Line 41:
	local posX2, posY2, posZ2 = getElementPosition(player)		local posX2, posY2, posZ2 = getElementPosition(player)
	if getDistanceBetweenPoints3D(posX1, posY1, posZ1, posX2, posY2, posZ2) <= chatRadius then		if getDistanceBetweenPoints3D(posX1, posY1, posZ1, posX2, posY2, posZ2) <= chatRadius then
	outputChatBox(message, ~~nearbyPlayer~~)		outputChatBox(message, player)
	end		end
	end		end

Tails: removed and updated an example

2018-10-24T21:26:39Z

removed and updated an example

← Older revision		Revision as of 21:26, 24 October 2018
Line 23:		Line 23:
	==Examples==		==Examples==

	<section name="Example 1" class="server" show="~~false~~">		<section name="Example 1" class="server" show="true">
	This example limits receiving of chat messages to a spherical area around the player who sent the message, also blocking action and team text.		This example limits receiving of chat messages to a spherical area around the player who sent the message, also blocking action and team text.

	~~= Avoid using colSphere's in local chat, creating and destroy couse high cpu usage. Check example 4 insted =~~


	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
Line 34:		Line 31:

	-- define a handler that will distribute the message to all nearby players		-- define a handler that will distribute the message to all nearby players
	function sendMessageToNearbyPlayers( message, messageType )		function sendMessageToNearbyPlayers(message, messageType)
	-- we will only send normal chat messages, action and team types will be ignored		-- we will only send normal chat messages, action and team types will be ignored
	if messageType == 0 then		if messageType == 0 then
	-- get the chatting player's position		-- get the chatting player's position
	local ~~posX~~, ~~posY~~, ~~posZ~~ = getElementPosition( source )		local posX1, posY1, posZ1 = getElementPosition(source)

	-- ~~create a sphere of the specified radius in that position~~		-- loop through all player and check distance
	~~local chatSphere = createColSphere( posX~~, ~~posY, posZ, chatRadius )~~		for id, player in ipairs(getElementsByType("player")) do
	~~-- get a table all~~ player ~~elements inside it~~		local posX2, posY2, posZ2 = getElementPosition(player)
	~~local nearbyPlayers = getElementsWithinColShape~~( ~~chatSphere,~~ "player" )		if getDistanceBetweenPoints3D(posX1, posY1, posZ1, posX2, posY2, posZ2) <= chatRadius then
	~~-- and destroy the sphere~~, ~~since we're done with it~~		outputChatBox(message, nearbyPlayer)
	~~destroyElement~~( ~~chatSphere~~ )		end

	~~-- deliver the message to each player in that table~~
	~~for index~~, ~~nearbyPlayer in ipairs( nearbyPlayers~~ ) do
	outputChatBox( message, nearbyPlayer )
	end		end
	end		end
			-- block the original message by cancelling this event
			cancelEvent()
	end		end
	-- attach our new chat handler to onPlayerChat		-- attach our new chat handler to onPlayerChat
	addEventHandler( "onPlayerChat", getRootElement(), sendMessageToNearbyPlayers )		addEventHandler( "onPlayerChat", getRootElement(), sendMessageToNearbyPlayers )

	~~-- define another handler function that cancels the event so that the message won't be delivered through the~~
	~~function blockChatMessage()~~
	~~cancelEvent()~~
	~~end~~
	~~-- attach it as a handler to onPlayerChat~~
	~~addEventHandler( "onPlayerChat", getRootElement(), blockChatMessage )~~
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>



Line 101:		Line 90:
	end --End of the function		end --End of the function
	addEventHandler("onPlayerChat", getRootElement(), onChat)		addEventHandler("onPlayerChat", getRootElement(), onChat)
	~~</syntaxhighlight>~~
	~~</section>~~


	~~<section name="Example 4" class="server" show="true">~~
	~~This example limits receiving of chat messages to a spherical area around the player who sent the message, also blocking action and team text.~~

	~~<syntaxhighlight lang="lua">~~
	~~-- define our chat radius~~
	~~local chatRadius = 20 --units~~

	~~-- define a handler that will distribute the message to all nearby players~~
	~~function sendMessageToNearbyPlayers( message, messageType )~~
	~~-- we will only send normal chat messages, action and team types will be ignored~~
	~~if messageType == 0 then~~
	~~-- get the chatting player's position~~
	~~local posX1, posY1, posZ1 = getElementPosition( source )~~

	~~-- loop through all player and check distance~~
	~~for id,player in ipairs(getElementsByType ( "player" ) ) do~~
	~~local posX2, posY2, posZ2 = getElementPosition( player )~~
	~~if getDistanceBetweenPoints3D(posX1, posY1, posZ1, posX2, posY2, posZ2) <= chatRadius then~~
	~~outputChatBox( message, nearbyPlayer )~~
	~~end~~
	~~end~~
	~~end~~
	~~end~~
	~~-- attach our new chat handler to onPlayerChat~~
	~~addEventHandler( "onPlayerChat", getRootElement(), sendMessageToNearbyPlayers )~~

	~~-- define another handler function that cancels the event so that the message won't be delivered through the~~
	~~function blockChatMessage()~~
	~~cancelEvent()~~
	~~end~~
	~~-- attach it as a handler to onPlayerChat~~
	~~addEventHandler( "onPlayerChat", getRootElement(), blockChatMessage )~~
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>