hook — Движок и ReHLDS

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

Движок и ReHLDS

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

player:use

Игрок нажал +use на чём-то с обработчиком Use — кнопке, рычаге, multi_manager.

hook.add("player:use", id, function(e)
	...
end)

Поля события

поле	тип
e.player	player	кого касается событие
e.entity	entity | nil	что использовали; nil, если оно уже пропало

Не отменяемое: к моменту события движковый DispatchUse уже отработал.

player:suicide

Игрок вот-вот покончит с собой командой kill из консоли.

hook.add("player:suicide", id, function(e)
	...
end)

Поля события

поле	тип
e.player	player	кого касается событие

Отмена. e:cancel() — команда не срабатывает вообще, даже таймер повторного kill не сдвигается.

ents:should_collide

Движок решает, должны ли две сущности физически сталкиваться.

hook.add("ents:should_collide", id, function(e)
	...
end)

Поля события

поле	тип
e.entity	entity | nil	первая сущность
e.other	entity | nil	вторая сущность
e.collide	boolean	запись: сталкиваются ли; по умолчанию true

Не через e:cancel() — здесь нет «отмены», это гейт с записываемым результатом: последний обработчик, тронувший e.collide, и решает. Молчание любого обработчика оставляет true — обычную физику.

Единственная реализация этого хука в принципе: ReGameDLL сам его не предоставляет, так что тут нечего «оборачивать» — какой ответ дашь, такой и будет.

ents:free

Сущность вот-вот уничтожат — последняя точка, где её ещё можно прочитать.

hook.add("ents:free", id, function(e)
	...
end)

Поля события

поле	тип
e.entity	entity | nil	сущность, ещё живая на момент события

Не отменяемое: держать сущность после этого события всё равно нельзя, движок продолжит её разрушать сразу после.

player:cvar_value

Клиент ответил на запрос значения cvar — старый вариант API, без имени cvar и без id запроса.

hook.add("player:cvar_value", id, function(e)
	...
end)

Поля события

поле	тип
e.player	player	кого касается событие
e.value	string	значение, которое прислал клиент

Плагин, который запрашивал значение, обязан сам помнить, о каком cvar шла речь — движок это не передаёт.

Смотри также

• player:cvar_value2

player:cvar_value2

То же самое, но новый вариант API: с именем cvar и id запроса, чтобы сверить ответ с тем, что спрашивали.

hook.add("player:cvar_value2", id, function(e)
	...
end)

Поля события

поле	тип
e.player	player	кого касается событие
e.request_id	number	id, который был передан при запросе
e.cvar	string	имя cvar, про который спросили
e.value	string	значение, которое прислал клиент

Смотри также

• player:cvar_value

server:cvar_change

Любой cvar вот-вот изменится — движковый, чужого плагина, свой.

hook.add("server:cvar_change", id, function(e)
	...
end)

Поля события

поле	тип
e.name	string	имя cvar
e.value	string	новое значение

Отмена. e:cancel() — cvar остаётся со старым значением.

Обработчик, который сам меняет cvar изнутри этого события, войдёт в него снова — не меняй здесь тот же cvar безусловно, иначе рекурсия не остановится.

Событие требует ReHLDS. На движке без него — тихо никогда не срабатывает, без ошибок и предупреждений.

server:precache_generic

Прекеширован generic-ресурс (не модель и не звук) — движком, игрой, другим плагином.

hook.add("server:precache_generic", id, function(e)
	...
end)

Поля события

поле	тип
e.name	string	путь ресурса
e.index	number	слот прекеша

Событие требует ReHLDS. На движке без него — тихо никогда не срабатывает, без ошибок и предупреждений.

client:bot_created

Подключился бот (fake client).

hook.add("client:bot_created", id, function(e)
	...
end)

Поля события

поле	тип
e.player	player	кого касается событие

Событие требует ReHLDS. На движке без него — тихо никогда не срабатывает, без ошибок и предупреждений.