OnChatMessage

	This article needs checking.
	Reason(s): thePlayer arguement from a say command returns userdata but is not an element, teamsay and me worked however.

Available only in MTA SA 1.2 and onwards This event is triggered when a player uses say, teamsay, me successfully. Or when any message is sent to a player using outputChatBox.

Parameters

string theMessage, element thePlayer

• theMessage: The text that was output to the chatbox
• thePlayer: The player who triggered the event (needs checking)

Source

The source of this event is the root element.

Example

This example outputs all chat messages to debug view.

[lua]
function onChatMessageHandler(theMessage, thePlayer)
	outputDebugString(theMessage)
end
addEventHandler("onChatMessage", root, onChatMessageHandler)

Requirements

Minimum server version	1.1.1-9.03316
Minimum client version	n/a

Note: Using this feature requires the resource to have the above minimum version declared in the meta.xml <min_mta_version> section. e.g. <min_mta_version server="1.1.1-9.03316" />

See Also

Server events

• onBan
• onChatMessage
• onDebugMessage
BETA: NEW FEATURE (BUILD: 1.6.0 r21914)
onExplosion
• onSettingChange
• onUnban

Event functions

• addEvent
• addEventHandler
• cancelEvent
• cancelLatentEvent
• getCancelReason
• getEventHandlers
• getLatentEventHandles
• getLatentEventStatus
• removeEventHandler
• triggerEvent
• triggerClientEvent
• triggerLatentClientEvent
• wasEventCancelled