From 0aa20762bc0c615751e604b0b700f51e67d38a5f Mon Sep 17 00:00:00 2001 From: madmaxoft Date: Wed, 16 Oct 2013 15:44:04 +0200 Subject: APIDump: Documented HOOK_WEATHER_CHANGING. --- MCServer/Plugins/APIDump/APIDesc.lua | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) (limited to 'MCServer/Plugins') diff --git a/MCServer/Plugins/APIDump/APIDesc.lua b/MCServer/Plugins/APIDump/APIDesc.lua index f67b2f08a..42158f2e4 100644 --- a/MCServer/Plugins/APIDump/APIDesc.lua +++ b/MCServer/Plugins/APIDump/APIDesc.lua @@ -3052,6 +3052,30 @@ end; }, -- HOOK_SPAWNING_MONSTER + HOOK_WEATHER_CHANGING = + { + CalledWhen = "The weather is about to change", + DefaultFnName = "OnWeatherChanging", -- also used as pagename + Desc = [[ + This hook is called when the current weather has expired and a new weather is selected. Plugins may + override the new weather setting.

+

+ The new weather setting is sent to the clients only after this hook has been processed.

+

+ See also the {{OnWeatherChanged|HOOK_WEATHER_CHANGED}} hook for a similar hook called after the + change. + ]], + Params = + { + { Name = "World", Type = "{{cWorld}}", Notes = "World for which the weather is changing" }, + { Name = "Weather", Type = "number", Notes = "The newly selected weather. One of wSunny, wRain, wStorm" }, + }, + Returns = [[ + If the function returns false or no value, the server calls other plugins' callbacks and finally + sets the weather. If the function returns true, the server takes the second returned value (wSunny + by default) and sets it as the new weather. No other plugins' callbacks are called in this case. + ]], + }, -- HOOK_WEATHER_CHANGING HOOK_WORLD_TICK = { -- cgit v1.2.3