timer

Отложенные и повторяющиеся вызовы

timer

Отложенные и повторяющиеся вызовы.

timer.after(5, function()
	players.broadcast:chat("{green}Прошло 5 секунд")
end)

Идут на серверном времени и тикают из StartFrame. Снимаются вместе с плагином: при lua_reload, при одиночной перезагрузке и при отключении плагина за превышение прекеша.

Анонимные

Адресуются по id, который вернул вызов.

timer.after	Вызывает функцию один раз через заданное время
timer.every	Вызывает функцию каждые N секунд, пока её не снимут
timer.cancel	Снимает таймер по id

Именованные

Адресуются по имени, уникальному внутри плагина.

timer.create	Заводит именованный таймер; повторный вызов заменяет старый
timer.destroy	Снимает именованный таймер этого плагина

Смена карты

Смена карты обнуляет серверные часы. Модуль переносит отложенные сроки на новые, поэтому timer.after(600, ...) остаётся «через десять минут», а не срабатывает пачкой на первом кадре следующей карты.

persist = false отменяет перенос: такой таймер снимается вместе с картой, на которой был заведён.

-- инфраструктура плагина: должна пережить changelevel
timer.create("stats.flush", 60, flush)

-- привязано к текущей карте: на следующей уже бессмысленно
timer.after(30, warmup_over, { persist = false })

По умолчанию persist = true. Обратный вариант ломал бы плагины молча: таймер сохранения статистики, заведённый один раз при загрузке, после первой же смены карты перестал бы работать до конца жизни сервера.