Multi Theft Auto: Wiki - User contributions [en]

GTA3:MTA 0.5

2009-08-29T09:06:26Z

Winky: Fixed MTA SA link

GTA3:MTA 0.5 is part of Multi Theft Auto 0.5, which is currently the latest MTA release for GTA3 and Vice City. It was the last version of MTA to utilise the old 0.3 core. [[Deathmatch_Client_Manual|Multi Theft Auto: San Andreas]] and all future releases will use the new [[Blue]] core.

It includes three deathmatch game maps:

* [[GTA3_SSV|Shoreside Vale]]
* [[GTA3_Staunton|Staunton Island]]
* [[GTA3_Portland|Portland]]

It is compatible with [[MTA_Addons|MTA:mA v3]].

[[Category: MTA 0.5]]

GTA3:MTA 0.5

2009-08-29T09:04:30Z

Winky: Added to category MTA 0.5

GTA3:MTA 0.5 is part of Multi Theft Auto 0.5, which is currently the latest MTA release for GTA3 and Vice City. It was the last version of MTA to utilise the old 0.3 core. [[MTA:SA_r1|Multi Theft Auto: San Andreas]] and all future releases will use the new [[Blue]] core.

It includes three deathmatch game maps:

* [[GTA3_SSV|Shoreside Vale]]
* [[GTA3_Staunton|Staunton Island]]
* [[GTA3_Portland|Portland]]

It is compatible with [[MTA_Addons|MTA:mA v3]].

[[Category: MTA 0.5]]

MTA:VC 0.5

2009-08-29T09:03:55Z

Winky: Added to category MTA 0.5

MTA:VC 0.5 is part of Multi Theft Auto 0.5, which is currently the latest MTA release for GTA3 and Vice City. It was the last version of MTA to utilise the old 0.3 core. [[MTA:SA_r1|Multi Theft Auto: San Andreas]] and all future releases will use the new [[Blue]] core.

It includes two game modes:

* [[Stunt_mode|Stunt Mode]]
* [[Deathmatch_Mode_VC|Deathmatch]]

It is compatible with [[MTA_Addons|MTA:mA v3]].

[[Category: MTA 0.5]]

GTA3:MTA 0.5 Known Issues

2009-08-29T09:01:43Z

Winky:

__NOTOC__

This applies to GTA:MTA 0.5, the known issues for MTA:SA 1.x can be found [[Known_Issues_-_FAQ | here]].

'''Newest Known Issues are at the bottom of this page'''

''Server Admins: Ensure you have downloaded and installed Patch 1 available [http://multitheftauto.com/mta05/download.php#server_sp1_download here.]''

=== Linux servers have a default MOTD set ===
Change the url or remove it when you first run the server

=== Linux servers have a default admin password set ===
Change the password before you first run the server

=== In-game MOTDs appear as nonsense ===
We noticed this during testing but it wasn't fixed. We'll fix it in the future. In the meantime, disable the MOTD by changing your mtaserver.conf (server admins) and use the rich motd instead.

=== Australian and German EXEs (and possibly others) may produce an "invalid executable" error when you try to start a game ===
As Australian and German EXEs don't work reliably with MTA, this shouldn't be a huge problem. Try to obtain a standard EXE.

=== Sometimes the url of the Rich MOTD is appended to the server name when it appears in the client ===
''Fixed in server patch 1''

This is caused by server names that are greater than 49 characters in length. Please try to keep them less than this to avoid this happening.

=== Server's memory usage increases very quickly ===
''Fixed in server patch 1''

We've fixed the memory leak that was causing this, and we'll be releasing a fix for it shortly. We've also fixed some other minor leaks that have existed since 0.4 (and earlier) so it should be better in general on that front.

=== Crash when GTA3 is loading ===
Make sure you run GTA3 at least once in Single Player without MTA before actually running it with MTA.

=== Freeze when client tries to display dialog asking for game path ===
There have been a couple of occurence of this, and we'd be interested to see why this is. You can avoid it by manually setting the path in the mta.ini in your game folder (not windows folder anymore). If you have this problem, can you please create a system info profile (Start -> Run -> "systeminfo > c:\sysinfo.txt") (no quotes) then email me the file sysinfo.txt on your c: drive (email is eAi[at]opencoding[dot]net).

For GTA3, your mta.ini should contain (replace the path if necessary):
[Game-GTA3]
Version=1
Location=C:\Program Files\Rockstar Games\GTAIII\gta3.exe

=== Your client times out as soon as you connect to a server. Players all time out when they connect to your server ===

This has been an unknown problem for quite some time now, but it seems it is caused not by MTA or the MTA Server but by MTAMA, or more specifically scripts running on it. If the scripts send multiple messages to the player when they join it is highly likely to time them out. This results in nobody being able to play.

For now a fix is available for MTAMA [http://forum.mtavc.com/viewtopic.php?p=181919#181919 HERE] (hopefully GRS will also be updated soon)

Please follow Aeron's instructions regarding its use.

A big thank you to Mike for discovering the cause of this problem and Aeron for getting a fix out so quickly.

=== Server Name Length ===
''Fixed in server patch 1''

It seems that if a Server Name is set too high then Clients and Admins cannot connect to the Server (even though it starts correctly).

=== Crash on client startup ===
This might be causes by being unable to download the welcome message. This should only happen if the MTA site is down, or you aren't connected to the internet. If this is the case, it should try to download it for about 15 seconds - before it gives the crash. It might be possible to fix this by adding "DontGetLatest=1" on the second line of your "mta.ini" in your MTA folder (under "[Main]"). Alternatively, try creating a blank file called "mtaclientwelcome.dat" in your MTA folder - this is probably only relevant if this is the first time you've run the MTA 0.5 client.
Update: We've managed to replicate, confirm and fix this bug. Whenever we release a general patch, this will be fixed. In the meantime, ensure mtaclient.exe can access the internet through your firewall, or for on a LAN you can change the following value in mta.ini .
DontGetLatest=1

=== XFire crashes game during loading ===
Both XFire and MTA use similar methods for integrating themselves into the game. We've contacted XFire to offer our support for them in implementing it, so that it works, but they don't respond. If you wish to use XFire in MTA, contact XFire. In the meantime, disable Xfire before you play.

=== MTA says you have a trainer but you don't ===
Try closing every other open window first. If that doesn't work, try uninstalling, then reinstalling MTA 0.5 again.

'''Update:''' It has been reported that "Kaspersky Anti Hacker" can set off this error. We advise that you close "Kaspersky Anti Hacker" if you wish to play MTA 0.5.

=== You join a server and are told you are banned, even though you aren't in the ban list ===
We're not sure what causes this, if anyone has any idea, please contact me (or someone else on the team). Of course, you may be banned by a over-general ban in the server's ban list.

=== GTA3 Shoreside Vale: Two players and two vehicles appear on the character select screen, followed shortly by a crash ===
We've only seen this occur a few times (once to me during beta) and we'll try to fix it. If someone who has this crash can tell me their crash ID (the error reporter should tell you), it'd help a lot.

=== Server: Attempting to connect to a server with Admin enabled and Admin + disabled, using admin+ causes the server to crash ===
''Fixed in server patch 1''

This has been fixed and will be in the server patch 1. In the meantime, either disable Admin entirely, or enable Admin+. Remember to change the password for admin+ and admin from their defaults.

=== MTAMA (mirc admin) times out when you try to connect to a server ===
Fixed in server patch 1''
This ia a bug in mIRC. We've fixed the issue that was triggering the bug in mIRC and we'll be releasing the fix along with the next server update.

=== Your server doesn't appear in the server list, or appears as "unscanned" ===
This isn't an issue, but ensure that you have the correct port open for ASE to query through. This should be your server port plus 123. For example, with the default port of 2003, port 2126 should be open. This is UDP.

=== You recieve the error "ERROR: The ServerName, ServerPort, GameMap, GameHour, GameMins, Weather and BannedFile MUST be specified in the configuration file" when you run your server, and all fields are filled in Only under Server Patch 1 ===
Ensure that your server name is 49 characters or less. This is a missleading error, we'll fix it in the server patch 1.

=== Client crashes when you join a server ===
''Fixed in next client release''

This crash may be caused by the client trying to download the rich text MOTD specified by the server and failing (e.g. the site its trying to get it from is down, or the URL is invalid). If this happens, the client will crash.

=== You have quite a few files on your computer called mtachat.txt ===
MTAchat.txt, as you probably guessed stores a chat log. This feature was added at the last moment and not propperly tested. Concequently, this problem has occured. This is probably due to how the client has been launched (the start path determines where it saves the chat, not the install path). Don't worry about it really.... We'll fix it in the next client version if we can. In the meantime, feel free to delete any files you don't want.

=== You recieve an error "System Error &H80070583 (-2147023485)" (or similar) when running the server config tool (or clicking "Setup Server" in the client) ===
This can be fixed by deleting the file called "MTAServerConfigTool.exe.manifest" in your Multi Theft Auto install folder.

=== Upon hitting Start Game the client informs you your CLIENT is modifed. ===
This is an error with the way we temporarily replace some of the games files. When you install take a back up of both weapon.dat and weapon.mta from the /gta?/data/ directory and put them somewhere safe. If you get this error close the client, REPLACE both files and retry.

=== An error appears that begins with "<font face="Arial" size=2>". ===
This means that an error has occured, but the error reporter system is overloaded and can't be sent the error report. Just click the button and ignore it.

=== When playing GTA3 you recieve an "Invalid Executeable" error ===
This is probably because you are using GTA3 version 1.0 instead of 1.1. You can get the GTA3 1.1 patch [http://www.take2games.com.au/index.php?p=support&product=121,3,Grand%20Theft%20Auto%203,PC,Rockstar_Games,gta3&section=patches here]. If this doesn't work, or you already have GTA3 1.1, check you have the USA/UK exe. If not, try to obtain one.

=== Your virus scanner informs you that the Multi Theft Auto 0.5 executeable is a virus or malware ===
MTA does not contain any viruses, malware, adware or spyware. If your virus scanner informs you that it is infected, either you have a virus on your computer that is infecting your files, or one of our mirrors has been infected with a virus or your virus scanner is making a mistake. McAfee has been known to make this mistake. We've informed NAI of this, but they've yet to fix it. In the meantime, disable your virus scanner while playing. Also, ensure you only download from this site. This link is hosted by our webhost. Use this if you doubt the validity of your copy of MTA.

[[Category:MTA 0.5]] [[Category:GTA 3]] [[Category:Historical]]

MTA 0.5 Known Issues

2009-08-29T09:00:50Z

Winky: Category MTA 0.5 added to article

__NOTOC__

This applies to MTA:VC 0.5, the known issues for MTA:SA 1.x can be found [[Known_Issues_-_FAQ | here]].

'''Newest Known Issues are at the bottom of this page'''

''Server Admins: Ensure you have downloaded and installed Patch 1 available [http://multitheftauto.com/mta05/download.php#server_sp1_download here.]''

=== Linux servers have a default MOTD set ===
Change the url or remove it when you first run the server

=== Linux servers have a default admin password set ===
Change the password before you first run the server

=== In-game MOTDs appear as nonsense ===
We noticed this during testing but it wasn't fixed. We'll fix it in the future. In the meantime, disable the motd by changing your mtaserver.conf (server admins) and use the rich motd instead.

=== Australian and German EXEs (and possibly others) may produce an "invalid executable" error when you try to start a game ===
As Australian and German EXEs don't work reliably with MTA, this shouldn't be a huge problem. Try to obtain a standard EXE.

=== The in-game help says the game is MTA 0.4, when it clearly is MTA 0.5 ===
Live with it

=== Sometimes the url of the Rich MOTD is appended to the server name when it appears in the client ===
''Fixed in server patch 1''

This is caused by server names that are greater than 49 characters in length. Please try to keep them less than this to avoid this happening.

=== Server's memory usage increases very quickly ===
''Fixed in server patch 1''

We've fixed the memory leak that was causing this. We've also fixed some other minor leaks that have existed since 0.4 (and earlier) so it should be better in general on that front.

=== Crash when Vice City is loading ===
Make sure you run Vice City at least once in Single Player without MTA before actually running it with MTA.

=== Freeze when client tries to display dialog asking for game path ===
There have been a couple of occurence of this, and we'd be interested to see why this is. You can avoid it by manually setting the path in the mta.ini in your game folder (not windows folder anymore). If you have this problem, can you please create a system info profile (Start -> Run -> "systeminfo > c:\sysinfo.txt") (no quotes) then email me the file sysinfo.txt on your c: drive (email is eAi[at]opencoding[dot]net).

For Vice City, your mta.ini should contain (replace the path if necessary):
[Game-VC]
Version=0
Location=C:\Program Files\Rockstar Games\Grand Theft Auto Vice City\gta-vc.exe

=== Your client times out as soon as you connect to a server. Players all time out when they connect to your server ===

This has been an unknown problem for quite some time now, but it seems it is caused not by MTA or the MTA Server but by MTAMA, or more specifically scripts running on it. If the scripts send multiple messages to the player when they join it is highly likely to time them out. This results in nobody being able to play.

For now a fix is available for MTAMA [http://forum.mtavc.com/viewtopic.php?p=181919#181919 HERE] (hopefully GRS will also be updated soon)

Please follow Aeron's instructions regarding its use.

A big thank you to Mike for discovering the cause of this problem and Aeron for getting a fix out so quickly.

=== Server Name Length ===
''Fixed in server patch 1''

It seems that if a Server Name is set too high then Clients and Admins cannot connect to the Server (even though it starts correctly).

=== Crash on client startup ===
This might be causes by being unable to download the welcome message. This should only happen if the MTA site is down, or you aren't connected to the internet. If this is the case, it should try to download it for about 15 seconds - before it gives the crash. It might be possible to fix this by adding ''"DontGetLatest=1"'' on the second line of your "mta.ini" in your MTA folder (under "[Main]"). Alternatively, try creating a blank file called "mtaclientwelcome.dat" in your MTA folder - this is probably only relevant if this is the first time you've run the MTA 0.5 client.

'''Update:''' We've managed to replicate, confirm and fix this bug. Whenever we release a general patch, this will be fixed. In the meantime, ensure mtaclient.exe can access the internet through your firewall, or for on a LAN you can change the following value in mta.ini:
DontGetLatest=1

=== XFire crashes game during loading ===
Both XFire and MTA use similar methods for integrating themselves into the game. We've contacted XFire to offer our support for them in implementing it, so that it works, but they don't respond. If you wish to use XFire in MTA, contact XFire. In the meantime, disable Xfire before you play.

=== MTA says you have a trainer but you don't ===
Try closing every other open window first. If that doesn't work, try uninstalling, then reinstalling MTA 0.5 again. It has also been reported that changing game version from 1.0 to 1.1 (Vice City) can fix this, though we're not sure why - we're looking into it. Further Update: All the error reports that have come in about this are using Vice City 1.0. Try updating to 1.1, if this _doesn't_ work, contact me.

Update: It has been reported that "Kaspersky Anti Hacker" can set off this error. We advise that you close "Kaspersky Anti Hacker" if you wish to play MTA 0.5.

=== If you try to spawn as a Crusader twice, you get disconnected for trainer usage ===
We'll fix this issue in the next release, in the meantime, avoid using the crusader.

=== You join a server and are told you are banned, even though you aren't in the ban list ===
We're not sure what causes this, if anyone has any idea, please contact me (or someone else on the team). Of course, you may be banned by a over-general ban in the server's ban list.

=== In Vice City Stunt, RC vehicles can appear locked when you try to enter them ===
Stand directly in the middle of the RC vehicle (they aren't solid to cars or humans) and press the enter button. You should appear in the RC car.

=== Server: Attempting to connect to a server with Admin enabled and Admin + disabled, using admin+ causes the server to crash ===
''Fixed in Server Patch 1''

This has been fixed and is in the server patch 1. In the meantime, either disable Admin entierly, or enable Admin+. Remember to change the password for admin+ and admin from their defaults.

=== Vice City crashes when you try to get on a bike as passenger when it has no driver ===
This has existed as a problem ever since MTA first came out, I'm not sure if we'll bother to fix it. 3.4% of crashes we've logged are caused by this, so it may be worthwhile.

=== MTAMA (mirc admin) times out when you try to connect to a server ===
''Fixed in Server Patch 1''

This is a bug in mIRC. We've fixed the issue that was triggering the bug in mIRC and we'll be releasing the fix along with the next server update.

=== Your server doesn't appear in the server list, or appears as "unscanned" ===
This isn't an issue, but ensure that you have the correct port open for ASE to query through. This should be your server port plus 123. For example, with the default port of 2003, port 2126 should be open. This is UDP.

=== You recieve the error "ERROR: The ServerName, ServerPort, GameMap, GameHour, GameMins, Weather and BannedFile MUST be specified in the configuration file" when you run your server, and all fields are filled in ''Only under Server Patch 1'' ===
Ensure that your server name is 49 characters or less. This is a missleading error, we'll fix it in the server patch 1.

=== Client crashes when you join a server ===
''Fixed in next client release''

This crash may be caused by the client trying to download the rich text MOTD specified by the server and failing (e.g. the site its trying to get it from is down, or the URL is invalid). If this happens, the client will crash.

=== You have quite a few files on your computer called mtachat.txt ===
MTAchat.txt, as you probably guessed stores a chat log. This feature was added at the last moment and not propperly tested. Concequently, this problem has occured. This is probably due to how the client has been launched (the start path determines where it saves the chat, not the install path). Don't worry about it really.... We'll fix it in the next client version if we can. In the meantime, feel free to delete any files you don't want.

=== You recieve an error "System Error &H80070583 (-2147023485)" (or similar) when running the server config tool (or clicking "Setup Server" in the client) ===
This can be fixed by deleting the file called "MTAServerConfigTool.exe.manifest" in your Multi Theft Auto install folder.

=== Upon hitting Start Game the client informs you your CLIENT is modifed. ===
This is an error with the way we temporarily replace some of the games files. When you install take a back up of both weapon.dat and weapon.mta from the /gta?/data/ directory and put them somewhere safe. If you get this error close the client, REPLACE both files and retry.

=== An error appears that begins with "<font face="Arial" size=2>". ===
This means that an error has occured, but the error reporter system is overloaded and can't be sent the error report. Just click the button and ignore it.

=== Your virus scanner informs you that the Multi Theft Auto 0.5 executeable is a virus or malware ===
MTA does not contain any viruses, malware, adware or spyware. If your virus scanner informs you that it is infected, either you have a virus on your computer that is infecting your files, or one of our mirrors has been infected with a virus or your virus scanner is making a mistake. McAfee has been known to make this mistake. We've informed NAI of this, but they've yet to fix it. In the meantime, disable your virus scanner while playing. Also, ensure you only download from this site. This link is hosted by our webhost. Use this if you doubt the validity of your copy of MTA.

=== You get a crash at the address 652f30 when starting the game ===
This is caused by having the incorrect GXT file. To fix this, copy all the gxt files from the Grand Theft Auto Vice City\TEXT folder except the "american.gxt" into the Grand Theft Auto Vice City\MTA folder. You should also ensure you game language is set to english.

[[Category:Vice_City]]
[[Category:MTA_0.5]]

SetCameraMatrix

2009-06-21T19:56:14Z

Winky: Added the forgotten []

__NOTOC__
{{Server client function}}
This function sets the camera's position and direction. The first three arguments are the point at which the camera lies, the last three are the point the camera faces (or the point it "looks at").

'''Note:''' Calling this function takes the camera's focus away from the player and sets the camera in a fixed position and rotation. The camera's focus can be brought back to the player using the [[setCameraTarget]] function.
==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool setCameraMatrix ( player thePlayer, float positionX, float positionY, float positionZ [, float lookAtX, float lookAtY, float lookAtZ ] )
</syntaxhighlight>

===Required Arguments===
*'''thePlayer:''' The player whose camera is to be changed.
*'''positionX:''' The x coordinate of the camera's position.
*'''positionY:''' The y coordinate of the camera's position.
*'''positionZ:''' The z coordinate of the camera's position.

===Optional Arguments===
*'''lookAtX:''' The x coordinate of the point the camera faces.
*'''lookAtY:''' The y coordinate of the point the camera faces.
*'''lookAtZ:''' The z coordinate of the point the camera faces.
</section>

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
bool setCameraMatrix ( float positionX, float positionY, float positionZ [, float lookAtX, float lookAtY, float lookAtZ ] )
</syntaxhighlight>

===Required Arguments===
*'''thePlayer:''' The player whose camera is to be changed.
*'''positionX:''' The x coordinate of the camera's position.
*'''positionY:''' The y coordinate of the camera's position.
*'''positionZ:''' The z coordinate of the camera's position.

===Optional Arguments===
*'''lookAtX:''' The x coordinate of the point the camera faces.
*'''lookAtY:''' The y coordinate of the point the camera faces.
*'''lookAtZ:''' The z coordinate of the point the camera faces.
</section>

===Returns===
Returns ''true'' if the arguments are valid, ''false'' otherwise.

==Example==
This code fixates the camera onto the Vinewood sign in Las Venturas for any player that joins the server:
<section class="server" name="Server script" show="true">
<syntaxhighlight lang="lua">
function setCameraOnPlayerJoin()
-- slowly fade the camera in to make the screen visible
fadeCamera(source, true, 5)
-- set the player's camera to a fixed position, looking at a fixed point
setCameraMatrix(source, 1468.8785400391, -919.25317382813, 100.153465271, 1468.388671875, -918.42474365234, 99.881813049316)
end
addEventHandler("onPlayerJoin", getRootElement(), setCameraOnPlayerJoin)</syntaxhighlight>
</section>

==See Also==
{{Camera functions}}

TextDisplayGetObservers

2009-06-21T19:40:29Z

Winky: not complete yet

__NOTOC__
{{Server function}}

==Syntax==
<syntaxhighlight lang="lua">--TODO</syntaxhighlight>

===Required Arguments===

===Returns===

==See Also==
{{Text functions}}

[[Category:incomplete]]
[[Category:Needs Example]]

Template:Elements

2009-06-21T19:31:56Z

Winky: Added ped element

* [[Element/Player|Player]]
* [[Element/Ped|Ped]]
* [[Element/Vehicle|Vehicle]]
* [[Element/Object|Object]]
* [[Element/Pickup|Pickup]]
* [[Element/Marker|Marker]]
* [[Element/Collision shape|Collision shape]]
* [[Element/Blip|Blip]]
* [[Element/Radar area|Radar area]]
* [[Element/Projectile|Projectile]]
* [[Element/Team|Team]]
* [[Element/Console|Server console]]
* [[Element/Admin|Remote admin]]
* [[GUI widgets]]:
<ul>{{GUI_widgets}}</ul>
* [[Element/TXD|TXD]]
* [[Element/DFF|DFF]]
* [[Element/COL|COL]]
* [[Element/Sound|Sound]]

Element/Console

2009-06-21T19:29:13Z

Winky:

The Server Console class represents the server console.

The element type of this class is '''"console"'''.

[[Category:Incomplete]]
[[Category:Element Types]]

Element/Console

2009-06-21T19:28:11Z

Winky: New page: The Console class represents the server console. The element type of this class is '''"console"'''. Category:Incomplete Category:Element Types

The Console class represents the server console.

The element type of this class is '''"console"'''.

[[Category:Incomplete]]
[[Category:Element Types]]

Known Issues - FAQ

2009-06-21T08:26:06Z

Winky: Linked to the map editor FAQ

Post here your proposed Q&A, regarding the known problems with MTA:SA and their solutions, especially the problems we are encountering now, that might be also encountered by users in the final release. You're also welcome to edit them grammar/style wise.

[[Resource:Editor#FAQ|Map editor FAQ/known issues can be found here.]]

== Client ==

=== General ===
==== Does MTASA work with v1.01 or v2.00 of GTA San Andreas? ====
No. It can be made to work with them however - please see [http://forum.mtavc.com/viewtopic.php?t=15151 this forum topic] for instructions on patching the exe.

==== The game says it cannot locate the map editor ====
Map editor for MTA: Deathmatch is not available for Developer Preview 2. It is available as an optional download for 1.0-based nightly builds however, and will be available by default on MTA:SA 1.0 final build.
For instructions on how to get a nightly build, see [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 our Google Code page]

See also: [[Resource:Editor|Main article about Map Editor]]

==== Initial black screen/hanging GTA splash screens ====
* '''MTA shows a permanent black screen or hanging GTA splash screens.'''

It may be necessary that during/after the logo splash screens in Grand Theft Auto you have to give some input in order to skip the videos correctly. Try to click your left-mouse button a few times, or tapping a few keys.

* '''MTA shows a permanent black screen after the GTA splash screens (possibly with text in the bottom right corner).'''

This can be related to a lack of support for DirectX or video card features, on your system, which are needed to run the dynamically rendered menu. This dynamic menu is enabled by default. You can disable it by opening your [[coreconfig.xml]] configuration file located in the ''GTA San Andreas\MTA'' directory, and changing the value of ''menu_options'' to ''248''.

==== Halt after MTA splash screen ====
* '''Nothing happens after the 'Stop playing with yourself' splash screen'''

If you use nVidia GeForce, try turning off nView Desktop Manager before starting MTA.

Also try deleting GTA San Andreas settings file ("gta_sa.set") in "Documents\GTA San Andreas User Files" folder

==== Crash after MTA splash screen ====
* '''MTA crashes after the 'Stop playing with yourself' logo. Both single player and the MTA: Race ran fine before.'''

Try downloading the latest DirectX Runtime files from [http://www.microsoft.com/downloads/details.aspx?FamilyID=2da43d38-db71-4c1b-bc6a-9b6652cd92a3&DisplayLang=en Microsoft]. Also check in Task Manager, if gta_sa.exe process isn't already running.

If you run at any substandard resolutions (e.g. 960x720), try to change your resolution to a commonly supported one (e.g. 640×480, 800×600, 1024×768, 1152×864, 1280×1024) by launching Grand Theft Auto: San Andreas in normal mode, setting the new resolution and exiting.

==== Assertion in CMainMenu.cpp line 106 upon launching MTASA ====
* '''I'm getting an assertion in CMainMenu.cpp (line 106) after I have launched MTASA. I'm able to ignore it, but then game crashes after I try to connect to a server.'''

This is likely caused by GTASA or MTA:SA being installed in a path that contains non-ASCII characters (eg. Cyrillic, Polish, Japanese) in it.

To resolve this, you need to uninstall MTA:SA and GTASA, then install them in such paths that don't contain such characters.

==== Crash after connecting to any server ====
* '''MTASA crashes upon connecting to any server. Single player runs fine.'''

Single player mods can affect the way MTA:SA works, potentially causing crashes - you should always use a clean GTASA install for MTA:SA.

This might also occur on non-modded installs, when your GTASA executable is in an unsupported by MTA:SA version (eg. 1.0 German or Australian). To resolve this, use [http://forum.multitheftauto.com/viewtopic.php?f=89&t=15151 our converter].

==== Controls not working ====
* '''My controls don't seem to work as they should.'''

Try using the 'copygtacontrols' command in the console.

==== Incorrect models ====
* '''Woman model's breasts look awkward ingame / I'm seeing odd, spider-like shaped player models.'''

This is caused by the way GTA handles player stats. To fix this, be sure to set both fat and muscles player stats to 0, when you're changing player skin.

==== Incorrect drive-by functionality ====
* '''Drivebys arent working as they should'''

Drivebys are handled by script, and will change depending on the loaded gamemode.

==== Unsaved settings ====
* '''My MTA setting(s) didn't get saved (...) I crashed.'''

First, configure the MTA the way you want to, then exit the game and launch it again. Settings should get saved. Alternatively, try removing the coreconfig.xml file, then configure it and quit the game.

==== Gamepad support ====
* '''MTA doesn't recognise my gamepad'''

In DP2, this is a known issue - MTA's keybinds system does not support direct input. As an alternative, [http://xpadder.com/ XPadder] can be used. This emulates joypad buttons as keyboard/mouse so that it can be used in MTA. Please refer to [http://forum.mtasa.com/viewtopic.php?f=87&t=21167 this forum topic] for a brief guide on how to use XPadder.

'''This is no longer an issue in MTASA 1.0 (neither nightlies nor final) however, as we have introduced an initial support for gamepads there.''' You can configure your gamepad in options in MTASA's main menu. If for some reason it doesn't work right, please [http://bugs.mtasa.com inform us about it].

==== Free mouselook not working properly ====
* '''MTA doesnt recognise my mouse'''

Some people got problems with their mouse in MTA. They can use it in the menu, connect to a server, but they can't use the mouse for free look.
This problem can be solved by entering a server, click your Win/Windows key at your keyboard once, and then click your mouse.
If that doesn't work try starting GTA in Singleplayer, go to options > controler setup and set "Configuration" to "Mouse + Keys" instead of "Joypad".

==== Sky flickering ====
* '''My screen/sky flickers when weather or sky effects are enabled.

MTA:SA DM uses a new text rendering system from race, which is much more efficient in terms of FPS. However, this can cause conflicts within the game, particularly with ATI based cards. To fix this, bring up the console with F8, and type the command '''ceguitext 1'''. This reverts the rendering method to that of Race. All glitches should no longer happen, at the cost of lower FPS.

==== Server browser not working ====
* '''The in-game server browser shows "Loading" but does not come up with any servers'''

Depending on the type and status of the internet connection you are using, it can take up to a few seconds for the server browser to retrieve all the servers. Please wait a little longer for the results to appear.

==== Invalid serial number ====
* '''I am getting an 'Invalid serial number' error when trying to launch or play the game'''

You are running an outdated version of Multi Theft Auto. Head over to the [http://www.mtasa.com/deathmatch.html download page] and download the latest version of Multi Theft Auto.

==== 'Network module could not be located' ====
* '''I am getting 'Network module could not be located' error message upon launching MTA:SA DM

Copy the file 'net.dll' from your GTA:SA/mta directory into your GTA:SA directory, overwriting existing files.

==== 'Network module not compatible!' on MTASA launch ====
* '''I am getting 'Network module not compatible!' error message upon launching MTA:SA DM

This could mean that your MTASA install is incomplete or broken. Reinstall it.

==== 'No such mod installed (deathmatch)' ====
* '''I am getting a 'No such mod installed (deathmatch)' error message when trying to connect to any server

'''Option 1:''' Simply re-install MTA. <br>
'''Option 2:''' Run both gta_sa.exe and Multi Theft Auto.exe with administrator privileges.

==== D3dx9_**.dll is not found ====
* '''When I start Multi Theft Auto: San Andreas I am getting an error D3dx9_**.dll (** = a number) cannot be found.

This means that DirectX 9 is not installed or not up to date.
To install/update DirectX download the [http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=2da43d38-db71-4c1b-bc6a-9b6652cd92a3 DirectX End-User Runtime Web Installer] from the Microsoft download site.

=== Windows Vista®-related ===

==== Crash on launch ====
* '''I've successfully upgraded from MTA Race to MTASA DM on Vista, but it seems to crash on launch.

'''Option 1''' Go to your Program Files\MTA San Andreas\mods\race directory, and rename client.dll to something else. <br>
'''Option 2''' Go to your Grand Theft Auto: San Andreas directory (usually Program Files\Rockstar Games\GTA San Andreas"), navigate to the MTA directory, then enter the "data" directory and remove the menu.mkv file. This will start Multi Theft Auto: San Andreas without main menu video rendering.

==== Crash on connect ====
* '''I seem to crash whenever I connect to a server just before I go in-game on Vista'''

This seems to be an issue with the Microsoft DirectX April 2006 SDK Redistributable DLL file (d3dx9_30.dll) when running in compatibility mode. Please make sure that compatibility mode is competely turned off for '''both''' your GTA_SA.exe and Multi Theft Auto.exe executables.

==== Invalid or disabled serial error ====
* '''MTASA DM installer complains about wrong serial provided. I'm running it for the first time.

You need to run the installer with Administrator privileges. To do so, right click on the installer executable, choose 'Properties', go into 'Compatibility' tab and tick the check box on the last field.

Some have found that setting compatibility to Windows XP/2000 have fixed the problem.

If User Account Control is disabled, you might need to enable it and run the installer with admin privileges (like said above) in order to install MTA:SA DM.

*'''I am getting 'invalid serial' when I try to connect to a server'''
After some research we have found that in most cases this problem occurs if registry data has not been set for some reason. To fix this problem, take the following steps:

Open regedit (start > run > regedit)<br>
Go to HKEY_LOCAL_MACHINE\SOFTWARE\Multi Theft Auto: San Andreas<br>
Create a new string key called Username and fill there the username you have on mtabeta.com<br>
Create one more string key called Serial and paste there the serial from mtabeta.com<br>

If you have no serial at http://community.mtasa.com (mtabeta.com) to complete the last step, register on our forums and request one [http://forum.mtasa.com/viewtopic.php?f=89&t=21435&p=269057 here]

*'''I am getting 'disabled serial' when I try to connect to a server'''
If you receive this message, your serial has been banned (most likely for cheating). There is nothing you can do to fix this. Registering a new account does not unban you.

==== Clock manipulation error ====
* '''I am getting 'Clock manipulation detected!' error message upon launching MTA:SA DM

This is caused by incorrect system date/time being set (which could be a result of wrong settings or a faulty battery on the pc's motherboard). Setting time and date again should fix the problem.

It might also happen if you are using an AMD Athlon 64 X2 processor with some old drivers. Update them at [http://support.amd.com/us/Pages/drivers.aspx AMD's site].

==== Halt on launch ====
* '''When I launch MTA:SA DM, nothing happens (GTA_SA.exe is running but not loading up)

Run MTA:SA DM with Administrator privileges. To do this, right click on the installer executable, choose 'Properties', go into 'Compatibility' tab and tick the check box on the last field and try again.

==== General GTA problems ====
* '''I have unexplainable GTA problems or crashes'''

Make sure your computer as well as your GTA install meet the [[Deathmatch_Client_Manual#System_requirements|minimum requirements]] and that you are not running in any 98/2000/XP/2003 compatibility modes.

Also try the solutions from these pages:
* http://www.gtaforums.com/index.php?showtopic=273549&view=findpost&p=4537502
* http://pullmonkey.com/2007/4/30/how-i-got-gta-san-andreas-to-work-with-a-crappy-os-vista

== Server ==

=== General ===
==== Fatal error 3 ====
* '''I'm getting ''Fatal Error 3'' whenever I connect to my server'''

This error happens when the server you are trying to connect to is unable to provide you the required downloads, because it does not have http downloading enabled. Be sure to set the '''httpdownload''' configuration tag in your configuration to '''1'''.
==== Download error 9: Error downloading requested files ====
* '''I'm getting ''Download Error 9: Error downloading requested files'' whenever I connect to my server'''

This error happens when the server you are trying to connect to is unable to provide you with a valid link. This results in a 404 (Not found) HTTP error and an error at your end.

* If you are running the built-in server ('''httpserver''' is set to '''1''' and '''httpdownloadurl''' is empty), make sure that your HTTP server is accessible (you can try to access it by using a browser) for everyone.

* If you have configured an external web server ('''httpdownloadurl''' is set to your custom URL), make sure that your HTTP is accessible and make sure you have read the [[Deathmatch_Server_Manual#Configuring_an_external_web_server | Configuring an external web server]] guide.
==== Download error 28 ====
Try closing anti-virus or firewall applications. If it then works, try adding an exception to your firewall to allow your http port through.

=== Windows-related ===
No known reported issues in the version {{Current Version|full}}.

=== Linux-related ===
====Default nohup creates infinitely big nohup.out====

Temporary fix, disable the nohup file: 'nohup ./mta_server > /dev/null &'

OnClientGUITabSwitched

2009-06-21T08:13:49Z

Winky: Started with the page

{{Client event}}
__NOTOC__
This event is triggered each time the user switch from GUI tab.

==Parameters==
''None''

==Example==
<syntaxhighlight lang="lua">
--TODO
</syntaxhighlight>

==See Also==
===GUI events===
{{GUI_events}}
===Client event functions===
{{Client_event_functions}}

[[Category:Needs Example]]
[[Category:Incomplete]]

Changes in 1.0

2009-06-18T21:14:40Z

Winky: /* Chatbox */ window -> menu

This page outlines the major and fundamental changes when upgrading from dp2.x to 1.0.

==Client==
===General===
* The settings menu is now much more advanced and allows for more in depth changes, such as the addition of a '''Video''' tab which allows you to set the resolution
[[Image:Settings_videotab.png]]

===Console commands===
The console commands now use [[Console Commands and CVars|CVARS]]. This essentially means that the standard commands that are built into MTA now exhibit a different syntax.

Whereas in dp2 you may have done:
chat_font 2

In 1.0 you would perform a command that mimics C:
chat_font = 2

This applies to all inbuilt commands, except for those that may interface with a server (e.g. ''nick'' or ''me'').

===Chatbox===
The chatbox has had minor changes in 1.0. In particular, the text now displays an animation when a new line appears, and the ''Page Up'' and ''Page Down'' keys can be used to scroll the chat.
Now it is also possible to change the chatbox layout in the settings menu.

[[Image:Settings_chatboxtab.png]]

===Host Game===
This useful addition allows you to quickly start a game without having to run the MTA Server executable. It is fully functional and based upon the local.conf.

[[Image:Hostgame_window.png]]

===Joypad support===
From 1.0, users can use their joypad/controller ingame. The keys for your joypad can be configured in the '''Binds''' tab, and advanced configuration such as analog keys can be configured in the '''Controls''' tab.

[[Image:Settings_controltab.png]]

===Map Editor===
The Map Editor is now functional as of 1.0. This is assuming you have the map editor installed. Please see the [[Editor|Editor manual]] for details.

==Server==
The interface of the server is largely the same as dp2.x, there have, however been various tweaks

===Server config===
If upgrading from dp2, you should also add any missing variables to your config:
* '''fpslimit''': This sets the FPS limit on your server.
* '''donotbroadcastlan''': This sets whether the server can broadcast to Local Area Network servers

===Commands===
The commands of the server console are mostly the same, with the exception of:
* '''refresh''' - Previously the refresh command would refresh ''all'' resources. Now it only detects new resources that are in your resources directory
* '''refreshall''' - This new command mimics the previous functioning of refresh, and refreshes all resources - even those which are loaded already.
* '''loadmodule''' - Modules can now be loaded using this command without them being set in the server config.

==Resources==
Many of the default resources have been changed or updated, and new ones have also been added.

* Resource [http://community.mtasa.com/index.html?p=resources&s=details&id=57 realdriveby] has been added. This will facilitate the driveby mode in vehicles
* Resource [http://community.mtasa.com/index.html?p=resources&s=details&id=43 freeroam] has been added. (This resource is also needed when you want to run the test mode in the map editor)
* Resource [http://code.google.com/p/multitheftauto-resources/source/browse/#svn/trunk/required/parachute parachute] has been added, which facilitates parachutes from single player.
* Resource [http://multitheftauto-resources.googlecode.com/svn/trunk/optional/deathmatch deathmatch] has been added. This is a simple frag-/timelimit based deathmatch gamemode with custom map support.
* Resource [http://multitheftauto-resources.googlecode.com/svn/trunk/optional/race/ race] has undergone many changes and is now much more stable and functional.

==Scripting==
Much of the scripting interface has changed in 1.0. Almost all resources will need updating in order to function, although the extent of this varies between scripts.
All the affected scripting changes can be viewed on [[:Category:Changes_in_1.0|Changes in 1.0]] page.

===Camera functions===
The [[Server_Scripting_Functions#Camera_functions|Camera Functions]] have been completely overhauled.
===Player functions===
Some [[Server_Scripting_Functions#Player_functions|Player functions]] have been renamed to [[Server_Scripting_Functions#Ped_functions|Ped functions]].

Changes in 1.0

2009-06-18T20:55:52Z

Winky: /* Chatbox */

This page outlines the major and fundamental changes when upgrading from dp2.x to 1.0.

==Client==
===General===
* The settings menu is now much more advanced and allows for more in depth changes, such as the addition of a '''Video''' tab which allows you to set the resolution
[[Image:Settings_videotab.png]]

===Console commands===
The console commands now use [[Console Commands and CVars|CVARS]]. This essentially means that the standard commands that are built into MTA now exhibit a different syntax.

Whereas in dp2 you may have done:
chat_font 2

In 1.0 you would perform a command that mimics C:
chat_font = 2

This applies to all inbuilt commands, except for those that may interface with a server (e.g. ''nick'' or ''me'').

===Chatbox===
The chatbox has had minor changes in 1.0. In particular, the text now displays an animation when a new line appears, and the ''Page Up'' and ''Page Down'' keys can be used to scroll the chat.
Now it is also possible to change the chatbox layout in the settings window.

[[Image:Settings_chatboxtab.png]]

===Host Game===
This useful addition allows you to quickly start a game without having to run the MTA Server executable. It is fully functional and based upon the local.conf.

[[Image:Hostgame_window.png]]

===Joypad support===
From 1.0, users can use their joypad/controller ingame. The keys for your joypad can be configured in the '''Binds''' tab, and advanced configuration such as analog keys can be configured in the '''Controls''' tab.

[[Image:Settings_controltab.png]]

===Map Editor===
The Map Editor is now functional as of 1.0. This is assuming you have the map editor installed. Please see the [[Editor|Editor manual]] for details.

==Server==
The interface of the server is largely the same as dp2.x, there have, however been various tweaks

===Server config===
If upgrading from dp2, you should also add any missing variables to your config:
* '''fpslimit''': This sets the FPS limit on your server.
* '''donotbroadcastlan''': This sets whether the server can broadcast to Local Area Network servers

===Commands===
The commands of the server console are mostly the same, with the exception of:
* '''refresh''' - Previously the refresh command would refresh ''all'' resources. Now it only detects new resources that are in your resources directory
* '''refreshall''' - This new command mimics the previous functioning of refresh, and refreshes all resources - even those which are loaded already.
* '''loadmodule''' - Modules can now be loaded using this command without them being set in the server config.

==Resources==
Many of the default resources have been changed or updated, and new ones have also been added.

* Resource [http://community.mtasa.com/index.html?p=resources&s=details&id=57 realdriveby] has been added. This will facilitate the driveby mode in vehicles
* Resource [http://community.mtasa.com/index.html?p=resources&s=details&id=43 freeroam] has been added. (This resource is also needed when you want to run the test mode in the map editor)
* Resource [http://code.google.com/p/multitheftauto-resources/source/browse/#svn/trunk/required/parachute parachute] has been added, which facilitates parachutes from single player.
* Resource [http://multitheftauto-resources.googlecode.com/svn/trunk/optional/deathmatch deathmatch] has been added. This is a simple frag-/timelimit based deathmatch gamemode with custom map support.
* Resource [http://multitheftauto-resources.googlecode.com/svn/trunk/optional/race/ race] has undergone many changes and is now much more stable and functional.

==Scripting==
Much of the scripting interface has changed in 1.0. Almost all resources will need updating in order to function, although the extent of this varies between scripts.
All the affected scripting changes can be viewed on [[:Category:Changes_in_1.0|Changes in 1.0]] page.

===Camera functions===
The [[Server_Scripting_Functions#Camera_functions|Camera Functions]] have been completely overhauled.
===Player functions===
Some [[Server_Scripting_Functions#Player_functions|Player functions]] have been renamed to [[Server_Scripting_Functions#Ped_functions|Ped functions]].

File:Settings chatboxtab.png

2009-06-18T20:54:49Z

Winky: Chatbox tab in the settings window in 1.0 r1112

Chatbox tab in the settings window in 1.0 r1112

Changes in 1.0

2009-06-15T20:09:14Z

Winky: Added link to category "Changes in 1.0", linked the resources

This page outlines the major and fundamental changes when upgrading from dp2.x to 1.0.

==Client==
===General===
* The settings menu is now much more advanced and allows for more in depth changes, such as the addition of a '''Video''' tab which allows you to set the resolution
[[Image:Settings_videotab.png]]

===Console commands===
The console commands now use [[Console Commands and CVars|CVARS]]. This essentially means that the standard commands that are built into MTA now exhibit a different syntax.

Whereas in dp2 you may have done:
chat_font 2

In 1.0 you would perform a command that mimics C:
chat_font = 2

This applies to all inbuilt commands, except for those that may interface with a server (e.g. ''nick'' or ''me'').

===Chatbox===
The chatbox has had minor changes in 1.0. In particular, the text now displays an animation when a new line appears, and the ''Page Up'' and ''Page Down'' keys can be used to scroll the chat.

===Host Game===
This useful addition allows you to quickly start a game without having to run the MTA Server executable. It is fully functional and based upon the local.conf.

[[Image:Hostgame_window.png]]

===Joypad support===
From 1.0, users can use their joypad/controller ingame. The keys for your joypad can be configured in the '''Binds''' tab, and advanced configuration such as analog keys can be configured in the '''Controls''' tab.

[[Image:Settings_controltab.png]]

===Map Editor===
The Map Editor is now functional as of 1.0. This is assuming you have the map editor installed. Please see the [[Editor|Editor manual]] for details.

==Server==
The interface of the server is largely the same as dp2.x, there have, however been various tweaks

===Server config===
If upgrading from dp2, you should also add any missing variables to your config:
* '''fpslimit''': This sets the FPS limit on your server.
* '''donotbroadcastlan''': This sets whether the server can broadcast to Local Area Network servers

===Commands===
The commands of the server console are mostly the same, with the exception of:
* '''refresh''' - Previously the refresh command would refresh ''all'' resources. Now it only detects new resources that are in your resources directory
* '''refreshall''' - This new command mimics the previous functioning of refresh, and refreshes all resources - even those which are loaded already.
* '''loadmodule''' - Modules can now be loaded using this command without them being set in the server config.

==Resources==
Many of the default resources have been changed or updated, and new ones have also been added.

* Resource [http://community.mtasa.com/index.html?p=resources&s=details&id=57 realdriveby] has been added. This will facilitate the driveby mode in vehicles
* Resource [http://community.mtasa.com/index.html?p=resources&s=details&id=43 freeroam] has been added. (This resource is also needed when you want to run the test mode in the map editor)
* Resource [http://code.google.com/p/multitheftauto-resources/source/browse/#svn/trunk/required/parachute parachute] has been added, which facilitates parachutes from single player.
* Resource [http://multitheftauto-resources.googlecode.com/svn/trunk/optional/race/ race] has undergone many changes and is now much more stable and functional.

==Scripting==
Much of the scripting interface has changed in 1.0. Almost all resources will need updating in order to function, although the extent of this varies between scripts.
All the affected scripting changes can be viewed on [[:Category:Changes_in_1.0|Changes in 1.0]] page.

===Camera functions===
The [[Server_Scripting_Functions#Camera_functions|Camera Functions]] have been completely overhauled.
===Player functions===
Some [[Server_Scripting_Functions#Player_functions|Player functions]] have been renamed to [[Server_Scripting_Functions#Ped_functions|Ped functions]].

Changes in 1.0

2009-06-14T12:53:58Z

Winky: Added images

This page outlines the major and fundamental changes when upgrading from dp2.x to 1.0.

==Client==
===General===
* The settings menu is now much more advanced and allows for more in depth changes, such as the addition of a '''Video''' tab which allows you to set the resolution
[[Image:Settings_videotab.png]]

===Console commands===
The console commands now use [[Console Commands and CVars|CVARS]]. This essentially means that the standard commands that are built into MTA now exhibit a different syntax.

Whereas in dp2 you may have done:
chat_font 2

In 1.0 you would perform a command that mimics C:
chat_font = 2

This applies to all inbuilt commands, except for those that may interface with a server (e.g. ''nick'' or ''me'').

===Chatbox===
The chatbox has had minor changes in 1.0. In particular, the text now displays an animation when a new line appears, and the ''Page Up'' and ''Page Down'' keys can be used to scroll the chat.

===Host Game===
This useful addition allows you to quickly start a game without having to run the MTA Server executable. It is fully functional and based upon the local.conf.

[[Image:Hostgame_window.png]]

===Joypad support===
From 1.0, users can use their joypad/controller ingame. The keys for your joypad can be configured in the '''Binds''' tab, and advanced configuration such as analog keys can be configured in the '''Controls''' tab.

[[Image:Settings_controltab.png]]

===Map Editor===
The Map Editor is now functional as of 1.0. This is assuming you have the map editor installed. Please see the [[Editor|Editor manual]] for details.

==Server==
The interface of the server is largely the same as dp2.x, there have, however been various tweaks

===Server config===
If upgrading from dp2, you should also add any missing variables to your config:
* '''fpslimit''': This sets the FPS limit on your server.
* '''donotbroadcastlan''': This sets whether the server can broadcast to Local Area Network servers

===Commands===
The commands of the server console are mostly the same, with the exception of:
* '''refresh''' - Previously the refresh command would refresh ''all'' resources. Now it only detects new resources that are in your resources directory
* '''refreshall''' - This new command mimics the previous functioning of refresh, and refreshes all resources - even those which are loaded already.
* '''loadmodule''' - Modules can now be loaded using this command without them being set in the server config.

==Resources==
Many of the default resources have been changed or updated, and new ones have also been added.

* Resource '''realdriveby''' has been added. This will facilitate the driveby mode in vehicles
* Resource '''freeroam''' has been added. (This resource is also needed when you want to run the test mode in the map editor)
* Resource '''parachute''' has been added, which facilitates parachutes from single player.
* Resource '''race''' has undergone many changes and is now much more stable and functional.

==Scripting==
Much of the scripting interface has changed in 1.0. Almost all resources will need updating in order to function, although the extent of this varies between scripts.

===Camera functions===
The [[Server_Scripting_Functions#Camera_functions|Camera Functions]] have been completely overhauled.
===Player functions===
Some [[Server_Scripting_Functions#Player_functions|Player functions]] have been renamed to [[Server_Scripting_Functions#Ped_functions|Ped functions]].

File:Hostgame window.png

2009-06-14T12:52:54Z

Winky: Host game window in MTA:SA 1.0 r1074

Host game window in MTA:SA 1.0 r1074

File:Settings controltab.png

2009-06-14T12:49:49Z

Winky: The control tab in MTA:SA 1.0 r1074

The control tab in MTA:SA 1.0 r1074

File:Settings videotab.png

2009-06-14T12:40:01Z

Winky: The settings window in MTA:SA 1.0 r1074

The settings window in MTA:SA 1.0 r1074

Changes in 1.0

2009-06-14T12:33:27Z

Winky:

This page outlines the major and fundamental changes when upgrading from dp2.x to 1.0.

==Client==
===General===
* The settings menu is now much more advanced and allows for more in depth changes, such as the addition of a '''Video''' tab which allows you to set the resolution

===Console commands===
The console commands now use [[Console Commands and CVars|CVARS]]. This essentially means that the standard commands that are built into MTA now exhibit a different syntax.

Whereas in dp2 you may have done:
chat_font 2

In 1.0 you would perform a command that mimics C:
chat_font = 2

This applies to all inbuilt commands, except for those that may interface with a server (e.g. ''nick'' or ''me'').

===Chatbox===
The chatbox has had minor changes in 1.0. In particular, the text now displays an animation when a new line appears, and the ''Page Up'' and ''Page Down'' keys can be used to scroll the chat.

===Host Game===
This useful addition allows you to quickly start a game without having to run the MTA Server executable. It is fully functional and based upon the local.conf.

===Joypad support===
From 1.0, users can use their joypad/controller ingame. The keys for your joypad can be configured in the '''Binds''' tab, and advanced configuration such as analog keys can be configured in the '''Controls''' tab.

===Map Editor===
The Map Editor is now functional as of 1.0. This is assuming you have the map editor installed. Please see the [[Editor|Editor manual]] for details.

==Server==
The interface of the server is largely the same as dp2.x, there have, however been various tweaks

===Server config===
If upgrading from dp2, you should also add any missing variables to your config:
* '''fpslimit''': This sets the FPS limit on your server.
* '''donotbroadcastlan''': This sets whether the server can broadcast to Local Area Network servers

===Commands===
The commands of the server console are mostly the same, with the exception of:
* '''refresh''' - Previously the refresh command would refresh ''all'' resources. Now it only detects new resources that are in your resources directory
* '''refreshall''' - This new command mimics the previous functioning of refresh, and refreshes all resources - even those which are loaded already.
* '''loadmodule''' - Modules can now be loaded using this command without them being set in the server config.

==Resources==
Many of the default resources have been changed or updated, and new ones have also been added.

* Resource '''realdriveby''' has been added. This will facilitate the driveby mode in vehicles
* Resource '''freeroam''' has been added. (This resource is also needed when you want to run the test mode in the map editor)
* Resource '''parachute''' has been added, which facilitates parachutes from single player.
* Resource '''race''' has undergone many changes and is now much more stable and functional.

==Scripting==
Much of the scripting interface has changed in 1.0. Almost all resources will need updating in order to function, although the extent of this varies between scripts.

===Camera functions===
The [[Server_Scripting_Functions#Camera_functions|Camera Functions]] have been completely overhauled.
===Player functions===
Some [[Server_Scripting_Functions#Player_functions|Player functions]] have been renamed to [[Server_Scripting_Functions#Ped_functions|Ped functions]].

RotateCameraUp

2009-06-14T12:06:41Z

Winky: Added the deprecated template only

RotateCameraRight

2009-06-14T12:06:07Z

Winky: Added the deprecated template only

GetCameraFixedModeTarget

2009-06-14T12:05:25Z

Winky: Added the deprecated template only

Changes in 1.0

2009-05-26T20:23:25Z

Winky: Note about player functions and ped functions

This page outlines the major and fundamental changes when upgrading from dp2.x to 1.0.

==Client==
===General===
* The settings menu is now much more advanced and allows for more in depth changes, such as the addition of a '''Video''' tab which allows you to set the resolution

===Console commands===
The console commands now use [[Console Commands and CVars|CVARS]]. This essentially means that the standard commands that are built into MTA now exhibit a different syntax.

Whereas in dp2 you may have done:
chat_font 2

In 1.0 you would perform a command that mimics C:
chat_font = 2

This applies to all inbuilt commands, except for those that may interface with a server (e.g. ''nick'' or ''me'').

===Chatbox===
The chatbox has had minor changes in 1.0. In particular, the text now displays an animation when a new line appears, and the ''Page Up'' and ''Page Down'' keys can be used to scroll the chat.

===Host Game===
This useful addition allows you to quickly start a game without having to run the MTA Server executable. It is fully functional and based upon the local.conf.

===Joypad support===
From 1.0, users can use their joypad/controller ingame. The keys for your joypad can be configured in the '''Binds''' tab, and advanced configuration such as analog keys can be configured in the '''Controls''' tab.

===Map Editor===
The Map Editor is now functional as of 1.0. This is assuming you have the map editor installed. Please see the [[Editor|Editor manual]] for details.

==Server==
The interface of the server is largely the same as dp2.x, there have, however been various tweaks

===Server config===
If upgrading from dp2, you should also add any missing variables to your config:
* '''fpslimit''': This sets the FPS limit on your server.
* '''donotbroadcastlan''': This sets whether the server can broadcast to Local Area Network servers

===Commands===
The commands of the server console are mostly the same, with the exception of:
* '''refresh''' - Previously the refresh command would refresh ''all'' resources. Now it only detects new resources that are in your resources directory
* '''refreshall''' - This new command mimics the previous functioning of refresh, and refreshes all resources - even those which are loaded already.
* '''loadmodule''' - Modules can now be loaded using this command without them being set in the server config.

==Resources==
Many of the default resources have been changed or updated, and new ones have also been added.

* Resource '''realdriveby''' has been added. This will facilitate the driveby mode in vehicles
* Resource '''freeroam''' has been added.
* Resource '''parachute''' has been added, which facilitates parachutes from single player.
* Resource '''race''' has undergone many changes and is now much more stable and functional.

==Scripting==
Much of the scripting interface has changed in 1.0. Almost all resources will need updating in order to function, although the extent of this varies between scripts.

===Camera functions===
The camera functions have been completely overhauled. Scripters using the camera functions

===Player functions===
Some [[Server_Scripting_Functions#Player_functions|Player functions]] have been renamed to [[Server_Scripting_Functions#Ped_functions|Ped functions]].

OnResourcePreStart

2009-04-26T17:56:01Z

Winky: Started with onResourcePreStart, format? (not in the source found)

{{Server event}}
__NOTOC__
This event is triggered before a resource is loaded.

==Parameters==
<syntaxhighlight lang="lua">
--TODO
</syntaxhighlight>

==Source==

==Cancel effect==

==Example==
<syntaxhighlight lang="lua">
--TODO
</syntaxhighlight>

{{See also/Server event|Resource events}}

[[Category: Incomplete]]
[[Category: Needs Example]]

OnVehicleStartEnter

2009-04-24T14:28:20Z

Winky: Added before 1.0 template and from 1.0 template

__NOTOC__
{{Server event}}
This event is triggered when a player starts to enter a vehicle. This event can be used to cancel entry, if necessary.

==Parameters==
{{Deprecated_feature|3|1.0|
<syntaxhighlight lang="lua">
player enteringPlayer, int seat, player jacked
</syntaxhighlight>
}}
{{New feature|3|1.0|
<syntaxhighlight lang="lua">
player enteringPlayer, int seat, player jacked, int door
</syntaxhighlight>}}

*'''enteringPlayer''': A player element representing the player who is starting to enter a vehicle
*'''seat''': An integer representing the seat in which the player is entering
*'''jacked''': A player element representing who is going to be jacked
*{{New feature|3|1.0|'''door''': An integer of which door the player used (0-3). 0 is driver side door, 1 is front passenger, 2 is back right, 3 is back left.}}

==Source==
The [[event system#Event source|source]] of this event is the [[vehicle]] in which a player began to enter.

===Canceling===
If this event is [[Event system #Canceling|canceled]], the player will not enter the vehicle.

==Example==
This example blocks a player out of a police vehicle if he is not a policeman.
<syntaxhighlight lang="lua">
policeVehicles = { [598]=true,[596]=true,[597]=true,[599]=true }
policeSkins = { [280]=true,[281]=true,[282]=true,[283]=true,[284]=true,[285]=true,[286]=true }

function enterVehicle ( player, seat, jacked ) --when a player enters a vehicle
if ( policeVehicles[getVehicleID ( source )] ) and ( not policeSkins[getPlayerSkin ( player )] ) then --if the vehicle is one of 4 police cars, and the skin is not a police skin
cancelEvent()
outputChatBox ( "Only policeman can enter police cars!", player ) --and tell the player why
end
end
addEventHandler ( "onVehicleStartEnter", getRootElement(), enterVehicle ) --add an event handler for onVehicleStartEnter
</syntaxhighlight>

{{See also/Server event|Vehicle events}}

Account

2009-04-20T18:19:05Z

Winky: Added 1.0 function and added feature templates

The [[account]] class represents a [[client]]'s server account. You can get the [[account]] object associated to any client using:{{Deprecated_feature|3|1.0|[[getClientAccount]]}}
{{New feature|3|1.0|[[getAccountPlayer]]}}

Accounts are unique to each client and can be used to store information that is persistent across map changes and user sessions. Clients that join without an account are given a temporary 'guest' account. This can store information like any other account, but isn't saved across sessions.

When a user logs in or out, the account object assigned to them will change. As such, you must not assume that the account attached to a client remains constant during their session.

==Related scripting functions==
===Server===
{{Account functions}}
[[Category:Scripting Concepts]]

[[it:Account]]

Known Issues - FAQ

2009-04-16T17:57:32Z

Winky:

Post here your proposed Q&A, regarding the known problems with MTA:SA DM and their solutions, especially problems we're encountering now, that might be also encountered by users in the final release. You're also welcome to edit them grammar/style wise.

== Client ==

=== General ===
==== Does MTASA:DM work with v1.01 or v2.00 of GTA San Andreas? ====
No. Please see [http://forum.mtavc.com/viewtopic.php?t=15151 this forum topic] for instructions on patching the exe

==== The game says it cannot locate the map editor. ====
Map editor for MTA: Deathmatch has not yet been released. In the meantime you may use MTA: Race map editor for creating maps (and then convert those to MTA:DM syntax using various converters available).

==== Initial black screen/hanging GTA splash screens ====
* '''MTA shows a permanent black screen or hanging GTA splash screens.'''

It may be necessary that during/after the logo splash screens in Grand Theft Auto you have to give some input in order to skip the videos correctly. Try to click your left-mouse button a few times, or tapping a few keys.

* '''MTA shows a permanent black screen after the GTA splash screens (possibly with text in the bottom right corner).'''

This can be related to a lack of support for DirectX or video card features, on your system, which are needed to run the dynamically rendered menu. This dynamic menu is enabled by default. You can disable it by opening your [[coreconfig.xml]] configuration file located in the ''GTA San Andreas\MTA'' directory, and changing the value of ''menu_options'' to ''248''.

==== Halt after MTA splash screen ====
* '''Nothing happens after the 'Stop playing with yourself' splash screen'''

If you use nVidia GeForce, try turning off nView Desktop Manager before starting MTA.

Also try deleting GTA San Andreas settings file ("gta_sa.set") in "Documents\GTA San Andreas User Files" folder

==== Crash after MTA splash screen ====
* '''MTA crashes after the 'Stop playing with yourself' logo. Both single player and the MTA: Race ran fine before.'''

Try downloading the latest DirectX Runtime files from [http://www.microsoft.com/downloads/details.aspx?FamilyID=2da43d38-db71-4c1b-bc6a-9b6652cd92a3&DisplayLang=en Microsoft]. Also check in Task Manager, if gta_sa.exe process isn't already running.

If you run at any substandard resolutions (e.g. 960x720), try to change your resolution to a commonly supported one (e.g. 640×480, 800×600, 1024×768, 1152×864, 1280×1024) by launching Grand Theft Auto: San Andreas in normal mode, setting the new resolution and exiting.

==== Assertion in CMainMenu.cpp line 106 upon launching MTASA ====
* '''I'm getting an assertion in CMainMenu.cpp (line 106) after I have launched MTASA. I'm able to ignore it, but then game crashes after I try to connect to a server.'''

This is likely caused by GTASA or MTASA being installed in a path that contains non-ASCII characters (eg. Cyrillic, Polish, Japanese) in it.

To resolve this, you need to uninstall MTASA and GTASA, then install them in such paths that don't contain such characters.

==== Controls not working ====
* '''My controls don't seem to work as they should.'''

Try using the 'copygtacontrols' command in the console.

==== Incorrect models ====
* '''Woman model's breasts look awkward ingame / I'm seeing odd, spider-like shaped player models.'''

This is caused by the way GTA handles player stats. To fix this, be sure to set both fat and muscles player stats to 0, when you're changing player skin.

==== Incorrect drive-by functionality ====
* '''Drivebys arent working as they should'''

Drivebys are handled by script, and will change depending on the loaded gamemode.

==== Unsaved settings ====
* '''My MTA setting(s) didn't get saved (...) I crashed.'''

First, configure the MTA the way you want to, then exit the game and launch it again. Settings should get saved. Alternatively, try removing the coreconfig.xml file, then configure it and quit the game.

==== Gamepad support ====
* '''MTA doesnt recognise my gamepad'''

This is a known issue - MTA's keybinds system does not support direct input. As an alternative, [http://xpadder.com/ XPadder] can be used. This emulates joypad buttons as keyboard/mouse so that it can be used in MTA. Please refer to [http://forum.mtasa.com/viewtopic.php?f=87&t=21167 this forum topic] for a brief guide on how to use XPadder.

==== Free mouselook not working properly ====
* '''MTA doesnt recognise my mouse'''

Some people got problems with their mouse in MTA. They can use it in the menu, connect to a server, but they can't use the mouse for free look.
This problem can be solved by entering a server, click your Win/Windows key at your keyboard once, and then click your mouse.
If that doesn't work try starting GTA in Singleplayer, go to options > controler setup and set "Configuration" to "Mouse + Keys" instead of "Joypad".

==== Sky flickering ====
* '''My screen/sky flickers when weather or sky effects are enabled.

MTA:SA DM uses a new text rendering system from race, which is much more efficient in terms of FPS. However, this can cause conflicts within the game, particularly with ATI based cards. To fix this, bring up the console with F8, and type the command '''ceguitext 1'''. This reverts the rendering method to that of Race. All glitches should no longer happen, at the cost of lower FPS.

==== Server browser not working ====
* '''The in-game server browser shows "Loading" but does not come up with any servers'''

Depending on the type and status of the internet connection you are using, it can take up to a few seconds for the server browser to retrieve all the servers. Please wait a little longer for the results to appear.

==== Invalid serial number ====
* '''I am getting an 'Invalid serial number' error when trying to launch or play the game'''

You are running an outdated version of Multi Theft Auto. Head over to the [http://www.mtasa.com/deathmatch.html download page] and download the latest version of Multi Theft Auto.

==== 'Network module could not be located' ====
* '''I am getting 'Network module could not be located' error message upon launching MTA:SA DM

Copy the file 'net.dll' from your GTA:SA/mta directory into your GTA:SA directory, overwriting existing files.

==== 'Network module not compatible!' on MTASA launch ====
* '''I am getting 'Network module not compatible!' error message upon launching MTA:SA DM

This could mean that your MTASA install is incomplete or broken. Reinstall it.

==== 'No such mod installed (deathmatch)' ====
* '''I am getting a 'No such mod installed (deathmatch)' error message when trying to connect to any server

'''Option 1:''' Simply re-install MTA. <br>
'''Option 2:''' Run both gta_sa.exe and Multi Theft Auto.exe with administrator privileges.

==== D3dx9_**.dll is not found ====
* '''When I start Multi Theft Auto: San Andreas I am getting an error D3dx9_**.dll (** = a number) cannot be found.

This means that DirectX 9 is not installed or not up to date.
To install/update DirectX download the [http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=2da43d38-db71-4c1b-bc6a-9b6652cd92a3 DirectX End-User Runtime Web Installer] from the Microsoft download site.

=== Windows Vista®-related ===

==== Crash on launch ====
* '''I've successfully upgraded from MTA Race to MTASA DM on Vista, but it seems to crash on launch.

'''Option 1''' Go to your Program Files\MTA San Andreas\mods\race directory, and rename client.dll to something else. <br>
'''Option 2''' Go to your Grand Theft Auto: San Andreas directory (usually Program Files\Rockstar Games\GTA San Andreas"), navigate to the MTA directory, then enter the "data" directory and remove the menu.mkv file. This will start Multi Theft Auto: San Andreas without main menu video rendering.

==== Crash on connect ====
* '''I seem to crash whenever I connect to a server just before I go in-game on Vista'''

This seems to be an issue with the Microsoft DirectX April 2006 SDK Redistributable DLL file (d3dx9_30.dll) when running in compatibility mode. Please make sure that compatibility mode is competely turned off for '''both''' your GTA_SA.exe and Multi Theft Auto.exe executables.

==== Invalid or disabled serial error ====
* '''MTASA DM installer complains about wrong serial provided. I'm running it for the first time.

You need to run the installer with Administrator privileges. To do so, right click on the installer executable, choose 'Properties', go into 'Compatibility' tab and tick the check box on the last field.

Some have found that setting compatibility to Windows XP/2000 have fixed the problem.

If User Account Control is disabled, you might need to enable it and run the installer with admin privileges (like said above) in order to install MTA:SA DM.

*'''I am getting 'invalid serial' when I try to connect to a server'''
After some research we have found that in most cases this problem occurs if registry data has not been set for some reason. To fix this problem, take the following steps:

Open regedit (start > run > regedit)<br>
Go to HKEY_LOCAL_MACHINE\SOFTWARE\Multi Theft Auto: San Andreas<br>
Create a new string key called Username and fill there the username you have on mtabeta.com<br>
Create one more string key called Serial and paste there the serial from mtabeta.com<br>

If you have no serial at http://community.mtasa.com (mtabeta.com) to complete the last step, register on our forums and request one [http://forum.mtasa.com/viewtopic.php?f=89&t=21435&p=269057 here]

*'''I am getting 'disabled serial' when I try to connect to a server'''
If you receive this message, your serial has been banned (most likely for cheating). There is nothing you can do to fix this. Registering a new account does not unban you.

==== Clock manipulation error ====
* '''I am getting 'Clock manipulation detected!' error message upon launching MTA:SA DM

Further info coming soon.

==== Halt on launch ====
* '''When I launch MTA:SA DM, nothing happens (GTA_SA.exe is running but not loading up)

Run MTA:SA DM with Administrator privileges. To do this, right click on the installer executable, choose 'Properties', go into 'Compatibility' tab and tick the check box on the last field and try again.

==== General GTA problems ====
* '''I have unexplainable GTA problems or crashes'''

Make sure your computer as well as your GTA install meet the [[Deathmatch_Client_Manual#System_requirements|minimum requirements]] and that you are not running in any 98/2000/XP/2003 compatibility modes.

Also try the solutions from these pages:
* http://www.gtaforums.com/index.php?showtopic=273549&view=findpost&p=4537502
* http://pullmonkey.com/2007/4/30/how-i-got-gta-san-andreas-to-work-with-a-crappy-os-vista

== Server ==

=== General ===
==== Fatal error 3 ====
* '''I'm getting ''Fatal Error 3'' whenever I connect to my server'''

This error happens when the server you are trying to connect to is unable to provide you the required downloads, because it does not have http downloading enabled. Be sure to set the '''httpdownload''' configuration tag in your configuration to '''1'''.
==== Download error 9: Error downloading requested files ====
* '''I'm getting ''Download Error 9: Error downloading requested files'' whenever I connect to my server'''

This error happens when the server you are trying to connect to is unable to provide you with a valid link. This results in a 404 (Not found) HTTP error and an error at your end.

* If you are running the built-in server ('''httpserver''' is set to '''1''' and '''httpdownloadurl''' is empty), make sure that your HTTP server is accessible (you can try to access it by using a browser) for everyone.

* If you have configured an external web server ('''httpdownloadurl''' is set to your custom URL), make sure that your HTTP is accessible and make sure you have read the [[Deathmatch_Server_Manual#Configuring_an_external_web_server | Configuring an external web server]] guide.
==== Download error 28 ====
Try closing anti-virus or firewall applications. If it then works, try adding an exception to your firewall to allow your http port through.

=== Windows-related ===
No known reported issues in the version {{Current Version|full}}.

=== Linux-related ===
====Default nohup creates infinitely big nohup.out====

Temporary fix, disable the nohup file: 'nohup ./mta_server > /dev/null &'

BanSerial

2009-04-13T07:12:10Z

Winky:

__NOTOC__
{{Server function}}
{{Deprecated}}
This function will ban the specified [[serial]] number from the server.

==Syntax==
<syntaxhighlight lang="lua">
bool banSerial ( string theSerial )
</syntaxhighlight>

===Required Arguments===
*'''theSerial:''' The serial to ban from this server

===Returns===
Returns ''true'' if the serial was banned succesfully, ''false'' if invalid arguments are specified.

==Example==
This example lets a client (console or player) ban a serial if he has ACL rights.
<syntaxhighlight lang="lua">
--Add the "banserial" command handler
function banSerialCommand ( theClient, commandName, bannedSerial )

-- Give the player a nice error if he doesn't have rights
if ( hasObjectPermissionTo ( theClient, "function.banSerial" ) )

--Ban the serial
banSerial ( bannedSerial )
outputChatBox ( "banserial: Serial " .. bannedSerial .. " successfully banned", theClient )
else
outputChatBox ( "banserial: You don't have enough permissions", theClient )
end

end
addCommandHandler ( "banserial", banSerialCommand )
</syntaxhighlight>

==See Also==
{{Admin_functions}}

GetBanSerial

2009-04-13T07:11:21Z

Winky:

__NOTOC__
{{Server function}}
This function will return the [[serial]] of the specified [[ban]] pointer.

==Syntax==
<syntaxhighlight lang="lua">
string getBanSerial ( ban theBan )
</syntaxhighlight>

===Required Arguments===
*'''theBan:''' The [[ban]] you want to retrieve the serial of.

===Returns===
Returns a ''string'' of the serial if everything was successful, ''false'' if invalid arguments are specified or if there was no serial specified for the [[ban]].

==Example==
<syntaxhighlight lang="lua">
--TODO
</syntaxhighlight>

==See Also==
{{Admin functions}}

KillPlayer

2009-04-13T07:09:06Z

Winky: Removed 'DP3' things

{{Server function}}
__NOTOC__
{{Deprecated}}
This function kills the specified player.

==Syntax==
<syntaxhighlight lang="lua">bool killPlayer ( player thePlayer, [ player theKiller = nil, int weapon=255, int bodyPart=255 ] )</syntaxhighlight>

===Required Arguments===
* '''thePlayer:''' The [[player]] to kill

===Optional Arguments===
* '''theKiller:''' The player responsible for the kill
* '''weapon:''' The ID of the weapon that should appear to have killed the player (doesn't affect how they die)
* '''bodyPart:''' The ID of the body part that should appear to have been hit by the weapon (doesn't affect how they die)

===Returns===
Returns ''true'' if the player was killed, ''false'' if the player specified could not be killed or is invalid.

==Example==
'''Example 1:''' This simple example adds a '''kill''' command to commit suicide.
<syntaxhighlight lang="lua">
function commitSuicide(sourcePlayer)
-- kill the player and make him responsible for it
killPlayer(sourcePlayer, sourcePlayer)
end
-- attach our handler to the "kill" command
addCommandHandler("kill", commitSuicide)
</syntaxhighlight>

'''Example 2:''' This example enables 1 hit kills if a player is shot in the head.
<syntaxhighlight lang="lua">
function headshotKill ( attacker, attackerweapon, bodypart, loss )
if bodypart == 9 then --if the bodypart is the head
--kill the player, emulating the correct killer, weapon and bodypart.
killPlayer ( source, attacker, attackerweapon, bodypart )
end
end
addEventHandler ( "onPlayerDamage", getRootElement(), headshotKill )
</syntaxhighlight>

==See Also==
{{Player functions}}

XML

2009-04-12T11:00:30Z

Winky: New page: XML stands for ''Extensible Markup Language'', XML can be used in MTA to read or write data. MTA's map files are also in XML format. Example of XML: <syntaxhighlight lang="lua">[xml,n] <meta> <info author...

XML stands for ''Extensible Markup Language'', XML can be used in MTA to read or write data.
MTA's map files are also in XML format.

Example of XML:
<syntaxhighlight lang="lua">[xml,n]
<meta>
<info author="Slothman" type="gamemode" name="Stealth" />
<config src="help.xml" type="client"/>

<script src="stealthmain_server.lua" />
<script src="noiseblip.lua" />
<script src="mission_timer.lua" />
<script src="gadgets_server.lua" />
<script src="gadgets_client.lua" type="client"/>
<script src="stealthmain_client.lua" type="client"/>
<script src="noisebar.lua" type="client"/>
<script src="spycam.lua" type="client"/>

<file src="riot_shield.txd" />
<file src="riot_shield.dff" />
<file src="riot_shield.col" />
<file src="armor.png" />
<file src="camera.png" />
<file src="cloak.png" />
<file src="goggles.png" />
<file src="mine.png" />
<file src="radar.png" />
<file src="shield.png" />

<include resource="scoreboard" />
<include resource="killmessages" />
<include resource="maplimits" />
</meta>
</syntaxhighlight>

==Related Scripting Functions==

{{XML functions}}

==See Also==
*[[Xmlnode]]
*[[Meta.xml]]
*[[Resource:Editor/EDF]]
*[http://forum.multitheftauto.com/viewtopic.php?f=91&t=22247 Meta.xml generator]
*[http://en.wikipedia.org/wiki/XML XML on Wikipedia]
*[http://www.w3.org/XML/ W3C XML homepage]

[[Category: Scripting Concepts]]

BanPlayer

2009-04-11T13:05:33Z

Winky:

__NOTOC__
{{Server function}}
{{New feature|3|1.0|
This function will ban the specified player by either IP, [[serial]] or username
}}

{{Deprecated_feature|3|1.0|
This function will ban the specified player from the server by IP.
}}

==Syntax==
{{New feature|3|1.0|
<syntaxhighlight lang="lua">
ban banPlayer ( player bannedPlayer, [ bool IP = true, bool Username = false, bool Serial = false, player responsiblePlayer = nil, string reason = nil, int seconds = 0 ] )
</syntaxhighlight>
}}

{{Deprecated_feature|3|1.0|
<syntaxhighlight lang="lua">
bool banPlayer ( player bannedPlayer , [ element responsibleElement, string reason ] )
</syntaxhighlight>
}}

===Required Arguments===
*'''bannedPlayer:''' The player that will be banned from the server.

===Optional Arguments===
{{OptionalArg}}
{{New feature|3|1.0|
*'''IP:''' Will player be banned by IP?
*'''Username:''' Will player be banned by username?
*'''Serial:''' Will player be banned by serial?

:'''Note:''' to ban by username or serial, ''verifyserials'' must be enabled in the server configuration file.

}}
*'''responsibleElement:''' The element that is responsible for banning the player. This can be a player or the root ([[getRootElement]]()).
*'''reason:''' The reason the player will be banned from the server.
*'''seconds:''' The amount of seconds the player will be banned from the server for. This can be 0 for an infinite amount of time.

===Returns===
{{Deprecated_feature|3|1.0|
Returns ''true'' if the player was banned succesfully, ''false'' if invalid arguments are specified.
}}

{{New feature|3|1.0|
Returns a [[ban]] pointer if banned successfully, or ''false'' if unsuccessful.
}}

==Example==
This example lets a player ban anyone if he has ACL rights.
<syntaxhighlight lang="lua">
--Add the "ban" command handler
-- Example with the player
function banPlayerCommand ( theClient, commandName, bannedName, reason )

-- Give the player a nice error if he doesn't have rights
if ( hasObjectPermissionTo ( theClient, "function.banPlayer" ) ) then
--Get player element from the name
local bannedPlayer = getPlayerFromNick ( bannedName )

--Ban the player
banPlayer ( bannedPlayer, theClient, reason )
outputChatBox ( "ban: " .. bannedName .. " successfully banned", theClient )

else
outputChatBox ( "ban: You don't have enough permissions", theClient )
end

end
addCommandHandler ( "ban", banPlayerCommand )

-- Example function with the root element. Here you would pass a player element to the function.
function banCheater(theCheater)
banPlayer(theCheater, getRootElement(), "You are banned because of cheating.")
end
</syntaxhighlight>

==See Also==
{{Admin_functions}}

GetPlayerSerial

2009-04-11T12:59:31Z

Winky:

__NOTOC__
{{Server client function}}
This function returns the [[serial]] for a specified [[player]].

==Syntax==
<syntaxhighlight lang="lua">
string getPlayerSerial ( player thePlayer )
</syntaxhighlight>

===Required Arguments===
*'''thePlayer:''' A [[player]] object referencing the specified player.

==Returns==
Returns the serial as a ''string'' if it was found, ''false'' otherwise.

{{New feature|3|1.0|
The format of the serial has been changed.
}}

==Example==
<section name="Server" class="server" show="true">
This example creates a command with which player can check their own serial.
<syntaxhighlight lang="lua">
function checkMySerial( thePlayer, command )
local theSerial = getPlayerSerial( thePlayer )
if theSerial then
outputChatBox( "Your serial is: " .. theSerial, thePlayer )
else
outputChatBox( "Sorry, you have no serial. =(", thePlayer )
end
end
addCommandHandler( "serial", checkMySerial )
</syntaxhighlight>
</section>

==See Also==
{{Serial functions}}

Serial

2009-04-11T12:49:54Z

Winky: Typo

[[Image:Community serial page.png|thumb|MTA Community Serial Page]]
Serials are used by MTA to identify players, serials are bound to your hardware configuration and your [http://community.mtasa.com/ MTA community account].
Serials can contain numbers and letters, the format:
<syntaxhighlight lang="lua">[n]
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
</syntaxhighlight>
Server administrators can ban the serial, this is useful for players who have a [http://en.wikipedia.org/wiki/Dynamic_IP dynamic IP].

From MTA 1.0 players can login ingame with the MTA community account.

==Related Scripting Functions==
{{Serial functions}}

[[Category:Scripting_Concepts]]

Serial

2009-04-11T12:42:29Z

Winky: New page: MTA Community Serial Page Serials are used by MTA to identify players, serials are bound to your hardware configuration and your [http://community...

[[Image:Community serial page.png|thumb|MTA Community Serial Page]]
Serials are used by MTA to identify players, serials are bound to your hardware configuration and your [http://community.mtasa.com/ MTA community account].
Serials can contain numbers and letters, the format:
<syntaxhighlight lang="lua">[n]
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
</syntaxhighlight>
Server administrators can ban the serial, this is usefull for players who have a [http://en.wikipedia.org/wiki/Dynamic_IP dynamic IP].

From MTA 1.0 players can login ingame with the MTA community account.

==Related Scripting Functions==
{{Serial functions}}

[[Category:Scripting_Concepts]]

File:Community serial page.png

2009-04-11T12:40:16Z

Winky: MTA Community 'my serials' page

MTA Community 'my serials' page

Math

2009-04-11T12:01:11Z

Winky: New page: Lua has buildin math functions, that you can use in scripts. <syntaxhighlight lang="lua"> math.abs math.acos math.asin math.atan math.atan2 math.ceil math.cos math.cosh math.deg math.exp...

Lua has buildin math functions, that you can use in scripts.

<syntaxhighlight lang="lua">
math.abs
math.acos
math.asin
math.atan
math.atan2
math.ceil
math.cos
math.cosh
math.deg
math.exp
math.floor
math.fmod
math.frexp
math.huge
math.ldexp
math.log
math.log10
math.max
math.min
math.modf
math.pi
math.pow
math.rad
math.random
math.randomseed
math.sin
math.sinh
math.sqrt
math.tanh
math.tan
</syntaxhighlight>

==See Also==
*[http://lua-users.org/wiki/MathLibraryTutorial Math examples on the LUA Wiki]
[[Category:Scripting Concepts]]

SetVehicleDirtLevel

2009-04-11T11:47:51Z

Winky: Added to category 'Needs_Example'

__NOTOC__
{{server client function}}
This function sets the dirt level on a vehicle.

==Syntax==
<syntaxhighlight lang="lua">
bool setVehicleDirtLevel ( vehicle theVehicle, int dirtLevel )
</syntaxhighlight>

===Required Arguments===
*'''theVehicle:''' The vehicle that you want to set the dirt level from
*'''dirtLevel:''' The dirt level

===Returns===
Returns ''true'' if the dirt level was set on the vehicle, ''false'' if the dirt level was not set or if invalid arguments are specified.

==Example==
<syntaxhighlight lang="lua">
--TODO
</syntaxhighlight>

==See Also==
{{Vehicle functions}}
[[Category:Needs_Example]]

ResetVehicleExplosionTime

2009-04-11T11:47:23Z

Winky: New page: {{Server function}} __NOTOC__ Resets the vehicle explosion time ==Syntax== <syntaxhighlight lang="lua"> bool resetVehicleExplosionTime ( vehicle theVehicle ) </syntaxhighlight> ===Required Arguments=== *'''theV...

{{Server function}}
__NOTOC__
Resets the vehicle explosion time

==Syntax==
<syntaxhighlight lang="lua">
bool resetVehicleExplosionTime ( vehicle theVehicle )
</syntaxhighlight>

===Required Arguments===
*'''theVehicle:''' The vehicle you wish to reset the explosion time from.

===Returns===
Returns ''true'' if the vehicle explosion time has been reset, ''false'' if it failed to reset the explosion time.

==Example==
<syntaxhighlight lang="lua">
--TODO
</syntaxhighlight>

==See Also==
{{Vehicle functions}}
[[Category:Needs_Example]]

SetVehicleDirtLevel

2009-04-11T11:42:25Z

Winky: New page: __NOTOC__ {{server client function}} This function sets the dirt level on a vehicle. ==Syntax== <syntaxhighlight lang="lua"> bool setVehicleDirtLevel ( vehicle theVehicle, int dirtLevel ) </syntaxhighlight> ===Re...

Template:Vehicle functions

2009-04-11T11:41:16Z

Winky: according to the source setVehicleDirtLevel is a serverside and clientside function

*[[blowVehicle]]
*[[createVehicle]]
*[[fixVehicle]]
*[[spawnVehicle]]
*[[respawnVehicle]]

*[[getVehicleColor]]
{{Deprecated_feature|3|1.0|
*[[getVehicleID]]
*[[getVehicleIDFromName]]
*[[getVehicleNameFromID]]
}}
*[[getVehicleMaxPassengers]]
{{New feature|3|1.0|
*[[getVehicleModelFromName]]
*[[getVehicleNameFromModel]]
}}
*[[getVehicleName]]
*[[getVehicleOccupant]]
*[[getVehicleController]]
*[[getVehicleRotation]]
*[[getVehicleType]]
*[[getVehicleTurnVelocity]]
*[[getVehicleTurretPosition]]
{{New feature|3|1.0|
*[[getVehicleType]]
*[[getTrainDirection]]
*[[getTrainSpeed]]
}}

*[[getVehiclesOfType]]
*[[getVehicleUpgradeOnSlot]]
*[[getVehicleUpgrades]]
*[[getVehicleUpgradeSlotName]]
*[[getVehicleCompatibleUpgrades]]
*[[getVehicleDoorState]]
*[[getVehicleEngineState]]
*[[getVehicleWheelStates]]
*[[getVehicleLightState]]
*[[getVehicleOverrideLights]]
*[[getVehiclePanelState]]
*[[getVehicleTowedByVehicle]]
*[[getVehicleTowingVehicle]]
*[[getVehiclePaintjob]]
*[[getVehicleSirensOn]]
*[[getVehicleLandingGearDown]]
{{New feature|3|1.0|
*[[isTrainDerailable]]
*[[isTrainDerailed]]
}}
*[[isVehicleFrozen]]
*[[isVehicleLocked]]
*[[isVehicleFuelTankExplodable]]
*[[isVehicleOnGround]]

*[[resetVehicleIdleTime]]
*[[resetVehicleExplosionTime]]

*[[setVehicleDirtLevel]]
*[[setVehicleColor]]
{{New feature|3|1.0|
*[[setTrainDerailable]]
*[[setTrainDerailed]]
*[[setTrainDirection]]
*[[setTrainSpeed]]
}}
*[[setVehicleFrozen]]
*[[setVehicleLocked]]
{{Deprecated_feature|3|1.0|
*[[setVehicleModel]]
}}
*[[setVehicleDoorsUndamageable]]
*[[setVehicleRotation]]
*[[setVehicleTurnVelocity]]
*[[addVehicleUpgrade]]
*[[removeVehicleUpgrade]]
*[[setVehicleDoorState]]
*[[setVehicleWheelStates]]
*[[setVehicleLightState]]
*[[toggleVehicleRespawn]]
*[[setVehicleOverrideLights]]
*[[attachTrailerToVehicle]]
*[[detachTrailerFromVehicle]]
*[[setVehiclePaintjob]]
*[[setVehiclePanelState]]
*[[setVehicleEngineState]]
*[[setVehicleFuelTankExplodable]]
*[[setVehicleSirensOn]]
*[[setVehicleGunsEnabled]]
*[[setVehicleLandingGearDown]]
*[[setVehicleDamageProof]]
*[[setVehicleRespawnPosition]]
*[[setVehicleRespawnDelay]]
*[[setVehicleIdleRespawnDelay]]
{{New feature|3|1.0|
*[[setVehicleTaxiLightOn]]
*[[isVehicleTaxiLightOn]]
}}

Vending

2009-04-08T07:59:07Z

Winky: Fixed a typo

San Andreas Vending machine location list.
<br>

{| class="prettytable" style="width:50%;"
|-
| '''ID:''' - '''Name:''' || '''X:''' || '''Y:''' || '''Z:''' || '''Rotation Z:'''
|-
| '''1302''' - '''vendmachfd''' || -2420.18 || 985.945 || 44.2969 || -90
|-
| '''1309''' - '''vendmach''' || -2420.22 || 984.578 || 44.2969 || -90
|-
| '''1977''' - '''vendin3''' || 316.875 || -140.352 || 998.586 || 90
|-
| '''1775''' - '''CJ_SPRUNK1''' || 2225.2 || -1153.42 || 1025.91 || 90
|-
| '''1775''' - '''CJ_SPRUNK1''' || 2155.91 || 1606.77 || 1000.05 || -90
|-
| '''1775''' - '''CJ_SPRUNK1''' || 2576.7 || -1284.43 || 1061.09 || 90
|-
| '''1775''' - '''CJ_SPRUNK1''' || 2222.2 || 1606.77 || 1000.05 || -90
|-
| '''1775''' - '''CJ_SPRUNK1''' || -19.0391 || -57.8359 || 1003.63 || 0
|-
| '''1775''' - '''CJ_SPRUNK1''' || -16.1172 || -91.6406 || 1003.63 || 0
|-
| '''ID''' - '''Name''' || X || Y || Z || Rotation Z
|-
| '''ID''' - '''Name''' || X || Y || Z || Rotation Z
|-
| '''ID''' - '''Name''' || X || Y || Z || Rotation Z
|-
| '''ID''' - '''Name''' || X || Y || Z || Rotation Z
|-
| '''ID''' - '''Name''' || X || Y || Z || Rotation Z
|-
| '''ID''' - '''Name''' || X || Y || Z || Rotation Z
|-
| '''ID''' - '''Name''' || X || Y || Z || Rotation Z
|-
|}

*'''Fine! I'll continue this later >_<'''

<section name="Server" class="server" show="true">
Raw list of data:
<syntaxhighlight lang="lua">
// Vending Machine data extracted from San Andreas IPL Files by MeKorea

VENDMACHFD
VENDMACH
VENDIN3
CJ_SPRUNK1
CJ_CANDYVENDOR
CJ_EXT_CANDY
CJ_EXT_SPRUNK

ICESCART_PROP
CHILLIDOGCART
NOODLECART_PROP

ID: Name: X: Y: Z: Rotation Z:

1302 vendmachfd -2420.18 985.945 44.2969 -90
1309 vendmach -2420.22 984.578 44.2969 -90
1977 vendin3 316.875 -140.352 998.586 90
1775 CJ_SPRUNK1 2225.2 -1153.42 1025.91 90
1775 CJ_SPRUNK1 2155.91 1606.77 1000.05 -90
1775 CJ_SPRUNK1 2576.7 -1284.43 1061.09 90
1775 CJ_SPRUNK1 2222.2 1606.77 1000.05 -90
1775 CJ_SPRUNK1 -19.0391 -57.8359 1003.63 0
1775 CJ_SPRUNK1 -16.1172 -91.6406 1003.63 0
1775 CJ_SPRUNK1 -32.4453 -186.695 1003.63 0
1775 CJ_SPRUNK1 -35.7266 -140.227 1003.63 0
1775 CJ_SPRUNK1 495.969 -24.3203 1000.73 0
1775 CJ_SPRUNK1 501.828 -1.42969 1000.73 0
1775 CJ_SPRUNK1 373.828 -178.141 1000.73 0
1776 CJ_CANDYVENDOR 330.68 178.5 1020.07 0
1776 CJ_CANDYVENDOR 331.922 178.5 1020.07 0
1776 CJ_CANDYVENDOR 350.906 206.086 1008.48 -90
1776 CJ_CANDYVENDOR 361.562 158.617 1008.48 0
1776 CJ_CANDYVENDOR 371.594 178.453 1020.07 0
1776 CJ_CANDYVENDOR 374.891 188.977 1008.48 0
1776 CJ_CANDYVENDOR 2155.84 1607.88 1000.06 -90
1776 CJ_CANDYVENDOR 2202.45 1617.01 1000.06 360
1776 CJ_CANDYVENDOR 2209.24 1621.21 1000.06 0
1776 CJ_CANDYVENDOR 2222.37 1602.64 1000.06 -90
1776 CJ_CANDYVENDOR -36.1484 -57.875 1003.63 360
1776 CJ_CANDYVENDOR -17.5469 -91.7109 1003.63 360
1776 CJ_CANDYVENDOR -16.5312 -140.297 1003.63 360
1776 CJ_CANDYVENDOR -33.875 -186.766 1003.63 360
1776 CJ_CANDYVENDOR 500.562 -1.36719 1000.73 0
1776 CJ_CANDYVENDOR 379.039 -178.883 1000.73 90
956 CJ_EXT_CANDY 1634.11 -2237.53 12.8906 0
956 CJ_EXT_CANDY 2480.86 -1959.27 12.9609 360
956 CJ_EXT_CANDY 2139.52 -1161.48 23.3594 -90
956 CJ_EXT_CANDY 2153.23 -1016.15 62.2344 308.132
956 CJ_EXT_CANDY -1350.12 493.859 10.5859 -90
956 CJ_EXT_CANDY -2229.19 286.414 34.7031 0
956 CJ_EXT_CANDY 1659.46 1722.86 10.2188 0
956 CJ_EXT_CANDY 2647.7 1129.66 10.2188 0
956 CJ_EXT_CANDY 1398.84 2222.61 10.4219 0
956 CJ_EXT_CANDY -1455.12 2591.66 55.2344 0
956 CJ_EXT_CANDY -76.0312 1227.99 19.125 -90
956 CJ_EXT_CANDY -253.742 2599.76 62.2422 -90
956 CJ_EXT_CANDY 662.43 -552.164 15.7109 360
955 CJ_EXT_SPRUNK 1789.21 -1369.27 15.1641 90
955 CJ_EXT_SPRUNK 1729.79 -1943.05 12.9453 0
955 CJ_EXT_SPRUNK 2060.12 -1897.64 12.9297 0
955 CJ_EXT_SPRUNK 1928.73 -1772.45 12.9453 -90
955 CJ_EXT_SPRUNK 2325.98 -1645.13 14.2109 0
955 CJ_EXT_SPRUNK 2352.18 -1357.16 23.7734 -90
955 CJ_EXT_SPRUNK 1154.73 -1460.89 15.1562 90
955 CJ_EXT_SPRUNK -1350.12 492.289 10.5859 -90
955 CJ_EXT_SPRUNK -2118.97 -423.648 34.7266 75.0001
955 CJ_EXT_SPRUNK -2118.62 -422.414 34.7266 75.0001
955 CJ_EXT_SPRUNK -2097.27 -398.336 34.7266 360
955 CJ_EXT_SPRUNK -2092.09 -490.055 34.7266 0
955 CJ_EXT_SPRUNK -2063.27 -490.055 34.7266 0
955 CJ_EXT_SPRUNK -2005.65 -490.055 34.7266 0
955 CJ_EXT_SPRUNK -2034.46 -490.055 34.7266 0
955 CJ_EXT_SPRUNK -2068.56 -398.336 34.7266 360
955 CJ_EXT_SPRUNK -2039.85 -398.336 34.7266 360
955 CJ_EXT_SPRUNK -2011.14 -398.336 34.7266 360
955 CJ_EXT_SPRUNK -1980.79 142.664 27.0703 90
955 CJ_EXT_SPRUNK 2319.99 2532.85 10.2188 0
955 CJ_EXT_SPRUNK 1520.15 1055.27 10 90
955 CJ_EXT_SPRUNK -862.828 1536.61 21.9844 0
955 CJ_EXT_SPRUNK -14.7031 1175.36 18.9531 0
955 CJ_EXT_SPRUNK -253.742 2597.95 62.2422 -90
955 CJ_EXT_SPRUNK 201.016 -107.617 0.898438 90
1340 chillidogcart 1589.7 -1287.27 17.6406 90
1340 chillidogcart 1000.48 -1849.04 12.7969 70
1340 chillidogcart 388.859 -2071.66 7.94531 90
1340 chillidogcart -2691.68 384.492 4.48438 45
1340 chillidogcart -2146.52 -424.773 35.3281 334.564
1340 chillidogcart -2094.23 -396.461 35.6562 309.564
1340 chillidogcart -2036.32 -396.758 35.6562 279.564
1340 chillidogcart 2537.82 2137.12 10.8594 0
1340 chillidogcart 1558.2 979.445 10.9453 0
1340 chillidogcart 2144.64 1441.93 10.8516 90
1340 chillidogcart -799.781 1624.22 27.125 72.0001
1340 chillidogcart -197.492 2659.91 62.8203 0
1340 chillidogcart -2199.99 -2386.89 30.7188 19.3753
1341 icescart_prop -2286.54 147.633 35.3203 315
1341 icescart_prop -2384.23 -584.008 132.109 360
1341 icescart_prop 2538.03 2153.7 10.7344 0
1341 icescart_prop 2295.71 2250.1 10.7344 0
1341 icescart_prop 1030.59 1362.59 10.8125 -90
1341 icescart_prop 2125.13 1442.08 10.7031 -90
1341 icescart_prop 2175.09 1523.41 10.7344 -90
1342 noodlecart_prop -2515.79 -15.6172 25.6328 325
1342 noodlecart_prop -2151.84 -435.562 35.2891 314.564
1342 noodlecart_prop -2193.77 605.188 35.2109 285
1342 noodlecart_prop -2194.02 613.406 35.2109 85.0001
1342 noodlecart_prop -2197.59 613.406 35.2109 65
1342 noodlecart_prop -2181.48 613.703 35.2109 65
1342 noodlecart_prop -2187.15 614.547 35.2109 80.0001
1342 noodlecart_prop 2536.12 2290.85 10.8594 360
</syntaxhighlight>
</section>
<br>
[[Category:Scripting Concepts]]

SetPedStat

2009-04-05T09:57:30Z

Winky: Updated for 1.0

{{Server function}}
{{Needs_Checking|
*Things like infinite run, fire proof CJ, 150 health, 150 armor have special activation flags. They need a way to be triggered on/off.
}}

{{Deprecated_feature|3|1.0|Note: Weapon stats are currently frozen.}}

__NOTOC__
This function allows you to set the value of a specific statistic for a [[ped]]. '''Visual stats (FAT and BODY_MUSCLE) can only be used on the CJ skin''', they have no effect on other skins.

==Syntax==
<syntaxhighlight lang="lua">
bool setPedStat ( ped thePed, int stat, float value )
</syntaxhighlight>

===Required Arguments===
*'''thePed''': the [[ped]] whose statistic you want to modify.
*'''stat''': the stat ID.
{{Stats}}

*'''value''': the new value of the stat (0..999)

===Returns===
Returns ''true'' if the statistic was changed succesfully. Returns ''false'' if an invalid player is specified, if the stat-id/value is out of acceptable range or if the FAT or BODY_MUSCLE stats are used on non-CJ players.

==Example==
This example allows a player to type the command 'beefcake' to change his player's BODY_MUSCLE stat (#23) to the maximum value of 999. This will result in him looking really muscular.

<syntaxhighlight lang="lua">function changeBodyStrength ( player, commandName )
-- Output whether the setPlayerStat was successful in changing the BODY_MUSCLE STAT
if setPedStat ( player, 23, 999 ) then
outputChatBox ( "Your player looks really muscular" )
else
outputChatBox ( "Failed to make your player look muscular." )
end
end
addCommandHandler ( "beefcake", changeBodyStrength )
</syntaxhighlight>

==See Also==
{{Ped functions}}

OnPlayerWasted

2009-04-04T15:55:05Z

Winky: Updated for 1.0

__NOTOC__
{{Server event}}
This event is triggered when a player is killed or dies.

==Parameters==
{{New feature|3|1.0|<syntaxhighlight lang="lua">
int totalAmmo, element killer, int killerWeapon, int bodypart [, bool stealth ]
</syntaxhighlight>}}

{{Deprecated_feature|3|1.0|<syntaxhighlight lang="lua">
int totalAmmo, element killer, int killerWeapon, int bodypart
</syntaxhighlight>}}

*'''totalAmmo''': an integer representing the total ammo the victim had when he died.
*'''killer''': an [[element]] representing the player or vehicle who was the killer. If there was no killer this is ''false''.
*'''killerWeapon''': an integer representing the [[weapon]] the killer used to kill the player.
*'''bodypart''': an integer representing the bodypart ID the victim was hit on when he died.
{{BodyParts}}
*{{New feature|3|1.0|'''stealth''': boolean value representing whether or not this was a stealth kill}}

==Source==
The [[event system#Event source|source]] of this event is the [[player]] that died or got killed.

==Example==
This example prints the killer and bodypart to the chat when a player dies.
<syntaxhighlight lang="lua">
-- register player_Wasted as a handler for onPlayerWasted
function player_Wasted ( ammo, attacker, weapon, bodypart )
-- if there was an attacker
if ( attacker ) then
-- we declare our variable outside the following checks
local tempString
-- if the element that killed him was a player,
if ( getElementType ( attacker ) == "player" ) then
-- put the attacker, victim and weapon info in the string
tempString = getClientName ( attacker ).." killed "..getClientName ( source ).." ("..getWeaponNameFromID ( weapon )..")"
-- else, if it was a vehicle,
elseif ( getElementType ( attacker ) == "vehicle" ) then
-- we'll get the name from the attacker vehicle's driver
local tempString = getClientName ( getVehicleController ( attacker ) ).." killed "..getClientName ( source ).." ("..getWeaponNameFromID ( weapon )..")"
end
-- if the victim was shot in the head, append a special message
if ( bodypart == 9 ) then
tempString = tempString.." (HEADSHOT!)"
-- else, just append the bodypart name
else
tempString = tempString.." ("..getBodyPartName ( bodypart )..")"
end
-- display the message
outputChatBox ( tempString )
-- if there was no attacker,
else
-- output a death message without attacker info
outputChatBox ( getClientName ( source ).." died. ("..getWeaponNameFromID ( weapon )..") ("..getBodyPartName ( bodypart )..")" )
end
end
addEventHandler ( "onPlayerWasted", getRootElement(), player_Wasted )
</syntaxhighlight>

And another example, this will spawn you in the middle of GTA SA world (x=0, y=0, z=3) after 2 seconds of your death
<syntaxhighlight lang="lua">
addEventHandler( "onPlayerWasted", getRootElement( ),
function( )
setTimer( spawnPlayer, 2000, 1, source, 0, 0, 3 ) )
end
)
</syntaxhighlight>

{{See also/Server event|Player events}}

ResetVehicleIdleTime

2009-02-27T09:07:56Z

Winky: Forgot the 'See Also'

{{Server function}}
__NOTOC__
Resets the vehicle idle time

==Syntax==
<syntaxhighlight lang="lua">
bool resetVehicleIdleTime ( vehicle theVehicle )
</syntaxhighlight>

===Required Arguments===
*'''theVehicle:''' The vehicle you wish to reset the idle time from.

===Returns===
Returns ''true'' if the vehicle idle time has been reset, ''false'' if it failed to reset the idle time.

==Example==
<syntaxhighlight lang="lua">
--Example here
</syntaxhighlight>

==See Also==
{{Vehicle functions}}
[[Category:Needs_Example]]

GetFunctionsBoundToKey

2009-02-26T09:46:07Z

Winky: New page: __NOTOC__ {{Server function}} Gets the functions bound to a key. To bind a function to a key use the bindKey function ==Syntax== <syntaxhighlight lang="lua"> string getFunctionsBoundToKey ( player th...

__NOTOC__
{{Server function}}
Gets the functions bound to a key. To bind a function to a key use the [[bindKey]] function

==Syntax==
<syntaxhighlight lang="lua">
string getFunctionsBoundToKey ( player thePlayer, string theKey )
</syntaxhighlight>

===Required Arguments===
*'''thePlayer:''' The player to get the functions from a key.
*'''theKey:''' The key you wish to check the functions from.

===Returns===
Returns a string of the functions bound on that key.

==Example==
<syntaxhighlight lang="lua">
--Example here
</syntaxhighlight>

==See Also==
{{Input_functions}}
[[Category:Needs_Example]]

UnbanSerial

2009-02-26T09:24:09Z

Winky: New page: __NOTOC__ {{Server function}} {{Deprecated}} ==Syntax== <syntaxhighlight lang="lua"> bool unbanSerial ( string serialToUnban ) </syntaxhighlight> ==See Also== {{Admin_functions}}

__NOTOC__
{{Server function}}
{{Deprecated}}

==Syntax==
<syntaxhighlight lang="lua">
bool unbanSerial ( string serialToUnban )
</syntaxhighlight>

==See Also==
{{Admin_functions}}

ResetVehicleIdleTime

2009-02-26T09:19:23Z

Winky: I guess this is a serverside function