summaryrefslogtreecommitdiffstats
path: root/MCServer/Plugins/APIDump/Hooks/OnChunkUnloading.lua
blob: cd79e2a130e6b04f7d91acf5a68d1b6b6d0380d8 (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
return
{
	HOOK_CHUNK_UNLOADING =
	{
		CalledWhen = " 	A chunk is about to be unloaded from the memory. Plugins may refuse the unload.",
		DefaultFnName = "OnChunkUnloading",  -- also used as pagename
		Desc = [[
			MCServer calls this function when a chunk is about to be unloaded from the memory. A plugin may
			force MCServer to keep the chunk in memory by returning true.</p>
			<p>
			FIXME: The return value should be used only for event propagation stopping, not for the actual
			decision whether to unload.
		]],
		Params =
		{
			{ Name = "World", Type = "{{cWorld}}", Notes = "The world from which the chunk is unloading" },
			{ Name = "ChunkX", Type = "number", Notes = "X-coord of the chunk" },
			{ Name = "ChunkZ", Type = "number", Notes = "Z-coord of the chunk" },
		},
		Returns = [[
			If the function returns false or no value, the next plugin's callback is called and finally MCServer
			unloads the chunk. If the function returns true, no other callback is called for this event and the
			chunk is left in the memory.
		]],
	},  -- HOOK_CHUNK_UNLOADING
}