summaryrefslogtreecommitdiffstats
path: root/MCServer
diff options
context:
space:
mode:
authormadmaxoft <github@xoft.cz>2013-10-15 18:12:37 +0200
committermadmaxoft <github@xoft.cz>2013-10-15 18:12:37 +0200
commit9c7ca813d283b42fae5ce6839aec5bff3181d0eb (patch)
tree93a66dad171966b2f6e57ea77063cae0d6554159 /MCServer
parentAPIDump: Documented HOOK_SPAWNING_ENTITY. (diff)
downloadcuberite-9c7ca813d283b42fae5ce6839aec5bff3181d0eb.tar
cuberite-9c7ca813d283b42fae5ce6839aec5bff3181d0eb.tar.gz
cuberite-9c7ca813d283b42fae5ce6839aec5bff3181d0eb.tar.bz2
cuberite-9c7ca813d283b42fae5ce6839aec5bff3181d0eb.tar.lz
cuberite-9c7ca813d283b42fae5ce6839aec5bff3181d0eb.tar.xz
cuberite-9c7ca813d283b42fae5ce6839aec5bff3181d0eb.tar.zst
cuberite-9c7ca813d283b42fae5ce6839aec5bff3181d0eb.zip
Diffstat (limited to 'MCServer')
-rw-r--r--MCServer/Plugins/APIDump/APIDesc.lua26
1 files changed, 26 insertions, 0 deletions
diff --git a/MCServer/Plugins/APIDump/APIDesc.lua b/MCServer/Plugins/APIDump/APIDesc.lua
index 42762a9ad..8b62df24d 100644
--- a/MCServer/Plugins/APIDump/APIDesc.lua
+++ b/MCServer/Plugins/APIDump/APIDesc.lua
@@ -2995,6 +2995,32 @@ end;
]],
}, -- HOOK_SPAWNING_ENTITY
+ HOOK_SPAWNING_MONSTER =
+ {
+ CalledWhen = "Before a monster is spawned in the world.",
+ DefaultFnName = "OnSpawningMonster", -- also used as pagename
+ Desc = [[
+ This hook is called before the server spawns a {{cMonster|monster}}. The plugins may modify the
+ monster's parameters in the {{cMonster}} class, or disallow the spawning altogether. This hook is
+ called before the {{OnSpawningEntity|HOOK_SPAWNING_ENTITY}} is called for the monster entity.</p>
+ <p>
+ See also the {{OnSpawnedMonster|HOOK_SPAWNED_MONSTER}} hook for a similar hook called after the
+ monster is spawned.
+ ]],
+ Params =
+ {
+ { Name = "World", Type = "{{cWorld}}", Notes = "The world in which the entity will spawn" },
+ { Name = "Monster", Type = "{{cMonster}} descentant", Notes = "The monster that will spawn" },
+ },
+ Returns = [[
+ If the function returns false or no value, the next plugin's callback is called. Finally, the server
+ spawns the monster with whatever parameters the plugins set in the cMonster parameter.</p>
+ <p>
+ If the function returns true, no other callback is called for this event and the monster won't
+ spawn.
+ ]],
+ }, -- HOOK_SPAWNING_MONSTER
+
}, -- Hooks[]