OnPlayerDeath

Материал из Pro-Pawn Wiki
Версия от 18:36, 29 августа 2018; Daniel-Cortez (обсуждение | вклад) (Новая страница: «{{Description | Вызывается при смерти игрока. }} {{Params|playerid, killerid, reason}} {{Param | playerid | ID погибшего игр…»)

(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к: навигация, поиск

Описание:

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

Параметры:

(playerid, killerid, reason)
playerid ID погибшего игрока.
killerid ID убийцы. Может иметь значение INVALID_PLAYER_ID, если игрок умер сам (например, утонул или упал с высоты).
reason ID причины смерти.


Возвращаемое значение:

  • В моде: Возвращаемое значение не обрабатывается сервером.
  • В фильтрскриптах: При возврате 0 функция не будет вызвана в других фильтрскриптах.

Info rhombus.png
Примечание
Функция вызывается сначала в фильтрскриптах, затем в моде.


Exclamation.png
Внимание!
Не забывайте проверять параметр killerid на равенство INVALID_PLAYER_ID, чтобы не получить выход за пределы массива из-за неосторожного обращения к какому-либо массиву по индексу killerid (см. пример ниже).


Пример использования:

// Массивы под счётчики смертей и убийств
new num_deaths[MAX_PLAYERS], num_kills[MAX_PLAYERS];

public OnPlayerConnect(playerid)
{
    num_deaths[playerid] = 0;
    num_kills[playerid] = 0;
    return 1;
}

public OnPlayerDeath(playerid, killerid, reason)
{
    // Увеличим счётчик смертей у убитого игрока
    num_deaths[playerid]++;

    // Перед тем, как увеличить счётчик убийств,
    // убедимся, что ID убийцы - не INVALID_PLAYER_ID
    if (killerid != INVALID_PLAYER_ID)
    {
        // Увеличим счётчик
        num_kills[killerid]++;
    }
    return 1;
}