summaryrefslogtreecommitdiffstats
path: root/MCServer/Plugins/APIDump/Hooks/OnEntityChangeWorld.lua
blob: 25072ca5c111b169c08b21363289b3cec3d25b11 (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_ENTITY_CHANGE_WORLD =
	{
		CalledWhen = "Before a entity is changing the world.",
		DefaultFnName = "OnEntityChangeWorld",  -- also used as pagename
		Desc = [[
			This hook is called before the server moves the {{cEntity|entity}} to the given world. Plugins may
			refuse the changing of the entity to the new world.<p>
			See also the {{OnEntityChangedWorld|HOOK_ENTITY_CHANGED_WORLD}} hook for a similar hook is called after the
			entity has been moved to the world.
		]],
		Params =
		{
			{ Name = "Entity", Type = "{{cEntity}}", Notes = "The entity that wants to change the world" },
			{ Name = "World", Type = "{{cWorld}}", Notes = "The world to which the entity wants to change" },
		},
		Returns = [[
			If the function returns false or no value, the next plugin's callback is called. If the function
			returns true, no other callback is called for this event and the change of the entity to the world is
			cancelled.
		]],
	},  -- HOOK_ENTITY_CHANGE_WORLD
}