PT-BR/OutputChatBox: Difference between revisions
m (Correção ortográfica) |
m (Nota atualizada da original) |
||
Line 1: | Line 1: | ||
{{BR/Função compartilhada}} | {{BR/Função compartilhada}} | ||
{{BR/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.''}} | {{BR/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.''}} | ||
{{BR/Nota|A partir da versão r20391, '''visivelPara''' aceita tabela de jogadores e [[Elemento/Team|elemento-equipe]]}} | |||
__NOTOC__ | __NOTOC__ | ||
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. | 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. | ||
Line 19: | Line 20: | ||
==Argumentos Opcionais== | ==Argumentos Opcionais== | ||
{{BR/ArgOpcional}} | {{BR/ArgOpcional}} | ||
*'''visivelPara:''' | *'''visivelPara:''' Este argumento define para quem você quer que seja enviado o texto. Você pode especificar uma tabela (de índices numéricos) com jogadores, um [[Elemento/Player|elemento-jogador]], ou um [[Elemento/Team|elemento-equipe]] (Team). Confira [[Visibility/PT-BR|visibilidade]]. | ||
*'''r:''' A quantidade de vermelho na cor do texto. O valor padrão é 231. | *'''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. | *'''g:''' A quantidade de verde na cor do texto. O valor padrão é 217. |
Revision as of 15:55, 21 June 2020
![]() |
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, visivelPara 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 texto [, element visivelPara = 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
- texto: 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.
- visivelPara: Este argumento define para quem você quer que seja enviado o texto. Você pode especificar uma tabela (de índices numéricos) com jogadores, um elemento-jogador, ou um elemento-equipe (Team). Confira visibilidade.
- 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 texto [, int r = 231, int g = 217, int b = 176, bool colorCoded = false ] )
Argumentos Obrigatórios
- text: The text string that you wish to send to the chat window. If more than 256 characters it will not be showed in chat.
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)
Veja também
- getMaxPlayers
- getServerConfigSetting
- getServerHttpPort
- getServerName
- getServerPassword
- getServerPort
- isGlitchEnabled
- setGlitchEnabled
- setMaxPlayers
- setServerConfigSetting
- setServerPassword
- shutdown