Difference between revisions of "OnChatMessage"

From Multi Theft Auto: Wiki
m
Line 2: Line 2:
 
__NOTOC__  
 
__NOTOC__  
 
{{New feature/item|3.0120|1.2|3316|
 
{{New feature/item|3.0120|1.2|3316|
'''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 output to chat using [[outputChatBox]]. It can be used to get the resource responsible for specific [[outputChatBox]] call via the second parameter.
 
This event is triggered when a player uses say, teamsay, me successfully. Or when any message is output to chat using [[outputChatBox]]. It can be used to get the resource responsible for specific [[outputChatBox]] call via the second parameter.

Revision as of 00:23, 28 April 2014

This event is triggered when a player uses say, teamsay, me successfully. Or when any message is output to chat using outputChatBox. It can be used to get the resource responsible for specific outputChatBox call via the second parameter.

Parameters

string theMessage, resource / element theElement
  • theMessage: The text that was output to the chatbox
  • theElement: Player element if chatbox output was done via say, teamsay or me. Resource if it was done via outputChatBox.

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 supported server 1.1.1-9.03316
Minimum supported client n/a

Note: Using this function 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

Event functions