Pular para o conteúdo principal

SendClientMessage

Descrição​

Esta função envia uma mensagem para um jogador específico com uma cor escolhida no chat. Toda a linha na caixa de bate-papo estará na cor definida, a menos que a incorporação de cores seja usada.

NomeDescrição
playeridO ID do jogador para o qual exibir a mensagem.
colorA cor da mensagem (formato hexadecimal 0xRRGGBBAA).
const format[]O texto que será exibido (máximo 144 caracteres).
OPEN_MP_TAGS:...Número indefinido de argumentos de qualquer tag.

Retornos​

true - A função foi executada com sucesso. O sucesso é relatado quando a string tem mais de 144 caracteres, mas a mensagem não será enviada.

false - Falha na execução da função. O jogador não está conectado.

Exemplos​

#define COLOR_RED 0xFF0000FF

public OnPlayerConnect(playerid)
{
    SendClientMessage(playerid, COLOR_RED, "This text is red");
    SendClientMessage(playerid, 0x00FF00FF, "This text is green.");
    SendClientMessage(playerid, -1, "This text is white.");
    return 1;
}

public OnPlayerDeath(playerid, killerid, WEAPON:reason)
{
    if (killerid != INVALID_PLAYER_ID)
    {
        new name[MAX_PLAYER_NAME];
        GetPlayerName(killerid, name, sizeof(name));

        SendClientMessage(playerid, COLOR_RED, "%s killed you.", name);
    }
    return 1;
}

Notas​

dica
  • Você pode usar a incorporação de cores para várias cores na mensagem.
  • Usar '-1' como cor tornará o texto branco (pela simples razão de que -1, quando representado em notação hexadecimal, é 0xFFFFFFFF).
aviso
  • Se uma mensagem tiver mais de 144 caracteres, ela não será enviada. O truncamento pode ser usado para evitar isso. Exibir uma mensagem em várias linhas também resolverá esse problema.
  • Evite usar o sinal de porcentagem (ou especificadores de formato) no texto da mensagem real sem escapar adequadamente (como %%). Caso contrário, isso resultará em travamentos.

Funções Relacionadas​