PT-BR/OutputChatBox
|
Nota: Evite enviar texto para a caixa de bate-papo que não seja realmente um bate-papo, pois isso pode ser irritante para os jogadores. Envie informações e mensagens de status para o HUD. OBS: Isto é algo opcional mas de muita utilidade, fica a critério dos desenvolvedores do servidor. |
|
|
Nota: A partir da versão r20391, visibleTo aceita tabela de jogadores e elemento-equipe |
Esta função envia texto para a caixa de bate-papo. Pode ser interpretado como uma mensagem, aviso, etc. para determinados jogadores ou todos os jogadores.
Opcionalmente, pode incorporar alterações de cores na sequência, definindo o valor booleano colorCoded como true. Isso permite:
outputChatBox ( "#FF0000E aí #00FF00Brasil!", getRootElement(), 255, 255, 255, true )
Isto mostrará: E aí Brasil!
Sintaxe
bool outputChatBox ( string text [, element visibleTo = getRootElement(), int r = 231, int g = 217, int b = 176, bool colorCoded = false ] )
Sintaxe POO(OOP) Não entendeu o que significa isso?
- Método: player:outputChat(...)
Argumento Obrigatório
- text: O texto que será enviado para a janela de chat. Se tiver mais que 256 caracteres o texto não será enviado.
Argumentos Opcionais
NOTA: Ao usar argumentos opcionais, pode ser necessário fornecer todos os argumentos anteriores ao que você deseja usar. Para obter mais informações sobre argumentos opcionais, consulte Argumentos Opcionais.
- visibleTo: Este argumento define para quem você quer que seja enviado o texto.
- r: A quantidade de vermelho na cor do texto. O valor padrão é 231.
- g: A quantidade de verde na cor do texto. O valor padrão é 217.
- b: A quantidade de azul na cor do texto. O valor padrão é 176.
- colorCoded: Um valor booleano que determina ou não se as tags '#RRGGBB' devem ser usadas.
Nota: O formato #RRGGBB deve conter letras maiúsculas, a-f não é aceitável, mas A-F é. Os valores padrões RGB usado neste formato é: '#E7D9B0'.
bool outputChatBox ( string text [, int r = 231, int g = 217, int b = 176, bool colorCoded = false ] )
Argumentos Obrigatórios
- text: O texto que será enviado para a janela de chat. Se tiver mais que 256 caracteres o texto não será enviado.
Argumentos Opcionais
NOTA: Ao usar argumentos opcionais, pode ser necessário fornecer todos os argumentos anteriores ao que você deseja usar. Para obter mais informações sobre argumentos opcionais, consulte Argumentos Opcionais.
- r: A quantidade de vermelho na cor do texto. O valor padrão é 231.
- g: A quantidade de verde na cor do texto. O valor padrão é 217.
- b: A quantidade de azul na cor do texto. O valor padrão é 176.
- colorCoded: Um valor booleano que determina ou não se as tags '#RRGGBB' devem ser usadas.
Nota: O formato #RRGGBB deve conter letras maiúsculas, a-f não é aceitável, mas A-F é. Os valores padrões RGB usado neste formato é: '#E7D9B0'.
Retorno
Retorna true se a mensagem foi enviada com sucesso. Retorna false se argumentos inválidos foram especificados.
Exemplo
Exemplo 1: Este exemplo mostra uma mensagem no chat para todos os jogadores.
x = 5 y = 10 -- Mostra a mensagem outputChatBox ( "Eu tenho " .. x .. " abacates e " .. y .. " melancias." )
Exemplo 2: Este evento envia uma simples mensagem com cores, "Vermelho Branco", onde o 'Branco' está na cor branca, e 'Vermelho' na cor vermelha.
outputChatBox ( "Vermelho #FFFFFFBranco", getRootElement(), 255, 0, 0, true )
Exemplo 3: Este exemplo permite o chat colorido, de acordo com a cor que o jogador definiu em seu nick.
function colouredChat ( message, theType )
if theType == 0 then --Se for uma mensagem normal no chat (sem ser /me ou chat de grupo) então
cancelEvent() -- cancela o envio da mensagem
message = string.gsub(message, "#%x%x%x%x%x%x", "") -- remove qualquer cor usada na mensagem pelo jogador com a função nativa de Lua: string.gsub
local r,g,b = getPlayerNametagColor ( source ) -- pegamos a cor que o jogador usa em seu nick
local chatterName = getPlayerName ( source ) -- pegamos o nick dele
-- envia a mensagem com o nick e a cor do nick, e o resto em branco.
outputChatBox ( chatterName..":#FFFFFF "..message, getRootElement(), r, g, b, true )
end
end
addEventHandler("onPlayerChat", getRootElement(), colouredChat)
Exemplo 4: Este exemplo mostra uma mensagem no chat para um jogador chamado fulano.
-- Ache o elemento jogador pelo nick dele: 'fulano'
myPlayer = getPlayerFromName ( "fulano" )
-- Se um jogador foi achado pelo seu nick 'fulano' então...
if ( myPlayer ~= false ) then
x = 5
y = 10
-- Mostre a mensagem
outputChatBox ( "Eu tenho " .. x .. " celulares e " .. y .. " fones de ouvido.", myPlayer )
end
Exemplo 5: Essas duas funções podem acelerar a digitação, e mostra a mensagem para quando o jogador entrar no servidor.
local msg_red, msg_green, msg_blue = 255, 255, 0
function servertalkprivate(message, sendto)
-- Fale com o jogador diretamente
outputChatBox(tostring(message), sendto, msg_red, msg_green, msg_blue, true)
end
function servertalk(message)
-- Fala para todos
servertalkprivate(message, getRootElement())
end
function quandoEntrar()
servertalkprivate("Bem vindo ao Brasil", source)
end
addEventHandler("onPlayerJoin", getRootElement(), quandoEntrar)
Exemplo 6: Isto pode ser usado para quando um jogador entrar no servidor e então definir o colete dele para 100.
function onJoin()
setPedArmor(source, 100)
local playerName = getPlayerName(source)
outputChatBox("Bem vindo ".. playerName .." ao servidor", source, 0, 154, 255)
end
addEventHandler("onPlayerJoin", root, onJoin)