hook

Одна система на движковые события и на свои

hook

Одна система на движковые события и на свои.

Обработчик получает одну таблицу — объект события. Возврат не читается: чтобы что-то изменить, пиши в поле, чтобы отменить — вызови e:cancel().

hook.add("player:hurt", "myplugin.double", function(e)
	e.damage = e.damage * 2
end)

Одна и та же таблица достаётся всей цепочке, поэтому второй обработчик видит правки первого. У каждого события есть e.name и e.cancelled.

Имя события — subject:verb через двоеточие (player:spawn, weapon:buy). Своё событие плагина — через точку (shop.bought): так модуль отличает опечатку в движковом имени от чужого события, которое просто ещё не зарегистрировано.

Пространство имён

hook.add	Подписывает функцию на событие
hook.remove	Снимает подписку по имени события и id
hook.run	Запускает своё событие плагина
hook.list	Возвращает список подписок в порядке вызова

Подключение

Порядок: client:connect → client:authorized → client:connected.

client:connect	Игрок стучится на сервер; его ещё можно не пустить
client:disconnect	Игрок отключился
client:authorized	Steam ответил, steamid наконец известен
client:connected	Игрок в игре, сообщения до него доходят
player:chat	Игрок написал в чат
menu:select	Игрок нажал клавишу в меню, открытом из Lua

Жизнь сервера

server:map_change	Карта заканчивается
module:plugin_unload	Плагин или всё состояние уходит

Геймплей

Всё в этом разделе приходит из ReGameDLL.

player:spawn	Игрок появился в раунде живым
player:hurt	Игроку наносят урон; урон можно изменить или погасить
player:hurt_post	Урон уже применён; только для наблюдателей
player:trace_attack	Один хитбокс получил попадание — раньше и точнее, чем player:hurt: до брони, до множителей, до суммирования дроби дробовика в одно число
player:heal	Игроку вот-вот дадут здоровье — аптечка, админ-команда; своей регенерации в CS нет
player:death	Игрок погиб
player:team_change	Игрок сменил сторону
player:jump	Игрок прыгнул
player:duck	Игрок присел
player:spectate	Игрок перешёл в режим наблюдателя
player:radio	Игрок использовал радиокоманду
player:respawn_check	Игра вот-вот решит, можно ли игроку возродиться
player:money_change	У игрока вот-вот изменятся деньги — раундовый бонус, награда за фраг, покупка, действие с заложником и т.д
weapon:fire	Из ствола вышел выстрел
weapon:deploy	Оружие вот-вот покажет вьюмодель и модель в руках
weapon:reload	Началась настоящая перезарядка
item:give	Движок вот-вот выдаст игроку предмет по имени classname
player:strip	У игрока только что забрали весь инвентарь
player:can_have_item	Игра вот-вот решит, может ли игрок вообще получить этот предмет
weapon:pickup	Игрок подобрал оружие с земли
weapon:throw	Любой гранатный слот вот-вот покинёт руку, до того как движок решил, HE это, дымовая или флешка
weapon:secondary_attack	Игрок нажал правую кнопку мыши, держа это оружие
grenade:throw	HE, дымовая или флешка вот-вот покинёт руку
grenade:thrown	HE, дымовая или флешка только что покинула руку
player:disappear	Сущность игрока временно убирается из мира
player:can_switch_team	Игра вот-вот решит, может ли игрок перейти в команду team
player:shield_give	Игроку вот-вот выдадут щит
player:shield_drop	У игрока только что забрали щит
player:observer_next	Наблюдатель вот-вот переключится на другую цель
player:observer_mode	У наблюдателя только что сменился режим камеры
player:score_add	Игроку вот-вот изменят личный счёт очков
team:score_add	Команде вот-вот изменят счёт очков
player:userinfo_change	У игрока изменился один из userinfo-ключей (модель, имя и т.д.)
player:can_hear	Игра вот-вот решит, слышит ли listener голос speaker
player:choose_model	Игрок выбрал пункт в меню внешности
player:choose_team	Игрок выбрал пункт в меню команды
grenade:explode	HE, дымовая или флешка вот-вот взорвётся
player:round_respawn	Игрока вот-вот сбросят на новый раунд — позиция, здоровье, оружие (оставить или нет), наказание за тимкилл
player:give_default_items	Игроку вот-вот выдадут стандартный набор на раунд — нож, дефолтный пистолет, всё, что задано cvar-ами команды

Раунд и бомба

round:start	Раунд начался
round:end	Раунд закончился
round:freeze_end	Заморозка кончилась, игроки могут двигаться
round:balance_teams	Автобаланс только что раскидал игроков по командам
round:intermission	Карта закончилась, сервер вот-вот покажет табло перед сменой карты
bomb:planted	Бомба заложена
bomb:defusing	Игрок начал разминирование
bomb:defused	Попытка разминирования завершилась
bomb:exploded	Бомба взорвалась
bomb:carrier	Игра только что выбрала, кому достанется бомба в этом раунде
round:remove_guns	У всех игроков вот-вот заберут оружие
round:dead_weapons	Игра только что решила, что делать с оружием погибшего
round:cleanup	Карта вот-вот сбросит мир между раундами

Магазин

weapon:buy	Игрок покупает оружие в магазине
ammo:buy	Игрок покупает патроны для оружия в руках
item:buy	Игрок покупает не-оружие в магазине: броню, прибор ночного видения, набор для разминирования, щит или гранату
ammo:pickup	Игроку вот-вот добавят патронов в запас — подбор с земли или дозарядка через магазин (отдельно от ammo:buy, которое про сам факт покупки)
weapon:drop	Игрок вот-вот выбросит оружие на пол — командой drop, из p:drop() или при потере слота

Движок и ReHLDS

В отличие от «Геймплея» эти события не требуют ReGameDLL — работают и на ванильном mp.dll. Три из них (отмечены отдельно) требуют ReHLDS.

player:use	Игрок нажал +use на чём-то с обработчиком Use — кнопке, рычаге, multi_manager
player:suicide	Игрок вот-вот покончит с собой командой kill из консоли
ents:should_collide	Движок решает, должны ли две сущности физически сталкиваться
ents:free	Сущность вот-вот уничтожат — последняя точка, где её ещё можно прочитать
player:cvar_value	Клиент ответил на запрос значения cvar — старый вариант API, без имени cvar и без id запроса
player:cvar_value2	То же самое, но новый вариант API: с именем cvar и id запроса, чтобы сверить ответ с тем, что спрашивали
server:cvar_change	Любой cvar вот-вот изменится — движковый, чужого плагина, свой
server:precache_generic	Прекеширован generic-ресурс (не модель и не звук) — движком, игрой, другим плагином
client:bot_created	Подключился бот (fake client)