PT-BR/getPlayerName

From Multi Theft Auto: Wiki
Jump to navigation Jump to search

Esta função retorna uma string contendo o nome do jogador informado.

Sintaxe

string getPlayerName ( player thePlayer )

Sintaxe POO(OOP) Não entendeu o que significa isso?

Método: player:getName(...)
Variável: .name
Oposto: setPlayerName

Argumentos obrigatórios

  • thePlayer: o jogador o qual você quer obter o nome.

Retorno

Retorna uma string contendo o nome do jogador informado, ou false caso o jogador informado seja inválido.

Limites

  • O nome do jogador deve ser composto por caracteres ASCII entre 33 e 126 (latin básico):
   !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~
  • O nome deve conter pelo menos 1 caractere.
  • O nome deve conter no máximo 22 caracteres.
  • O nome dos jogadores é case-insensitive. Isso quer dizer que "Jhon" e "jhon" são a mesma coisa, embora exista a diferença de letra maiúscula e minúscula. Como não podem haver dois nomes iguais em um mesmo servidor, não pode haver um "Jhon" e um "jhon" no mesmo servidor.

Exemplo

Click to collapse [-]
Server
addCommandHandler("myname",
  function(playerSource)
    outputChatBox("Seu nome: "..getPlayerName(playerSource), playerSource)
  end
)
Click to collapse [-]
Client

Este exemplo mostra o nome do jogador local no chat.

addCommandHandler("myname",
  function()
   local localPlayerName = getPlayerName(getLocalPlayer())
   outputChatBox(localPlayerName)
  end
)

Veja também