Pular para o conteúdo principal

OnPlayerDeath

Descrição​

Esta callback é chamada quando um jogador morre, tanto por suicídio ou por ser morto por outros jogadores.

NomeDescrição
playeridO ID do jogador que morreu
killeridO ID do jogador que matou o jogador que morreu, ou INVALID_PLAYER_ID se não houve um.
WEAPON:reasonO ID do motivo da morte do jogador.

Retorno​

1 - Irá previnir que outro filterscript receba esta callback.

0 - Indica que esta callback será passada para o próximo filterscript.

Sempre é chamada primeiro em filterscripts.

Exemplos​

new PlayerDeaths[MAX_PLAYERS];
new PlayerKills[MAX_PLAYERS];

public OnPlayerDeath(playerid, killerid, WEAPON:reason)
{
    SendDeathMessage(killerid, playerid, reason); // Mostra o kill no killfeed

    // Verifica se o ID do jogador que matou é valido antes de fazer qualquer coisa
    if (killerid != INVALID_PLAYER_ID)
    {
        PlayerKills[killerid] ++;
    }

    // Fora da verificação, faça os códigos desejados para o jogador que morreu.
    PlayerDeaths[playerid] ++;
    return 1;
}

Notas​

dica

O motivo da morte retornará 37 (Lança Chamas) para qualquer fonte que utilize fogo (EX: Molotov). O motivo da morte retornará 51 para qualquer fonte que utilize explosões (EX: RPG, granada). Você não precisa verificar se o killerid é valido antes de usa-lo no SendDeathMessage. INVALID_PLAYER_ID é um parâmetro valido nesta função. playerid é o único que pode chamar esta callback.

atenção

Você PRECISA verificar se 'killerid' é valido (não INVALID_PLAYER_ID) antes de usa-lo em uma array (ou qualquer outro lugar), pois isso irá ocasionar no crash do OnPlayerDeath (não o script todo). Isto é devido ao INVALID_PLAYER_ID ser definido como 65535, e se uma array tem apenas 'MAX_PLAYERS' como definição do número de elementos, você estaria tentando acessar um index inválido.