summaryrefslogtreecommitdiffstats
path: root/MCServer/Plugins/APIDump/Hooks/OnChat.lua
blob: d98df008a6f6e4c37ba09f15a9550692ee4ad4e9 (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
26
27
28
29
return
{
	HOOK_CHAT =
	{
		CalledWhen = "Player sends a chat message",
		DefaultFnName = "OnChat",  -- also used as pagename
		Desc = [[
			A plugin may implement an OnChat() function and register it as a Hook to process chat messages from
			the players. The function is then called for every in-game message sent from any player. Note that
			commands are handled separately using a command framework API.
		]],
		Params = {
			{ Name = "Player", Type = "{{cPlayer}}", Notes = "The player who sent the message" },
			{ Name = "Message", Type = "string", Notes = "The message" },
		},
		Returns = [[
			The plugin may return 2 values. The first is a boolean specifying whether the hook handling is to be
			stopped or not. If it is false, the message is broadcast to all players in the world. If it is true,
			no message is broadcast and no further action is taken.</p>
			<p>
			The second value is specifies the message to broadcast. This way, plugins may modify the message. If
			the second value is not provided, the original message is used.
		]],
	},  -- HOOK_CHAT
}