summaryrefslogtreecommitdiffstats
path: root/Server/Plugins/APIDump/Hooks/OnPluginMessage.lua
blob: 743d3bb5e14739a9a11bd5d52204b46c28d7e0cc (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
return
{
	HOOK_PLUGIN_MESSAGE =
	{
		CalledWhen = "The server receives a plugin message from a client",
		DefaultFnName = "OnPluginMessage",  -- also used as pagename
		Desc = [[
			A plugin may implement an OnPluginMessage() function and register it as a Hook to process plugin messages
			from the players. The function is then called for every plugin message sent from any player.
		]],
		Params = {
			{ Name = "Client", Type = "{{cClientHandle}}", Notes = "The client who sent the plugin message" },
			{ Name = "Channel", Type = "string", Notes = "The channel on which the message was sent" },
			{ Name = "Message", Type = "string", Notes = "The message's payload" },
		},
		Returns = [[
			If the function returns false or no value, other plugins' callbacks are called. If the function
			returns true, no other callbacks are called for this event.
		]],
	},  -- HOOK_CHAT
}