setPlayerName

Troca o nome de um jogador conectado.

Sintaxe

bool setPlayerName ( player oJogador, string novoNome )

Parâmetros

Nome	Tipo	Padrão	Descrição
oJogador	player	—	Jogador que vai ser renomeado.
novoNome	string	—	Novo nome, de 1 a 22 caracteres.

Todo caractere do novo nome precisa ser um caractere ASCII visível: nada de espaços, de caracteres de controle nem de crase.

Retorno

true se a troca aconteceu. Devolve false, sem gerar erro, quando o nome está vazio ou passa de 22 caracteres, quando tem algum caractere não permitido, quando é o mesmo nome que o jogador já usa, ou quando outro jogador conectado já está com ele (maiúsculas e minúsculas contam como o mesmo nome).

Logo antes de o novo nome valer, o evento onPlayerChangeNick dispara nesse jogador levando o nome antigo e o novo. Em seguida a troca é enviada para todos os clientes, então placares e nametags acompanham.

Exemplo

addCommandHandler("nick", function(oJogador, _, novoNome)
    if not setPlayerName(oJogador, novoNome) then
        outputDebugString("Nome recusado: inválido ou já em uso")
    end
end)

Veja também

• kickPlayer — Desconecta um jogador do servidor.
• redirectPlayer — Manda o cliente do jogador se conectar a outro servidor.
• setPlayerMuted — Marca um jogador como silenciado, ou tira o silenciamento.
• isPlayerMuted — Verifica se um jogador está silenciado no momento.
• spawnPlayer — Coloca um jogador no mundo, numa posição definida.
• setPlayerBlurLevel — Ajusta o nível de borrão da tela do jogador.
• getPlayerBlurLevel — Devolve o nível de borrão do jogador.
• setControlState — Força um controle do jogo ligado ou desligado no cliente do jogador, como se ele estivesse apertando a tecla.