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)

Документация

Справочник API

hook

hook

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

Подключение

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

Геймплей

Раунд и бомба

Магазин

Движок и ReHLDS

​hook

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

​Подключение

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

​Геймплей

​Раунд и бомба

​Магазин

​Движок и ReHLDS

hook

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

Подключение

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

Геймплей

Раунд и бомба

Магазин

Движок и ReHLDS