<div style="background: #FFEEAA; padding: 5px; float:right; width: 30%;">Dernière version stable de '''Multi Theft Auto: San Andreas''' est '''{{Current Version|full}}'''. Rendez-vous sur la [http://mtasa.com/ page principale] pour la télécharger.
<p>
Vous pouvez aussi télécharger une [http://nightly.mtasa.com/ beta] pour avoir la dernière version ( non stable ).
</p>
</div>
__NOTOC__
Bienvenue sur le wiki de Multi Theft Auto. Sur ce wiki, vous trouverez toutes les informations sur Multi Theft Auto.

Il y a [[How you can help|différents moyens de nous aider]]: créer une map, un gamemode, rediger des articles sur des fonctions, écrire un exemple, écrire un tutorial ou juste jouer à MTA et nous rapportez les bugs trouvés.

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Pour commencer====

* [[FR/Manuel_Client|Manuel Client]] ( Traduction: [http://wiki.multitheftauto.com/wiki/User:DrawKiie DrawKiie] )
* [[FR/Manuel_Serveur|Manuel Serveur]] ( Traduction: [http://wiki.multitheftauto.com/wiki/User:Rouche Rouche] )
* [[FR/Problemes_connus|Problèmes connus]] ( Traduction: [http://wiki.multitheftauto.com/wiki/User:Rouche Rouche] )
* [[FR/Migrer_de_MTARace_a_MTASA_1.0.x|Migrer de MTA:Race à MTA:SA 1.0.x]] ( Traduction: [http://wiki.multitheftauto.com/wiki/User:Rouche Rouche] )
* [[FR/A propos des Map|A propos des Map]] ( Traduction: [http://wiki.multitheftauto.com/wiki/User:Rouche Rouche] )

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Programmer====

* [[FR/Introduction_Programmation|Introduction: La programmation]]
* [[FR/Introduction_GUI|Introduction: Le GUI]] ( Traduction: [http://wiki.multitheftauto.com/wiki/User:FatalTeror FatalTerror] )
* [[FR/Debugage|Tutoriel: Le débugage]] - Comment trouver les erreurs dans son script
* [[FR/Ressources|Introduction: Les ressources]] (Traduction : [http://wiki.multitheftauto.com/wiki/User:Myk3L Myk3L])
** [[FR/Ressource_Acces_Internet|Introduction: L'accès depuis internet]] - Comment créer un site à partir d'une ressource (Traduction : [http://wiki.multitheftauto.com/wiki/User:Myk3L Myk3L])
** [[:Category:Resource|Catalogue des ressources]]
** [[FR/Meta.xml|Meta.xml]] - Derière chaque ressource ce trouve une meta pour la définir
** [[FR/ACL|ACL]] - Access Control List, pour définir les autorisations
* [[FR/Ecrire_Gamemode|Créer un gamemode]] ( Traduction: [http://wiki.multitheftauto.com/wiki/User:Rouche Rouche])
* [[FR/Fonctions_Utiles|Fonctions Utiles]]

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Bases de données====
Cette section décrit toutes les capacités fournies par le LUA/MTA ou par les ressources.
* [[:Category:Resource|Catalogue des ressources]] - Vous devriez le lire pour réaliser un script approprié.
* [[FR/Les_scripts_clients| Les scripts clients]]
</div>
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Aide générale du LUA====
Des pages conçues pour aider votre compréhension du Lua
*[http://www.lua.org/pil/index.html "Programming in Lua"]
**[http://www.lua.org/manual/5.1/#index Les fonctions Lua]
*[http://lua-users.org/wiki/TutorialDirectory wiki Lua]
*[http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Un guide général au Lua de Nixstaller]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Map Editor====
*[[Resource:Editor|Manuel]]
*[[Resource:Editor/EDF|Editor Definition Format]]
*[[Resource:Editor/Plugins|Plugins]]
*[[Resource:Editor#FAQ|Questions Fréquentes]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Développer Multi Theft Auto====
* [[FR/Compiler_MTASA|Compiler MTASA sur Windows]]
* [[FR/Compiler_MTASA_Server_sur_Mac_OS_X|Compiler MTASA sur Mac OS X]]
* [[FR/Compiler_MTASA_Server_sur_GNU_Linux|Compiler MTASA sur GNU/Linux]]
* [[FR/Directives_de_codage|Directives de codage]]
* [http://code.google.com/p/mtasa-blue Google Code SVN]
* [[FR/Roadmap|Roadmap]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">

====Références====
* [[FR/Fonctions_Clients|Fonctions Clients]]
* [[FR/Events_Clients|Events Clients]]
* [[FR/Fonctions_Serveurs|Fonctions Clients]]
* [[FR/Events_Serveurs|Events Clients]]

* [[FR/MTA Classes|MTA Classes]] - Les descriptions détaillées de tous les types personnalisés MTA
** [[FR/Element|MTA Elements]] / [[Element tree]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====[[Id|ID Listes]]====
*[[FR/Animations|Animations]]
*[[FR/Skins_Personnages|Skins Personnages]]
*[[FR/Vetements_CJ|Vêtements CJ]]
*[[FR/Garage|Garage IDs]]
*[[FR/Interieurs_IDs|Intérieurs IDs]]
*[[FR/Materiel_IDs|Matériel IDs]]
*[[FR/Projectiles|Projectiles]]
*[[FR/Radar Blips|Radar Blips]]
*[[FR/Sons|Sons]]
*[[FR/Vehicule_IDs|ID des véhicules]]
*[[FR/Vehicule_Couleurs|Couleurs véhicules]]
*[[FR/Vehicule_Upgrades|Tuning IDs]]
*[[FR/Armes|Armes]]
*[[FR/Meteos|Météos]]
</div>

|-
| colspan="2" |
|}
{{Languages list|fr}}

FR/Debugage

2014-07-08T20:57:24Z

V1ncenzo: /* Astuces de déboguage */

Quand vous scriptez vous pouvez passer à côté de certaines erreurs qui ne sont pas apparentes au premier coup d’œil. Cette page va essayer de vous indiquer quelques démarches à suivre pour localiser les erreurs.

==Console de Débogage==
MTA a pour caractéristique de posséder une console de débogage qui comme son nom l'indique vous permet de déceler les erreurs dans les fonctions et scripts. Vous pouvez l'ouvrir en tapant ''debugscript x'' dans la console, ici ''x'' est le niveau de débogage:
* '''1:''' seulement les erreurs
* '''2:''' erreurs et warnings
* '''3:''' erreurs, warnings et messages d'informations
Ainsi, en tapant ''debugscript 3'' tout les messages seront visibles, cependant le niveau 2 est recommandé la plupart du temps pour le débogage. Quand vous testez vos scripts vous devez avoir le ''debugscript'' à disposition , cela vous permettra de détecter facilement les fautes d'orthographes dans les fonctions ou toutes autres erreurs aussi simple.

===Exemple===
L'exemple ci-dessous contient deux erreurs:
<syntaxhighlight lang="lua">
if (getPlayerName(player) == "Fedor")
outputChatbox("Hello Fedor")
end
</syntaxhighlight>
Quand ce bout de code va être chargé, debugscript va vous renvoyer à peu près ceci:
{{Debug info|Loading script failed: C:\<server path>\mods\deathmatch\resources\myResource\script.lua:15: 'then' expected near ´outputChatbox'}}
Cela signifie que le code ne peut-être analysé/traité, car il y a une erreur de syntaxe. On vous montre le répertoire où se trouve le fichier, vous pouvez donc voir dans quelle ressource ce dernier se trouve ('myResource' dans notre cas) et bien sûr on vous donne le nom du fichier en question. Après le nom du fichier, on a le numéro de la ligne et encore après l'erreur/problème en question. C'est bien plus facile à résoudre maintenant, il manque juste 'then':
<syntaxhighlight lang="lua">
if (getPlayerName(player) == "Fedor") then
outputChatbox("Hello Fedor")
end
</syntaxhighlight>
A présent le bout de code se charge et ne renvoie aucune erreur, jusqu'à ce qu'un joueur avec le pseudo 'Fedor' fasse son apparition. Le debugscript va nous renvoyer alors:
{{Debug error|C:\<server path>\mods\deathmatch\resources\d\script.lua:15: attempt to call global 'outputChatbox' (a nil value)}}
Cela signifie que la fonction appelée n'existe pas, cela s'explique facilement par le fait que le nom de la fonction est ''outputChatBox'' (avec une capitale ''B''):
<syntaxhighlight lang="lua">
if (getPlayerName(player) == "Fedor") then
outputChatBox("Hello Fedor")
end
</syntaxhighlight>

Ceci n'est bien sûr qu'un exemple, il y a une multitude d'autres erreurs et problèmes, mais vous avez au moins une idée du débogage.

==Debug logging==
You can also turn debug message logging on by editing ''coreconfig.xml'' in your GTA\MTA folder. You should find the following tag:
<syntaxhighlight lang="xml"><debugfile/></syntaxhighlight>

Replace that with a tag specifying the file you want to log messages to (file path is relative from the GTA folder):
<syntaxhighlight lang="xml"><debugfile>MTA\debugscript.log</debugfile></syntaxhighlight>

All debug messages will be appended to the specified file from now on. To turn logging off, replace that line with an empty tag again.

==Astuces de déboguage==

Au lieu de foncer tête baisser dans votre code, il existe d'autres stratégies pour débusquer les erreurs. La plupart d'entres elles utilisent des messages/sorties (au niveau de la console) de déboguage qui sont différent suivant les situations.

===Fonctions Utiles===
Pour commencer, il y a quelques fonctions qui peuvent être utiles pour le ''débogage''.
* [[outputDebugString]] ou [[outputChatBox]] pour afficher des informations.
* [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] sur une variable pour la convertir en chaîne de caractères, par exemple lorsque c'est un booléen.
* [[getElementType]] pour vérifier le type d'un élément de MTA.

===Ajouter un message pour vérifier quand une condition ''if'', ''when'' ou ''how often'' est executée===
Un exemple typique qui vérifie si une condition ''if''est executée ou non. Il vous suffit d'ajouter un message que vous reconnaîtrez lorsqu'il s'affichera quand la condition sera executée.
<syntaxhighlight lang="lua">
if (variable1 == variable2) then
outputDebugString("Condition vérifiée")
-- Instruction
end
</syntaxhighlight>
Une autre pratique serait de vérifier quand est-ce que la valeur de la variable est modifiée. Il faut pour cela chercher le moment où la variable est modifiée et ajouter une fonction qui permet l'affichage d'un message juste après.

===Afficher un message pour vérifier la "valeur" d'une variable===
Prenons le cas ou vous voulez créer un checkpoint (marqueur), mais ce dernier n'apparaît pas à la position attendu. La première chose que vous allez faire sera de vérifier si la fonction [[createMarker]] est executée. Au lieu de faire ceci, vous pouvez vérifier les valeurs qui sont utilisées par la fonction [[createMarker]].
<syntaxhighlight lang="lua">
outputChatBox(tostring(x).." "..tostring(y).." "..tostring(z))
createMarker(x,y,z)
</syntaxhighlight>
Ce code aura pour conséquence de vous afficher un message avec les trois valeurs des variables qui sont utilisées en tant que coordonnées pour le marqueur. Vous pouvez maintenant comparer les valeurs obtenues avec celle désirées. Le [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] vous permettra de vous assurer que les valeurs des variables seront transformées en "string" (chaîne de caractères), même si c'est un boléen.

==Exemple==
Imaginons que vous créiez un ''colshape'' (figure géométrique bi/tridimensionnelle pour détecter les collisions) quelque part et que vous souhaitiez qu'un joueur reste 10 secondes dans celle-ci avant d'éxecuter un code.
<syntaxhighlight lang="lua">
function colShapeHit(player)
-- défini un timer pour afficher un message (le timer peut très bien éxécuter une fonction)
-- stocke l'id du timer dans un tableau en utilisant le joueur (''player'') comme index/case.
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"Le joueur est depuis 10 secondes dans le colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- arrête le timer dès que le joueur quitte le colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>
Quand le joueur entre dans le colshape, le debugscript affiche le message suivant:
{{Debug error|..[path]: attempt to index global 'colshapeTimer' (a nil value)}}
Cela signifie que vous voulez stocker une valeur dans un tableau (à la case ''player'') qui n'existe pas. Dans l'exemple, le problème se pose quand vous voulez stocker l'id du timer dans le tableau. Nous devons donc vérifier si le tableau existe et si non en créer un.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- défini un timer pour afficher un message (le timer peut très bien éxécuter une fonction)
-- stocke l'id du timer dans un tableau en utilisant le joueur (''player'') comme index/case.
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"Le joueur est depuis 10 secondes dans le colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- arrête le timer dès que le joueur quitte le colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

Ceci fait il nous reste quand même un ''warning'' (avertissement).Attendez le message et quittez à nouveau le colshape:

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

À part ceci (nous en parlerons plus tard) tous semble bien fonctionner. Un joueur entre dans le ''colshape'', le timer se lance, si il reste un message s'affiche, si il quitte le ''colshape'' le timer est arrêté.

===Une erreur un peu plus complexe===
Cependant, pour une quelconque raison le message est envoyé deux fois quand on reste dans le cercle de collision alors qu'on est dans un véhicule. Since it would appear some code is executed twice, we add debug messages to check this.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- ajout d'un message de debugage
outputDebugString("colShapeHit")
-- set a timer to output a message (could as well execute another function)
-- store the timer id in a table, using the player as index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- ajout d'un message de debugage
outputDebugString("colShapeLeave")
-- kill the timer when the player leaves the colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>
Nous remarquons que les deux fonctions rattachées aux événements sont éxécutées deux fois, mais seulement une lorsque qu'on est à pied. On peut donc penser que le véhicule déclenche aussi les événements. Pour confirmer cette théorie , nous allons vérifier la variable ''player'' qui '''devrait''' contenir un ''élément joueur''.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- ajout d'un message de debugage avec le type de l'élément
outputDebugString("colShapeHit "..getElementType(player))
-- set a timer to output a message (could as well execute another function)
-- store the timer id in a table, using the player as index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- ajout d'un message de debugage avec le type de l'élément
outputDebugString("colShapeLeave "..getElementType(player))
-- kill the timer when the player leaves the colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

Le message de débugage nous informe que, l'une des variables ''player'' est un joueur, et que l'autre, est un véhicule. Si nous voulons éxecuter notre code seulement quand un joueur entre dans le ''colshape'', nous devons rajouter un ''if'' (condition) qui stoppera l'éxecution du code si ce n'est pas un joueur.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- add a check for the element type
if (getElementType(player) ~= "player") then return end
-- add a debug message, with the element type
outputDebugString("colShapeHit "..getElementType(player))
-- set a timer to output a message (could as well execute another function)
-- store the timer id in a table, using the player as index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- add a check for the element type
if (getElementType(player) ~= "player") then return end
-- add a debug message, with the element type
outputDebugString("colShapeLeave "..getElementType(player))
-- kill the timer when the player leaves the colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

Maintenant le code devrait fonctionner comme nous le souhaitions, mais nous avons toujours l'avertissement mentionné plus tôt. Cela est dû au fait que nous essayons d'arrêter un timer qui , quand le joueur est resté dans le colshape 10 secondes est éxecuté, n'existe plus. Il y a différentes façons de se débarasser de cet avertissement (si on part du principe qu'on sait qu'il n'existe plus à partir d'un certain moment et qu'on peut l'arrêter seulement si il ne s'est pas éxecuté).
Une des méthodes serait de vérifier si le timer stocker dans le tableau existe. Pour faire cela, nous devons utiliser [[isTimer]] avant d'arrêter le timer.

<syntaxhighlight lang="lua">
if (isTimer(colshapeTimer[player])) then
killTimer(colshapeTimer[player])
end
</syntaxhighlight>
Le code final ressemblerait à ceci:
<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- add a check for the element type
if (getElementType(player) ~= "player") then return end
-- add a debug message, with the element type
outputDebugString("colShapeHit "..getElementType(player))
-- set a timer to output a message (could as well execute another function)
-- store the timer id in a table, using the player as index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- add a check for the element type
if (getElementType(player) ~= "player") then return end
-- add a debug message, with the element type
outputDebugString("colShapeLeave "..getElementType(player))
-- kill the timer when the player leaves the colshape
if (isTimer(colshapeTimer[player])) then
killTimer(colshapeTimer[player])
end
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

==Debugging Performance Issues==

Si vous serveur utilise plus de ressource qu'il ne devrait ou si vous voulez vous assurez que votre code est efficace, vous pourrez trouver les brebis galeuses avec l'outil ''performancebrowser''. Pour le lancer taper dans votre console "start performancebrowser" si cette ressource n'exite pas assurer de bien la posséder à l'emplacement adequat. Cet outil fourni un bon nombre d'information sur le debugage de perfomance. Fuite de mémoire, perte d'éléments et utilisation intensive du CPU sont facilement décelable via cet outil. Si vous utilisez l'option -d vous pourrez voir quelles fonctions utilisent de manière excéssive le CPU.

Pour accèder au ''performancebrowser'' vous devez entrer cette adresse dans votre navigateur de recherche: http://serverIPHere:serverHTTPPortHere/performancebrowser/ Noterque le / à la fin est obligatoire. Donc par exemple: http://127.0.0.1:22005/performancebrowser/ . Ensuite, vous devez vous logguer en jeu avec un compte administrateur ou un compte ayant accès à la ressource "general.HTTP" . La plupart des informations dont vous aurez besoin se trouvent dans les catégories "Lua timing" et "Lua memory". Chercher les valeurs qui sont plus élevées que les autres.

===Exemples de code qui posent des problèmes de performances===

L'ajout de données à un tableau sans les supprimer ensuite, même si ça prendra quelques mois ou années avant de poser des problèmes.
<syntaxhighlight lang="lua">
local someData = {}

function storeData()
someData[source] = true
-- Rien ne gère le moment ou le joueur quitte le jeu, c'est donc considéré comme une perte de mémoire.
-- Using the Lua timing tab you can detect the RAM usage of each resource.
end
addEventHandler("onPlayerJoin", root, storeData)
</syntaxhighlight>

Element leaking is possible if you use temporary colshapes for whatever reason and may not destroy them. This would cause bandwidth, CPU and memory performance issues over time.
<syntaxhighlight lang="lua">
function useTemporaryCol()
local col = createColCircle(some code here)
if (normally this should happen) then
destroyElement(col)
end
-- But sometimes it didn't so the script ended but the collision area remained and over time
-- you may end up with hundreds to thousands of pointless collision areas.
-- The Lua timing tab allows you to see the amount of elements each script has created.
end
</syntaxhighlight>

High CPU usage resulting in the server FPS dropping so much that the server is unplayable. In under 24 hours this can create havoc on a very busy server. The amount of "refs" in the Lua timing detect this type of build up, surprisingly the Lua timing tab didn't help in this case but Lua memory did.
<syntaxhighlight lang="lua">
addEventHandler("onPlayerJoin", root, function()
-- Code for joiner
addEventHandler("onPlayerQuit", root, function()
-- Code for when they have quit
-- See the problem? It's bound to root which the event handler is being added again and again and again
end)
end)
</syntaxhighlight>

A function uses up a lot of your CPU because whatever it does takes a long time. This is just some function that takes a long time to complete. Without performancebrowser you'd have no idea its the cause but with performancebrowser you can see that a resource is using lots of CPU in the Lua timing tab. If you then enter: -d into the options edit box it will even tell you what file name and first line of the function that is using up so much CPU.
<syntaxhighlight lang="lua">
function someDodgyCode()
for i=1, 100000 do
-- some code
end
end
</syntaxhighlight>

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

FR/Debugage

2014-07-08T20:55:59Z

V1ncenzo: /* Astuces de Déboggage */

Quand vous scriptez vous pouvez passer à côté de certaines erreurs qui ne sont pas apparentes au premier coup d’œil. Cette page va essayer de vous indiquer quelques démarches à suivre pour localiser les erreurs.

==Console de Débogage==
MTA a pour caractéristique de posséder une console de débogage qui comme son nom l'indique vous permet de déceler les erreurs dans les fonctions et scripts. Vous pouvez l'ouvrir en tapant ''debugscript x'' dans la console, ici ''x'' est le niveau de débogage:
* '''1:''' seulement les erreurs
* '''2:''' erreurs et warnings
* '''3:''' erreurs, warnings et messages d'informations
Ainsi, en tapant ''debugscript 3'' tout les messages seront visibles, cependant le niveau 2 est recommandé la plupart du temps pour le débogage. Quand vous testez vos scripts vous devez avoir le ''debugscript'' à disposition , cela vous permettra de détecter facilement les fautes d'orthographes dans les fonctions ou toutes autres erreurs aussi simple.

===Exemple===
L'exemple ci-dessous contient deux erreurs:
<syntaxhighlight lang="lua">
if (getPlayerName(player) == "Fedor")
outputChatbox("Hello Fedor")
end
</syntaxhighlight>
Quand ce bout de code va être chargé, debugscript va vous renvoyer à peu près ceci:
{{Debug info|Loading script failed: C:\<server path>\mods\deathmatch\resources\myResource\script.lua:15: 'then' expected near ´outputChatbox'}}
Cela signifie que le code ne peut-être analysé/traité, car il y a une erreur de syntaxe. On vous montre le répertoire où se trouve le fichier, vous pouvez donc voir dans quelle ressource ce dernier se trouve ('myResource' dans notre cas) et bien sûr on vous donne le nom du fichier en question. Après le nom du fichier, on a le numéro de la ligne et encore après l'erreur/problème en question. C'est bien plus facile à résoudre maintenant, il manque juste 'then':
<syntaxhighlight lang="lua">
if (getPlayerName(player) == "Fedor") then
outputChatbox("Hello Fedor")
end
</syntaxhighlight>
A présent le bout de code se charge et ne renvoie aucune erreur, jusqu'à ce qu'un joueur avec le pseudo 'Fedor' fasse son apparition. Le debugscript va nous renvoyer alors:
{{Debug error|C:\<server path>\mods\deathmatch\resources\d\script.lua:15: attempt to call global 'outputChatbox' (a nil value)}}
Cela signifie que la fonction appelée n'existe pas, cela s'explique facilement par le fait que le nom de la fonction est ''outputChatBox'' (avec une capitale ''B''):
<syntaxhighlight lang="lua">
if (getPlayerName(player) == "Fedor") then
outputChatBox("Hello Fedor")
end
</syntaxhighlight>

Ceci n'est bien sûr qu'un exemple, il y a une multitude d'autres erreurs et problèmes, mais vous avez au moins une idée du débogage.

==Debug logging==
You can also turn debug message logging on by editing ''coreconfig.xml'' in your GTA\MTA folder. You should find the following tag:
<syntaxhighlight lang="xml"><debugfile/></syntaxhighlight>

Replace that with a tag specifying the file you want to log messages to (file path is relative from the GTA folder):
<syntaxhighlight lang="xml"><debugfile>MTA\debugscript.log</debugfile></syntaxhighlight>

All debug messages will be appended to the specified file from now on. To turn logging off, replace that line with an empty tag again.

==Debug strategies==
There are several strategies that support finding errors, apart from going through the code of course. Most of them include outputting debug messages, with differing information depending on the situtation.
Au lieu de foncer tête baisser dans votre code, il existe d'autres stratégies pour débusquer les erreurs. La plupart d'entres elles utilisent des messages/sorties (au niveau de la console) de déboggage qui sont différent suivant les situations.

===Fonctions Utiles===
Pour commencer, il y a quelques fonctions qui peuvent être utiles pour le ''débogage''.
* [[outputDebugString]] ou [[outputChatBox]] pour afficher des informations.
* [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] sur une variable pour la convertir en chaîne de caractères, par exemple lorsque c'est un booléen.
* [[getElementType]] pour vérifier le type d'un élément de MTA.

===Ajouter un message pour vérifier quand une condition ''if'', ''when'' ou ''how often'' est executée===
Un exemple typique qui vérifie si une condition ''if''est executée ou non. Il vous suffit d'ajouter un message que vous reconnaîtrez lorsqu'il s'affichera quand la condition sera executée.
<syntaxhighlight lang="lua">
if (variable1 == variable2) then
outputDebugString("Condition vérifiée")
-- Instruction
end
</syntaxhighlight>
Une autre pratique serait de vérifier quand est-ce que la valeur de la variable est modifiée. Il faut pour cela chercher le moment où la variable est modifiée et ajouter une fonction qui permet l'affichage d'un message juste après.

===Afficher un message pour vérifier la "valeur" d'une variable===
Prenons le cas ou vous voulez créer un checkpoint (marqueur), mais ce dernier n'apparaît pas à la position attendu. La première chose que vous allez faire sera de vérifier si la fonction [[createMarker]] est executée. Au lieu de faire ceci, vous pouvez vérifier les valeurs qui sont utilisées par la fonction [[createMarker]].
<syntaxhighlight lang="lua">
outputChatBox(tostring(x).." "..tostring(y).." "..tostring(z))
createMarker(x,y,z)
</syntaxhighlight>
Ce code aura pour conséquence de vous afficher un message avec les trois valeurs des variables qui sont utilisées en tant que coordonnées pour le marqueur. Vous pouvez maintenant comparer les valeurs obtenues avec celle désirées. Le [http://www.lua.org/manual/5.1/manual.html#pdf-tostring tostring()] vous permettra de vous assurer que les valeurs des variables seront transformées en "string" (chaîne de caractères), même si c'est un boléen.

==Exemple==
Imaginons que vous créiez un ''colshape'' (figure géométrique bi/tridimensionnelle pour détecter les collisions) quelque part et que vous souhaitiez qu'un joueur reste 10 secondes dans celle-ci avant d'éxecuter un code.
<syntaxhighlight lang="lua">
function colShapeHit(player)
-- défini un timer pour afficher un message (le timer peut très bien éxécuter une fonction)
-- stocke l'id du timer dans un tableau en utilisant le joueur (''player'') comme index/case.
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"Le joueur est depuis 10 secondes dans le colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- arrête le timer dès que le joueur quitte le colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>
Quand le joueur entre dans le colshape, le debugscript affiche le message suivant:
{{Debug error|..[path]: attempt to index global 'colshapeTimer' (a nil value)}}
Cela signifie que vous voulez stocker une valeur dans un tableau (à la case ''player'') qui n'existe pas. Dans l'exemple, le problème se pose quand vous voulez stocker l'id du timer dans le tableau. Nous devons donc vérifier si le tableau existe et si non en créer un.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- défini un timer pour afficher un message (le timer peut très bien éxécuter une fonction)
-- stocke l'id du timer dans un tableau en utilisant le joueur (''player'') comme index/case.
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"Le joueur est depuis 10 secondes dans le colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- arrête le timer dès que le joueur quitte le colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

Ceci fait il nous reste quand même un ''warning'' (avertissement).Attendez le message et quittez à nouveau le colshape:

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

À part ceci (nous en parlerons plus tard) tous semble bien fonctionner. Un joueur entre dans le ''colshape'', le timer se lance, si il reste un message s'affiche, si il quitte le ''colshape'' le timer est arrêté.

===Une erreur un peu plus complexe===
Cependant, pour une quelconque raison le message est envoyé deux fois quand on reste dans le cercle de collision alors qu'on est dans un véhicule. Since it would appear some code is executed twice, we add debug messages to check this.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- ajout d'un message de debugage
outputDebugString("colShapeHit")
-- set a timer to output a message (could as well execute another function)
-- store the timer id in a table, using the player as index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- ajout d'un message de debugage
outputDebugString("colShapeLeave")
-- kill the timer when the player leaves the colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>
Nous remarquons que les deux fonctions rattachées aux événements sont éxécutées deux fois, mais seulement une lorsque qu'on est à pied. On peut donc penser que le véhicule déclenche aussi les événements. Pour confirmer cette théorie , nous allons vérifier la variable ''player'' qui '''devrait''' contenir un ''élément joueur''.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- ajout d'un message de debugage avec le type de l'élément
outputDebugString("colShapeHit "..getElementType(player))
-- set a timer to output a message (could as well execute another function)
-- store the timer id in a table, using the player as index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- ajout d'un message de debugage avec le type de l'élément
outputDebugString("colShapeLeave "..getElementType(player))
-- kill the timer when the player leaves the colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

Le message de débugage nous informe que, l'une des variables ''player'' est un joueur, et que l'autre, est un véhicule. Si nous voulons éxecuter notre code seulement quand un joueur entre dans le ''colshape'', nous devons rajouter un ''if'' (condition) qui stoppera l'éxecution du code si ce n'est pas un joueur.

<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- add a check for the element type
if (getElementType(player) ~= "player") then return end
-- add a debug message, with the element type
outputDebugString("colShapeHit "..getElementType(player))
-- set a timer to output a message (could as well execute another function)
-- store the timer id in a table, using the player as index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- add a check for the element type
if (getElementType(player) ~= "player") then return end
-- add a debug message, with the element type
outputDebugString("colShapeLeave "..getElementType(player))
-- kill the timer when the player leaves the colshape
killTimer(colshapeTimer[player])
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

Maintenant le code devrait fonctionner comme nous le souhaitions, mais nous avons toujours l'avertissement mentionné plus tôt. Cela est dû au fait que nous essayons d'arrêter un timer qui , quand le joueur est resté dans le colshape 10 secondes est éxecuté, n'existe plus. Il y a différentes façons de se débarasser de cet avertissement (si on part du principe qu'on sait qu'il n'existe plus à partir d'un certain moment et qu'on peut l'arrêter seulement si il ne s'est pas éxecuté).
Une des méthodes serait de vérifier si le timer stocker dans le tableau existe. Pour faire cela, nous devons utiliser [[isTimer]] avant d'arrêter le timer.

<syntaxhighlight lang="lua">
if (isTimer(colshapeTimer[player])) then
killTimer(colshapeTimer[player])
end
</syntaxhighlight>
Le code final ressemblerait à ceci:
<syntaxhighlight lang="lua">
function colShapeHit(player)
if (colshapeTimer == nil) then
colshapeTimer = {}
end
-- add a check for the element type
if (getElementType(player) ~= "player") then return end
-- add a debug message, with the element type
outputDebugString("colShapeHit "..getElementType(player))
-- set a timer to output a message (could as well execute another function)
-- store the timer id in a table, using the player as index
colshapeTimer[player] = setTimer(outputChatBox,10000,1,"The player stayed 10 seconds in the colshape!")
end
addEventHandler("onColShapeHit",getRootElement(),colShapeHit)

function colShapeLeave(player)
-- add a check for the element type
if (getElementType(player) ~= "player") then return end
-- add a debug message, with the element type
outputDebugString("colShapeLeave "..getElementType(player))
-- kill the timer when the player leaves the colshape
if (isTimer(colshapeTimer[player])) then
killTimer(colshapeTimer[player])
end
end
addEventHandler("onColShapeLeave",getRootElement(),colShapeLeave)
</syntaxhighlight>

==Debugging Performance Issues==

Si vous serveur utilise plus de ressource qu'il ne devrait ou si vous voulez vous assurez que votre code est efficace, vous pourrez trouver les brebis galeuses avec l'outil ''performancebrowser''. Pour le lancer taper dans votre console "start performancebrowser" si cette ressource n'exite pas assurer de bien la posséder à l'emplacement adequat. Cet outil fourni un bon nombre d'information sur le debugage de perfomance. Fuite de mémoire, perte d'éléments et utilisation intensive du CPU sont facilement décelable via cet outil. Si vous utilisez l'option -d vous pourrez voir quelles fonctions utilisent de manière excéssive le CPU.

Pour accèder au ''performancebrowser'' vous devez entrer cette adresse dans votre navigateur de recherche: http://serverIPHere:serverHTTPPortHere/performancebrowser/ Noterque le / à la fin est obligatoire. Donc par exemple: http://127.0.0.1:22005/performancebrowser/ . Ensuite, vous devez vous logguer en jeu avec un compte administrateur ou un compte ayant accès à la ressource "general.HTTP" . La plupart des informations dont vous aurez besoin se trouvent dans les catégories "Lua timing" et "Lua memory". Chercher les valeurs qui sont plus élevées que les autres.

===Exemples de code qui posent des problèmes de performances===

L'ajout de données à un tableau sans les supprimer ensuite, même si ça prendra quelques mois ou années avant de poser des problèmes.
<syntaxhighlight lang="lua">
local someData = {}

function storeData()
someData[source] = true
-- Rien ne gère le moment ou le joueur quitte le jeu, c'est donc considéré comme une perte de mémoire.
-- Using the Lua timing tab you can detect the RAM usage of each resource.
end
addEventHandler("onPlayerJoin", root, storeData)
</syntaxhighlight>

Element leaking is possible if you use temporary colshapes for whatever reason and may not destroy them. This would cause bandwidth, CPU and memory performance issues over time.
<syntaxhighlight lang="lua">
function useTemporaryCol()
local col = createColCircle(some code here)
if (normally this should happen) then
destroyElement(col)
end
-- But sometimes it didn't so the script ended but the collision area remained and over time
-- you may end up with hundreds to thousands of pointless collision areas.
-- The Lua timing tab allows you to see the amount of elements each script has created.
end
</syntaxhighlight>

High CPU usage resulting in the server FPS dropping so much that the server is unplayable. In under 24 hours this can create havoc on a very busy server. The amount of "refs" in the Lua timing detect this type of build up, surprisingly the Lua timing tab didn't help in this case but Lua memory did.
<syntaxhighlight lang="lua">
addEventHandler("onPlayerJoin", root, function()
-- Code for joiner
addEventHandler("onPlayerQuit", root, function()
-- Code for when they have quit
-- See the problem? It's bound to root which the event handler is being added again and again and again
end)
end)
</syntaxhighlight>

A function uses up a lot of your CPU because whatever it does takes a long time. This is just some function that takes a long time to complete. Without performancebrowser you'd have no idea its the cause but with performancebrowser you can see that a resource is using lots of CPU in the Lua timing tab. If you then enter: -d into the options edit box it will even tell you what file name and first line of the function that is using up so much CPU.
<syntaxhighlight lang="lua">
function someDodgyCode()
for i=1, 100000 do
-- some code
end
end
</syntaxhighlight>

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