Хуки аниматроников

Хуки, связанные с общим поведением аниматроников: скримеры, Шокер, реплики.

FH_PlayerShouldJumpscare HOOK SERVER

Вызывается перед скримером.

hook.Run("FH_PlayerShouldJumpscare", ply, ent, target)

Аргумент	Тип	Описание
ply	Player	Аниматроник
ent	Entity	Модель аниматроника
target	Player	Жертва

Возврат false — отменить скример.

-- Защитить игроков с маской маньяка (примерная логика)
hook.Add("FH_PlayerShouldJumpscare", "MaskProtect", function(ply, ent, target)
    if target:GetNWBool("HasMaskObsession") then
        return false
    end
end)

---

FH_HandleTaserHit HOOK SERVER

Вызывается перед ударом Шокера по игроку.

hook.Run("FH_HandleTaserHit", ply)

Возврат false — отменить действие Шокера.

hook.Add("FH_HandleTaserHit", "AdminTaserImmune", function(ply)
    if ply:IsAdmin() then return false end
end)

---

FH_AnimatronicJumpscare HOOK SERVER

Вызывается после успешного скримера.

hook.Run("FH_AnimatronicJumpscare", ply, ent, target, data)

Структура data:

{
    delay = 0.5,           -- через сколько умрёт target
    char  = "sfreddy",     -- имя аниматроника
    dist  = 64.2,          -- дистанция в момент скримера
    wep   = "fh_freddy_h"  -- класс оружия от 1-го лица
}

hook.Add("FH_AnimatronicJumpscare", "LogScares", function(ply, ent, target, data)
    print(string.format("[FH] %s заскримерил %s (дист=%.1f, char=%s)",
        ply:Nick(), target:Nick(), data.dist, data.char))
end)

---

FH_JumpscareEvent HOOK SERVER

Вызывается перед заморозкой игроков в скримере.

hook.Run("FH_JumpscareEvent", ply, ent, target, dist)

Аргумент	Тип	Описание
ply	Player	Аниматроник
ent	Entity	Модель аниматроника
target	Entity	Жертва
dist	float	Дистанция

---

FH_OverrideVoiceline HOOK SERVER

Вызывается перед проигрыванием реплики аниматроника. Позволяет заменить реплику.

hook.Run("FH_OverrideVoiceline", ply, anim, line)

Аргумент	Тип	Описание
ply	Player	Аниматроник
anim	string	Имя аниматроника
line	string	Текущая реплика

Возврат новой строки заменит реплику.

hook.Add("FH_OverrideVoiceline", "FunnyLines", function(ply, anim, line)
    if anim == "freddy" and math.random(1, 10) == 1 then
        return "sound/my_addon/freddy_meme.wav"
    end
end)