PT-BR/OutputChatBox

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

[[{{{image}}}|link=]] 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.
[[{{{image}}}|link=]] 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

Click to collapse [-]
Server
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.
BETA: DA VERSÃO 1.5.7-9.20391 ADIANTE
  • 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'.

    Click to collapse [-]
    Client
    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

    Click to collapse [-]
    Server

    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

    BETA: FROM VERSION 1.5.8 r20788 ONWARDS
    BETA: FROM VERSION 1.5.8 r20788 ONWARDS