Depuração - Revision history

Cristiano Cardoso: [add] [fix] nova introdução; erro de consistência no primeiro exemplo

2019-02-28T20:16:43Z

[add] [fix] nova introdução; erro de consistência no primeiro exemplo

← Older revision		Revision as of 20:16, 28 February 2019
Line 1:		Line 1:
	~~Quando você estiver fazendo seu script~~, ~~certos problemas surgirão~~. ~~O problema~~ é que ~~nem todos são tão aparentes assim~~, ~~então esta página irá descrever algumas estratégias básicas para localiza-los~~.		É comum ao programar cometer erros de sintaxe e semântica. O primeiro deles acontece porque o computador não tem a sensibilidade do ser humano para compreender um texto, mesmo que tenha erros de ortografia. Já o segundo, é basicamente culpa sua, não do computador. Por exemplo, em um complexo algoritmo para distribuir jogadores pelo mapa, ocorre uma [https://pt.wikipedia.org/wiki/Divis%C3%A3o_por_zero divisão por zero]. De fato, até este ponto, a máquina só seguiu suas instruções, que eventualmente, em um caso específico chegou a uma operação matemática inválida.

	==Debug no ~~console~~==		A depuração (debug, em inglês) ajuda o programador a encontrar erros apontando o que são eles são e onde estão, poupando seu valioso tempo. Esta página irá ensinar como ativar a depuração e dar alguns exemplos de como corrigir erros comuns.
	O MTA vem com um sistema no console onde mensagens de ''debug'' relacionadas às funções e scripts são mostradas. Lembrando que é necessário ter uma permissão de administrador para ativá-lo (a não ser se você modificar o ACL). Para fazer isso, digite ''debugscript x'' no console, em que ''x'' é o nível:
			==Debug no Console==
			O MTA vem com um sistema no console onde mensagens de ''debug'' relacionadas às funções e scripts são mostradas. Lembrando que é necessário ter uma permissão de administrador para ativá-lo (a não ser se você modificar o ACL). Para fazer isso, digite <code>debugscript X</code> no console, em que ''X'' é o nível:

	* '''1:''' mostra somente os erros		* '''1:''' mostra somente os erros
	* '''2:''' erros e avisos		* '''2:''' erros e avisos
	* '''3:''' erros, avisos e mensagens informativas		* '''3:''' erros, avisos e mensagens informativas
	Ao digitar ''debugscript 3'', todas as ocorrências serão mostradas. O nível 3 ou o 2 são os recomendados para a maioria dos casos. É ~~de extrema importância estar com~~ o ''debugscript'~~' ligado~~ para testar seu script e detectar os erros de digitação~~. Como também, resolver outros eventuais problemas~~.		Ao digitar <code>debugscript 3</code>, todas as ocorrências serão mostradas. O nível 3 ou o 2 são os recomendados para a maioria dos casos. É recomendado ativar o ''debugscript' para testar seu script e detectar os erros de digitação.

	===Exemplo===		===Exemplo===
	Neste código há dois erros:		Neste código há dois erros. Consegue encontra-los?
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function SayHello(message, player)		function SayHello(message, player)
	if (getPlayerName(player) == "Cebola")		if (getPlayerName(player) == "Cebola")
	outputChatbox("~~Hello Fedor~~")		outputChatbox("Olá, Cebola!")
	end		end
	end		end
Line 26:		Line 28:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function SayHello(message, player)		function SayHello(message, player)
	if (getPlayerName(player) == "~~Fedor~~") then		if (getPlayerName(player) == "Cebola") then
	outputChatbox("~~Hello Fedor~~")		outputChatbox("Olá, Cebola!")
	end		end
	end		end
Line 38:		Line 40:
	function SayHello(message, player)		function SayHello(message, player)
	if (getPlayerName(player) == "Cebola") then		if (getPlayerName(player) == "Cebola") then
	outputChatBox("~~Bem vindo~~, Cebola!")		outputChatBox("Olá, Cebola!")
	end		end
	end		end
Line 44:		Line 46:
	</syntaxhighlight>		</syntaxhighlight>

	~~É óbvio~~ que isso é só um exemplo e não será sempre desse jeito, pois há vários tipos de erros ~~em diversos casos. Mas até aqui, uma boa base já foi ensinada~~.		Lembrando que isso é só ''um exemplo'' e não será sempre desse jeito, pois há vários tipos de erros que podem acontecer.

	==Log de debug do Cliente e Servidor==		==Log de debug do Cliente e Servidor==

Danilo: Link dos resources atualizados

2019-02-27T22:14:18Z

Link dos resources atualizados

← Older revision		Revision as of 22:14, 27 February 2019
Line 259:		Line 259:

	==Verificando problemas na performance==		==Verificando problemas na performance==
	Se o seu servidor estiver trabalhando muito além da conta ou você deseja se certificar que seus scripts são eficientes, é possível matar o problema pela raiz usando uma boa ferramenta inclusa na instalação: [[Resource:Performancebrowser\|performancebrowser]]. É só inicia-lo usando ''''start performancebrowser''''. Caso ele não exista, pode encontrá-lo no último pacote de recursos hospedado no [~~http~~://~~code.google~~.com/p/mtasa-resources ~~Google Code~~]. Esta ferramenta inclui uma série de informações relativas a performance, como:		Se o seu servidor estiver trabalhando muito além da conta ou você deseja se certificar que seus scripts são eficientes, é possível matar o problema pela raiz usando uma boa ferramenta inclusa na instalação: [[Resource:Performancebrowser\|performancebrowser]]. É só inicia-lo usando ''''start performancebrowser''''. Caso ele não exista, pode encontrá-lo no último pacote de recursos hospedado no [https://github.com/multitheftauto/mtasa-resources GitHub]. Esta ferramenta inclui uma série de informações relativas a performance, como:
	* Memory leaks - uso excessivo de memória		* Memory leaks - uso excessivo de memória
	* Element leaks - criação excessiva de elementos		* Element leaks - criação excessiva de elementos

Cristiano Cardoso at 22:07, 8 February 2015

2015-02-08T22:07:53Z

← Older revision		Revision as of 22:07, 8 February 2015
Line 323:		Line 323:
	[[it:Guida al Debug]]		[[it:Guida al Debug]]
	[[ru:Debugging]]		[[ru:Debugging]]
	[[Category:~~Translated/~~Scripting ~~Concepts~~]]		[[Category:Conceitos de Scripting]]
	[[Category:Tutorials]]		[[Category:Tutorials]]

Cristiano Cardoso: Cristiano Cardoso moved page PT-BR/Depuração to Depuração

2015-02-08T22:07:37Z

Cristiano Cardoso moved page PT-BR/Depuração to Depuração

← Older revision	Revision as of 22:07, 8 February 2015
(No difference)

Banex: /* Exemplo */

2014-12-06T02:22:50Z

Exemplo

Fabervox at 12:13, 29 September 2014

2014-09-29T12:13:32Z

← Older revision		Revision as of 12:13, 29 September 2014
Line 324:		Line 324:
	[[it:Guida al Debug]]		[[it:Guida al Debug]]
	[[ru:Debugging]]		[[ru:Debugging]]
	[[Category:Scripting Concepts]]		[[Category:Translated/Scripting Concepts]]
	[[Category:Tutorials]]		[[Category:Tutorials]]

Cristiano Cardoso: Translated!

2014-07-06T23:57:11Z

Translated!

New page

Quando você estiver fazendo seu script, certos problemas surgirão. O problema é que nem todos são tão aparentes assim, então esta página irá descrever algumas estratégias básicas para localiza-los.

==Debug no console==
O MTA vem com um sistema no console onde mensagens de ''debug'' relacionadas às funções e scripts são mostradas. Lembrando que é necessário ter uma permissão de administrador para ativá-lo (a não ser se você modificar o ACL). Para fazer isso, digite ''debugscript *x*'' no console, em que ''x'' é o nível:

* '''1:''' mostra somente os erros
* '''2:''' erros e avisos
* '''3:''' erros, avisos e mensagens informativas
Ao digitar ''debugscript 3'', todas as ocorrências serão mostradas. O nível 3 ou o 2 são os recomendados para a maioria dos casos. É de extrema importância estar com o ''debugscript'' ligado para testar seu script e detectar os erros de digitação. Como também, resolver outros eventuais problemas.

===Exemplo===
Neste código há dois erros:
<syntaxhighlight lang="lua">
function SayHello(message, player)
if (getPlayerName(player) == "Cebola")
outputChatbox("Hello Fedor")
end
end
addEventHandler("onChatMessage", root, SayHello)
</syntaxhighlight>
Quando este script for carregado, no console irá aparecer algo assim:
:{{Debug info|Loading script failed: meuRecurso\script.lua:2: 'then' expected near ´outputChatbox'}}

Isso significa que o script não pode ser executado porque há um erro de sintaxe. Nesta mensagem, primeiramente aparece qual script de qual recurso deu problema. Depois disso, há dois pontos e um número mostrando a linha onde está o erro; para facilitar o trabalho do programador quando se trata de scripts maiores. Depois disso, a mensagem irá variar de acordo com o tipo de erro. Neste caso, é fácil concluir que o erro está localizado no '''meuRecurso''' e na linha dois do arquivo '''script.lua'''. Desta vez está na cara: precisamos colocar o "then" na cláusula ''if''.
<syntaxhighlight lang="lua">
function SayHello(message, player)
if (getPlayerName(player) == "Fedor") then
outputChatbox("Hello Fedor")
end
end
addEventHandler("onChatMessage", root, SayHello)
</syntaxhighlight>
Agora tudo será carregado com sucesso e nenhum erro aparecerá até que um jogador apelidado "Cebola" dizer algo no chat. Aí no console irá aparecer:
:{{Debug error|myResource\script.lua:2: attempt to call global 'outputChatbox' (a nil value)}}
Isso significa que a função '''outputChatbox''' é um valor ''nil'', ou seja, ele não existe! Isso porque a função na verdade se chama [[outputChatBox]], e não [[outputChatbox]]. Então, tome cuidado com a letra maiúscula B.:
<syntaxhighlight lang="lua">
function SayHello(message, player)
if (getPlayerName(player) == "Cebola") then
outputChatBox("Bem vindo, Cebola!")
end
end
addEventHandler("onChatMessage", root, SayHello)
</syntaxhighlight>

É óbvio que isso é só um exemplo e não será sempre desse jeito, pois há vários tipos de erros em diversos casos. Mas até aqui, uma boa base já foi ensinada.

==Log de debug do Cliente e Servidor==
====Servidor====
Na pasta ''../server/mods/deathmatch'', haverá dois arquivos com funções parecidas:

*''local.conf'' - são as configurações oriundas do item "host game" no menu principal do MTA. Isto é uma maneira rápida de iniciar um servidor de testes dentro do próprio programa. Quando o usuário fecha o jogo, ele é automaticamente desligado também.

*''mtaserver.conf'' - é usado quando se inicia o "MTA Server.exe" dentro da pasta ''../server/''. Em outras palavras, o servidor é rodado em prompt de comando e não necessita de o MTA estar executando junto. Isso é muito útil para os interessados em montar um servidor dedicado ou mesmo experimentar como é mexer em um servidor de verdade.

Dependendo das suas necessidades, com certeza irá querer alterar essas configurações abaixo:

<syntaxhighlight lang="xml">

<scriptdebuglogfile>logs/scripts.log</scriptdebuglogfile>


<scriptdebugloglevel>0</scriptdebugloglevel></syntaxhighlight>

Como as descrições acima já dizem, é opcional salvar um arquivo de log de acordo com o nível desejado. Os três níveis estão descritos acima, sendo neste caso o zero como a não ativação do debugscript - fazendo o arquivo ficar em branco. Se 3 for ativado, todos os erros encontrados no '''lado do servidor''' serão salvos em: ''../server/mods/deathmatch/logs/scripts.log''

====Cliente====
Todos os erros '''do cliente''' serão salvos na pasta ''../server/clientscript.log''. Isso já é definido por padrão, então nenhuma configuração é necessária.

==Habilidades em Deubug==

Em vez de ficar procurando no código os erros cometidos, há algumas coisas a serem feitas para ajudar a encontrar-los. A maioria delas estão relacionadas com a adição de alguma mensagem de debug informando o que está ocorrendo no script.

===Funções Úteis===
As funções abaixo podem lhe ajudar com o debug:
* [[outputDebugString]] ou [[outputChatBox]] para escrever qualquer informação na tela (de preferência outputDebugString para suporte técnico)
* [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] para tornar qualquer variável em uma ''string''. Muito útil para saber o que ela é, escrevendo na tela. Não será necessário usa-la se a variável já uma string ou um número.
* [[getElementType]] verifica o tipo de elemento do MTA em questão.
* [[isElement]] verifica se elemento existe.

===Adicionando mensagens de debug para verificar ''se'', ''quando'' ou por qual ''frequência'' um código é executado===
Se você terminou de escrever um código e percebe que algo esperado não acontece e fica em dúvida se as instruções foram executadas ou não; nesse caso é recomendado adicionar mensagens de debug para verificar os passos.<br>
Um exemplo típico seria checar se uma clausula ''if'' foi atendida ou não:
<syntaxhighlight lang="lua">
if (variable1 == variable2) then
outputDebugString("A variável 1 é igual a 2.")
-- portanto, faça alguma coisa
end
</syntaxhighlight>

Outra maneira semelhante seria verificar se alguma variável muda. Em outras palavras, é só adicionar uma mensagem de debug depois de cada vez que isso acontece.

===Adicionando uma mensagem de debug para verificar o ''valor'' de uma variável===
Digamos que desejas criar um marcador (marker), mas ele não aparece na posição esperada. A primeira coisa a ser feita é verificar se a função [[createMarker]] foi executada com sucesso. Depois disso, só precisamos verificar os valores usados nela.
<syntaxhighlight lang="lua">
local marker = createMarker(x,y,z)
if not marker then
outputChatBox("O marcador não pode ser criado.")
end
outputChatBox("A posX é "..x..", posY "..y..", e posZ "..z)
</syntaxhighlight>
Feito isso, as variáveis usadas como coordenadas serão mostradas. Lembrando que se uma variável não for uma frase ou número, é recomendado usar a função [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()], pois ela torna qualquer variável agrupável em uma ''string'', mesmo se for uma ''bool'' ou tabela.

==Exemplo==
Imagine que você criou um [[Colshape|detector de colisão]] e se o jogador ficar dez segundos dentro dele, algo vai acontecer:
<syntaxhighlight lang="lua">
function colShapeHit(player)
-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
-- e inserimos ele em uma tabela, usando o jogador como index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colisor!")
end
addEventHandler("onColShapeHit", root, colShapeHit)

function colShapeLeave(player)
-- destrua o timer quando o jogador sair do colisor
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave", root, colShapeLeave)
</syntaxhighlight>
Quando o jogador entrar no colisor, o debugscript irá escrever a seguinte mensagem:
:{{Debug error|..[path]: attempt to index global 'colshapeTimer' (a nil value)}}
Isso significa que você tentou endereçar uma tabela não existente quando tentou colocar o timer dentro dela; ou seja, ela é um valor ''nil'' - portanto, não existe. Para corrigir isso, precisamos verificar se a tabela não existe, e caso a resposta for positiva; a criaremos.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
-- e inserimos ele em uma tabela, usando o jogador como index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colisor!")
end
addEventHandler("onColShapeHit", root, colShapeHit)

function colShapeLeave(player)
-- destrua o timer quando o jogador sair do colisor
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",root,colShapeLeave)
</syntaxhighlight>

Desta vez receberemos um aviso quando o jogador entrar no colisor, esperar a mensagem e sair de lá:

:{{Debug warning|[..]: Bad argument @ 'killTimer' Line: ..}}

Tirando isso (vamos corrigir mais tarde!), tudo parece funcionar bem. O jogador entra no colisor e o ''timer'' começa a contar: se ele esperar, a mensagem é escrita, caso contrário o ''timer'' é destruído. Mas...

===Um erro imperceptível===
Por alguma razão, quando o jogador entra no colisor usando um veículo, a mensagem é escrita duas vezes; como se o código tivesse sido executado duas vezes. Então, adicionamos uma mensagem de debug para verificar isso.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- adicionamos uma mensagem de debug
outputDebugString("colShapeHit")
-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
-- e inserimos ele em uma tabela, usando o jogador como index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colisor!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- adicionamos outra mensagem de debug
outputDebugString("colShapeLeave")
-- destrua o timer quando o jogador sair do colisor
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>
Agora dá pra ter certeza que as funções são executadas duas vezes quando entramos com um veículo, mas só uma quando se está a pé. É possível que o veículo seja um elemento a parte e ativa a função de forma independente ao jogador. Para confirmar essa teoria, verificamos se a variável ''player'' realmente se refere ao jogador.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- adicionamos uma mensagem de debug, seguido do elemento "jogador"
outputDebugString("colShapeHit"..getElementType(player))
-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
-- e inserimos ele em uma tabela, usando o jogador como index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colisor!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- adicionamos outra mensagem de debug, incluindo o jogador
outputDebugString("colShapeLeave "..getElementType(player))
-- destrua o timer quando o jogador sair do colisor
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

A mensagem de debug nos diz que uma referência da variável ''player'' é realmente o jogador, mas outra é o veículo. Já que nós destinamos o evento especificamente ao boneco dele, adicionaremos uma cláusula ''if'', obrigando o término da execução do código caso a variável '''não''' for o jogador.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- adicionamos um verificador
if (getElementType(player) ~= "player") then return end
-- adicionamos uma mensagem de debug, seguido do elemento "jogador"
outputDebugString("colShapeHit"..getElementType(player))
-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
-- e inserimos ele em uma tabela, usando o jogador como index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colisor!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- adicionamos ele novamente
if (getElementType(player) ~= "player") then return end
-- adicionamos outra mensagem de debug, incluindo o jogador
outputDebugString("colShapeLeave "..getElementType(player))
-- destrua o timer quando o jogador sair do colisor
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>
Agora tudo está funcionando como o planejado, mas aquela mensagem de aviso mencionada acima ainda aparece. Isso porque quando tentamos destruir o timer depois que o jogador saí do colisor, ele não existe mais, já que os 10 segundos se passaram. Em outras palavras, o timer é automaticamente destruído quando ele conta os 10 segundos. Há diversas formas de se livrar do aviso, uma vez que temos conhecimento da não existência do ''timer''. Uma delas seria verificar se ele existe na tabela. Para fazer isto, usamos a função [[isTimer]] na hora de destruí-lo:
<syntaxhighlight lang="lua">
if (isTimer(colshapeTimer[player])) then
killTimer(colshapeTimer[player])
end
</syntaxhighlight>

Então o código completo ficará assim:
<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- adicionamos um verificador
if (getElementType(player) ~= "player") then return end
-- adicionamos uma mensagem de debug, seguido do elemento "jogador"
outputDebugString("colShapeHit"..getElementType(player))
-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
-- e inserimos ele em uma tabela, usando o jogador como index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colisor!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- adicionamos ele novamente
if (getElementType(player) ~= "player") then return end
-- adicionamos outra mensagem de debug, incluindo o jogador
outputDebugString("colShapeLeave "..getElementType(player))
-- destrua o timer quando o jogador sair do colisor
if (isTimer(colshapeTimer[player])) then
killTimer(colshapeTimer[player])
end
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

==Verificando problemas na performance==
Se o seu servidor estiver trabalhando muito além da conta ou você deseja se certificar que seus scripts são eficientes, é possível matar o problema pela raiz usando uma boa ferramenta inclusa na instalação: [[Resource:Performancebrowser|performancebrowser]]. É só inicia-lo usando ''''start performancebrowser''''. Caso ele não exista, pode encontrá-lo no último pacote de recursos hospedado no [http://code.google.com/p/mtasa-resources Google Code]. Esta ferramenta inclui uma série de informações relativas a performance, como:
* Memory leaks - uso excessivo de memória
* Element leaks - criação excessiva de elementos
* CPU usage - uso excessivo de CPU

Para acessar o performancebrowser, é preciso ir até o navegador e digitar o endereço: <nowiki>http://<ip-do-servidor>:<porta>/performancebrowser/</nowiki>. Um exemplo seria o endereço do servidor local: http://127.0.0.1:22005/performancebrowser/. Lembrando que é preciso:
* colocar a barra (/) no final do endereço
* logar no jogo com uma conta de administrador ou outra que tenha acesso no ACL a:
:* '''resource.performancebrowser.http''' e '''resource.ajax.http'''

{{Dica|A maioria das informações relevantes estão nas categorias ''Lua timing'' e ''Lua memory''. E, o problema está nos valores mais altos apresentados.}}

===Exemplos de scripts problemáticos===

Um deles seria adicionar dados a alguma tabela, mas não remover posteriormente. Porém, isso levaria alguns meses ou até anos para danificar o funcionamento do servidor.
<syntaxhighlight lang="lua">
local someData = {}

function storeData()
someData[source] = true
-- não há nenhum evento para retirar os dados quando o jogador sair. Isso é considerado memory leak
-- Entrando na aba Lua timing, você pode verificar o uso de RAM de cada recurso.
end
addEventHandler("onPlayerJoin", root, storeData)
</syntaxhighlight>

Um caso possível de ''Element leak'' é criar colisores temporários e nunca destruí-los mais tarde. Isso aumenta muito o uso de transferência dados (bandwidth), CPU e memória pelo servidor.
<syntaxhighlight lang="lua">
function useTemporaryCol()
local col = createColCircle(some code here)
if (algo que deveria acontecer...) then
destroyElement(col)
end
-- E as vezes não acontece, fazendo o colisor permanecer no mapa pra sempre...
-- Criando de centenas à milhares de coliores sem função alguma.
-- Na aba Lua timing é possível ver quantos elementos cada script criou.
end
</syntaxhighlight>

O alto uso de CPU resulta na queda de FPS, fazendo o servidor um lugar ruim para se jogar. Em 24 horas, isso pode causar sérios prejuízos. O número de elementos criados detectados na aba ''Lua timing'' não ajudará neste caso, mas o ''Lua memory'' sim.
<syntaxhighlight lang="lua">
addEventHandler("onPlayerJoin", root, function()
-- [Código para o novo jogador]
-- Até que um evento é adicionado para quando ele sair
addEventHandler("onPlayerQuit", root, function()
-- Encontrou o problema? Esse evento além de usar o root como o seu causador, é criado infinitamente...
end)
end)
</syntaxhighlight>
Uma função usa muito o CPU quando ela demora para terminar de ser executada. O exemplo abaixo é uma delas. Sem o performancebrowser, você não perceberia tão cedo que esta é a causa do problema. Mas com ele, verá na aba ''Lua timing'' que o seu recurso usa muito o potencial do CPU. Ficará mais fácil descobrir isso se usar o parâmetro ''''d'''' na caixa de entrada ''Options''. Isso porque ela lhe dirá também a linha em que está o código problemático.
<syntaxhighlight lang="lua">
function umaFuncaoPoucoEficaz()
-- para cada cem mil coisas quaisquer
for i=1, 100000 do
-- [código abaixo]
end
end
</syntaxhighlight>

[[en:Debugging]]
[[it:Guida al Debug]]
[[ru:Debugging]]
[[Category:Scripting Concepts]]
[[Category:Tutorials]]

← Older revision		Revision as of 02:22, 6 December 2014
Line 109:		Line 109:
	-- criamos um timer para escrever uma mensagem (pode também ativar uma função)		-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
	-- e inserimos ele em uma tabela, usando o jogador como index		-- e inserimos ele em uma tabela, usando o jogador como index
	colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do ~~colisor~~!")		colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colshape!")
	end		end
	addEventHandler("onColShapeHit", root, colShapeHit)		addEventHandler("onColShapeHit", root, colShapeHit)

	function colShapeLeave(player)		function colShapeLeave(player)
	-- destrua o timer quando o jogador sair do ~~colisor~~		-- destrua o timer quando o jogador sair do colshape
	killTimer(colshapeTimer[player])		killTimer(colshapeTimer[player])
	end		end
	addEventHandler("onColShapeLeave", root, colShapeLeave)		addEventHandler("onColShapeLeave", root, colShapeLeave)
	</syntaxhighlight>		</syntaxhighlight>
	Quando o jogador entrar no ~~colisor~~, o debugscript irá escrever a seguinte mensagem:		Quando o jogador entrar no colshape, o debugscript irá escrever a seguinte mensagem:
	:{{Debug error\|..[path]: attempt to index global 'colshapeTimer' (a nil value)}}		:{{Debug error\|..[path]: attempt to index global 'colshapeTimer' (a nil value)}}
	Isso significa que você tentou endereçar uma tabela não existente quando tentou colocar o timer dentro dela; ou seja, ela é um valor ''nil'' - portanto, não existe. Para corrigir isso, precisamos verificar se a tabela não existe, e caso a resposta for positiva; a criaremos.		Isso significa que você tentou endereçar uma tabela não existente quando tentou colocar o timer dentro dela; ou seja, ela é um valor ''nil'' - portanto, não existe. Para corrigir isso, precisamos verificar se a tabela não existe, e caso a resposta for positiva; a criaremos.
Line 130:		Line 130:
	-- criamos um timer para escrever uma mensagem (pode também ativar uma função)		-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
	-- e inserimos ele em uma tabela, usando o jogador como index		-- e inserimos ele em uma tabela, usando o jogador como index
	colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do ~~colisor~~!")		colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colshape!")
	end		end
	addEventHandler("onColShapeHit", root, colShapeHit)		addEventHandler("onColShapeHit", root, colShapeHit)

	function colShapeLeave(player)		function colShapeLeave(player)
	-- destrua o timer quando o jogador sair do ~~colisor~~		-- destrua o timer quando o jogador sair do colshape
	killTimer(colshapeTimer[player])		killTimer(colshapeTimer[player])
	end		end
Line 141:		Line 141:
	</syntaxhighlight>		</syntaxhighlight>

	Desta vez receberemos um aviso quando o jogador entrar no ~~colisor~~, esperar a mensagem e sair de lá:		Desta vez receberemos um aviso quando o jogador entrar no colshape, esperar a mensagem e sair de lá:

	:{{Debug warning\|[..]: Bad argument @ 'killTimer' Line: ..}}		:{{Debug warning\|[..]: Bad argument @ 'killTimer' Line: ..}}

	Tirando isso (vamos corrigir mais tarde!), tudo parece funcionar bem. O jogador entra no ~~colisor~~ e o ''timer'' começa a contar: se ele esperar, a mensagem é escrita, caso contrário o ''timer'' é destruído. Mas...		Tirando isso (vamos corrigir mais tarde!), tudo parece funcionar bem. O jogador entra no colshape e o ''timer'' começa a contar: se ele esperar, a mensagem é escrita, caso contrário o ''timer'' é destruído. Mas...

	===Um erro imperceptível===		===Um erro imperceptível===
	Por alguma razão, quando o jogador entra no ~~colisor~~ usando um veículo, a mensagem é escrita duas vezes; como se o código tivesse sido executado duas vezes. Então, adicionamos uma mensagem de debug para verificar isso.		Por alguma razão, quando o jogador entra no colshape usando um veículo, a mensagem é escrita duas vezes; como se o código tivesse sido executado duas vezes. Então, adicionamos uma mensagem de debug para verificar isso.

	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
Line 159:		Line 159:
	-- criamos um timer para escrever uma mensagem (pode também ativar uma função)		-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
	-- e inserimos ele em uma tabela, usando o jogador como index		-- e inserimos ele em uma tabela, usando o jogador como index
	colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do ~~colisor~~!")		colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colshape!")
	end		end
	addEventHandler("onColShapeHit",getRootElement(),colShapeHit)		addEventHandler("onColShapeHit",getRootElement(),colShapeHit)
Line 166:		Line 166:
	-- adicionamos outra mensagem de debug		-- adicionamos outra mensagem de debug
	outputDebugString("colShapeLeave")		outputDebugString("colShapeLeave")
	-- destrua o timer quando o jogador sair do ~~colisor~~		-- destrua o timer quando o jogador sair do colshape
	killTimer(colshapeTimer[player])		killTimer(colshapeTimer[player])
	end		end
Line 182:		Line 182:
	-- criamos um timer para escrever uma mensagem (pode também ativar uma função)		-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
	-- e inserimos ele em uma tabela, usando o jogador como index		-- e inserimos ele em uma tabela, usando o jogador como index
	colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do ~~colisor~~!")		colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colshape!")
	end		end
	addEventHandler("onColShapeHit",getRootElement(),colShapeHit)		addEventHandler("onColShapeHit",getRootElement(),colShapeHit)
Line 189:		Line 189:
	-- adicionamos outra mensagem de debug, incluindo o jogador		-- adicionamos outra mensagem de debug, incluindo o jogador
	outputDebugString("colShapeLeave "..getElementType(player))		outputDebugString("colShapeLeave "..getElementType(player))
	-- destrua o timer quando o jogador sair do ~~colisor~~		-- destrua o timer quando o jogador sair do colshape
	killTimer(colshapeTimer[player])		killTimer(colshapeTimer[player])
	end		end
Line 208:		Line 208:
	-- criamos um timer para escrever uma mensagem (pode também ativar uma função)		-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
	-- e inserimos ele em uma tabela, usando o jogador como index		-- e inserimos ele em uma tabela, usando o jogador como index
	colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do ~~colisor~~!")		colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colshape!")
	end		end
	addEventHandler("onColShapeHit",getRootElement(),colShapeHit)		addEventHandler("onColShapeHit",getRootElement(),colShapeHit)
Line 217:		Line 217:
	-- adicionamos outra mensagem de debug, incluindo o jogador		-- adicionamos outra mensagem de debug, incluindo o jogador
	outputDebugString("colShapeLeave "..getElementType(player))		outputDebugString("colShapeLeave "..getElementType(player))
	-- destrua o timer quando o jogador sair do ~~colisor~~		-- destrua o timer quando o jogador sair do colshape
	killTimer(colshapeTimer[player])		killTimer(colshapeTimer[player])
	end		end
	addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)		addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
	</syntaxhighlight>		</syntaxhighlight>
	Agora tudo está funcionando como o planejado, mas aquela mensagem de aviso mencionada acima ainda aparece. Isso porque quando tentamos destruir o timer depois que o jogador saí do ~~colisor~~, ele não existe mais, já que os 10 segundos se passaram. Em outras palavras, o timer é automaticamente destruído quando ele conta os 10 segundos. Há diversas formas de se livrar do aviso, uma vez que temos conhecimento da não existência do ''timer''. Uma delas seria verificar se ele existe na tabela. Para fazer isto, usamos a função [[isTimer]] na hora de destruí-lo:		Agora tudo está funcionando como o planejado, mas aquela mensagem de aviso mencionada acima ainda aparece. Isso porque quando tentamos destruir o timer depois que o jogador saí do colshape, ele não existe mais, já que os 10 segundos se passaram. Em outras palavras, o timer é automaticamente destruído quando ele conta os 10 segundos. Há diversas formas de se livrar do aviso, uma vez que temos conhecimento da não existência do ''timer''. Uma delas seria verificar se ele existe na tabela. Para fazer isto, usamos a função [[isTimer]] na hora de destruí-lo:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	if (isTimer(colshapeTimer[player])) then		if (isTimer(colshapeTimer[player])) then
Line 241:		Line 241:
	-- criamos um timer para escrever uma mensagem (pode também ativar uma função)		-- criamos um timer para escrever uma mensagem (pode também ativar uma função)
	-- e inserimos ele em uma tabela, usando o jogador como index		-- e inserimos ele em uma tabela, usando o jogador como index
	colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do ~~colisor~~!")		colshapeTimer[player] = setTimer(outputChatBox,10000,1,"O jogador permaneceu dez segundos dentro do colshape!")
	end		end
	addEventHandler("onColShapeHit",getRootElement(),colShapeHit)		addEventHandler("onColShapeHit",getRootElement(),colShapeHit)
Line 250:		Line 250:
	-- adicionamos outra mensagem de debug, incluindo o jogador		-- adicionamos outra mensagem de debug, incluindo o jogador
	outputDebugString("colShapeLeave "..getElementType(player))		outputDebugString("colShapeLeave "..getElementType(player))
	-- destrua o timer quando o jogador sair do ~~colisor~~		-- destrua o timer quando o jogador sair do colshape
	if (isTimer(colshapeTimer[player])) then		if (isTimer(colshapeTimer[player])) then
	killTimer(colshapeTimer[player])		killTimer(colshapeTimer[player])
Line 257:		Line 257:
	addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)		addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
	</syntaxhighlight>		</syntaxhighlight>


	==Verificando problemas na performance==		==Verificando problemas na performance==