Подарки

Система подарков FH позволяет игрокам подбирать коробки с положительными или отрицательными эффектами. Вы можете регистрировать собственные.

Свои эффекты

gifts.AddPositiveEffect(name, desc, num, func, [req]) SERVER

Регистрирует положительный эффект подарка.

Параметр	Тип	Описание
name	string	Техническое имя эффекта
desc	string	Описание для игрока (можно вписать переводимую строку или оставить пустым)
num	int	Число для подстановки в %i описания (если ≥ 0)
func	function	Функция, выполняемая при получении эффекта
req	function (опц.)	Условие выдачи эффекта

Пример: выдать монтировку игроку, если у него её нет.

gifts.AddPositiveEffect(
    "give_crowbar",
    "fazhunt.gifts.crowbar_received",
    -1,
    function(ply)
        ply:Give("weapon_crowbar")
    end,
    function(ply)
        -- Выдавать только если монтировки ещё нет
        return not ply:HasWeapon("weapon_crowbar")
    end
)

gifts.AddNegativeEffect(name, desc, num, func) SERVER

Регистрирует отрицательный эффект подарка. Параметры — те же, кроме req.

gifts.AddNegativeEffect(
    "slow_player",
    "fazhunt.gifts.slowed",
    -1,
    function(ply)
        ply:SetWalkSpeed(100)
        ply:SetRunSpeed(150)
    end
)

gifts.GrantEffect(ply, name) SERVER

Выдаёт игроку позитивный эффект с подарков.

hook.Add( "PlayerSay", "ChatGift", function( ply, text )
	if ply:IsAdmin() and string.StartWith( string.lower( text ), "/gift " ) then
		gifts.GrantEffect(ply, string.sub( text, 7 )) 
		-- Мы написали 7 в string.sub потому что это длина "/gift " + 1
		return ""
	end
end )

Хуки

FH_ShouldPlayerReceiveGifts HOOK SERVER

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

hook.Add("FH_ShouldPlayerReceiveGifts", "NoGiftsForAdmins", function(ply)
	-- Админы не получают подарки.
    if ply:IsAdmin() then return false end
end)

См. также

• doGiftSpawning() — включить появление подарков
• disableGiftSpawning() — отключить появление подарков
• PLAYER:SetGiftOwnership(bool) — установить флаг владения подарком