summaryrefslogtreecommitdiffstats
path: root/Server/Plugins/APIDump/Hooks/OnBlockSpread.lua
blob: 7da796d4d07be83b794793ae28fc2231cf0d4008 (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
30
31
32
33
34
35
36
37
38
39
40
return
{
	HOOK_BLOCK_SPREAD =
	{
		CalledWhen = "Called when a block spreads based on world conditions",
		DefaultFnName = "OnBlockSpread",  -- also used as pagename
		Desc = [[
			This hook is called when a block spreads.</p>
			<p>
			The spread carries with it the type of its source - whether it's a block spreads.
			It also carries the identification of the actual source. The exact type of the identification
			depends on the source kind:
			<table>
			<tr><th>Source</th><th>Notes</th></tr>
			<tr><td>ssFireSpread</td><td>Fire spreading</td></tr>
			<tr><td>ssGrassSpread</td><td>Grass spreading</td></tr>
			<tr><td>ssMushroomSpread</td><td>Mushroom spreading</td></tr>
			<tr><td>ssMycelSpread</td><td>Mycel spreading</td></tr>
			<tr><td>ssVineSpread</td><td>Vine spreading</td></tr>
			</table></p>
		]],
		Params =
		{
			{ Name = "World", Type = "{{cWorld}}", Notes = "The world in which the block resides" },
			{ Name = "BlockX", Type = "number", Notes = "X-coord of the block" },
			{ Name = "BlockY", Type = "number", Notes = "Y-coord of the block" },
			{ Name = "BlockZ", Type = "number", Notes = "Z-coord of the block" },
			{ Name = "Source", Type = "eSpreadSource", Notes = "Source of the spread. See the table above." },
		},
		Returns = [[
			If the function returns false or no value, the next plugin's callback is called, and finally
			Cuberite will process the spread. If the function
			returns true, no other callback is called for this event and the spread will not occur.
		]],
	},  -- HOOK_BLOCK_SPREAD
}