onClientDebugMessage

Disparado quando uma mensagem de script vai para o log.

Origem

A raiz (root).

Parâmetros

Posição	Nome	Tipo	Descrição
1	mensagem	string	O texto da mensagem.
2	nivel	number	1 erro, 2 aviso, 3 informação.
3	arquivo	string	O arquivo de script de onde veio a mensagem, no formato resource/caminho.lua, ou nil quando não se sabe.
4	linha	number	A linha dentro desse arquivo, ou nil.
5	r	number	Canal vermelho da cor que o console usaria, 0–255.
6	g	number	Canal verde.
7	b	number	Canal azul.

Cancelável

Sim.

Cancelar mantém a mensagem fora do console de debug. Isso só vale para mensagens registradas na thread de scripts, que é onde os scripts rodam; uma mensagem registrada por outra thread é exibida primeiro e chega aos manipuladores no quadro seguinte, quando já não dá para escondê-la.

A cor acompanha o nivel: vermelho para erro, laranja para aviso, verde para informação; os níveis 0 e 4 trazem a cor passada ao outputDebugString, branco por padrão. Ela existe para que uma janela de debug própria consiga reproduzir o que o console mostra sem reimplementar esse mapeamento.

Cobre o que sai de outputDebugString, os erros de runtime dos scripts e as reclamações de argumento inválido das funções. Mensagens do próprio cliente não entram — só o que vem da camada de script.

Nota

A origem viaja ao lado da mensagem, nunca dentro dela, então mensagem é exatamente o que foi escrito — o arquivo:linha: que aparece no console de debug é acrescentado na hora de imprimir a linha, não ao valor que o manipulador recebe. É o mesmo comportamento do onDebugMessage do servidor.

Cuidado

Um outputDebugString dentro deste manipulador não dispara o evento de novo — a reentrada é bloqueada de propósito. Ainda assim, evite: a mensagem some do fluxo de eventos e só aparece no log.

---

Veja também

• onClientMTAXFocusChange — Disparado quando a janela do jogo ganha ou perde o foco.
• onClientPauseMenuOpen — Disparado quando o jogador está prestes a abrir o menu principal do MTAX — com Esc, ou por qualquer outro caminho que a interface ofereça.
• onClientMinimize — Disparado quando a janela do jogo é minimizada.
• onClientRestore — Disparado quando a janela do jogo volta de minimizada.
• onClientConsole — Disparado quando uma linha é digitada no console do cliente, depois de os manipuladores de comando locais rodarem e imediatamente antes de a linha ser encaminhada ao servidor.