https://wiki.multitheftauto.com/api.php?action=feedcontributions&user=Arc&feedformat=atomMulti Theft Auto: Wiki - User contributions [en]2024-03-29T12:18:27ZUser contributionsMediaWiki 1.39.3https://wiki.multitheftauto.com/index.php?title=Resource:Race&diff=24021Resource:Race2010-07-10T17:12:00Z<p>Arc: /* Element data */</p>
<hr />
<div>{{Resource page}}<br />
__NOTOC__<br />
The "race" gamemode organizes sprint or freeroam races for one or more players. It supports both maps from MTA:Race and maps in the MTA:SA DM map syntax that were created in the map editor.<br />
<br />
==Ingame==<br />
Playing race is quite straightforward. If there are checkpoints, drive from checkpoint to checkpoint and be the first to reach the finish line within the time. If there are no checkpoints, just drive around and have fun.<br />
<br />
In races you may encounter three types of pickups which will have an effect on your vehicle:<br />
*'''Repair pickups:''' this pickup looks like a wrench. If you drive over it, your vehicle will be restored to full health.<br />
*'''Nitrous oxide pickups:''' a red NOS bottle. After you drive over one you can press the fire button (by default the left mouse button) to get a temporary speed boost.<br />
*'''Vehicle change pickups:''' these display the name of a vehicle above them. As soon as you drive over a pickup your vehicle will be changed.<br />
<br />
Lastly, if you get stuck during a race, you can enter the /kill command in the chatbox to kill yourself and respawn at the previous checkpoint.<br />
<br />
==Converting MTA:Race maps==<br />
Use the [http://files.mtasa.com/apps/1.0/raceconv.zip batch converter] to convert all your MTA:Race maps into MTA:SA maps in one go.<br />
<br />
==Map syntax==<br />
You can create race maps using the new MTA:SA [[Resource:editor|map editor]]. The map syntax is given here for reference.<br />
<br />
===.map file===<br />
<syntaxhighlight lang="xml"><br />
<map mod="deathmatch"><br />
<!-- One or more --><br />
<spawnpoint posX="X" posY="Y" posZ="Z" rotation="Rotation in degrees" vehicle="Vehicle ID" id="spawnpointID" [ paintjob="paintjob ID" upgrades="comma-separated list of upgrades" ] /><br />
<br />
<!-- Zero or more --><br />
<checkpoint posX="X" posY="Y" posZ="Z" color="#FF0000" id="textual or numeric checkpoint ID" nextid="ID of checkpoint after this one" [ size="checkpoint size" vehicle="vehicle ID to change into" paintjob="paintjob ID" upgrades="comma-separated list of upgrades" ] /><br />
<br />
<!-- Zero or more --><br />
<object posX="X" posY="Y" posZ="Z" rotX="in degrees" rotY="in degrees" rotZ="in degrees" model="model ID" id="objectID" /><br />
<br />
<!-- Zero or more --><br />
<pickup posX="X" posY="Y" posZ="Z" type="repair|nitro|vehiclechange" id="pickupID" [ vehicle="vehicle ID" paintjob="paintjob ID" upgrades="comma-separated list of upgrades" ] /><br />
</map><br />
</syntaxhighlight><br />
<br />
===meta.xml===<br />
<syntaxhighlight lang="xml"><br />
<meta><br />
<info type="map" gamemodes="race" name="Map name" author="Author name" description="Map description" version="Map version number"/><br />
<race src="Map file.map"/><br />
<settings><br />
<setting name="#optionName" value="optionValue"/><br />
...<br />
</settings><br />
</meta><br />
</syntaxhighlight><br />
The <setting>s correspond to options in MTA:Race syntax. For example, <time>4:0</time> in MTA:Race syntax would correspond to <setting name="#time" value="4:0"/> in DM syntax.<br />
<br />
==Addons==<br />
A Race 'addon' is no different from any other script resource, except that is has addon="race" in the <info> section of it's meta.xml file. This is simply to allow Race to identify it and put it in the /config menu for you. Addons communicate with Race via events. The current list of Race events and what they do are here:<br />
<br />
==Events for version 0.8.3==<br />
'''Note:''' You may have to add the events in your script using addEvent() if you want to use them.<br />
===Server===<br />
<br />
{| class="wikitable" border="0"<br />
|-<br />
|width="200pt"|'''Name'''<br />
|width="60pt"|'''Source'''<br />
|'''Parameters''' <br />
|}<br />
<br />
{| class="wikitable" border="0"<br />
|-<br />
|width="200pt"|'''onPlayerReachCheckpoint'''<br />
|width="60pt"|player <br />
|<syntaxhighlight lang="lua">int checkpoint, int time_</syntaxhighlight> <br />
|}<br />
<br />
{| class="wikitable" border="0"<br />
|-<br />
|width="200pt"|'''onPlayerPickUpRacePickup'''<br />
|width="60pt"|player <br />
|<syntaxhighlight lang="lua">int/string pickupID, string pickupType, int vehicleModel</syntaxhighlight><br />
|}<br />
<br />
{| class="wikitable" border="0"<br />
|- <br />
|width="200pt"|'''onMapStarting'''<br />
|width="60pt"|<br />
|<syntaxhighlight lang="lua">table mapInfo, table mapOptions, table gameOptions</syntaxhighlight> <br />
|}<br />
<br />
{| class="wikitable" border="0"<br />
|- <br />
|width="200pt"|'''onPlayerFinish'''<br />
|width="60pt"|player <br />
|height="20pt"|<syntaxhighlight lang="lua">int rank, int time</syntaxhighlight> <br />
|}<br />
<br />
{| class="wikitable" border="0"<br />
|- <br />
|width="200pt"|'''onPostFinish''' <br />
|width="60pt"|<br />
|height="38pt"| <br />
|}<br />
<br />
{| class="wikitable" border="0"<br />
|- <br />
|width="200pt"|'''onPollStarting'''<br />
|width="60pt"|<br />
|<syntaxhighlight lang="lua">table poll</syntaxhighlight> <br />
|}<br />
<br />
{| class="wikitable" border="0"<br />
|- <br />
|width="200pt"|'''onRaceStateChanging'''<br />
|width="60pt"|<br />
|<syntaxhighlight lang="lua">string newStateName, string oldStateName</syntaxhighlight> <br />
|- <br />
|}<br />
<br />
{| class="wikitable" border="0"<br />
|- <br />
|width="200pt"|'''onPlayerRaceWasted'''<br />
|width="60pt"|player<br />
|<syntaxhighlight lang="lua">vehicle playersVehicle</syntaxhighlight> <br />
|- <br />
|}<br />
<br />
===Client===<br />
<br />
{| class="wikitable" border="0"<br />
|- <br />
|width="200pt"|'''onClientMapStarting'''<br />
|width="60pt"|<br />
|<syntaxhighlight lang="lua">table mapinfo</syntaxhighlight> <br />
|- <br />
|}<br />
<br />
{| class="wikitable" border="0"<br />
|- <br />
|width="200pt"|'''onClientPlayerFinish'''<br />
|width="60pt"|player <br />
|height="38pt"|<br />
|- <br />
|}<br />
<br />
{| class="wikitable" border="0"<br />
|- <br />
|width="200pt"|'''onClientPlayerOutOfTime'''<br />
|width="60pt"|player <br />
|height="38pt"|<br />
|- <br />
|}<br />
<br />
{| class="wikitable" border="0"<br />
|- <br />
|width="200pt"|'''onClientMapStopping'''<br />
|width="60pt"|<br />
|height="38pt"|<br />
|- <br />
|}<br />
<br />
{| class="wikitable" border="0"<br />
|- <br />
|width="200pt"|'''onClientScreenFadedOut'''<br />
|width="60pt"|<br />
|height="38pt"|<br />
|- <br />
|}<br />
<br />
{| class="wikitable" border="0"<br />
|- <br />
|width="200pt"|'''onClientScreenFadedIn'''<br />
|width="60pt"|<br />
|height="38pt"|<br />
|- <br />
|}<br />
<br />
==Events for version 0.8.3 in detail==<br />
'''Note:''' You may have to add the events in your script using addEvent() if you want to use them.<br />
===onPlayerReachCheckpoint===<br />
Triggered when a player reaches any checkpoint but the last one.<br />
====Parameters====<br />
<syntaxhighlight lang="lua">int checkpoint, int time</syntaxhighlight><br />
*'''checkpoint:''' the number of the checkpoint the player went through. The first checkpoint has number 1.<br />
*'''time:''' time since the race started, in milliseconds.<br />
<br />
====Source====<br />
The source is the player that reached the checkpoint.<br />
<br />
===onPlayerFinish===<br />
Triggered when a player reaches the last checkpoint (i.e. has finished the race)<br />
====Parameters====<br />
<syntaxhighlight lang="lua">int rank, int time</syntaxhighlight><br />
*'''rank:''' the player's rank. 1 means he won the race, 2 that he came in second place, etc.<br />
*'''time:''' time since the race started, in milliseconds.<br />
<br />
====Source====<br />
The source is the player that finished the race.<br />
<br />
===onPlayerPickUpRacePickup===<br />
====Parameters====<br />
<syntaxhighlight lang="lua">int/string pickupID, string pickupType, int vehicleModel</syntaxhighlight><br />
*'''pickupID:''' the number of the pickup in case of MTA:Race syntax (starting at 1), or the "id" attribute of the pickup in case of DM syntax.<br />
*'''pickupType:''' the pickup type. Can be "nitro", "repair" or "vehiclechange".<br />
*'''vehicleModel:''' if the pickup is of type vehiclechange, this is the vehicle model that it sets.<br />
<br />
====Source====<br />
The source is the player that picked up the pickup.<br />
<br />
==Element data==<br />
These element data are set on each player:<br />
*'''race rank:''' the current position of the player in the race. 1 = first, 2 = second etc. Updated on a 1 second interval.<br />
*'''race.checkpoint:''' the number of the checkpoint the player is ''heading for''. When the player spawns this number is 1, after he passed the first checkpoint it's 2, etc.<br />
*'''race.finished:''' ''true'' if the player has finished, ''false'' if he's still racing.<br />
<br />
This server only element data is set for the resource root element:<br />
*'''info:''' which contains a table with these sub-tables: '''mapInfo''', '''mapOptions''' and '''gameOptions'''.<br />
<br />
==Super Advanced Element data==<br />
You can also set player element data to change the player collision status and render transparency:<br />
<syntaxhighlight lang="lua"><br />
e.g. setElementData( thePlayer, "overrideCollide.uniqueblah", 0, false ) -- Collide 'off' for this player<br />
setElementData( thePlayer, "overrideCollide.uniqueblah", nil, false ) -- Collide 'default' for this player<br />
setElementData( thePlayer, "overrideAlpha.uniqueblah", 120, false ) -- Alpha '120 maximum' for this player<br />
setElementData( thePlayer, "overrideAlpha.uniqueblah", nil, false ) -- Alpha 'default' for this player<br />
</syntaxhighlight><br />
Set 'uniqueblah' to whatever you like (up to 15 characters long)<br />
<br />
==Exported Server functions==<br />
<br />
{| class="wikitable" border="0"<br />
|- <br />
|width="80pt"|<syntaxhighlight lang="lua">int</syntaxhighlight><br />
|width="110pt"|'''getTimePassed'''<br />
|height="38pt"|<br />
|- <br />
|}<br />
<br />
{| class="wikitable" border="0"<br />
|- <br />
|width="80pt"|<syntaxhighlight lang="lua">int</syntaxhighlight><br />
|width="110pt"|'''getPlayerRank'''<br />
|<syntaxhighlight lang="lua">player thePlayer</syntaxhighlight><br />
|- <br />
|}<br />
<br />
{| class="wikitable" border="0"<br />
|- <br />
|width="80pt"|<syntaxhighlight lang="lua">boolean</syntaxhighlight><br />
|width="110pt"|'''isPlayerFinished'''<br />
|<syntaxhighlight lang="lua">player thePlayer</syntaxhighlight><br />
|- <br />
|}<br />
<br />
{| class="wikitable" border="0"<br />
|- <br />
|width="80pt"|<syntaxhighlight lang="lua">vehicle</syntaxhighlight><br />
|width="110pt"|'''getPlayerVehicle'''<br />
|<syntaxhighlight lang="lua">player thePlayer</syntaxhighlight><br />
|- <br />
|}</div>Archttps://wiki.multitheftauto.com/index.php?title=Known_Issues_-_FAQ&diff=22825Known Issues - FAQ2010-04-05T11:29:29Z<p>Arc: /* Crash after MTA splash screen */</p>
<hr />
<div>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.<br />
<br />
[[Resource:Editor#FAQ|Map editor FAQ/known issues can be found here.]]<br />
<br />
<br />
== Client ==<br />
<br />
=== General ===<br />
==== Does MTASA work with v1.01 or v2.00 of GTA San Andreas? ====<br />
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.<br />
<br />
==== Initial black screen/hanging GTA splash screens ====<br />
* '''MTA shows a permanent black screen or hanging GTA splash screens.'''<br />
<br />
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.<br />
<br />
* '''MTA shows a permanent black screen after the GTA splash screens (possibly with text in the bottom right corner).'''<br />
<br />
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''.<br />
<br />
==== Halt after MTA splash screen ====<br />
* '''Nothing happens after the 'Stop playing with yourself' splash screen'''<br />
<br />
If you use nVidia GeForce, try turning off nView Desktop Manager before starting MTA.<br />
<br />
Also try deleting GTA San Andreas settings file ("gta_sa.set") in "Documents\GTA San Andreas User Files" folder<br />
<br />
==== Crash after MTA splash screen ====<br />
* '''MTA crashes after the 'Stop playing with yourself' logo. Both single player and the MTA: Race ran fine before.'''<br />
<br />
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.<br />
<br />
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.<br />
<br />
If you are a user of Windows Vista or Windows 7, try the following:<br />
* Enable Windows XP SP3 compatiblity mode for both Multi Theft Auto.exe and gta_sa.exe, setting their privilege level to "Run this program as an administrator".<br />
* Configure Data Execution Prevention: Use the setting ''Turn DEP for all programs and services except those I select''. Click ''add'' and find "Multi Theft Auto.exe" and "gta_sa.exe" and add them.<br />
* Run MTASA as administrator.<br />
<br />
==== Assertion in CMainMenu.cpp line 106 upon launching MTASA ====<br />
* '''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.'''<br />
<br />
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. <br />
<br />
To resolve this, you need to uninstall MTA:SA and GTASA, then install them in such paths that don't contain such characters.<br />
<br />
==== Crash after connecting to any server ====<br />
* '''MTASA crashes upon connecting to any server. Single player runs fine.'''<br />
<br />
Single player mods can affect the way MTA:SA works, potentially causing crashes - you should always use a clean GTASA install for MTA:SA.<br />
<br />
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].<br />
<br />
==== Controls not working ====<br />
* '''My controls don't seem to work as they should.'''<br />
<br />
Try using the 'copygtacontrols' command in the console.<br />
<br />
==== Incorrect models ====<br />
* '''Woman model's breasts look awkward ingame / I'm seeing odd, spider-like shaped player models.'''<br />
<br />
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.<br />
<br />
==== Incorrect drive-by functionality ====<br />
* '''Drivebys arent working as they should'''<br />
<br />
Drivebys are handled by script, and will change depending on the loaded gamemode.<br />
<br />
==== Unsaved settings ====<br />
* '''My MTA setting(s) didn't get saved (...) I crashed.'''<br />
<br />
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.<br />
<br />
==== Gamepad support ====<br />
* '''MTA doesn't recognise my gamepad'''<br />
<br />
Ensure that your controller is the first controller recognised by Windows (MTA will only use the first controller). You can configure your gamepad in options in MTASA's main menu.<br />
<br />
==== Free mouselook not working properly ====<br />
* '''MTA doesnt recognise my mouse'''<br />
<br />
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.<br />
This problem can be solved by entering a server, click your Win/Windows key at your keyboard once, and then click your mouse.<br />
If that doesn't work try starting GTA in Singleplayer, go to options > controler setup and set "Configuration" to "Mouse + Keys" instead of "Joypad".<br />
<br />
<br />
==== Server browser not working ====<br />
* '''The in-game server browser shows "Loading" but does not come up with any servers'''<br />
<br />
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.<br />
<br />
If all else fails, you can logon to [http://www.game-monitor.com/search.php?game=mta GameMonitor], and click the green play icon to play on that server.<br />
<br />
==== Invalid serial number ====<br />
* '''I am getting an 'Invalid serial number' error when trying to launch or play the game'''<br />
<br />
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.<br />
<br />
==== 'Network module could not be located' ====<br />
* '''I am getting 'Network module could not be located' error message upon launching MTA:SA DM<br />
<br />
Copy the file 'net.dll' from your GTA:SA/mta directory into your GTA:SA directory, overwriting existing files.<br />
<br />
==== 'Network module not compatible!' on MTASA launch ====<br />
* '''I am getting 'Network module not compatible!' error message upon launching MTA:SA DM<br />
<br />
This could mean that your MTASA install is incomplete or broken. Reinstall it.<br />
<br />
==== 'No such mod installed (deathmatch)' ====<br />
* '''I am getting a 'No such mod installed (deathmatch)' error message when trying to connect to any server<br />
<br />
'''Option 1:''' Simply re-install MTA. <br><br />
'''Option 2:''' Run both gta_sa.exe and Multi Theft Auto.exe with administrator privileges.<br />
<br />
==== D3dx9_**.dll is not found ====<br />
* '''When I start Multi Theft Auto: San Andreas I am getting an error D3dx9_**.dll (** = a number) cannot be found.<br />
<br />
This means that DirectX 9 is not installed or not up to date.<br />
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.<br />
<br />
=== Windows Vista®-related ===<br />
<br />
==== Crash on launch ====<br />
* '''I've successfully upgraded from MTA Race to MTASA DM on Vista, but it seems to crash on launch.<br />
<br />
'''Option 1''' Go to your Program Files\MTA San Andreas\mods\race directory, and rename client.dll to something else. <br><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.<br />
<br />
==== Crash on connect ====<br />
* '''I seem to crash whenever I connect to a server just before I go in-game on Vista'''<br />
<br />
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.<br />
<br />
==== Invalid or disabled serial error ====<br />
* '''MTASA DM installer complains about wrong serial provided. I'm running it for the first time.<br />
<br />
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.<br />
<br />
Some have found that setting compatibility to Windows XP/2000 have fixed the problem.<br />
<br />
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.<br />
<br />
*'''I am getting 'invalid serial' when I try to connect to a server'''<br />
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:<br />
<br />
Open regedit (start > run > regedit)<br><br />
Go to HKEY_LOCAL_MACHINE\SOFTWARE\Multi Theft Auto: San Andreas<br><br />
Create a new string key called Username and fill there the username you have on mtabeta.com<br><br />
Create one more string key called Serial and paste there the serial from mtabeta.com<br><br />
<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]<br />
<br />
*'''I am getting 'disabled serial' when I try to connect to a server'''<br />
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.<br />
<br />
==== Clock manipulation error ====<br />
* '''I am getting 'Clock manipulation detected!' error message upon launching MTA:SA DM<br />
<br />
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.<br />
<br />
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].<br />
<br />
==== Halt on launch ====<br />
* '''When I launch MTA:SA DM, nothing happens (GTA_SA.exe is running but not loading up)<br />
<br />
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.<br />
<br />
==== General GTA problems ====<br />
* '''I have unexplainable GTA problems or crashes'''<br />
<br />
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.<br />
<br />
Also try the solutions from these pages:<br />
* http://www.gtaforums.com/index.php?showtopic=273549&view=findpost&p=4537502<br />
* http://pullmonkey.com/2007/4/30/how-i-got-gta-san-andreas-to-work-with-a-crappy-os-vista<br />
<br />
== Server ==<br />
<br />
=== General ===<br />
==== Fatal error 3 ====<br />
* '''I'm getting ''Fatal Error 3'' whenever I connect to my server'''<br />
<br />
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'''.<br />
==== Download error 9: Error downloading requested files ====<br />
* '''I'm getting ''Download Error 9: Error downloading requested files'' whenever I connect to my server'''<br />
<br />
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.<br />
<br />
* 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.<br />
<br />
* 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.<br />
==== Download error 28 ====<br />
Try closing anti-virus or firewall applications. If it then works, try adding an exception to your firewall to allow your http port through.<br />
<br />
=== Windows-related ===<br />
No known reported issues in the version {{Current Version|full}}.<br />
<br />
=== Linux-related ===<br />
====Default nohup creates infinitely big nohup.out====<br />
<br />
Temporary fix, disable the nohup file: 'nohup ./mta_server > /dev/null &'<br />
<br />
====Download error #0-52 when running several servers on the same machine====<br />
<br />
Temporary fix: http://forum.multitheftauto.com/viewtopic.php?f=106&t=25152#p295646<br />
<br />
This issue is fixed in the next MTASA release (1.0.1)<br />
<br />
[[es:Problemas Conocidos - FAQ]]<br />
[[it:Bugs noti e FAQ]]<br />
[[ru:Known Issues - FAQ]]</div>Archttps://wiki.multitheftauto.com/index.php?title=Known_Issues_-_FAQ&diff=22824Known Issues - FAQ2010-04-05T11:27:46Z<p>Arc: /* Crash after MTA splash screen */</p>
<hr />
<div>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.<br />
<br />
[[Resource:Editor#FAQ|Map editor FAQ/known issues can be found here.]]<br />
<br />
<br />
== Client ==<br />
<br />
=== General ===<br />
==== Does MTASA work with v1.01 or v2.00 of GTA San Andreas? ====<br />
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.<br />
<br />
==== Initial black screen/hanging GTA splash screens ====<br />
* '''MTA shows a permanent black screen or hanging GTA splash screens.'''<br />
<br />
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.<br />
<br />
* '''MTA shows a permanent black screen after the GTA splash screens (possibly with text in the bottom right corner).'''<br />
<br />
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''.<br />
<br />
==== Halt after MTA splash screen ====<br />
* '''Nothing happens after the 'Stop playing with yourself' splash screen'''<br />
<br />
If you use nVidia GeForce, try turning off nView Desktop Manager before starting MTA.<br />
<br />
Also try deleting GTA San Andreas settings file ("gta_sa.set") in "Documents\GTA San Andreas User Files" folder<br />
<br />
==== Crash after MTA splash screen ====<br />
* '''MTA crashes after the 'Stop playing with yourself' logo. Both single player and the MTA: Race ran fine before.'''<br />
<br />
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.<br />
<br />
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.<br />
<br />
If you are a user of Windows Vista or Windows 7, try the following:<br />
* Enable Windows XP SP3 compatiblity mode for both Multi Theft Auto.exe and gta_sa.exe, setting their privilege level to "Run this program as an administrator".<br />
* Configure Data Execution Prevention: Use the setting ''Turn DEP for all programs and services except those I select''. Click ''add'' and find "MTA San Andreas.exe" and "gta_sa.exe" and add them.<br />
* Run MTASA as administrator.<br />
<br />
==== Assertion in CMainMenu.cpp line 106 upon launching MTASA ====<br />
* '''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.'''<br />
<br />
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. <br />
<br />
To resolve this, you need to uninstall MTA:SA and GTASA, then install them in such paths that don't contain such characters.<br />
<br />
==== Crash after connecting to any server ====<br />
* '''MTASA crashes upon connecting to any server. Single player runs fine.'''<br />
<br />
Single player mods can affect the way MTA:SA works, potentially causing crashes - you should always use a clean GTASA install for MTA:SA.<br />
<br />
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].<br />
<br />
==== Controls not working ====<br />
* '''My controls don't seem to work as they should.'''<br />
<br />
Try using the 'copygtacontrols' command in the console.<br />
<br />
==== Incorrect models ====<br />
* '''Woman model's breasts look awkward ingame / I'm seeing odd, spider-like shaped player models.'''<br />
<br />
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.<br />
<br />
==== Incorrect drive-by functionality ====<br />
* '''Drivebys arent working as they should'''<br />
<br />
Drivebys are handled by script, and will change depending on the loaded gamemode.<br />
<br />
==== Unsaved settings ====<br />
* '''My MTA setting(s) didn't get saved (...) I crashed.'''<br />
<br />
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.<br />
<br />
==== Gamepad support ====<br />
* '''MTA doesn't recognise my gamepad'''<br />
<br />
Ensure that your controller is the first controller recognised by Windows (MTA will only use the first controller). You can configure your gamepad in options in MTASA's main menu.<br />
<br />
==== Free mouselook not working properly ====<br />
* '''MTA doesnt recognise my mouse'''<br />
<br />
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.<br />
This problem can be solved by entering a server, click your Win/Windows key at your keyboard once, and then click your mouse.<br />
If that doesn't work try starting GTA in Singleplayer, go to options > controler setup and set "Configuration" to "Mouse + Keys" instead of "Joypad".<br />
<br />
<br />
==== Server browser not working ====<br />
* '''The in-game server browser shows "Loading" but does not come up with any servers'''<br />
<br />
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.<br />
<br />
If all else fails, you can logon to [http://www.game-monitor.com/search.php?game=mta GameMonitor], and click the green play icon to play on that server.<br />
<br />
==== Invalid serial number ====<br />
* '''I am getting an 'Invalid serial number' error when trying to launch or play the game'''<br />
<br />
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.<br />
<br />
==== 'Network module could not be located' ====<br />
* '''I am getting 'Network module could not be located' error message upon launching MTA:SA DM<br />
<br />
Copy the file 'net.dll' from your GTA:SA/mta directory into your GTA:SA directory, overwriting existing files.<br />
<br />
==== 'Network module not compatible!' on MTASA launch ====<br />
* '''I am getting 'Network module not compatible!' error message upon launching MTA:SA DM<br />
<br />
This could mean that your MTASA install is incomplete or broken. Reinstall it.<br />
<br />
==== 'No such mod installed (deathmatch)' ====<br />
* '''I am getting a 'No such mod installed (deathmatch)' error message when trying to connect to any server<br />
<br />
'''Option 1:''' Simply re-install MTA. <br><br />
'''Option 2:''' Run both gta_sa.exe and Multi Theft Auto.exe with administrator privileges.<br />
<br />
==== D3dx9_**.dll is not found ====<br />
* '''When I start Multi Theft Auto: San Andreas I am getting an error D3dx9_**.dll (** = a number) cannot be found.<br />
<br />
This means that DirectX 9 is not installed or not up to date.<br />
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.<br />
<br />
=== Windows Vista®-related ===<br />
<br />
==== Crash on launch ====<br />
* '''I've successfully upgraded from MTA Race to MTASA DM on Vista, but it seems to crash on launch.<br />
<br />
'''Option 1''' Go to your Program Files\MTA San Andreas\mods\race directory, and rename client.dll to something else. <br><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.<br />
<br />
==== Crash on connect ====<br />
* '''I seem to crash whenever I connect to a server just before I go in-game on Vista'''<br />
<br />
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.<br />
<br />
==== Invalid or disabled serial error ====<br />
* '''MTASA DM installer complains about wrong serial provided. I'm running it for the first time.<br />
<br />
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.<br />
<br />
Some have found that setting compatibility to Windows XP/2000 have fixed the problem.<br />
<br />
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.<br />
<br />
*'''I am getting 'invalid serial' when I try to connect to a server'''<br />
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:<br />
<br />
Open regedit (start > run > regedit)<br><br />
Go to HKEY_LOCAL_MACHINE\SOFTWARE\Multi Theft Auto: San Andreas<br><br />
Create a new string key called Username and fill there the username you have on mtabeta.com<br><br />
Create one more string key called Serial and paste there the serial from mtabeta.com<br><br />
<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]<br />
<br />
*'''I am getting 'disabled serial' when I try to connect to a server'''<br />
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.<br />
<br />
==== Clock manipulation error ====<br />
* '''I am getting 'Clock manipulation detected!' error message upon launching MTA:SA DM<br />
<br />
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.<br />
<br />
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].<br />
<br />
==== Halt on launch ====<br />
* '''When I launch MTA:SA DM, nothing happens (GTA_SA.exe is running but not loading up)<br />
<br />
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.<br />
<br />
==== General GTA problems ====<br />
* '''I have unexplainable GTA problems or crashes'''<br />
<br />
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.<br />
<br />
Also try the solutions from these pages:<br />
* http://www.gtaforums.com/index.php?showtopic=273549&view=findpost&p=4537502<br />
* http://pullmonkey.com/2007/4/30/how-i-got-gta-san-andreas-to-work-with-a-crappy-os-vista<br />
<br />
== Server ==<br />
<br />
=== General ===<br />
==== Fatal error 3 ====<br />
* '''I'm getting ''Fatal Error 3'' whenever I connect to my server'''<br />
<br />
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'''.<br />
==== Download error 9: Error downloading requested files ====<br />
* '''I'm getting ''Download Error 9: Error downloading requested files'' whenever I connect to my server'''<br />
<br />
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.<br />
<br />
* 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.<br />
<br />
* 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.<br />
==== Download error 28 ====<br />
Try closing anti-virus or firewall applications. If it then works, try adding an exception to your firewall to allow your http port through.<br />
<br />
=== Windows-related ===<br />
No known reported issues in the version {{Current Version|full}}.<br />
<br />
=== Linux-related ===<br />
====Default nohup creates infinitely big nohup.out====<br />
<br />
Temporary fix, disable the nohup file: 'nohup ./mta_server > /dev/null &'<br />
<br />
====Download error #0-52 when running several servers on the same machine====<br />
<br />
Temporary fix: http://forum.multitheftauto.com/viewtopic.php?f=106&t=25152#p295646<br />
<br />
This issue is fixed in the next MTASA release (1.0.1)<br />
<br />
[[es:Problemas Conocidos - FAQ]]<br />
[[it:Bugs noti e FAQ]]<br />
[[ru:Known Issues - FAQ]]</div>Archttps://wiki.multitheftauto.com/index.php?title=Known_Issues_-_FAQ&diff=22823Known Issues - FAQ2010-04-05T11:26:50Z<p>Arc: /* Crash after MTA splash screen */</p>
<hr />
<div>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.<br />
<br />
[[Resource:Editor#FAQ|Map editor FAQ/known issues can be found here.]]<br />
<br />
<br />
== Client ==<br />
<br />
=== General ===<br />
==== Does MTASA work with v1.01 or v2.00 of GTA San Andreas? ====<br />
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.<br />
<br />
==== Initial black screen/hanging GTA splash screens ====<br />
* '''MTA shows a permanent black screen or hanging GTA splash screens.'''<br />
<br />
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.<br />
<br />
* '''MTA shows a permanent black screen after the GTA splash screens (possibly with text in the bottom right corner).'''<br />
<br />
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''.<br />
<br />
==== Halt after MTA splash screen ====<br />
* '''Nothing happens after the 'Stop playing with yourself' splash screen'''<br />
<br />
If you use nVidia GeForce, try turning off nView Desktop Manager before starting MTA.<br />
<br />
Also try deleting GTA San Andreas settings file ("gta_sa.set") in "Documents\GTA San Andreas User Files" folder<br />
<br />
==== Crash after MTA splash screen ====<br />
* '''MTA crashes after the 'Stop playing with yourself' logo. Both single player and the MTA: Race ran fine before.'''<br />
<br />
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.<br />
<br />
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.<br />
<br />
If you are a user of Windows Vista or Windows 7, try the following:<br />
* Enable Windows XP SP3 compatiblity mode for both Multi Theft Auto.exe and gta_sa.exe.<br />
* Configure Data Execution Prevention: Use the setting ''Turn DEP for all programs and services except those I select''. Click ''add'' and find "MTA San Andreas.exe" and "gta_sa.exe" and add them.<br />
* Run MTASA as administrator.<br />
<br />
==== Assertion in CMainMenu.cpp line 106 upon launching MTASA ====<br />
* '''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.'''<br />
<br />
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. <br />
<br />
To resolve this, you need to uninstall MTA:SA and GTASA, then install them in such paths that don't contain such characters.<br />
<br />
==== Crash after connecting to any server ====<br />
* '''MTASA crashes upon connecting to any server. Single player runs fine.'''<br />
<br />
Single player mods can affect the way MTA:SA works, potentially causing crashes - you should always use a clean GTASA install for MTA:SA.<br />
<br />
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].<br />
<br />
==== Controls not working ====<br />
* '''My controls don't seem to work as they should.'''<br />
<br />
Try using the 'copygtacontrols' command in the console.<br />
<br />
==== Incorrect models ====<br />
* '''Woman model's breasts look awkward ingame / I'm seeing odd, spider-like shaped player models.'''<br />
<br />
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.<br />
<br />
==== Incorrect drive-by functionality ====<br />
* '''Drivebys arent working as they should'''<br />
<br />
Drivebys are handled by script, and will change depending on the loaded gamemode.<br />
<br />
==== Unsaved settings ====<br />
* '''My MTA setting(s) didn't get saved (...) I crashed.'''<br />
<br />
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.<br />
<br />
==== Gamepad support ====<br />
* '''MTA doesn't recognise my gamepad'''<br />
<br />
Ensure that your controller is the first controller recognised by Windows (MTA will only use the first controller). You can configure your gamepad in options in MTASA's main menu.<br />
<br />
==== Free mouselook not working properly ====<br />
* '''MTA doesnt recognise my mouse'''<br />
<br />
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.<br />
This problem can be solved by entering a server, click your Win/Windows key at your keyboard once, and then click your mouse.<br />
If that doesn't work try starting GTA in Singleplayer, go to options > controler setup and set "Configuration" to "Mouse + Keys" instead of "Joypad".<br />
<br />
<br />
==== Server browser not working ====<br />
* '''The in-game server browser shows "Loading" but does not come up with any servers'''<br />
<br />
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.<br />
<br />
If all else fails, you can logon to [http://www.game-monitor.com/search.php?game=mta GameMonitor], and click the green play icon to play on that server.<br />
<br />
==== Invalid serial number ====<br />
* '''I am getting an 'Invalid serial number' error when trying to launch or play the game'''<br />
<br />
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.<br />
<br />
==== 'Network module could not be located' ====<br />
* '''I am getting 'Network module could not be located' error message upon launching MTA:SA DM<br />
<br />
Copy the file 'net.dll' from your GTA:SA/mta directory into your GTA:SA directory, overwriting existing files.<br />
<br />
==== 'Network module not compatible!' on MTASA launch ====<br />
* '''I am getting 'Network module not compatible!' error message upon launching MTA:SA DM<br />
<br />
This could mean that your MTASA install is incomplete or broken. Reinstall it.<br />
<br />
==== 'No such mod installed (deathmatch)' ====<br />
* '''I am getting a 'No such mod installed (deathmatch)' error message when trying to connect to any server<br />
<br />
'''Option 1:''' Simply re-install MTA. <br><br />
'''Option 2:''' Run both gta_sa.exe and Multi Theft Auto.exe with administrator privileges.<br />
<br />
==== D3dx9_**.dll is not found ====<br />
* '''When I start Multi Theft Auto: San Andreas I am getting an error D3dx9_**.dll (** = a number) cannot be found.<br />
<br />
This means that DirectX 9 is not installed or not up to date.<br />
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.<br />
<br />
=== Windows Vista®-related ===<br />
<br />
==== Crash on launch ====<br />
* '''I've successfully upgraded from MTA Race to MTASA DM on Vista, but it seems to crash on launch.<br />
<br />
'''Option 1''' Go to your Program Files\MTA San Andreas\mods\race directory, and rename client.dll to something else. <br><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.<br />
<br />
==== Crash on connect ====<br />
* '''I seem to crash whenever I connect to a server just before I go in-game on Vista'''<br />
<br />
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.<br />
<br />
==== Invalid or disabled serial error ====<br />
* '''MTASA DM installer complains about wrong serial provided. I'm running it for the first time.<br />
<br />
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.<br />
<br />
Some have found that setting compatibility to Windows XP/2000 have fixed the problem.<br />
<br />
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.<br />
<br />
*'''I am getting 'invalid serial' when I try to connect to a server'''<br />
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:<br />
<br />
Open regedit (start > run > regedit)<br><br />
Go to HKEY_LOCAL_MACHINE\SOFTWARE\Multi Theft Auto: San Andreas<br><br />
Create a new string key called Username and fill there the username you have on mtabeta.com<br><br />
Create one more string key called Serial and paste there the serial from mtabeta.com<br><br />
<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]<br />
<br />
*'''I am getting 'disabled serial' when I try to connect to a server'''<br />
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.<br />
<br />
==== Clock manipulation error ====<br />
* '''I am getting 'Clock manipulation detected!' error message upon launching MTA:SA DM<br />
<br />
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.<br />
<br />
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].<br />
<br />
==== Halt on launch ====<br />
* '''When I launch MTA:SA DM, nothing happens (GTA_SA.exe is running but not loading up)<br />
<br />
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.<br />
<br />
==== General GTA problems ====<br />
* '''I have unexplainable GTA problems or crashes'''<br />
<br />
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.<br />
<br />
Also try the solutions from these pages:<br />
* http://www.gtaforums.com/index.php?showtopic=273549&view=findpost&p=4537502<br />
* http://pullmonkey.com/2007/4/30/how-i-got-gta-san-andreas-to-work-with-a-crappy-os-vista<br />
<br />
== Server ==<br />
<br />
=== General ===<br />
==== Fatal error 3 ====<br />
* '''I'm getting ''Fatal Error 3'' whenever I connect to my server'''<br />
<br />
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'''.<br />
==== Download error 9: Error downloading requested files ====<br />
* '''I'm getting ''Download Error 9: Error downloading requested files'' whenever I connect to my server'''<br />
<br />
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.<br />
<br />
* 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.<br />
<br />
* 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.<br />
==== Download error 28 ====<br />
Try closing anti-virus or firewall applications. If it then works, try adding an exception to your firewall to allow your http port through.<br />
<br />
=== Windows-related ===<br />
No known reported issues in the version {{Current Version|full}}.<br />
<br />
=== Linux-related ===<br />
====Default nohup creates infinitely big nohup.out====<br />
<br />
Temporary fix, disable the nohup file: 'nohup ./mta_server > /dev/null &'<br />
<br />
====Download error #0-52 when running several servers on the same machine====<br />
<br />
Temporary fix: http://forum.multitheftauto.com/viewtopic.php?f=106&t=25152#p295646<br />
<br />
This issue is fixed in the next MTASA release (1.0.1)<br />
<br />
[[es:Problemas Conocidos - FAQ]]<br />
[[it:Bugs noti e FAQ]]<br />
[[ru:Known Issues - FAQ]]</div>Archttps://wiki.multitheftauto.com/index.php?title=SetVehicleDamageProof&diff=22262SetVehicleDamageProof2010-01-08T19:09:06Z<p>Arc: </p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
This functions makes a vehicle damage proof, so it won't take damage from bullets, hits, explosions or fire. A damage proof's vehicle health can still be changed via script.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
bool setVehicleDamageProof ( vehicle theVehicle, bool damageProof )<br />
</syntaxhighlight> <br />
<br />
===Required Arguments=== <br />
*'''theVehicle:''' The [[vehicle]] you wish to make damage proof.<br />
*'''damageProof:''' ''true'' is damage proof, ''false'' is damageable.<br />
<br />
===Returns===<br />
Returns ''true'' if the vehicle was set damage proof succesfully, ''false'' if the arguments are invalid or it failed.<br />
<br />
==Example==<br />
This example spawns a vehicle and sets it damage proof immediately.<br />
<syntaxhighlight lang="lua"><br />
newvehicle = createVehicle(602, 0, 0, 6)<br />
setVehicleDamageProof(newvehicle, true)<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Vehicle functions}}</div>Archttps://wiki.multitheftauto.com/index.php?title=Template:Marker_types&diff=22094Template:Marker types2009-12-28T02:35:10Z<p>Arc: </p>
<hr />
<div>** '''"checkpoint"''': A race checkpoint. These are very tall, but not infinite, light pillars. Checkpoints snap to ground and become invisible after going over a certain Z height.<br />
** '''"ring"''': Doughnut shaped ring, normally used for aircraft.<br />
** '''"cylinder"''': Small glowing ground ring. These are the glow markers you walk into to activate missions or events in single player.<br />
** '''"arrow"''': Arrow pointing down. These are the arrows on the doors you can enter in single player, except MTA's are not animated by default.<br />
** '''"corona"''': A glowing ball of light.</div>Archttps://wiki.multitheftauto.com/index.php?title=Resource:Race&diff=21418Resource:Race2009-09-05T11:56:54Z<p>Arc: /* Events for version 0.8.3 in detail */</p>
<hr />
<div>{{Resource page}}<br />
__NOTOC__<br />
The "race" gamemode organizes sprint or freeroam races for one or more players. It supports both maps from MTA:Race and maps in the MTA:SA DM map syntax that were created in the map editor.<br />
<br />
==Ingame==<br />
Playing race is quite straightforward. If there are checkpoints, drive from checkpoint to checkpoint and be the first to reach the finish line within the time. If there are no checkpoints, just drive around and have fun.<br />
<br />
In races you may encounter three types of pickups which will have an effect on your vehicle:<br />
*'''Repair pickups:''' this pickup looks like a wrench. If you drive over it, your vehicle will be restored to full health.<br />
*'''Nitrous oxide pickups:''' a red NOS bottle. After you drive over one you can press the fire button (by default the left mouse button) to get a temporary speed boost.<br />
*'''Vehicle change pickups:''' these display the name of a vehicle above them. As soon as you drive over a pickup your vehicle will be changed.<br />
<br />
Lastly, if you get stuck during a race, you can enter the /kill command in the chatbox to kill yourself and respawn at the previous checkpoint.<br />
<br />
==Converting MTA:Race maps==<br />
Use the [http://files.mtasa.com/apps/1.0/raceconv.zip batch converter] to convert all your MTA:Race maps into MTA:SA maps in one go.<br />
<br />
==Map syntax==<br />
You can create race maps using the new MTA:SA [[Resource:editor|map editor]]. The map syntax is given here for reference.<br />
<br />
===.map file===<br />
<syntaxhighlight lang="xml"><br />
<map mod="deathmatch"><br />
<!-- One or more --><br />
<spawnpoint posX="X" posY="Y" posZ="Z" rotation="Rotation in degrees" vehicle="Vehicle ID" id="spawnpointID" [ paintjob="paintjob ID" upgrades="comma-separated list of upgrades" ] /><br />
<br />
<!-- Zero or more --><br />
<checkpoint posX="X" posY="Y" posZ="Z" color="#FF0000" id="textual or numeric checkpoint ID" nextid="ID of checkpoint after this one" [ size="checkpoint size" vehicle="vehicle ID to change into" paintjob="paintjob ID" upgrades="comma-separated list of upgrades" ] /><br />
<br />
<!-- Zero or more --><br />
<object posX="X" posY="Y" posZ="Z" rotX="in degrees" rotY="in degrees" rotZ="in degrees" model="model ID" id="objectID" /><br />
<br />
<!-- Zero or more --><br />
<pickup posX="X" posY="Y" posZ="Z" type="repair|nitro|vehiclechange" id="pickupID" [ vehicle="vehicle ID" paintjob="paintjob ID" upgrades="comma-separated list of upgrades" ] /><br />
</map><br />
</syntaxhighlight><br />
<br />
===meta.xml===<br />
<syntaxhighlight lang="xml"><br />
<meta><br />
<info type="map" gamemodes="race" name="Map name" author="Author name" description="Map description" version="Map version number"/><br />
<race src="Map file.map"/><br />
<settings><br />
<setting name="#optionName" value="optionValue"/><br />
...<br />
</settings><br />
</meta><br />
</syntaxhighlight><br />
The <setting>s correspond to options in MTA:Race syntax. For example, <time>4:0</time> in MTA:Race syntax would correspond to <setting name="#time" value="4:0"/> in DM syntax.<br />
<br />
==Addons==<br />
A Race 'addon' is no different from any other script resource, except that is has addon="race" in the <info> section of it's meta.xml file. This is simply to allow Race to identify it and put it in the /config menu for you. Addons communicate with Race via events. The current list of Race events and what they do are here:<br />
<br />
==Events for version 0.8.3==<br />
<br />
===Server===<br />
<br />
'''onPlayerReachCheckpoint'''<br />
<br />
'''onPlayerPickUpRacePickup'''<br />
<br />
'''onMapStarting'''<br />
<br />
'''onPlayerFinish'''<br />
<br />
'''onPostFinish'''<br />
<br />
'''onPollStarting'''<br />
<br />
===Client===<br />
'''onClientMapStarting'''<br />
<br />
'''onClientPlayerFinish'''<br />
<br />
'''onClientPlayerOutOfTime'''<br />
<br />
'''onClientMapStopping'''<br />
<br />
'''onClientScreenFadedOut'''<br />
<br />
'''onClientScreenFadedIn'''<br />
<br />
==Events for version 0.8.3 in detail==<br />
===onPlayerReachCheckpoint===<br />
Triggered when a player reaches any checkpoint but the last one.<br />
====Parameters====<br />
<syntaxhighlight lang="lua">int checkpoint, int time</syntaxhighlight><br />
*'''checkpoint:''' the number of the checkpoint the player went through. The first checkpoint has number 1.<br />
*'''time:''' time since the race started, in milliseconds.<br />
<br />
====Source====<br />
The source is the player that reached the checkpoint.<br />
<br />
===onPlayerFinish===<br />
Triggered when a player reaches the last checkpoint (i.e. has finished the race)<br />
====Parameters====<br />
<syntaxhighlight lang="lua">int rank, int time</syntaxhighlight><br />
*'''rank:''' the player's rank. 1 means he won the race, 2 that he came in second place, etc.<br />
*'''time:''' time since the race started, in milliseconds.<br />
<br />
====Source====<br />
The source is the player that finished the race.<br />
<br />
===onPlayerPickUpRacePickup===<br />
====Parameters====<br />
<syntaxhighlight lang="lua">int/string pickupID, string type, int vehicle</syntaxhighlight><br />
*'''pickupID:''' the number of the pickup in case of MTA:Race syntax (starting at 1), or the "id" attribute of the pickup in case of DM syntax.<br />
*'''type:''' the pickup type. Can be "nitro", "repair" or "vehiclechange".<br />
*'''vehicle:''' if the pickup is of type vehiclechange, this is the vehicle model that it sets.<br />
<br />
====Source====<br />
The source is the player that picked up the pickup.<br />
<br />
==Element data==<br />
These element data are set on each player:<br />
*'''Race rank:''' the current position of the player in the race. 1 = first, 2 = second etc. Updated on a 1 second interval.<br />
*'''race.checkpoint:''' the number of the checkpoint the player is ''heading for''. When the player spawns this number is 1, after he passed the first checkpoint it's 2, etc.<br />
*'''race.finished:''' ''true'' if the player has finished, ''false'' if he's still racing.</div>Archttps://wiki.multitheftauto.com/index.php?title=Shutdown&diff=21408Shutdown2009-09-03T17:42:33Z<p>Arc: </p>
<hr />
<div>{{Server function}}<br />
__NOTOC__<br />
This function shuts down the server. <br />
<br />
Make sure your server ACL setup has function.shutdown object protected.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
bool shutdown ( string reason ) <br />
</syntaxhighlight> <br />
<br />
===Required Arguments=== <br />
*'''reason:''' the reason why the server has been shut down.<br />
<br />
===Returns===<br />
Returns ''false'' if it was not possible to shut down the server.<br />
<br />
==Example== <br />
This command shuts down the server on request<br />
<syntaxhighlight lang="lua"><br />
addCommandHandler ( "shutdown", function ( player, command, reason )<br />
if ( hasObjectPermissionTo ( player, "function.shutdown" ) ) then<br />
shutdown ( reason or "" )<br />
end<br />
end )<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Server functions}}</div>Archttps://wiki.multitheftauto.com/index.php?title=Server_Manual&diff=21252Server Manual2009-08-26T21:22:41Z<p>Arc: </p>
<hr />
<div>__TOC__<br />
<br />
==Getting started==<br />
It is much easier than it looks to get a server up and running for your internet or LAN buddies: follow this wiki article and you will hopefully be on your way to hosting your own MTA:SA DM Server in no time!<br />
<br />
==Installing the server==<br />
The dedicated server application is available in different flavours depending on the platform of the server.<br />
<br />
===Linux installation===<br />
Follow the link to learn how to [http://code.google.com/p/multitheftauto/wiki/HowToBuildLinux compile the server on Linux]<br />
<br />
===Windows installation===<br />
Installation of the MTA:SA DM server on Windows is easy as pie.<br />
*Go to the [http://mtasa.com/124.html download page] and download the installer.<br />
*Once the installer is downloaded, open it.<br />
*Select a folder where you want to install the server.<br />
*Click Install.<br />
*Done!<br />
<br />
''For a full explanation of acl.xml (access control list) read: [[Access_Control_List|Access Control List]]''<br/><br/><br />
<br />
==Configuring your server==<br />
The Multi Theft Auto dedicated server is initially configurable through it's console window, from within the game, and from a webbrowser. In order to make use of the two last options, it is necessary to add at least one administrator user to your configuration file.<br />
<br />
===General configuration===<br />
All general configuration options can be found in the 'mods/deathmatch/'''mtaserver.conf'''' file and can be opened by any regular text editor.<br />
<br />
This file is fairly straightforward; every variable has a description of what to do with it and how to change it.<br />
<br />
===Port forwarding===<br />
If you run your server on your own private computer, and you have an router between the internet and your computer. You need to forward 3 ports.<br />
<br />
First of all open the file 'mods/deathmatch/'''mtaserver.conf'''' and search for the next lines:<br />
<syntaxhighlight lang="xml"><br />
<serverport>22004</serverport> <br />
<httpport>22005</httpport><br />
</syntaxhighlight><br />
<br />
The ports are needed to setup the server right. We explain later how to set them, but first if you want your server to list in the server browser there is an other port we need, and that is the ase port. <br />
(quick example for how to turn ase on or of):<br />
<syntaxhighlight lang="xml"><br />
<ase>1</ase> <!-- 0 = off, 1 = on --><br />
</syntaxhighlight><br />
<br />
Now we going to forward the ports in router, which is not needed if you already have all ports open, or if you don't have a router with a firewall. If so, skip this part.<br />
<br />
If you don't know how port forwarding works in your router, go to: http://portforward.com/, find your router there, and follow the instructions there.<br />
<br />
In almost every router you can set the port type: UDP or TCP. The following list will explain which port type is needed for what:<br />
<br />
<br />
Main server port: UDP<br />
<br />
HTTP Port: TCP<br />
<br />
ASE Port: UDP (this is needed if you want your server to appear in the server list)<br />
<br />
<br />
The ASE port is also simply to get:<br />
<br />
ASE port = Main Server port + 123<br />
<br />
So, if you have the main server port set to 22003, then the ASE port will be 22126.<br />
<br />
Good luck!<br />
<br />
===Adding administrators===<br />
It is strongly recommended to add at least one administrator to your server in order to make use of the built-in webserver to easily maintain and configure your server. This administrator will then also be able to log-in from within the game and control the server.<br />
<br />
To add an administrator to your server, follow these steps:<br><br />
<ol><br />
<li>Make sure your server is stopped; if your server is still running, all changes you make will be overwritten</li><br />
<li>Open the file 'mods/deathmatch/'accounts.xml'''' with any text editor</li><br />
<li>Add a new account into the file by using the XML-syntax below, we use the username "BennyLava" with password "123password" for illustration purposes<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><br />
<accounts><br />
...<br />
<account name="BennyLava" password="123password" /><br />
</accounts><br />
</syntaxhighlight><br />
</div><br />
<li>Save and close the file</li><br />
<li>Open the file 'mods/deathmatch/'acl.xml'''' with any text editor</li><br />
<li>Add the account to the ''Admin'' group by using the XML-syntax below<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><br />
<ACL><br />
...<br />
<group name="Admin"><br />
<acl name="Admin"/><br />
...<br />
<object name="user.BennyLava" /><br />
</group><br />
...<br />
</ACL><br />
</syntaxhighlight><br />
</div><br />
<br />
You can actually add your user to any group you want. Each group is linked to an ACL ([[Access Control List]]). Each ACL contains a series of specific allowed or denied rights. These groups exist so different users can be assigned different rights. The ''Admin'' group points to the ''Admin'' ACL, which is empty (thus allowing all possible commands). The ''Everyone'' group points to the ''Default'' ACL that puts a series of restrictions on the available commands (to disallow regular players from using admin commands).<br />
</li><br />
<li><br />
You're done! You can add as many administrators or users as you want this way, take a look at some of the other groups and ACLs for example. The ACL is also accessible through the [[Access_Control_List|Lua scripting engine]].<br><br />
<br />
It is recommended to take a look at the web interface, we will explain how to do this below.<br />
</li><br />
</ol><br />
'''Note''': There are also ways to add accounts and edit rights for the server while it's running. "addaccount <user> <password>" is an internal command to add accounts, but you will have to use the web interface to add these accounts to specific groups/ACLs!<br /><br />
<br />
===Using the web interface===<br />
The dedicated server comes with a few Lua [[resources]] that provide a nice little web interface to your server. This can be used to easily maintain your server, as it allows you to add users, start/stop resources, and more.<br />
<br />
The web interface resources are enabled by default and are served through the built-in HTTP web server. To make sure the built-in HTTP web server runs on a port you like (22005 by default), follow these steps:<br />
<ol><br />
<li>Make sure your server is stopped<br />
<li>Open the file '''mods/deathmatch/mtaserver.conf''' with any text editor</li><br />
<li>Verify that the HTTP server is enabled:<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><br />
<httpserver>1</httpserver><br />
</syntaxhighlight><br />
</div><br />
</li><br />
<li>Change the HTTP server port to your liking:<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><br />
<httpport>22005</httpport><br />
</syntaxhighlight><br />
</div><br />
</li><br />
<li>Save and close the configuration file</li><br />
<li>Start your server</li><br />
<li>If you happened to have changed the start-up resources in your configuration file, make sure the following resources are started:<br />
<br />
# resourcebrowser<br />
# resourcemanager<br />
# webadmin<br />
# webmap<br />
<br />
These are automatically started in the default configuration file, in case you just installed your server.<br />
</li><br />
<li>Open a web browser (Internet Explorer 6 or 7 are NOT supported: use [http://www.mozilla.com/firefox Mozilla Firefox], [http://www.google.com/chrome Google Chrome], [http://www.apple.com/safari/download Apple Safari], [http://www.opera.com Opera] or others) and navigate to the HTTP server URL: '''http://server:port/'''. For example, If you are running a local server on HTTP port 22005, use '''http://127.0.0.1:22005/'''.</li><br />
<li>Enter the username and password of the administrator you added in the previous section.</li><br />
</ol><br />
<br />
<br /><br />
You should now be able to maintain your server from the web interface.<br />
<br />
=== Configuring an external web server ===<br />
The built-in web server is also used to serve files that are required by resources running on your server to any player that is connected to your server. For example, if you are running a game script with a scripted graphical user interface, or custom models, these need to be transferred to every connected player in order to function properly. This is done by either the built-in web server, or an external web server (that is usually a bit faster) but needs to be set up separately.<br />
<br />
For performance or consistency reasons during the game, you could choose to make use of such an external web server if you have one set up. The external web server needs to be accessible for the public, so any client will be able to download the necessary client-side files in order to join and play on your server.<br />
<br />
To enable downloading off an external web server, you should configure the ''httpdownload'' and ''httpdownloadurl'' tags in your server configuration:<br />
<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><httpdownload>1</httpdownload> <br />
<httpdownloadurl>http://www.myserver.tld/directory/here</httpdownloadurl><br />
</syntaxhighlight></div><br />
<br />
Since all the default resources provided with the dedicated server are zipped, and are normally automatically extracted by the built-in web server, you now have to provide a way for the clients to download the unextracted files to their computers. The unextracted files are always available in the '''<SERVER>/mods/deathmatch/resourcecache''' directory.<br />
<br />
<ol><br />
<li>Launch the dedicated server once and exit again. This will extract the zip files into the '''<SERVER>/mods/deathmatch/resourcecache''' directory.</li><br />
<li>Go into the directory above and copy the resources to your external web server's public directory, this can be done in several ways:<br />
<ul><br />
<li>If you don't care about your '''server-side files being publically available''': create a symbolic link (Linux), a junction (Windows) or just plain copy the contents of the '''resourcecache''' directory to your public web server directory.</li><br />
<li>If you don't want your server files to be publically available through your web server: go into the '''resourcecache''' directory and manually copy the folders over to your public web server directory, removing any server-side files (they are '''not''' necessary for the client-side downloading) you do not want to be hosting on your web server.<br /><br />
<br /><br />
A quick way of securing your server-side files is currently not available. We will investigate into developing a tool that automatically copies only the necessary client-side files for all resources on your server.<br />
</ul><br />
</li><br />
</ol><br />
<br />
'''Note 1''': Please try to avoid any special characters (e.g. ~, !) in your download URLs.<br /><br />
'''Note 2''': Please do not use a trailing slash in your download URL (e.g. ''hxxp://www.myserver.tld/directory'' rather than ''hxxp://www.myserver.tld/directory/'')<br />
<br />
==Starting your server==<br />
Begin by making sure that you have finished all configuration of your server, starting your server is the last stage so everything must be ready!<br />
<br />
To start your server double click on MTA Server.exe, make sure you allow it through any firewalls and forward ports where nessessary.<br />
<br />
==Installing/Updating resources on your server==<br />
Resources can come in two formats, either a ZIP format or just a normal folder with the script files inside it. The MTA:SA DM server supports both these methods.<br />
<br />
# Move or copy the new resource to your <SERVER>\mods\deathmatch\resources folder.<br />
# In the server window type in the command "refresh" (without the quotes), this will re-scan the resources folder and update the live resources where necessary.<br />
<br />
==Uninstalling resources==<br />
Resources can easily be removed from your server if you no longer want them.<br />
<br />
# Delete the ZIP file or the folder of the resource you wish to uninstall<br />
# In the server window type in the command "refresh" (without the quotes), this will re-scan the resources folder and update the live resources where necessary.<br />
<br />
==Administrating your server==<br />
You can start resources by typing the command "start resourcename" in the server console, or stop ones with "stop resourcename".<br />
<br />
It's also possible to execute these and other admin commands from the ingame console (which you can bring up with the ` key or F8); for this to work, you first need to log in with the command "login username password". Additionally, you can press the p key to bring up the admin panel: this is a graphical interface which allows you to easily kick or ban misbehaving players, among others.<br />
<br />
For further commands, type "help" in a console.<br />
<br />
==Starting a map/gamemode==<br />
See the commands section of the documentation for [[Resource:Map manager|mapmanager]] for more information.<br />
<br />
==Useful Notes==<br />
<br />
# You may also update the resources while ingame as long as you have the correct access levels by typing "refresh" in the clients console or "/refresh" in the chat window. This may cause a second of lag if you have many resources.<br />
# In the above instructions, <SERVER> is the path to your server's main directory. In most cases this is C:\Program Files\MTA San Andreas\server<br />
# You can choose a different config file for the server to use by passing it in the command line after a --config argument, e.g. mtaserver.exe --config anotherconfig.cfg.<br />
# Do not be alarmed by the warning regarding the parsing of the settings.xml file. This happens because your server installation is still clean and unused.<br />
<br />
====Need further help?====<br />
Why not pop over to our [http://forum.mtasa.com/ Forums] or join us on [irc://irc.multitheftauto.com/mta IRC] (irc.multitheftauto.com #mta - [http://www.mirc.com MIRC])<br />
<br />
[[es:Manual Servidor Deathmatch]]<br />
[[de:MTA DM Server Anleitung]]<br />
[[it:Manuale del Server]]<br />
[[nl:Deathmatch Server Manual]]<br />
[[ru:Deathmatch Server Manual]]</div>Archttps://wiki.multitheftauto.com/index.php?title=ExecuteSQLSelect&diff=21200ExecuteSQLSelect2009-08-23T11:42:34Z<p>Arc: </p>
<hr />
<div>__NOTOC__<br />
{{Server function}}<br />
This function retrieves rows from a table in the database, if they exist. If you pass the table name, along with the columns you want to retrieve (and any conditions for the row) this function will return a table containing the corresponding values.<br />
<br />
The SQLite database contains globally stored data and can be used by scripts to store and retrieve data in a structured manner.<br />
<br />
The executed SQL query is the following:<br />
<br />
<syntaxhighlight lang="lua">[sql]SELECT <fields> FROM <tables> WHERE <conditions> LIMIT <limit></syntaxhighlight><br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
table executeSQLSelect ( string tableName, string fields, [ string conditions ], [ int limit ] )<br />
</syntaxhighlight><br />
<br />
===Required Arguments===<br />
*'''tableName:''' The table you want to query. No spaces allowed.<br />
*'''fields:''' The fields you want to query. No spaced allowed. Multiple fields should be separated by a comma (,). Wildcard (*) allowed to query all fields in the table. If you use wildcards, please pay attention to the order in which you'll have to retrieve your values from the table.<br />
<br />
===Optional Arguments===<br />
*'''conditions:''' The conditions for the query. Multiple conditions should be separated by logical operators (AND, OR).<br />
*'''limit:''' Maximum amount of rows to return.<br />
<br />
===Returns===<br />
On success: the 2-dimensional table where the results are stored as table [row_index] [column_name].<br />
<br />
On failure: ''false''.<br />
<br />
<br />
==Example==<br />
This example creates a SQL table when a map loads, and stores info about a player to that database when he spawns.<br />
<syntaxhighlight lang="lua"><br />
function onMapLoad ()<br />
-- create our table, if it doesn't already exist<br />
executeSQLCreateTable ( "players", "clothes_head_texture TEXT, clothes_head_model TEXT, player TEXT" )<br />
end<br />
addEventHandler ( "onGamemodeMapStart", getRootElement(), onMapLoad )<br />
<br />
function addInfoToSQL( theSpawnpoint, theTeam ) <br />
sourcename = getClientName ( source ) -- get the player's name<br />
<br />
-- try to retrieve the player data from the db<br />
result = executeSQLSelect ( "players", "player", "player = '" .. sourcename .. "'" )<br />
if ( result == false ) then -- see if any data was found at all<br />
outputChatBox ( "This is your first time here! Welcome " .. sourcename .. "!", source )<br />
executeSQLInsert ( "players", "'none', 'none', '" .. sourcename .. "'" )<br />
else<br />
outputChatBox ( "Welcome back " .. sourcename .. "!", source )<br />
executeSQLUpdate ( "players", "clothes_head_texture = 'hairgreen', clothes_head_model = 'somehead'",<br />
"player = '" .. sourcename .. "'" )<br />
end <br />
<br />
-- get the clothes data for the player<br />
result = executeSQLSelect ( "players", "clothes_head_texture, clothes_head_model", "player = '" .. sourcename .. "'" )<br />
outputChatBox ( "Your head texture is " .. result[1].clothes_head_texture )<br />
outputChatBox ( "Your head model is " .. result[1].clothes_head_model ) <br />
end<br />
addEventHandler ( "onPlayerSpawn", getRootElement(), addInfoToSQL )<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Registry_functions}}</div>Archttps://wiki.multitheftauto.com/index.php?title=User:Arc&diff=21197User:Arc2009-08-22T22:38:56Z<p>Arc: </p>
<hr />
<div>__NOTOC__<br />
{{MTA Developer}}<br />
<br />
Belgian reverse engineer/coder/scripter. I joined MTA Quality Assurance in August 2007 doing tests and writing gamemodes, and now contribute to MTA itself since it went open source in November 2008.<br />
<br />
==Progamming languages==<br />
* C/C++, C#, x86 assembly, Lua, Perl, Python, and the typical web stuff (php/js/html/css).<br />
<br />
==Todo list==<br />
* <strike>Release amx, the SA-MP emulator</strike><br />
* <strike>Release DeAMX Lua prototype</strike><br />
* Release DeAMX 1.0<br />
* <strike>Modify PIX to log call stacks, making it more useful for reversing</strike><br />
* Remove call/jump obfuscation from xlive.dll (personal reversing challenge)<br />
* <strike>Fix MTA so that 1.0 can be released</strike><br />
* Eventually learn enough about Windows kernel mode to do awesome stuff<br />
* Eventually learn enough about DirectX to do awesome stuff<br />
* Finish university master thesis (pff)</div>Archttps://wiki.multitheftauto.com/index.php?title=Upgrading_from_MTA:Race&diff=21188Upgrading from MTA:Race2009-08-22T01:06:12Z<p>Arc: /* Server Owners */</p>
<hr />
<div>__NOTOC__<br />
MTA:Race was the first Multi Theft Auto release for Grand Theft Auto San Andreas. Since its release, we've seen thousands of maps and a vast, active community develop and mature. Despite this, for everything there is a time to move on. Multi Theft Auto: San Andreas 1.0, in conjunction with the latest version of the [[Resource:Race]] gamemode provides a stable platform for server admins and gamers alike to upgrade to the most powerful GTA Race experience yet.<br />
<br />
== Why upgrade? ==<br />
Although it may seem that its safer to stick what works, the release of 1.0 will provide a significant step-up in the multiplayer experience.<br />
<br />
=== Scripting ===<br />
With the arrival of MTA:SA 1.0, comes a powerful and flexible Lua scripting interface. This surpasses previous scripting abilities of Race servers in every single way. By utilising the Lua script interface, server admins and players alike can take advantage of features such as:<br />
* '''Fully fledged built-in scripting.''' No more external mIRC clients to run your Admin interface<br />
* '''Take full advantage of the Plugins system of Race.''' By developing Lua plugins, the bounds to extend Race are limitless. Examples that are included in the release package are the Traffic Sensor, which uses HUD to display when cars are behind you, and a Top Times plugin, which displays the person with the best record in a certain race.<br />
* '''Extend the possibilities of any map.''' By attaching a Lua script to your map, you can have virtually anything happen during gameplay. Custom models, moving objects, timed explosives and upside down gravity tracks are all possibilities by taking advantage of scripting.<br />
* '''Full customisability.''' Customisable UI, along with a possibility to add custom pictures, objects, sounds, and vehicle models, specific to your server. Imagine being able to display your server's logo during gameplay on the screen.<br />
<br />
=== Gameplay ===<br />
The MTA:SA 1.0 platform is much more versatile and therefore makes the gameplay experience superior to MTA:Race. On top of this, the Race gamemode has had hundreds of improvements to make the racing experience much more fun.<br />
* Have up to '''128 players''' in your Race server. That's a lot more than ''32''. You may wonder "How on earth do 128 people fit on the track?". No problem, the latest Race offers <br />
a '''ghostmode''' feature so that high player counts are feasable.<br />
* Support for newest Microsoft Windows operating systems like Windows Vista, Windows 2008 and Windows 7 in both x86 and x64 flavours. Due to the open-source nature of MTA:SA 1.0, compatiblity is mantained constantly.<br />
* Much more accurate vehicle synchronisation. When switching to 1.0, the first thing racers will notice is the amazing vehicle synchronisation. It now is incredibly smooth, and synced much more precisely - an essential to any racing game.<br />
* The Traffic Sensor addon means nearby opponents are displayed on the screen. At last, you can be aware of which way those tailgating opponents are challenging you!<br />
* The all new open-sourced [[Resource:Editor|Map Editor]] means you can create your race maps with ease.<br />
* MTA:SA 1.0 provides a single mod for '''all''' your online GTA needs.<br />
<br />
=== Server owner's paradise ===<br />
With the latest Race, server owner's are in control: you are able to customise the Race experience. Become a truly unique server.<br />
* '''Improved ingame Admin.''' MTA:SA 1.0 offers an ingame Admin interface where you can easily point and click to effortlessly moderate a server.<br />
* '''Improved stability, performance and bandwidth usage'''. The 1.0 and Race platform have been tested extremely thoroughly, and this has meant the bar has been raised much higher than the original MTA:Race. Bandwidth has been paid special attention to, and upgrading server owners will reap the benefits of optimized bandwidth usage for their servers.<br />
* '''Framelimiter'''. We've all seen it - that frustrating FPS limit in MTA:Race. The arrival of 1.0 means server owners can set the FPS limit of their particular server.<br />
* '''Customisability'''. As mentioned several times - everything is in your control. Using Lua you can modify and improve the open-source Race experience. The new Plugins system means you can easily add or remove components that extend MTA:Race<br />
<br />
=== Community ===<br />
If you ever have any issues, we'll be happy to assist you in our forums. The growing amount of scripters for MTA:SA 1.0 has also meant we have a much more alive and vibrant community than previously with MTA:Race.<br />
<br />
== How do I upgrade ==<br />
=== Race players ===<br />
Upgrading your client to MTA:SA 1.0 is simple. And better yet, you have nothing to lose. MTA:SA 1.0 can be installed alongside your original MTA:Race installation without conflict.<br />
<br />
<br />
All you have to do is head to the download page (link pending) and install MTA:SA 1.0.<br />
<br />
=== Server Owners ===<br />
Server owners can easily upgrade to MTA:SA 1.0. Races are fully compatible after a short upgrade process. Simply install the latest server package, and use our [http://files.mtasa.com/apps/1.0/raceconv.zip batch converter] to convert your maps into MTA:SA 1.0 resource format. From then on, your converted maps work with the [[Resource:race|race gamemode]] and can be managed through the [[Resource:mapmanager|map manager]] and the [[Resource:votemanager|vote manager]].</div>Archttps://wiki.multitheftauto.com/index.php?title=Upgrading_from_MTA:Race&diff=21187Upgrading from MTA:Race2009-08-22T01:01:20Z<p>Arc: /* Race players */</p>
<hr />
<div>__NOTOC__<br />
MTA:Race was the first Multi Theft Auto release for Grand Theft Auto San Andreas. Since its release, we've seen thousands of maps and a vast, active community develop and mature. Despite this, for everything there is a time to move on. Multi Theft Auto: San Andreas 1.0, in conjunction with the latest version of the [[Resource:Race]] gamemode provides a stable platform for server admins and gamers alike to upgrade to the most powerful GTA Race experience yet.<br />
<br />
== Why upgrade? ==<br />
Although it may seem that its safer to stick what works, the release of 1.0 will provide a significant step-up in the multiplayer experience.<br />
<br />
=== Scripting ===<br />
With the arrival of MTA:SA 1.0, comes a powerful and flexible Lua scripting interface. This surpasses previous scripting abilities of Race servers in every single way. By utilising the Lua script interface, server admins and players alike can take advantage of features such as:<br />
* '''Fully fledged built-in scripting.''' No more external mIRC clients to run your Admin interface<br />
* '''Take full advantage of the Plugins system of Race.''' By developing Lua plugins, the bounds to extend Race are limitless. Examples that are included in the release package are the Traffic Sensor, which uses HUD to display when cars are behind you, and a Top Times plugin, which displays the person with the best record in a certain race.<br />
* '''Extend the possibilities of any map.''' By attaching a Lua script to your map, you can have virtually anything happen during gameplay. Custom models, moving objects, timed explosives and upside down gravity tracks are all possibilities by taking advantage of scripting.<br />
* '''Full customisability.''' Customisable UI, along with a possibility to add custom pictures, objects, sounds, and vehicle models, specific to your server. Imagine being able to display your server's logo during gameplay on the screen.<br />
<br />
=== Gameplay ===<br />
The MTA:SA 1.0 platform is much more versatile and therefore makes the gameplay experience superior to MTA:Race. On top of this, the Race gamemode has had hundreds of improvements to make the racing experience much more fun.<br />
* Have up to '''128 players''' in your Race server. That's a lot more than ''32''. You may wonder "How on earth do 128 people fit on the track?". No problem, the latest Race offers <br />
a '''ghostmode''' feature so that high player counts are feasable.<br />
* Support for newest Microsoft Windows operating systems like Windows Vista, Windows 2008 and Windows 7 in both x86 and x64 flavours. Due to the open-source nature of MTA:SA 1.0, compatiblity is mantained constantly.<br />
* Much more accurate vehicle synchronisation. When switching to 1.0, the first thing racers will notice is the amazing vehicle synchronisation. It now is incredibly smooth, and synced much more precisely - an essential to any racing game.<br />
* The Traffic Sensor addon means nearby opponents are displayed on the screen. At last, you can be aware of which way those tailgating opponents are challenging you!<br />
* The all new open-sourced [[Resource:Editor|Map Editor]] means you can create your race maps with ease.<br />
* MTA:SA 1.0 provides a single mod for '''all''' your online GTA needs.<br />
<br />
=== Server owner's paradise ===<br />
With the latest Race, server owner's are in control: you are able to customise the Race experience. Become a truly unique server.<br />
* '''Improved ingame Admin.''' MTA:SA 1.0 offers an ingame Admin interface where you can easily point and click to effortlessly moderate a server.<br />
* '''Improved stability, performance and bandwidth usage'''. The 1.0 and Race platform have been tested extremely thoroughly, and this has meant the bar has been raised much higher than the original MTA:Race. Bandwidth has been paid special attention to, and upgrading server owners will reap the benefits of optimized bandwidth usage for their servers.<br />
* '''Framelimiter'''. We've all seen it - that frustrating FPS limit in MTA:Race. The arrival of 1.0 means server owners can set the FPS limit of their particular server.<br />
* '''Customisability'''. As mentioned several times - everything is in your control. Using Lua you can modify and improve the open-source Race experience. The new Plugins system means you can easily add or remove components that extend MTA:Race<br />
<br />
=== Community ===<br />
If you ever have any issues, we'll be happy to assist you in our forums. The growing amount of scripters for MTA:SA 1.0 has also meant we have a much more alive and vibrant community than previously with MTA:Race.<br />
<br />
== How do I upgrade ==<br />
=== Race players ===<br />
Upgrading your client to MTA:SA 1.0 is simple. And better yet, you have nothing to lose. MTA:SA 1.0 can be installed alongside your original MTA:Race installation without conflict.<br />
<br />
<br />
All you have to do is head to the download page (link pending) and install MTA:SA 1.0.<br />
<br />
=== Server Owners ===<br />
Server owners can easily upgrade to MTA:SA 1.0. Races are fully compatible after a short upgrade process. Simply install the latest server package, and use our [http://files.mtasa.com/apps/1.0/raceconv.zip batch converter] to convert your maps into MTA:SA 1.0 resource format.</div>Archttps://wiki.multitheftauto.com/index.php?title=Upgrading_from_MTA:Race&diff=21186Upgrading from MTA:Race2009-08-22T00:59:41Z<p>Arc: /* Gameplay */</p>
<hr />
<div>__NOTOC__<br />
MTA:Race was the first Multi Theft Auto release for Grand Theft Auto San Andreas. Since its release, we've seen thousands of maps and a vast, active community develop and mature. Despite this, for everything there is a time to move on. Multi Theft Auto: San Andreas 1.0, in conjunction with the latest version of the [[Resource:Race]] gamemode provides a stable platform for server admins and gamers alike to upgrade to the most powerful GTA Race experience yet.<br />
<br />
== Why upgrade? ==<br />
Although it may seem that its safer to stick what works, the release of 1.0 will provide a significant step-up in the multiplayer experience.<br />
<br />
=== Scripting ===<br />
With the arrival of MTA:SA 1.0, comes a powerful and flexible Lua scripting interface. This surpasses previous scripting abilities of Race servers in every single way. By utilising the Lua script interface, server admins and players alike can take advantage of features such as:<br />
* '''Fully fledged built-in scripting.''' No more external mIRC clients to run your Admin interface<br />
* '''Take full advantage of the Plugins system of Race.''' By developing Lua plugins, the bounds to extend Race are limitless. Examples that are included in the release package are the Traffic Sensor, which uses HUD to display when cars are behind you, and a Top Times plugin, which displays the person with the best record in a certain race.<br />
* '''Extend the possibilities of any map.''' By attaching a Lua script to your map, you can have virtually anything happen during gameplay. Custom models, moving objects, timed explosives and upside down gravity tracks are all possibilities by taking advantage of scripting.<br />
* '''Full customisability.''' Customisable UI, along with a possibility to add custom pictures, objects, sounds, and vehicle models, specific to your server. Imagine being able to display your server's logo during gameplay on the screen.<br />
<br />
=== Gameplay ===<br />
The MTA:SA 1.0 platform is much more versatile and therefore makes the gameplay experience superior to MTA:Race. On top of this, the Race gamemode has had hundreds of improvements to make the racing experience much more fun.<br />
* Have up to '''128 players''' in your Race server. That's a lot more than ''32''. You may wonder "How on earth do 128 people fit on the track?". No problem, the latest Race offers <br />
a '''ghostmode''' feature so that high player counts are feasable.<br />
* Support for newest Microsoft Windows operating systems like Windows Vista, Windows 2008 and Windows 7 in both x86 and x64 flavours. Due to the open-source nature of MTA:SA 1.0, compatiblity is mantained constantly.<br />
* Much more accurate vehicle synchronisation. When switching to 1.0, the first thing racers will notice is the amazing vehicle synchronisation. It now is incredibly smooth, and synced much more precisely - an essential to any racing game.<br />
* The Traffic Sensor addon means nearby opponents are displayed on the screen. At last, you can be aware of which way those tailgating opponents are challenging you!<br />
* The all new open-sourced [[Resource:Editor|Map Editor]] means you can create your race maps with ease.<br />
* MTA:SA 1.0 provides a single mod for '''all''' your online GTA needs.<br />
<br />
=== Server owner's paradise ===<br />
With the latest Race, server owner's are in control: you are able to customise the Race experience. Become a truly unique server.<br />
* '''Improved ingame Admin.''' MTA:SA 1.0 offers an ingame Admin interface where you can easily point and click to effortlessly moderate a server.<br />
* '''Improved stability, performance and bandwidth usage'''. The 1.0 and Race platform have been tested extremely thoroughly, and this has meant the bar has been raised much higher than the original MTA:Race. Bandwidth has been paid special attention to, and upgrading server owners will reap the benefits of optimized bandwidth usage for their servers.<br />
* '''Framelimiter'''. We've all seen it - that frustrating FPS limit in MTA:Race. The arrival of 1.0 means server owners can set the FPS limit of their particular server.<br />
* '''Customisability'''. As mentioned several times - everything is in your control. Using Lua you can modify and improve the open-source Race experience. The new Plugins system means you can easily add or remove components that extend MTA:Race<br />
<br />
=== Community ===<br />
If you ever have any issues, we'll be happy to assist you in our forums. The growing amount of scripters for MTA:SA 1.0 has also meant we have a much more alive and vibrant community than previously with MTA:Race.<br />
<br />
== How do I upgrade ==<br />
=== Race players ===<br />
Upgrading your client to MTA:SA 1.0 is simply. And better yet, you have nothing to lose. MTA:SA 1.0 can be installed alongside your original MTA:Race installation without conflict.<br />
<br />
<br />
All you have to do is head to the download page (link pending) and install MTA:SA 1.0.<br />
<br />
=== Server Owners ===<br />
Server owners can easily upgrade to MTA:SA 1.0. Races are fully compatible after a short upgrade process. Simply install the latest server package, and use our [http://files.mtasa.com/apps/1.0/raceconv.zip batch converter] to convert your maps into MTA:SA 1.0 resource format.</div>Archttps://wiki.multitheftauto.com/index.php?title=Upgrading_from_MTA:Race&diff=21185Upgrading from MTA:Race2009-08-22T00:57:54Z<p>Arc: </p>
<hr />
<div>__NOTOC__<br />
MTA:Race was the first Multi Theft Auto release for Grand Theft Auto San Andreas. Since its release, we've seen thousands of maps and a vast, active community develop and mature. Despite this, for everything there is a time to move on. Multi Theft Auto: San Andreas 1.0, in conjunction with the latest version of the [[Resource:Race]] gamemode provides a stable platform for server admins and gamers alike to upgrade to the most powerful GTA Race experience yet.<br />
<br />
== Why upgrade? ==<br />
Although it may seem that its safer to stick what works, the release of 1.0 will provide a significant step-up in the multiplayer experience.<br />
<br />
=== Scripting ===<br />
With the arrival of MTA:SA 1.0, comes a powerful and flexible Lua scripting interface. This surpasses previous scripting abilities of Race servers in every single way. By utilising the Lua script interface, server admins and players alike can take advantage of features such as:<br />
* '''Fully fledged built-in scripting.''' No more external mIRC clients to run your Admin interface<br />
* '''Take full advantage of the Plugins system of Race.''' By developing Lua plugins, the bounds to extend Race are limitless. Examples that are included in the release package are the Traffic Sensor, which uses HUD to display when cars are behind you, and a Top Times plugin, which displays the person with the best record in a certain race.<br />
* '''Extend the possibilities of any map.''' By attaching a Lua script to your map, you can have virtually anything happen during gameplay. Custom models, moving objects, timed explosives and upside down gravity tracks are all possibilities by taking advantage of scripting.<br />
* '''Full customisability.''' Customisable UI, along with a possibility to add custom pictures, objects, sounds, and vehicle models, specific to your server. Imagine being able to display your server's logo during gameplay on the screen.<br />
<br />
=== Gameplay ===<br />
The MTA:SA 1.0 platform is much more versatile and therefore makes the gameplay experience superior to MTA:Race. On top of this, the Race gamemode has had hundreds of improvements to make the racing experience much more fun.<br />
* Have up to '''128 players''' in your Race server. That's a lot more than ''32''. You may wonder "How on earth do 128 people fit on the track?". No problem, the latest Race offers <br />
a '''ghostmode''' feature so that high player counts are feasable.<br />
* Support for newest Microsoft Windows operating systems like Windows Vista, Windows 2008 and Windows 7 in both x86 and x64 flavours. Due to the open-source nature of MTA:SA 1.0, compatiblity is mantained constantly.<br />
* Much more accurate vehicle synchronisation. When switching to 1.0, the first thing racers will notice is the amazing vehicle syncrhonisation. It now is incredibly smooth, and synced much more precisely - an essential to any racing game.<br />
* The Traffic Sensor addon means nearby opponents are displayed on the screen. At last, you can be aware of which way those tailgating opponents are challenging you!<br />
* The all new open-sourced [[Resource:Editor|Map Editor]] means you can create your race maps with ease.<br />
* MTA:SA 1.0 provides a single mod for '''all''' your online GTA needs.<br />
<br />
=== Server owner's paradise ===<br />
With the latest Race, server owner's are in control: you are able to customise the Race experience. Become a truly unique server.<br />
* '''Improved ingame Admin.''' MTA:SA 1.0 offers an ingame Admin interface where you can easily point and click to effortlessly moderate a server.<br />
* '''Improved stability, performance and bandwidth usage'''. The 1.0 and Race platform have been tested extremely thoroughly, and this has meant the bar has been raised much higher than the original MTA:Race. Bandwidth has been paid special attention to, and upgrading server owners will reap the benefits of optimized bandwidth usage for their servers.<br />
* '''Framelimiter'''. We've all seen it - that frustrating FPS limit in MTA:Race. The arrival of 1.0 means server owners can set the FPS limit of their particular server.<br />
* '''Customisability'''. As mentioned several times - everything is in your control. Using Lua you can modify and improve the open-source Race experience. The new Plugins system means you can easily add or remove components that extend MTA:Race<br />
<br />
=== Community ===<br />
If you ever have any issues, we'll be happy to assist you in our forums. The growing amount of scripters for MTA:SA 1.0 has also meant we have a much more alive and vibrant community than previously with MTA:Race.<br />
<br />
== How do I upgrade ==<br />
=== Race players ===<br />
Upgrading your client to MTA:SA 1.0 is simply. And better yet, you have nothing to lose. MTA:SA 1.0 can be installed alongside your original MTA:Race installation without conflict.<br />
<br />
<br />
All you have to do is head to the download page (link pending) and install MTA:SA 1.0.<br />
<br />
=== Server Owners ===<br />
Server owners can easily upgrade to MTA:SA 1.0. Races are fully compatible after a short upgrade process. Simply install the latest server package, and use our [http://files.mtasa.com/apps/1.0/raceconv.zip batch converter] to convert your maps into MTA:SA 1.0 resource format.</div>Archttps://wiki.multitheftauto.com/index.php?title=Modules/IRCEcho&diff=21181Modules/IRCEcho2009-08-21T16:07:20Z<p>Arc: </p>
<hr />
<div>{{Module_Info|<br />
name = MTASA IRC Echo |<br />
version = 2.1 |<br />
author = [[User:VRocker|VRocker]] |<br />
module_website = ''Not available'' |<br />
download_link = [http://liberty-unleashed.co.uk/MTA/IRC%20Echo%20Script%20v2.zip Here] |<br />
license = ''Unlicensed'' |<br />
}}<br />
MTASA IRC Echo is a module that provides an IRC echo for an MTASA server. It is available for both Windows and Linux.<br />
<br />
==Installation==<br />
===Windows===<br />
Uncompress the file ml_ircecho.dll into your ''%PROGRAMFILES%\MTA San Andreas\server\mods\deathmatch\modules\'' directory.<br />
<br />
Then, add the following line in mtaserver.conf:<br />
<syntaxhighlight lang="xml"><br />
<module src="ml_ircecho.dll" /><br />
</syntaxhighlight><br />
<br />
(In DP2, use ''file'' instead of ''src''.)<br />
<br />
===Linux===<br />
Uncompress the file ml_ircecho.so into your ''%MTASERVER%\mods\deathmatch\modules\'' directory.<br />
<br />
Then, add the following line in mtaserver.conf:<br />
<syntaxhighlight lang="xml"><br />
<module src="ml_ircecho.so" /><br />
</syntaxhighlight><br />
<br />
(In DP2, use ''file'' instead of ''src''.)<br />
<br />
==Functions==<br />
{{Modules/IRCEcho/Functions}}<br />
<br />
==Callbacks==<br />
{{Modules/IRCEcho/Callbacks}}<br />
<br />
[[Category:Modules]]</div>Archttps://wiki.multitheftauto.com/index.php?title=Server_Manual&diff=21113Server Manual2009-08-16T12:05:25Z<p>Arc: </p>
<hr />
<div>__TOC__<br />
<br />
==Getting started==<br />
It is much easier than it looks to get a server up and running for your internet or LAN buddies: follow this wiki article and you will hopefully be on your way to hosting your own MTA:SA DM Server in no time!<br />
<br />
==Installing the server==<br />
The dedicated server application is available in different flavours depending on the platform of the server.<br />
<br />
===Linux installation===<br />
Follow the link to learn how to [http://code.google.com/p/multitheftauto/wiki/HowToBuildLinux compile the server on Linux]<br />
<br />
===Windows installation===<br />
Installation of the MTA:SA DM server on Windows is easy as pie.<br />
*Go to the [http://mtasa.com/deathmatch.html download page] and scroll down to the "Dedicated servers" section<br />
*Click the Windows download link.<br />
*Once the installer is downloaded, open it.<br />
*Select a folder where you want to install the server.<br />
*Click Install.<br />
*Done!<br />
<br />
''For a full explanation of acl.xml (access control list) read: [[Access_Control_List|Access Control List]]''<br/><br/><br />
<br />
==Configuring your server==<br />
The Multi Theft Auto dedicated server is initially configurable through it's console window, from within the game, and from a webbrowser. In order to make use of the two last options, it is necessary to add at least one administrator user to your configuration file.<br />
<br />
===General configuration===<br />
All general configuration options can be found in the 'mods/deathmatch/'''mtaserver.conf'''' file and can be opened by any regular text editor.<br />
<br />
This file is fairly straightforward; every variable has a description of what to do with it and how to change it.<br />
<br />
===Port forwarding===<br />
If you run your server on your own private computer, and you have an router between the internet and your computer. You need to forward 3 ports.<br />
<br />
First of all open the file 'mods/deathmatch/'''mtaserver.conf'''' and search for the next lines:<br />
<syntaxhighlight lang="xml"><br />
<serverport>22004</serverport> <br />
<httpport>22005</httpport><br />
</syntaxhighlight><br />
<br />
The ports are needed to setup the server right. We explain later how to set them, but first if you want your server to list in the server browser there is an other port we need, and that is the ase port. <br />
(quick example for how to turn ase on or of):<br />
<syntaxhighlight lang="xml"><br />
<ase>1</ase> <!-- 0 = off, 1 = on --><br />
</syntaxhighlight><br />
<br />
Now we going to forward the ports in router, which is not needed if you already have all ports open, or if you don't have a router with a firewall. If so, skip this part.<br />
<br />
If you don't know how port forwarding works in your router, go to: http://portforward.com/, find your router there, and follow the instructions there.<br />
<br />
In almost every router you can set the port type: UDP or TCP. The following list will explain which port type is needed for what:<br />
<br />
<br />
Main server port: UDP<br />
<br />
HTTP Port: TCP<br />
<br />
ASE Port: UDP (this is needed if you want your server to appear in the server list)<br />
<br />
<br />
The ASE port is also simply to get:<br />
<br />
ASE port = Main Server port + 123<br />
<br />
So, if you have the main server port set to 22003, then the ASE port will be 22126.<br />
<br />
Good luck!<br />
<br />
===Adding administrators===<br />
It is strongly recommended to add at least one administrator to your server in order to make use of the built-in webserver to easily maintain and configure your server. This administrator will then also be able to log-in from within the game and control the server.<br />
<br />
To add an administrator to your server, follow these steps:<br><br />
<ol><br />
<li>Make sure your server is stopped; if your server is still running, all changes you make will be overwritten</li><br />
<li>Open the file 'mods/deathmatch/'accounts.xml'''' with any text editor</li><br />
<li>Add a new account into the file by using the XML-syntax below, we use the username "BennyLava" with password "123password" for illustration purposes<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><br />
<accounts><br />
...<br />
<account name="BennyLava" password="123password" /><br />
</accounts><br />
</syntaxhighlight><br />
</div><br />
<li>Save and close the file</li><br />
<li>Open the file 'mods/deathmatch/'acl.xml'''' with any text editor</li><br />
<li>Add the account to the ''Admin'' group by using the XML-syntax below<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><br />
<ACL><br />
...<br />
<group name="Admin"><br />
<acl name="Admin"/><br />
...<br />
<object name="user.BennyLava" /><br />
</group><br />
...<br />
</ACL><br />
</syntaxhighlight><br />
</div><br />
<br />
You can actually add your user to any group you want. Each group is linked to an ACL ([[Access Control List]]). Each ACL contains a series of specific allowed or denied rights. These groups exist so different users can be assigned different rights. The ''Admin'' group points to the ''Admin'' ACL, which is empty (thus allowing all possible commands). The ''Everyone'' group points to the ''Default'' ACL that puts a series of restrictions on the available commands (to disallow regular players from using admin commands).<br />
</li><br />
<li><br />
You're done! You can add as many administrators or users as you want this way, take a look at some of the other groups and ACLs for example. The ACL is also accessible through the [[Access_Control_List|Lua scripting engine]].<br><br />
<br />
It is recommended to take a look at the web interface, we will explain how to do this below.<br />
</li><br />
</ol><br />
'''Note''': There are also ways to add accounts and edit rights for the server while it's running. "addaccount <user> <password>" is an internal command to add accounts, but you will have to use the web interface to add these accounts to specific groups/ACLs!<br /><br />
<br />
===Using the web interface===<br />
The dedicated server comes with a few Lua [[resources]] that provide a nice little web interface to your server. This can be used to easily maintain your server, as it allows you to add users, start/stop resources, and more.<br />
<br />
The web interface resources are enabled by default and are served through the built-in HTTP web server. To make sure the built-in HTTP web server runs on a port you like (22005 by default), follow these steps:<br />
<ol><br />
<li>Make sure your server is stopped<br />
<li>Open the file '''mods/deathmatch/mtaserver.conf''' with any text editor</li><br />
<li>Verify that the HTTP server is enabled:<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><br />
<httpserver>1</httpserver><br />
</syntaxhighlight><br />
</div><br />
</li><br />
<li>Change the HTTP server port to your liking:<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><br />
<httpport>22005</httpport><br />
</syntaxhighlight><br />
</div><br />
</li><br />
<li>Save and close the configuration file</li><br />
<li>Start your server</li><br />
<li>If you happened to have changed the start-up resources in your configuration file, make sure the following resources are started:<br />
<br />
# resourcebrowser<br />
# resourcemanager<br />
# webadmin<br />
# webmap<br />
<br />
These are automatically started in the default configuration file, in case you just installed your server.<br />
</li><br />
<li>Open a web browser (Internet Explorer 6 or 7 are NOT supported: use [http://www.mozilla.com/firefox Mozilla Firefox], [http://www.google.com/chrome Google Chrome], [http://www.apple.com/safari/download Apple Safari], [http://www.opera.com Opera] or others) and navigate to the HTTP server URL: '''http://server:port/'''. For example, If you are running a local server on HTTP port 22005, use '''http://127.0.0.1:22005/'''.</li><br />
<li>Enter the username and password of the administrator you added in the previous section.</li><br />
</ol><br />
<br />
<br /><br />
You should now be able to maintain your server from the web interface.<br />
<br />
=== Configuring an external web server ===<br />
The built-in web server is also used to serve files that are required by resources running on your server to any player that is connected to your server. For example, if you are running a game script with a scripted graphical user interface, or custom models, these need to be transferred to every connected player in order to function properly. This is done by either the built-in web server, or an external web server (that is usually a bit faster) but needs to be set up separately.<br />
<br />
For performance or consistency reasons during the game, you could choose to make use of such an external web server if you have one set up. The external web server needs to be accessible for the public, so any client will be able to download the necessary client-side files in order to join and play on your server.<br />
<br />
To enable downloading off an external web server, you should configure the ''httpdownload'' and ''httpdownloadurl'' tags in your server configuration:<br />
<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><httpdownload>1</httpdownload> <br />
<httpdownloadurl>http://www.myserver.tld/directory/here</httpdownloadurl><br />
</syntaxhighlight></div><br />
<br />
Since all the default resources provided with the dedicated server are zipped, and are normally automatically extracted by the built-in web server, you now have to provide a way for the clients to download the unextracted files to their computers. The unextracted files are always available in the '''<SERVER>/mods/deathmatch/resourcecache''' directory.<br />
<br />
<ol><br />
<li>Launch the dedicated server once and exit again. This will extract the zip files into the '''<SERVER>/mods/deathmatch/resourcecache''' directory.</li><br />
<li>Go into the directory above and copy the resources to your external web server's public directory, this can be done in several ways:<br />
<ul><br />
<li>If you don't care about your '''server-side files being publically available''': create a symbolic link (Linux), a junction (Windows) or just plain copy the contents of the '''resourcecache''' directory to your public web server directory.</li><br />
<li>If you don't want your server files to be publically available through your web server: go into the '''resourcecache''' directory and manually copy the folders over to your public web server directory, removing any server-side files (they are '''not''' necessary for the client-side downloading) you do not want to be hosting on your web server.<br /><br />
<br /><br />
A quick way of securing your server-side files is currently not available. We will investigate into developing a tool that automatically copies only the necessary client-side files for all resources on your server.<br />
</ul><br />
</li><br />
</ol><br />
<br />
'''Note 1''': Please try to avoid any special characters (e.g. ~, !) in your download URLs.<br /><br />
'''Note 2''': Please do not use a trailing slash in your download URL (e.g. ''hxxp://www.myserver.tld/directory'' rather than ''hxxp://www.myserver.tld/directory/'')<br />
<br />
==Starting your server==<br />
Begin by making sure that you have finished all configuration of your server, starting your server is the last stage so everything must be ready!<br />
<br />
To start your server double click on MTA Server.exe, make sure you allow it through any firewalls and forward ports where nessessary.<br />
<br />
==Installing/Updating resources on your server==<br />
Resources can come in two formats, either a ZIP format or just a normal folder with the script files inside it. The MTA:SA DM server supports both these methods.<br />
<br />
# Move or copy the new resource to your <SERVER>\mods\deathmatch\resources folder.<br />
# In the server window type in the command "refresh" (without the quotes), this will re-scan the resources folder and update the live resources where necessary.<br />
<br />
==Uninstalling resources==<br />
Resources can easily be removed from your server if you no longer want them.<br />
<br />
# Delete the ZIP file or the folder of the resource you wish to uninstall<br />
# In the server window type in the command "refresh" (without the quotes), this will re-scan the resources folder and update the live resources where necessary.<br />
<br />
==Administrating your server==<br />
You can start resources by typing the command "start resourcename" in the server console, or stop ones with "stop resourcename".<br />
<br />
It's also possible to execute these and other admin commands from the ingame console (which you can bring up with the ` key or F8); for this to work, you first need to log in with the command "login username password". Additionally, you can press the p key to bring up the admin panel: this is a graphical interface which allows you to easily kick or ban misbehaving players, among others.<br />
<br />
For further commands, type "help" in a console.<br />
<br />
==Starting a map/gamemode==<br />
See the commands section of the documentation for [[Resource:Map manager|mapmanager]] for more information.<br />
<br />
==Useful Notes==<br />
<br />
# You may also update the resources while ingame as long as you have the correct access levels by typing "refresh" in the clients console or "/refresh" in the chat window. This may cause a second of lag if you have many resources.<br />
# In the above instructions, <SERVER> is the path to your server's main directory. In most cases this is C:\Program Files\MTA San Andreas\server<br />
# You can choose a different config file for the server to use by passing it in the command line after a --config argument, e.g. mtaserver.exe --config anotherconfig.cfg.<br />
# Do not be alarmed by the warning regarding the parsing of the settings.xml file. This happens because your server installation is still clean and unused.<br />
<br />
====Need further help?====<br />
Why not pop over to our [http://forum.mtasa.com/ Forums] or join us on [irc://irc.multitheftauto.com/mta IRC] (irc.multitheftauto.com #mta - [http://www.mirc.com MIRC])<br />
<br />
[[de:MTA DM Server Anleitung]]<br />
[[it:Manuale del Server]]<br />
[[nl:Deathmatch Server Manual]]<br />
[[ru:Deathmatch Server Manual]]</div>Archttps://wiki.multitheftauto.com/index.php?title=Server_Manual&diff=21112Server Manual2009-08-16T12:04:55Z<p>Arc: /* Linux installation */</p>
<hr />
<div>__TOC__<br />
<br />
==Getting started==<br />
It is much easier than it looks to get a server up and running for your internet or LAN buddies: follow this wiki article and you will hopefully be on your way to hosting your own MTA:SA DM Server in no time!<br />
<br />
==Installing the server==<br />
The dedicated server application is available in different flavours depending on the platform of the server.<br />
<br />
==Linux installation==<br />
Follow the link to learn how to [http://code.google.com/p/multitheftauto/wiki/HowToBuildLinux compile the server on Linux]<br />
<br />
==Windows installation==<br />
Installation of the MTA:SA DM server on Windows is easy as pie.<br />
*Go to the [http://mtasa.com/deathmatch.html download page] and scroll down to the "Dedicated servers" section<br />
*Click the Windows download link.<br />
*Once the installer is downloaded, open it.<br />
*Select a folder where you want to install the server.<br />
*Click Install.<br />
*Done!<br />
<br />
''For a full explanation of acl.xml (access control list) read: [[Access_Control_List|Access Control List]]''<br/><br/><br />
<br />
==Configuring your server==<br />
The Multi Theft Auto dedicated server is initially configurable through it's console window, from within the game, and from a webbrowser. In order to make use of the two last options, it is necessary to add at least one administrator user to your configuration file.<br />
<br />
===General configuration===<br />
All general configuration options can be found in the 'mods/deathmatch/'''mtaserver.conf'''' file and can be opened by any regular text editor.<br />
<br />
This file is fairly straightforward; every variable has a description of what to do with it and how to change it.<br />
<br />
===Port forwarding===<br />
If you run your server on your own private computer, and you have an router between the internet and your computer. You need to forward 3 ports.<br />
<br />
First of all open the file 'mods/deathmatch/'''mtaserver.conf'''' and search for the next lines:<br />
<syntaxhighlight lang="xml"><br />
<serverport>22004</serverport> <br />
<httpport>22005</httpport><br />
</syntaxhighlight><br />
<br />
The ports are needed to setup the server right. We explain later how to set them, but first if you want your server to list in the server browser there is an other port we need, and that is the ase port. <br />
(quick example for how to turn ase on or of):<br />
<syntaxhighlight lang="xml"><br />
<ase>1</ase> <!-- 0 = off, 1 = on --><br />
</syntaxhighlight><br />
<br />
Now we going to forward the ports in router, which is not needed if you already have all ports open, or if you don't have a router with a firewall. If so, skip this part.<br />
<br />
If you don't know how port forwarding works in your router, go to: http://portforward.com/, find your router there, and follow the instructions there.<br />
<br />
In almost every router you can set the port type: UDP or TCP. The following list will explain which port type is needed for what:<br />
<br />
<br />
Main server port: UDP<br />
<br />
HTTP Port: TCP<br />
<br />
ASE Port: UDP (this is needed if you want your server to appear in the server list)<br />
<br />
<br />
The ASE port is also simply to get:<br />
<br />
ASE port = Main Server port + 123<br />
<br />
So, if you have the main server port set to 22003, then the ASE port will be 22126.<br />
<br />
Good luck!<br />
<br />
===Adding administrators===<br />
It is strongly recommended to add at least one administrator to your server in order to make use of the built-in webserver to easily maintain and configure your server. This administrator will then also be able to log-in from within the game and control the server.<br />
<br />
To add an administrator to your server, follow these steps:<br><br />
<ol><br />
<li>Make sure your server is stopped; if your server is still running, all changes you make will be overwritten</li><br />
<li>Open the file 'mods/deathmatch/'accounts.xml'''' with any text editor</li><br />
<li>Add a new account into the file by using the XML-syntax below, we use the username "BennyLava" with password "123password" for illustration purposes<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><br />
<accounts><br />
...<br />
<account name="BennyLava" password="123password" /><br />
</accounts><br />
</syntaxhighlight><br />
</div><br />
<li>Save and close the file</li><br />
<li>Open the file 'mods/deathmatch/'acl.xml'''' with any text editor</li><br />
<li>Add the account to the ''Admin'' group by using the XML-syntax below<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><br />
<ACL><br />
...<br />
<group name="Admin"><br />
<acl name="Admin"/><br />
...<br />
<object name="user.BennyLava" /><br />
</group><br />
...<br />
</ACL><br />
</syntaxhighlight><br />
</div><br />
<br />
You can actually add your user to any group you want. Each group is linked to an ACL ([[Access Control List]]). Each ACL contains a series of specific allowed or denied rights. These groups exist so different users can be assigned different rights. The ''Admin'' group points to the ''Admin'' ACL, which is empty (thus allowing all possible commands). The ''Everyone'' group points to the ''Default'' ACL that puts a series of restrictions on the available commands (to disallow regular players from using admin commands).<br />
</li><br />
<li><br />
You're done! You can add as many administrators or users as you want this way, take a look at some of the other groups and ACLs for example. The ACL is also accessible through the [[Access_Control_List|Lua scripting engine]].<br><br />
<br />
It is recommended to take a look at the web interface, we will explain how to do this below.<br />
</li><br />
</ol><br />
'''Note''': There are also ways to add accounts and edit rights for the server while it's running. "addaccount <user> <password>" is an internal command to add accounts, but you will have to use the web interface to add these accounts to specific groups/ACLs!<br /><br />
<br />
===Using the web interface===<br />
The dedicated server comes with a few Lua [[resources]] that provide a nice little web interface to your server. This can be used to easily maintain your server, as it allows you to add users, start/stop resources, and more.<br />
<br />
The web interface resources are enabled by default and are served through the built-in HTTP web server. To make sure the built-in HTTP web server runs on a port you like (22005 by default), follow these steps:<br />
<ol><br />
<li>Make sure your server is stopped<br />
<li>Open the file '''mods/deathmatch/mtaserver.conf''' with any text editor</li><br />
<li>Verify that the HTTP server is enabled:<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><br />
<httpserver>1</httpserver><br />
</syntaxhighlight><br />
</div><br />
</li><br />
<li>Change the HTTP server port to your liking:<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><br />
<httpport>22005</httpport><br />
</syntaxhighlight><br />
</div><br />
</li><br />
<li>Save and close the configuration file</li><br />
<li>Start your server</li><br />
<li>If you happened to have changed the start-up resources in your configuration file, make sure the following resources are started:<br />
<br />
# resourcebrowser<br />
# resourcemanager<br />
# webadmin<br />
# webmap<br />
<br />
These are automatically started in the default configuration file, in case you just installed your server.<br />
</li><br />
<li>Open a web browser (Internet Explorer 6 or 7 are NOT supported: use [http://www.mozilla.com/firefox Mozilla Firefox], [http://www.google.com/chrome Google Chrome], [http://www.apple.com/safari/download Apple Safari], [http://www.opera.com Opera] or others) and navigate to the HTTP server URL: '''http://server:port/'''. For example, If you are running a local server on HTTP port 22005, use '''http://127.0.0.1:22005/'''.</li><br />
<li>Enter the username and password of the administrator you added in the previous section.</li><br />
</ol><br />
<br />
<br /><br />
You should now be able to maintain your server from the web interface.<br />
<br />
=== Configuring an external web server ===<br />
The built-in web server is also used to serve files that are required by resources running on your server to any player that is connected to your server. For example, if you are running a game script with a scripted graphical user interface, or custom models, these need to be transferred to every connected player in order to function properly. This is done by either the built-in web server, or an external web server (that is usually a bit faster) but needs to be set up separately.<br />
<br />
For performance or consistency reasons during the game, you could choose to make use of such an external web server if you have one set up. The external web server needs to be accessible for the public, so any client will be able to download the necessary client-side files in order to join and play on your server.<br />
<br />
To enable downloading off an external web server, you should configure the ''httpdownload'' and ''httpdownloadurl'' tags in your server configuration:<br />
<br />
<div style="padding: 10px"><br />
<syntaxhighlight lang="xml"><httpdownload>1</httpdownload> <br />
<httpdownloadurl>http://www.myserver.tld/directory/here</httpdownloadurl><br />
</syntaxhighlight></div><br />
<br />
Since all the default resources provided with the dedicated server are zipped, and are normally automatically extracted by the built-in web server, you now have to provide a way for the clients to download the unextracted files to their computers. The unextracted files are always available in the '''<SERVER>/mods/deathmatch/resourcecache''' directory.<br />
<br />
<ol><br />
<li>Launch the dedicated server once and exit again. This will extract the zip files into the '''<SERVER>/mods/deathmatch/resourcecache''' directory.</li><br />
<li>Go into the directory above and copy the resources to your external web server's public directory, this can be done in several ways:<br />
<ul><br />
<li>If you don't care about your '''server-side files being publically available''': create a symbolic link (Linux), a junction (Windows) or just plain copy the contents of the '''resourcecache''' directory to your public web server directory.</li><br />
<li>If you don't want your server files to be publically available through your web server: go into the '''resourcecache''' directory and manually copy the folders over to your public web server directory, removing any server-side files (they are '''not''' necessary for the client-side downloading) you do not want to be hosting on your web server.<br /><br />
<br /><br />
A quick way of securing your server-side files is currently not available. We will investigate into developing a tool that automatically copies only the necessary client-side files for all resources on your server.<br />
</ul><br />
</li><br />
</ol><br />
<br />
'''Note 1''': Please try to avoid any special characters (e.g. ~, !) in your download URLs.<br /><br />
'''Note 2''': Please do not use a trailing slash in your download URL (e.g. ''hxxp://www.myserver.tld/directory'' rather than ''hxxp://www.myserver.tld/directory/'')<br />
<br />
==Starting your server==<br />
Begin by making sure that you have finished all configuration of your server, starting your server is the last stage so everything must be ready!<br />
<br />
To start your server double click on MTA Server.exe, make sure you allow it through any firewalls and forward ports where nessessary.<br />
<br />
==Installing/Updating resources on your server==<br />
Resources can come in two formats, either a ZIP format or just a normal folder with the script files inside it. The MTA:SA DM server supports both these methods.<br />
<br />
# Move or copy the new resource to your <SERVER>\mods\deathmatch\resources folder.<br />
# In the server window type in the command "refresh" (without the quotes), this will re-scan the resources folder and update the live resources where necessary.<br />
<br />
==Uninstalling resources==<br />
Resources can easily be removed from your server if you no longer want them.<br />
<br />
# Delete the ZIP file or the folder of the resource you wish to uninstall<br />
# In the server window type in the command "refresh" (without the quotes), this will re-scan the resources folder and update the live resources where necessary.<br />
<br />
==Administrating your server==<br />
You can start resources by typing the command "start resourcename" in the server console, or stop ones with "stop resourcename".<br />
<br />
It's also possible to execute these and other admin commands from the ingame console (which you can bring up with the ` key or F8); for this to work, you first need to log in with the command "login username password". Additionally, you can press the p key to bring up the admin panel: this is a graphical interface which allows you to easily kick or ban misbehaving players, among others.<br />
<br />
For further commands, type "help" in a console.<br />
<br />
==Starting a map/gamemode==<br />
See the commands section of the documentation for [[Resource:Map manager|mapmanager]] for more information.<br />
<br />
==Useful Notes==<br />
<br />
# You may also update the resources while ingame as long as you have the correct access levels by typing "refresh" in the clients console or "/refresh" in the chat window. This may cause a second of lag if you have many resources.<br />
# In the above instructions, <SERVER> is the path to your server's main directory. In most cases this is C:\Program Files\MTA San Andreas\server<br />
# You can choose a different config file for the server to use by passing it in the command line after a --config argument, e.g. mtaserver.exe --config anotherconfig.cfg.<br />
# Do not be alarmed by the warning regarding the parsing of the settings.xml file. This happens because your server installation is still clean and unused.<br />
<br />
====Need further help?====<br />
Why not pop over to our [http://forum.mtasa.com/ Forums] or join us on [irc://irc.multitheftauto.com/mta IRC] (irc.multitheftauto.com #mta - [http://www.mirc.com MIRC])<br />
<br />
[[de:MTA DM Server Anleitung]]<br />
[[it:Manuale del Server]]<br />
[[nl:Deathmatch Server Manual]]<br />
[[ru:Deathmatch Server Manual]]</div>Archttps://wiki.multitheftauto.com/index.php?title=Client_Manual&diff=21111Client Manual2009-08-16T12:02:57Z<p>Arc: /* Installing the game */</p>
<hr />
<div>__TOC__<br />
<br />
==Introduction==<br />
Multi Theft Auto: San Andreas is the latest in a series of fan-created multiplayer modifications for the Grand Theft Auto games (PC versions only). For the GTA3 and Vice City versions that run on the old core, visit [http://www.multitheftauto.com/ http://www.multitheftauto.com]. This mod is not endorsed by Rockstar Games or Take 2 Interactive.<br />
<br />
Please note that MTA:SA Deathmatch is a beta, which means it could crash or cause unexpected results.<br />
<br />
==Before you start==<br />
<br />
Before you install Multi Theft Auto: San Andreas, first make sure that there are no modifications to GTA:SA installed. These will conflict with MTA. If you would like to keep your single player mods, you can create two installations by reinstalling San Andreas to a second folder on your hard drive.<br />
<br />
Also make sure that you are running '''Windows XP''', '''Windows 2000''', '''Windows Vista''' or '''Windows Server 2003''' and that your machine is capable of running the game in single player. Note that if you are running single player on the absolute minimum requirements, you will experience slowdowns in MTA as it takes up extra processing power.<br />
<br />
'''Note: MTA:SA will only work on GTA:SA v1.0.''' If you bought the game recently, it is likely that you have a later version.<br />
<br />
Make sure you head over to the [[Known_Issues_-_FAQ|Known Issues]] page if you have issues, or join us on IRC @ irc://irc.multitheftauto.com/mta<br />
<br />
===System requirements===<br />
The minimum system requirements for Multi Theft Auto: San Andreas are slightly higher than the original minimum requirements for Grand Theft Auto: San Andreas.<br />
* Intel Pentium 4 or AMD Athlon XP<br />
* 512MB DDR RAM<br />
* Clean installation of Grand Theft Auto: San Andreas, version 1.0 (American or European)<br />
* 3.7GB of free hard disk space (3.6GB for a minimum Grand Theft Auto installation)<br />
* nVidia GeForce 4 series or ATI Radeon 8xxx series (64MB RAM and DirectX 9.0 compatible)<br />
* DirectX 9.0 compatible sound card<br />
* Keyboard and mouse<br />
* Broadband internet access (for smooth online play)<br />
<br />
For extra features, a pixel shader 2.0 compatible videocard (nVidia GeForce FX series or higher, ATI Radeon 9xxx series or higher) is recommended.<br />
<br />
For extra loading performance, more RAM is recommended.<br />
<br />
==Installing the game==<br />
<br />
'''This section will need to be updated when we get an installer'''<br />
<br />
# If you haven't already, download the MTA:SA client from the download page at mtasa.com.<br />
# Run the installer. You will be asked which components to install:<br />
#* '''Client''' interfaces with the game and is a required component.<br />
#* '''MTA Server''' enables you to host your own home-brew server<br />
#* '''MTA Server > Editor''' is used to create new maps, this is an optional component<br />
# You are then asked for a folder in which to install the mod. This can by anywhere and doesn't have to be in you San Andreas directory.<br />
# Next, you will be asked for the directory where you have San Andreas installed. The default location is: '''C:\Program Files\Rockstar Games\GTA San Andreas\'''.<br />
# When the installation completes, you will be given the option to start MTA: San Andreas straight away. Choose your option and then press '''Finish'''.<br />
# You will be able to launch MTA:DM from your Start Menu if you wish to play.<br />
<br />
==Running the game==<br />
# Start Multi Theft Auto by clicking the icon located in your Start Menu under '''MTA:San Andreas'''.<br />
# GTA: San Andreas will start and once it is loaded, you will be presented with the MTA:SA main menu. Here you will find several options:<br />
<br />
{| border="0" align="center"<br />
| width="188" |<br />
[[Image:MENU_QuickConnect.jpg]]<br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – this allows you to connect to a server that you already know the IP address or URL and port of. This is useful if you know precisely which server you want to join so that you don’t need to scroll through the whole server list.</font><br />
<br />
<br /><br />
|-<br />
| width="188" |<br />
[[Image:MENU_ServerBrowser.jpg|280px]]<br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – this allows you to receive a list of available servers to play on. </font><br />
<br />
<br /><br />
|-<br />
| width="188" |<br />
[[Image:Settings.jpg|280px]]<br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– this allows you to change your in-game nickname, customize controls and adjust display settings.</font><br />
<br />
<br /><br /><br />
|-<br />
| width="188" |<br />
[[Image:MENU_About.jpg|280px]]<br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– this gives you a list of contributors to the project.</font><br />
<br />
<br /><br />
|-<br />
| width="188" |<br />
<br><br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– this allows you to create your own maps, complete with checkpoints, ramps, pickups and other objects. These can then be uploaded onto a server so that you can play them with other people.</font><br />
<br />
<br /><br /><br />
|-<br />
| width="188" |<br />
<br><br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– this returns you back to your Windows desktop.</font><br />
<br />
<br /><br /><br />
|}<br />
<br />
The easiest way to play the game is to click '''Browse Servers''' on the menu. If servers have not appeared already, press the '''Refresh''' button and MTA will scan for servers, displaying them as a list.<br />
<br />
* Under the '''Name''' tab, each server's name is displayed.<br />
* Under the '''Players''' tab, the number of players and the maximum capacity of the server is displayed, in the format of [Used Slots] / [Maximum Slots].<br />
* The '''Ping''' tab displays the ping, or latency, between your machine and the server. Ping is a measure of the time it takes for "packets" of data to be received back from the server after sending them, so a higher ping means that you will experience more lag on that particular server. Generally, servers closest to your location should have the lowest pings.<br />
* The '''Host''' is the IP address of the server. You can use this address in future to connect to the same server via the Quick Connect option on the main menu.<br />
<br />
Each tab can be clicked to arrange the respective column in ascending or descending order.<br />
<br />
For optimal performance and gameplay, look for the best balance between players and ping.<br />
<br />
Once you have picked a server, select it and click the '''Connect''' button in the top right-hand corner of the dialog. If all goes well, you should connect to the server and automatically join the game.<br />
<br />
==How to Play==<br />
<br />
MTA:SA offers a comprehensive scripting system that allows map creators to customize many elements of the game in order to create their own innovative game modes. The game incorporates as many single player elements as possible but some aspects are different.<br />
<br />
There are no pedestrians and no AI traffic on the road. The only other people on the map are your opponents, or allies if it is a team game. You can talk with them using the chatbox located in the left-hand corner of the screen by pressing '''T'''. To chat only to your team members, press '''Y'''.<br />
<br />
MTA's map editor allows map creators to add various GTA objects to their maps including roads, exploding barrels, ramps, buildings, hills and more. Not only this, but the objects can be scripted to move, change model and disappear. This offers a great deal of fun and variation to the gameplay. <br />
<br />
Holding Tab will display the scoreboard. By default, only names and pings are displayed, but scripts can add extra columns that are specific to the particular gamemode being played. For example, a deathmatch game mode would definitely have a column listing total kills, but the map creator may choose to add extra columns for the number of deaths you have and how long you have been playing for, in order to put your score into perspective.<br />
<br />
==Controls==<br />
<br />
===In-Game Keys===<br />
<br />
* F8 (or Tilde Key) - Console<br />
* F9 - In-game help<br />
* F11 - Show SA map ''(the following list is for use when the map is up)''<br />
**numpad +/- - Zoom in and out<br />
**numpad 4, 8, 6, 2 - move map left, up, right, down<br />
**numpad 0 - toggle between attach to local player (map follows player blip) and free move (map stays stationary) <br />
* F12 - Take a screenshot<br />
* T - Chat<br />
* Y - Team Chat<br />
* TAB - Player List (if [[Scoreboard]] resource is running on the server)<br />
<br />
==Console Commands==<br />
<br />
'''bind defaults''' Binds control defaults in the settings menu<br />
<br />
Press '''~ (tilde)''' or '''F8''' to access the console, then type a command followed by any neccessary parameters (if applicable) then press Enter.<br />
<br />
;'''maps''' :This displays a list of all maps available on the server. <br />
<br />
;'''nick [nickname]''' :This changes your nickname whilst in-game to whatever you specify in the parameters.<br />
<br />
;'''msg [nickname] [message]''' or '''pm [nickname] [message]''' :This sends a private message to the person you specify in the [nickname] parameter. Only the person you specify can see the message. Both '''msg''' and '''pm''' perform the same function.<br />
<br />
;'''quit''' or '''exit''' :This disconnects you from the server and returns you to the Windows desktop. Performs the same function as the Quit button on the main menu.<br />
<br />
;'''ver''' :This displays the version number and copyright information for the software.<br />
<br />
;'''time''' :This displays the current time.<br />
<br />
;'''disconnect''' :This disconnects you from the server and returns you to the main menu.<br />
<br />
;'''say [text]''' :This enables you to continue talking to people in the chat box whilst the console is open.<br />
<br />
;'''ignore [nickname]''' :This will not display any text typed by the player you wish to ignore. To stop ignoring a player, type '''ignore [nickname]''' again.<br />
<br />
'''Tip:''' You can use these commands in the chatbox by putting a / (forward slash) in front of them.<br />
<br />
A list of console commands can be seen by typing '''help''' into the console and pressing Enter. The current map may also have extra commands which can be accessed by typing '''commands''' into the console.<br />
<br />
==Error codes and their meanings==<br />
'''Download errors'''<br><br />
0: UNKNOWN_ERROR<br><br />
1: INVALID_FILE_DESCRIPTORS<br><br />
2: INVALID_MAX_FILE_DESCRIPTOR<br><br />
3: INVALID_SELECT_RETURN<br><br />
4: INVALID_INITIAL_MULTI_PERFORM<br><br />
5: INVALID_MULTI_PERFORM_CODE<br><br />
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br><br />
7: UNEXPECTED_CURL_MESSAGE<br><br />
8: UNABLE_TO_CONNECT<br><br />
9: UNABLE_TO_DOWNLOAD_FILE<br><br />
10: FAILED_TO_INITIALIZE_DOWNLOAD<br><br />
<br />
'''Fatal errors'''<br><br />
1: no local player model on ingame event<br><br />
2: no local player on ingame event<br><br />
3: server downloads disabled<br><br />
4: no local player model on player-list packet<br><br />
5: no local player on player-list packet<br><br />
6: invalid custom data length on entity-add packet<br><br />
7: invalid bitstream data on entity-add packet<br><br />
8: system entity on entity-add packet<br><br />
9: failed to create object on entity-add packet<br><br />
10: failed to create pickup on entity-add packet<br><br />
11: failed to create vehicle on entity-add packet<br><br />
12: invalid team-name length on entity-add packet<br><br />
13: invalid lua-event name length in lua-event packet<br><br />
14: invalid resource name length in resource-start packet<br><br />
<br />
''''Unable to enter vehicle' errors'''<br><br />
1: script cancelled<br><br />
2: script cancelled (jack)<br><br />
3: current occupier is entering/exiting<br><br />
4: invalid seat<br><br />
5: not close enough<br><br />
6: already in a vehicle<br><br />
7: already entering/exiting<br><br />
8: invalid vehicle (trailer)<br><br />
<br />
[[es:Manual Cliente Deathmatch]]<br />
[[de:MTA DM Client Anleitung]]<br />
[[it:Manuale del Client]]<br />
[[nl:Deathmatch Client Manual]]<br />
[[ru:Deathmatch Client Manual]]</div>Archttps://wiki.multitheftauto.com/index.php?title=SetElementData&diff=21059SetElementData2009-08-13T16:54:24Z<p>Arc: </p>
<hr />
<div>{{Server client function}}<br />
__NOTOC__ <br />
This function stores [[element data]] under a certain key, attached to an element. Element data set using this is then synced with all clients or the server. As such you should avoid passing data that is not able to be synced into this function (i.e. xmlnodes, acls, aclgroups etc.) Server-created elements are able to be synced.<br />
<br />
==Syntax== <br />
<br />
<syntaxhighlight lang="lua"><br />
bool setElementData ( element theElement, string key, var value, [bool synchronize = true] )<br />
</syntaxhighlight> <br />
<br />
===Required Arguments=== <br />
*'''theElement:''' The [[element]] you wish to attach the data to.<br />
*'''key:''' The key you wish to store the data under.<br />
*'''value:''' The value you wish to store. See [[element data]] for a list of acceptable datatypes.<br />
<br />
===Optional Arguments=== <br />
*'''synchronize:''' Determines whether or not the data will be synchronized with the server (client-side variation) and remote clients (both variations).<br />
<br />
===Returns===<br />
Returns ''true'' if the data was set succesfully, ''false'' otherwise.<br />
<br />
==Example== <br />
<section name="Server" class="server" show="false"><br />
This example allows for a player to add a custom tag onto their nickname, and also revert it back to normal if they wish<br />
<syntaxhighlight lang="lua"><br />
function addPlayerCustomTag ( thePlayer, command, newTag )<br />
--Let's make sure the newTag param has been entered...<br />
if ( newTag ) then<br />
--Grab their current playername for saving.<br />
local sPlayerNickname = getClientName ( thePlayer )<br />
--Create their new nickname with their tag<br />
local sNewPlayerNickname = newTag .. " " .. sPlayerNickname<br />
<br />
--Let's first load the element data, see if it's there already<br />
--The reason for this is that if a player were to do /addtag twice,<br />
--the tag would be prepended a second time<br />
local sOldNick = getElementData( thePlayer, "tempdata.originalnick" )<br />
if ( sOldNick == false ) then<br />
--Save their orignal nickname in their element data<br />
setElementData ( thePlayer, "tempdata.originalnick", sPlayerNickname )<br />
end<br />
<br />
--Set their new nickname globally<br />
setClientName ( thePlayer, sNewPlayerNickname )<br />
<br />
--Tell them it's done<br />
outputChatBox ( "Your new nickname has been set, to put it back to its original state you can use /deltag", thePlayer )<br />
else<br />
--The newTag param was not entered, give an error message<br />
outputChatBox ( "/addtag - Incorrect syntax, Correct: /addtag <newtag>", thePlayer )<br />
end<br />
end<br />
addCommandHandler ( "addtag", addPlayerCustomTag )<br />
<br />
function removePlayerCustomTag ( thePlayer, command )<br />
--We first need to check that they have already used /addtag, let's do that now<br />
local sOldNick = getElementData( thePlayer, "tempdata.originalnick" )<br />
if ( sOldNick ) then<br />
--Great, they have a tag added, let's reset them<br />
<br />
--First we will want to reset the element data back to its default (that being false)<br />
setElementData ( thePlayer, "tempdata.originalnick", false )<br />
<br />
--Now set the client name back<br />
setClientName ( thePlayer, sOldNick )<br />
<br />
--Notify them<br />
outputChatBox ( "Your old nickname has been set", thePlayer )<br />
end<br />
end<br />
addCommandHandler ( "deltag", removePlayerCustomTag )<br />
</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Element_functions}}</div>Archttps://wiki.multitheftauto.com/index.php?title=Template:Client_ped_functions&diff=21057Template:Client ped functions2009-08-13T00:20:00Z<p>Arc: </p>
<hr />
<div>{{New feature|3|1.0|<br />
*[[blendPedAnimation]]<br />
*[[canPedBeKnockedOffBike]]<br />
*[[createPed]]<br />
*[[doesPedHaveJetPack]]<br />
*[[getPedAmmoInClip]]<br />
*[[getPedAnimation]]<br />
*[[getPedAnimationData]]<br />
*[[getPedArmor]]<br />
*[[getPedBonePosition]]<br />
*[[getPedClothes]]<br />
*[[getPedContactElement]]<br />
*[[getPedControlState]]<br />
*[[getPedOccupiedVehicle]]<br />
*[[getPedRotation]]<br />
*[[getPedSimplestTask]]<br />
*[[getPedSkin]]<br />
*[[getPedStat]]<br />
*[[getPedTarget]]<br />
*[[getPedTargetCollision]]<br />
*[[getPedTargetEnd]]<br />
*[[getPedTargetRange]]<br />
*[[getPedTargetStart]]<br />
*[[getPedTask]]<br />
*[[getPedTotalAmmo]]<br />
*[[getPedVoice]]<br />
*[[getPedWeapon]]<br />
*[[getPedWeaponMuzzlePosition]]<br />
*[[getPedWeaponSlot]]<br />
*[[isPedChoking]]<br />
*[[isPedDoingGangDriveby]]<br />
*[[isPedDoingTask]]<br />
*[[isPedDucked]]<br />
*[[isPedFrozen]]<br />
*[[isPedHeadless]]<br />
*[[isPedInVehicle]]<br />
*[[isPedInWater]]<br />
*[[isPedOnFire]]<br />
*[[isPedOnGround]]<br />
*[[setPedAimTarget]]<br />
*[[setPedAnimation]]<br />
*[[setPedCameraRotation]]<br />
*[[setPedCanBeKnockedOffBike]]<br />
*[[setPedControlState]]<br />
*[[setPedDoingGangDriveby]]<br />
*[[setPedHeadless]]<br />
*[[setPedLookAt]]<br />
*[[setPedOnFire]]<br />
*[[setPedRotation]]<br />
*[[setPedSkin]]<br />
*[[setPedVoice]]<br />
*[[setPedWeaponSlot]]<br />
}}</div>Archttps://wiki.multitheftauto.com/index.php?title=GetPedWeaponMuzzlePosition&diff=21056GetPedWeaponMuzzlePosition2009-08-13T00:19:26Z<p>Arc: Created page with '__NOTOC__ {{Client function}} Returns the world position of the muzzle of the weapon that a ped is currently carrying. The weapon muzzle is the end of the gun barrel where the b…'</p>
<hr />
<div>__NOTOC__<br />
{{Client function}}<br />
<br />
Returns the world position of the muzzle of the weapon that a ped is currently carrying. The weapon muzzle is the end of the gun barrel where the bullets/rockets/... come out.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">float, float, float getPedWeaponMuzzlePosition ( ped thePed )</syntaxhighlight><br />
<br />
===Required Arguments===<br />
*'''thePed:''' the ped whose weapon muzzle position to retrieve.<br />
<br />
===Returns===<br />
If successful, returns the x/y/z coordinates of the weapon muzzle. Returns ''false'' otherwise.<br />
<br />
==See Also==<br />
{{Client ped functions}}</div>Archttps://wiki.multitheftauto.com/index.php?title=EngineSetModelLODDistance&diff=21054EngineSetModelLODDistance2009-08-12T14:04:32Z<p>Arc: </p>
<hr />
<div>{{Client function}}<br />
__NOTOC__<br />
This function sets a custom LOD distance for any object / model ID. This is the distance at which objects of that model ID are switched to their LOD model, or (if there is no LOD model) become invisible.<br />
<br />
'''Note:''' the MTA streamer deletes objects that are further than 500 units away, regardless of LOD distance.<br><br />
Also, GTA currently has the limitation whereby the object will not be displayed if the distance to the object center is more than 300 units.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
bool engineSetModelLODDistance ( int model, float distance ) <br />
</syntaxhighlight> <br />
<br />
===Required Arguments=== <br />
*'''model:''' The model / object ID number you want to change the LOD distance of.<br />
*'''distance:''' New LOD distance value in San Andreas units.<br />
<br />
===Returns===<br />
Returns ''true'' if the function executed succesfully, ''false'' otherwise.<br />
<br />
==Example== <br />
<section name="Client" class="client" show="true"><br />
<syntaxhighlight lang="lua"><br />
-- TODO<br />
</syntaxhighlight><br />
</section><br />
<br />
<br />
==See Also==<br />
{{Engine_functions}}</div>Archttps://wiki.multitheftauto.com/index.php?title=Resource:Race&diff=21053Resource:Race2009-08-12T10:47:23Z<p>Arc: /* Parameters */</p>
<hr />
<div>{{Resource page}}<br />
__NOTOC__<br />
The "race" gamemode organizes sprint or freeroam races for one or more players. It supports both maps from MTA:Race and maps in the MTA:SA DM map syntax that were created in the map editor.<br />
<br />
==Ingame==<br />
Playing race is quite straightforward. If there are checkpoints, drive from checkpoint to checkpoint and be the first to reach the finish line within the time. If there are no checkpoints, just drive around and have fun.<br />
<br />
In races you may encounter three types of pickups which will have an effect on your vehicle:<br />
*'''Repair pickups:''' this pickup looks like a wrench. If you drive over it, your vehicle will be restored to full health.<br />
*'''Nitrous oxide pickups:''' a red NOS bottle. After you drive over one you can press the fire button (by default the left mouse button) to get a temporary speed boost.<br />
*'''Vehicle change pickups:''' these display the name of a vehicle above them. As soon as you drive over a pickup your vehicle will be changed.<br />
<br />
Lastly, if you get stuck during a race, you can enter the /kill command in the chatbox to kill yourself and respawn at the previous checkpoint.<br />
<br />
==Converting MTA:Race maps==<br />
Use the [http://files.mtasa.com/apps/1.0/raceconv.zip batch converter] to convert all your MTA:Race maps into MTA:SA maps in one go.<br />
<br />
==Map syntax==<br />
You can create race maps using the new MTA:SA [[Resource:editor|map editor]]. The map syntax is given here for reference.<br />
<br />
===.map file===<br />
<syntaxhighlight lang="xml"><br />
<map mod="deathmatch"><br />
<!-- One or more --><br />
<spawnpoint posX="X" posY="Y" posZ="Z" rotation="Rotation in degrees" vehicle="Vehicle ID" id="spawnpointID" [ paintjob="paintjob ID" upgrades="comma-separated list of upgrades" ] /><br />
<br />
<!-- Zero or more --><br />
<checkpoint posX="X" posY="Y" posZ="Z" color="#FF0000" id="textual or numeric checkpoint ID" nextid="ID of checkpoint after this one" [ size="checkpoint size" vehicle="vehicle ID to change into" paintjob="paintjob ID" upgrades="comma-separated list of upgrades" ] /><br />
<br />
<!-- Zero or more --><br />
<object posX="X" posY="Y" posZ="Z" rotX="in degrees" rotY="in degrees" rotZ="in degrees" model="model ID" id="objectID" /><br />
<br />
<!-- Zero or more --><br />
<pickup posX="X" posY="Y" posZ="Z" type="repair|nitro|vehiclechange" id="pickupID" [ vehicle="vehicle ID" paintjob="paintjob ID" upgrades="comma-separated list of upgrades" ] /><br />
</map><br />
</syntaxhighlight><br />
<br />
===meta.xml===<br />
<syntaxhighlight lang="xml"><br />
<meta><br />
<info type="map" gamemodes="race" name="Map name" author="Author name" description="Map description" version="Map version number"/><br />
<race src="Map file.map"/><br />
<settings><br />
<setting name="#optionName" value="optionValue"/><br />
...<br />
</settings><br />
</meta><br />
</syntaxhighlight><br />
The <setting>s correspond to options in MTA:Race syntax. For example, <time>4:0</time> in MTA:Race syntax would correspond to <setting name="#time" value="4:0"/> in DM syntax.<br />
<br />
==Addons==<br />
A Race 'addon' is no different from any other script resource, except that is has addon="race" in the <info> section of it's meta.xml file. This is simply to allow Race to identify it and put it in the /config menu for you. Addons communicate with Race via events. The current list of Race events and what they do are here:<br />
<br />
==Events for version 0.8.3==<br />
<br />
===Server===<br />
<br />
'''onPlayerReachCheckpoint'''<br />
<br />
'''onPlayerPickUpRacePickup'''<br />
<br />
'''onMapStarting'''<br />
<br />
'''onPlayerFinish'''<br />
<br />
'''onPostFinish'''<br />
<br />
'''onPollStarting'''<br />
<br />
===Client===<br />
'''onClientMapStarting'''<br />
<br />
'''onClientPlayerFinish'''<br />
<br />
'''onClientPlayerOutOfTime'''<br />
<br />
'''onClientMapStopping'''<br />
<br />
'''onClientScreenFadedOut'''<br />
<br />
'''onClientScreenFadedIn'''<br />
<br />
==Events for version 0.8.3 in detail==<br />
===onPlayerReachCheckpoint===<br />
====Parameters====<br />
<syntaxhighlight lang="lua">int checkpoint</syntaxhighlight><br />
*'''checkpoint:''' the number of the checkpoint the player went through. The first checkpoint has number 1.<br />
<br />
====Source====<br />
The source is the player that reached the checkpoint.<br />
<br />
===onPlayerPickUpRacePickup===<br />
====Parameters====<br />
<syntaxhighlight lang="lua">int/string pickupID, string type, int vehicle</syntaxhighlight><br />
*'''pickupID:''' the number of the pickup in case of MTA:Race syntax (starting at 1), or the "id" attribute of the pickup in case of DM syntax.<br />
*'''type:''' the pickup type. Can be "nitro", "repair" or "vehiclechange".<br />
*'''vehicle:''' if the pickup is of type vehiclechange, this is the vehicle model that it sets.<br />
<br />
====Source====<br />
The source is the player that picked up the pickup.<br />
<br />
==Element data==<br />
These element data are set on each player:<br />
*'''Race rank:''' the current position of the player in the race. 1 = first, 2 = second etc. Updated on a 1 second interval.<br />
*'''race.checkpoint:''' the number of the checkpoint the player is ''heading for''. When the player spawns this number is 1, after he passed the first checkpoint it's 2, etc.<br />
*'''race.finished:''' ''true'' if the player has finished, ''false'' if he's still racing.</div>Archttps://wiki.multitheftauto.com/index.php?title=Dictionary&diff=21018Dictionary2009-08-09T00:38:44Z<p>Arc: Undo revision 21017 by Arc (Talk)</p>
<hr />
<div>Over the years MTA's community has come across some new terms and words. They are most often used in IRC and on the forums but some are also featered in the game. What follows is an alphabetical list.<br />
<hr /><br /><br />
<br />
* Bitchpack (verb)<br />
Use of the lack of enter vehicle animation in MTA 0.x in order to get unlimited players into a <br />
vehicle<br />
<br />
* Johnline (being a ..) (noun)<br />
acting immature, using a lot of sexual related insults hoping to make you look cool/mature.<br />
<br />
* MAD_BOY (noun)<br />
When something is refered to as old or outdated<br />
<br />
* Ransom<br />
GTANet's resident bastard operator from hell<br />
<br />
* RIFK<br />
A common typographical error of "rofl", has also come to be known as an acronym <br />
for "rolling in fucking kitchens." Though first pioneered in #mta by Jani, it is most<br />
frequently used by BrophY and Johnline<br />
<br />
* Robpol86 (verb)/(noun)<br />
-Consistent use of mushrooms in order to grow and the ability to jump incredibly high<br />
-Also a mythical creature with a mustache of supernatural size and ability<br />
<br />
* YOIV<br />
-Your Opinion Is Void (aka "pulling a Luke")<br />
-Used to discribe a situation where an admin uses his powers to force his own opinion onto <br />
a person or a group of people.</div>Archttps://wiki.multitheftauto.com/index.php?title=Dictionary&diff=21017Dictionary2009-08-09T00:34:46Z<p>Arc: </p>
<hr />
<div>Over the years MTA's community has come across some new terms and words. They are most often used in IRC and on the forums but some are also featered in the game. What follows is an alphabetical list.<br />
<hr /><br /><br />
<br />
* Bitchpack (verb)<br />
Use of the lack of enter vehicle animation in MTA 0.x in order to get unlimited players into a <br />
vehicle<br />
<br />
* Johnline (being a ..) (noun)<br />
acting immature, using a lot of sexual related insults hoping to make you look cool/mature.<br />
<br />
* MAD_BOY (noun)<br />
Acting emo, talking about committing suicide in order to get attention.<br />
<br />
* Ransom<br />
GTANet's resident bastard operator from hell<br />
<br />
* RIFK<br />
A common typographical error of "rofl", has also come to be known as an acronym <br />
for "rolling in fucking kitchens." Though first pioneered in #mta by Jani, it is most<br />
frequently used by BrophY and Johnline<br />
<br />
* Robpol86 (verb)/(noun)<br />
-Consistent use of mushrooms in order to grow and the ability to jump incredibly high<br />
-Also a mythical creature with a mustache of supernatural size and ability<br />
<br />
* YOIV<br />
-Your Opinion Is Void (aka "pulling a Luke")<br />
-Used to discribe a situation where an admin uses his powers to force his own opinion onto <br />
a person or a group of people.</div>Archttps://wiki.multitheftauto.com/index.php?title=OnClientPreRender&diff=21000OnClientPreRender2009-08-07T13:03:59Z<p>Arc: </p>
<hr />
<div>__NOTOC__<br />
{{Client event}} <br />
This event is triggered every time before GTA renders a new frame.<br />
<br />
==Parameters==<br />
<syntaxhighlight lang="lua"><br />
float timeSlice<br />
</syntaxhighlight><br />
*'''timeSlice:''' The interval between this frame and the previous one in milliseconds.<br />
<br />
==Source==<br />
The [[event system#Event source|source]] of this event is the client's [[root element]].<br />
<br />
==Example==<br />
This example makes the camera follow the player in a GTA2-like way.<br />
<syntaxhighlight lang="lua"><br />
function updateCamera ()<br />
local x, y, z = getElementPosition ( getLocalPlayer () )<br />
setCameraMatrix ( x, y, z + 50, x, y, z )<br />
end<br />
addEventHandler ( "onClientPreRender", getLocalPlayer(), updateCamera )<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
===Other client events===<br />
{{Client_other_events}}<br />
===Client event functions===<br />
{{Client_event_functions}}</div>Archttps://wiki.multitheftauto.com/index.php?title=Resource:Race&diff=20994Resource:Race2009-08-07T00:49:08Z<p>Arc: </p>
<hr />
<div>{{Resource page}}<br />
__NOTOC__<br />
The "race" gamemode organizes sprint or freeroam races for one or more players. It supports both maps from MTA:Race and maps in the MTA:SA DM map syntax that were created in the map editor.<br />
<br />
==Ingame==<br />
Playing race is quite straightforward. If there are checkpoints, drive from checkpoint to checkpoint and be the first to reach the finish line within the time. If there are no checkpoints, just drive around and have fun.<br />
<br />
In races you may encounter three types of pickups which will have an effect on your vehicle:<br />
*'''Repair pickups:''' this pickup looks like a wrench. If you drive over it, your vehicle will be restored to full health.<br />
*'''Nitrous oxide pickups:''' a red NOS bottle. After you drive over one you can press the fire button (by default the left mouse button) to get a temporary speed boost.<br />
*'''Vehicle change pickups:''' these display the name of a vehicle above them. As soon as you drive over a pickup your vehicle will be changed.<br />
<br />
Lastly, if you get stuck during a race, you can enter the /kill command in the chatbox to kill yourself and respawn at the previous checkpoint.<br />
<br />
==Converting MTA:Race maps==<br />
Use the [http://files.mtasa.com/apps/1.0/raceconv.zip batch converter] to convert all your MTA:Race maps into MTA:SA maps in one go.<br />
<br />
==Map syntax==<br />
You can create race maps using the new MTA:SA [[Resource:editor|map editor]]. The map syntax is given here for reference.<br />
<br />
===.map file===<br />
<syntaxhighlight lang="xml"><br />
<map mod="deathmatch"><br />
<!-- One or more --><br />
<spawnpoint posX="X" posY="Y" posZ="Z" rotation="Rotation in degrees" vehicle="Vehicle ID" id="spawnpointID" [ paintjob="paintjob ID" upgrades="comma-separated list of upgrades" ] /><br />
<br />
<!-- Zero or more --><br />
<checkpoint posX="X" posY="Y" posZ="Z" color="#FF0000" id="textual or numeric checkpoint ID" nextid="ID of checkpoint after this one" [ size="checkpoint size" vehicle="vehicle ID to change into" paintjob="paintjob ID" upgrades="comma-separated list of upgrades" ] /><br />
<br />
<!-- Zero or more --><br />
<object posX="X" posY="Y" posZ="Z" rotX="in degrees" rotY="in degrees" rotZ="in degrees" model="model ID" id="objectID" /><br />
<br />
<!-- Zero or more --><br />
<pickup posX="X" posY="Y" posZ="Z" type="repair|nitro|vehiclechange" id="pickupID" [ vehicle="vehicle ID" paintjob="paintjob ID" upgrades="comma-separated list of upgrades" ] /><br />
</map><br />
</syntaxhighlight><br />
<br />
===meta.xml===<br />
<syntaxhighlight lang="xml"><br />
<meta><br />
<info type="map" gamemodes="race" name="Map name" author="Author name" description="Map description" version="Map version number"/><br />
<race src="Map file.map"/><br />
<settings><br />
<setting name="#optionName" value="optionValue"/><br />
...<br />
</settings><br />
</meta><br />
</syntaxhighlight><br />
The <setting>s correspond to options in MTA:Race syntax. For example, <time>4:0</time> in MTA:Race syntax would correspond to <setting name="#time" value="4:0"/> in DM syntax.<br />
<br />
==Addons==<br />
A Race 'addon' is no different from any other script resource, except that is has addon="race" in the <info> section of it's meta.xml file. This is simply to allow Race to identify it and put it in the /config menu for you. Addons communicate with Race via events. The current list of Race events and what they do are here:<br />
<br />
==Events for version 0.8.3==<br />
<br />
===Server===<br />
<br />
'''onPlayerReachCheckpoint'''<br />
<br />
'''onPlayerPickUpRacePickup'''<br />
<br />
'''onMapStarting'''<br />
<br />
'''onPlayerFinish'''<br />
<br />
'''onPostFinish'''<br />
<br />
'''onPollStarting'''<br />
<br />
===Client===<br />
'''onClientMapStarting'''<br />
<br />
'''onClientPlayerFinish'''<br />
<br />
'''onClientPlayerOutOfTime'''<br />
<br />
'''onClientMapStopping'''<br />
<br />
'''onClientScreenFadedOut'''<br />
<br />
'''onClientScreenFadedIn'''<br />
<br />
==Events for version 0.8.3 in detail==<br />
===onPlayerReachCheckpoint===<br />
====Parameters====<br />
<syntaxhighlight lang="lua">int checkpoint</syntaxhighlight><br />
*'''checkpoint:''' the number of the checkpoint the player went through. The first checkpoint has number 1.<br />
<br />
====Source====<br />
The source is the player that reached the checkpoint.<br />
<br />
===onPlayerPickUpRacePickup===<br />
====Parameters====<br />
<syntaxhighlight lang="lua">int/string pickupID</syntaxhighlight><br />
*'''pickupID:''' the number of the pickup in case of MTA:Race syntax (starting at 1), or the "id" attribute of the pickup in case of DM syntax.<br />
<br />
====Source====<br />
The source is the player that picked up the pickup.<br />
<br />
==Element data==<br />
These element data are set on each player:<br />
*'''Race rank:''' the current position of the player in the race. 1 = first, 2 = second etc. Updated on a 1 second interval.<br />
*'''race.checkpoint:''' the number of the checkpoint the player is ''heading for''. When the player spawns this number is 1, after he passed the first checkpoint it's 2, etc.<br />
*'''race.finished:''' ''true'' if the player has finished, ''false'' if he's still racing.</div>Archttps://wiki.multitheftauto.com/index.php?title=Resource:Race&diff=20993Resource:Race2009-08-07T00:46:09Z<p>Arc: </p>
<hr />
<div>{{Resource page}}<br />
__NOTOC__<br />
The "race" gamemode organizes sprint or freeroam races for one or more players. It supports both maps from MTA:Race and maps in the MTA:SA DM map syntax that were created in the map editor.<br />
<br />
==Ingame==<br />
Playing race is quite straightforward. If there are checkpoints, drive from checkpoint to checkpoint and be the first to reach the finish line within the time. If there are no checkpoints, just drive around and have fun.<br />
<br />
In races you may encounter three types of pickups which will have an effect on your vehicle:<br />
*'''Repair pickups:''' this pickup looks like a wrench. If you drive over it, your vehicle will be restored to full health.<br />
*'''Nitrous oxide pickups:''' a red NOS bottle. After you drive over one you can press the fire button (by default the left mouse button) to get a temporary speed boost.<br />
*'''Vehicle change pickups:''' these display the name of a vehicle above them. As soon as you drive over a pickup your vehicle will be changed.<br />
<br />
Lastly, if you get stuck during a race, you can enter the /kill command in the chatbox to kill yourself and respawn at the previous checkpoint.<br />
<br />
==Converting MTA:Race maps==<br />
Use the [http://files.mtasa.com/apps/1.0/raceconv.zip batch converter] to convert all your MTA:Race maps into MTA:SA maps in one go.<br />
<br />
==Map syntax==<br />
You can create race maps using the new MTA:SA map editor. The map syntax is given here for reference.<br />
<br />
===.map file===<br />
<syntaxhighlight lang="xml"><br />
<map mod="deathmatch"><br />
<!-- One or more --><br />
<spawnpoint posX="X" posY="Y" posZ="Z" rotation="Rotation in degrees" vehicle="Vehicle ID" id="spawnpointID" [ paintjob="paintjob ID" upgrades="comma-separated list of upgrades" ] /><br />
<br />
<!-- Zero or more --><br />
<checkpoint posX="X" posY="Y" posZ="Z" color="#FF0000" id="textual or numeric checkpoint ID" nextid="ID of checkpoint after this one" [ size="checkpoint size" vehicle="vehicle ID to change into" paintjob="paintjob ID" upgrades="comma-separated list of upgrades" ] /><br />
<br />
<!-- Zero or more --><br />
<object posX="X" posY="Y" posZ="Z" rotX="in degrees" rotY="in degrees" rotZ="in degrees" model="model ID" id="objectID" /><br />
<br />
<!-- Zero or more --><br />
<pickup posX="X" posY="Y" posZ="Z" type="repair|nitro|vehiclechange" id="pickupID" [ vehicle="vehicle ID" paintjob="paintjob ID" upgrades="comma-separated list of upgrades" ] /><br />
</map><br />
</syntaxhighlight><br />
<br />
===meta.xml===<br />
<syntaxhighlight lang="xml"><br />
<meta><br />
<info type="map" gamemodes="race" name="Map name" author="Author name" description="Map description" version="Map version number"/><br />
<race src="Map file.map"/><br />
<settings><br />
<setting name="#optionName" value="optionValue"/><br />
...<br />
</settings><br />
</meta><br />
</syntaxhighlight><br />
The <setting>s correspond to options in MTA:Race syntax. For example, <time>4:0</time> in MTA:Race syntax would correspond to <setting name="#time" value="4:0"/> in DM syntax.<br />
<br />
==Adding your scripts to Race==<br />
If you want to add new features to Race, you can either modify the original Race resource files, or more preferably, add the features as a separate resource and communicate with Race via events.<br />
Not hacking the Race core and is probably a good idea if you want to apply official updates and fixes for Race in the future. Choosing to use separate resources for your customization also means you can continue use customizations from other people, and if you so wish, share your customization with others.<br />
<br />
==Addons==<br />
A Race 'addon' is no different from any other script resource, except that is has addon="race" in the <info> section of it's meta.xml file. This is simply to allow Race to identify it and put it in the /config menu for you. Addons communicate with Race via events. The current list of Race events and what they do are here:<br />
<br />
==Events for version 0.8.3==<br />
<br />
===Server===<br />
<br />
'''onPlayerReachCheckpoint'''<br />
<br />
'''onPlayerPickUpRacePickup'''<br />
<br />
'''onMapStarting'''<br />
<br />
'''onPlayerFinish'''<br />
<br />
'''onPostFinish'''<br />
<br />
'''onPollStarting'''<br />
<br />
===Client===<br />
'''onClientMapStarting'''<br />
<br />
'''onClientPlayerFinish'''<br />
<br />
'''onClientPlayerOutOfTime'''<br />
<br />
'''onClientMapStopping'''<br />
<br />
'''onClientScreenFadedOut'''<br />
<br />
'''onClientScreenFadedIn'''<br />
<br />
==Events for version 0.8.3 in detail==<br />
===onPlayerReachCheckpoint===<br />
====Parameters====<br />
<syntaxhighlight lang="lua">int checkpoint</syntaxhighlight><br />
*'''checkpoint:''' the number of the checkpoint the player went through. The first checkpoint has number 1.<br />
<br />
====Source====<br />
The source is the player that reached the checkpoint.<br />
<br />
===onPlayerPickUpRacePickup===<br />
====Parameters====<br />
<syntaxhighlight lang="lua">int/string pickupID</syntaxhighlight><br />
*'''pickupID:''' the number of the pickup in case of MTA:Race syntax (starting at 1), or the "id" attribute of the pickup in case of DM syntax.<br />
<br />
====Source====<br />
The source is the player that picked up the pickup.<br />
<br />
==Element data==<br />
These element data are set on each player:<br />
*'''Race rank:''' the current position of the player in the race. 1 = first, 2 = second etc. Updated on a 1 second interval.<br />
*'''race.checkpoint:''' the number of the checkpoint the player is ''heading for''. When the player spawns this number is 1, after he passed the first checkpoint it's 2, etc.<br />
*'''race.finished:''' ''true'' if the player has finished, ''false'' if he's still racing.</div>Archttps://wiki.multitheftauto.com/index.php?title=Resource:Race&diff=20992Resource:Race2009-08-07T00:45:48Z<p>Arc: </p>
<hr />
<div>{{Resource page}}<br />
__NOTOC__<br />
The "race" gamemode organizes sprint or freeroam races for one or more players. It supports both maps from MTA:Race and maps in the MTA:SA DM map syntax that were created in the map editor.<br />
<br />
==Ingame==<br />
Playing race is quite straightforward. If there are checkpoints, drive from checkpoint to checkpoint and be the first to reach the finish line within the time. If there are no checkpoints, just drive around and have fun.<br />
<br />
In races you may encounter three types of pickups which will have an effect on your vehicle:<br />
*'''Repair pickups:''' this pickup looks like a wrench. If you drive over it, your vehicle will be restored to full health.<br />
*'''Nitrous oxide pickups:''' a red NOS bottle. After you drive over one you can press the fire button (by default the left mouse button) to get a temporary speed boost.<br />
*'''Vehicle change pickups:''' these display the name of a vehicle above them. As soon as you drive over a pickup your vehicle will be changed.<br />
<br />
Lastly, if you get stuck during a race, you can enter the /kill command in the chatbox to kill yourself and respawn at the previous checkpoint.<br />
<br />
==Converting MTA:Race maps==<br />
Use the [http://files.mtasa.com/apps/1.0/raceconv.zip|batch converter] to convert all your MTA:Race maps into MTA:SA maps in one go.<br />
<br />
==Map syntax==<br />
You can create race maps using the new MTA:SA map editor. The map syntax is given here for reference.<br />
<br />
===.map file===<br />
<syntaxhighlight lang="xml"><br />
<map mod="deathmatch"><br />
<!-- One or more --><br />
<spawnpoint posX="X" posY="Y" posZ="Z" rotation="Rotation in degrees" vehicle="Vehicle ID" id="spawnpointID" [ paintjob="paintjob ID" upgrades="comma-separated list of upgrades" ] /><br />
<br />
<!-- Zero or more --><br />
<checkpoint posX="X" posY="Y" posZ="Z" color="#FF0000" id="textual or numeric checkpoint ID" nextid="ID of checkpoint after this one" [ size="checkpoint size" vehicle="vehicle ID to change into" paintjob="paintjob ID" upgrades="comma-separated list of upgrades" ] /><br />
<br />
<!-- Zero or more --><br />
<object posX="X" posY="Y" posZ="Z" rotX="in degrees" rotY="in degrees" rotZ="in degrees" model="model ID" id="objectID" /><br />
<br />
<!-- Zero or more --><br />
<pickup posX="X" posY="Y" posZ="Z" type="repair|nitro|vehiclechange" id="pickupID" [ vehicle="vehicle ID" paintjob="paintjob ID" upgrades="comma-separated list of upgrades" ] /><br />
</map><br />
</syntaxhighlight><br />
<br />
===meta.xml===<br />
<syntaxhighlight lang="xml"><br />
<meta><br />
<info type="map" gamemodes="race" name="Map name" author="Author name" description="Map description" version="Map version number"/><br />
<race src="Map file.map"/><br />
<settings><br />
<setting name="#optionName" value="optionValue"/><br />
...<br />
</settings><br />
</meta><br />
</syntaxhighlight><br />
The <setting>s correspond to options in MTA:Race syntax. For example, <time>4:0</time> in MTA:Race syntax would correspond to <setting name="#time" value="4:0"/> in DM syntax.<br />
<br />
==Adding your scripts to Race==<br />
If you want to add new features to Race, you can either modify the original Race resource files, or more preferably, add the features as a separate resource and communicate with Race via events.<br />
Not hacking the Race core and is probably a good idea if you want to apply official updates and fixes for Race in the future. Choosing to use separate resources for your customization also means you can continue use customizations from other people, and if you so wish, share your customization with others.<br />
<br />
==Addons==<br />
A Race 'addon' is no different from any other script resource, except that is has addon="race" in the <info> section of it's meta.xml file. This is simply to allow Race to identify it and put it in the /config menu for you. Addons communicate with Race via events. The current list of Race events and what they do are here:<br />
<br />
==Events for version 0.8.3==<br />
<br />
===Server===<br />
<br />
'''onPlayerReachCheckpoint'''<br />
<br />
'''onPlayerPickUpRacePickup'''<br />
<br />
'''onMapStarting'''<br />
<br />
'''onPlayerFinish'''<br />
<br />
'''onPostFinish'''<br />
<br />
'''onPollStarting'''<br />
<br />
===Client===<br />
'''onClientMapStarting'''<br />
<br />
'''onClientPlayerFinish'''<br />
<br />
'''onClientPlayerOutOfTime'''<br />
<br />
'''onClientMapStopping'''<br />
<br />
'''onClientScreenFadedOut'''<br />
<br />
'''onClientScreenFadedIn'''<br />
<br />
==Events for version 0.8.3 in detail==<br />
===onPlayerReachCheckpoint===<br />
====Parameters====<br />
<syntaxhighlight lang="lua">int checkpoint</syntaxhighlight><br />
*'''checkpoint:''' the number of the checkpoint the player went through. The first checkpoint has number 1.<br />
<br />
====Source====<br />
The source is the player that reached the checkpoint.<br />
<br />
===onPlayerPickUpRacePickup===<br />
====Parameters====<br />
<syntaxhighlight lang="lua">int/string pickupID</syntaxhighlight><br />
*'''pickupID:''' the number of the pickup in case of MTA:Race syntax (starting at 1), or the "id" attribute of the pickup in case of DM syntax.<br />
<br />
====Source====<br />
The source is the player that picked up the pickup.<br />
<br />
==Element data==<br />
These element data are set on each player:<br />
*'''Race rank:''' the current position of the player in the race. 1 = first, 2 = second etc. Updated on a 1 second interval.<br />
*'''race.checkpoint:''' the number of the checkpoint the player is ''heading for''. When the player spawns this number is 1, after he passed the first checkpoint it's 2, etc.<br />
*'''race.finished:''' ''true'' if the player has finished, ''false'' if he's still racing.</div>Archttps://wiki.multitheftauto.com/index.php?title=OnClientVehicleExit&diff=20991OnClientVehicleExit2009-08-07T00:25:05Z<p>Arc: </p>
<hr />
<div>[[Category:Incomplete Event]]<br />
{{Client event}}<br />
__NOTOC__<br />
This event gets fired when a player gets out of a vehicle.<br />
<br />
==Parameters==<br />
<syntaxhighlight lang="lua"><br />
player thePlayer, int seat<br />
</syntaxhighlight><br />
*'''thePlayer:''' the player that exited the vehicle<br />
*'''seat:''' the number of the seat that the player was sitting on. 0 = driver, higher numbers are passenger seats.<br />
<br />
==Source==<br />
The source of the event is the vehicle that the player exited.<br />
<br />
==Example== <br />
This code updates a GUI label with the name of the vehicle the local player is in.<br />
<syntaxhighlight lang="lua"><br />
lblVehicle = guiCreateLabel(10, 200, 150, 20, "Currently on foot", false)<br />
addEventHandler("onClientVehicleEnter", getRootElement(),<br />
function(thePlayer, seat)<br />
if thePlayer == getLocalPlayer() then<br />
guiSetText(lblVehicle, "Currently in a " .. getVehicleName(source))<br />
end<br />
end<br />
)<br />
<br />
addEventHandler("onClientVehicleExit", getRootElement(),<br />
function(thePlayer, seat)<br />
if thePlayer == getLocalPlayer() then<br />
guiSetText(lblVehicle, "Currently on foot")<br />
end<br />
end<br />
)<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
===Client vehicle events===<br />
{{Client_vehicle_events}}<br />
===Client event functions===<br />
{{Client_event_functions}}</div>Archttps://wiki.multitheftauto.com/index.php?title=Resource:Editor&diff=20988Resource:Editor2009-08-06T17:30:37Z<p>Arc: /* Creating maps for specific gamemodes */</p>
<hr />
<div>{{Resource page}}<br />
The MTA:SA map editor allows you to create maps for gamemodes.<br />
<br />
==Starting==<br />
To start the editor, simply click the "Map editor" menu item in the main MTA menu.<br />
<br />
==Menus==<br />
Once the editor has started, you are presented with two menu bars: the main menu at the top, and the element menu in the lower left.<br />
<br />
===Main menu===<br />
These are the buttons in the main menu:<br />
* [[Image:Editor_New.png]] Create a new map.<br />
* [[Image:Editor_Open.png]] Open an existing map.<br />
* [[Image:Editor_Save.png]] Save the map you're working on.<br />
* [[Image:Editor_Save_as.png]] Save your map under a different name.<br />
* [[Image:Editor_Options.png]] Alter general map editor settings.<br />
* [[Image:Editor_Undo.png]] Undo the last action.<br />
* [[Image:Editor_Redo.png]] Restore the last undone action.<br />
* [[Image:Editor_Locations.png]] Stored game world locations. The editor comes with a great list of San Andreas Interior locations but you can also add your own interior and non-interior locations to the list.<br />
* [[Image:Editor_Current_elements.png]] List all the elements the map contains (objects, vehicles, markers, pickups etc.)<br />
* [[Image:Editor_Map_settings.png]] Map specific settings, like time of day, gravity etc. Here you can also specify what gamemodes the map is compatible with.<br />
* [[Image:Editor_Definitions.png]] Load [[Resource:Editor/EDF|editor definition files (EDF)]] that you want to use. <br />
* [[Image:Editor_Test.png]] Go into play mode to try out the map. This will load up the gamemode the map is made for.<br />
<br />
===Element menu===<br />
The element menu is used to add new elements to the map.<br />
* [[Image:Editor_Vehicle.png]] Create a new vehicle.<br />
* [[Image:Editor_Object.png]] Create a new object (buildings, roads and other scenery).<br />
* [[Image:Editor_Pickup.png]] Create a new pickup (health, armor, weapons).<br />
* [[Image:Editor_Marker.png]] Create a new marker.<br />
<br />
Additionally, if you have [[Resource:Editor/EDF|editor definitions loaded]], you can roll the mousewheel in this menu to bring up custom elements.<br />
<br />
==Using the editor==<br />
This section explains how to create and modify maps.<br />
<br />
===Moving around the map===<br />
When you initially start the editor, you are in ''camera mode''. You are able to use the '''WSAD''' keys to move the camera and the mouse to pan the camera. While moving around, you can hold '''ALT''' to move more slowly or '''SHIFT''' to go faster.<br />
<br />
To access the editor's interface and control panel you need to switch to ''cursor mode''. You can toggle between cursor mode and camera mode with the '''F''' key. When in cursor mode, your view is fixed, and you can use the mouse cursor to manipulate elements and use the graphical interface.<br />
<br />
Camera mode can be recognized by a crosshair in the center of the screen. You can use it to select and move elements just like in cursor mode.<br />
<br />
[[Image:Editor_Crosshair.png|center]]<br />
<br />
===Starting a new map===<br />
* Start the editor, or if it is already started, click the ''New'' menu button.<br />
* Click the ''Map settings'' button. In the ''Meta'' tab, fill in the Name and Author fields with the name of the map and your name respectively. Also open the ''Gamemodes'' tab and add the gamemodes your map is meant for (they will be moved to the ''Added gamemodes'' list). You can do this by selecting them and clicking ''Add'', or by double clicking them. Click OK when you're done.<br />
[[Image:Editor_Mapsettings.png|center]]<br />
* Click the ''Definitions'' window and add the resources of which you want to use the custom elements. These will consist of the gamemodes you selected in the ''Map settings'' window, plus eventual additional resources. For more information about editor definitions, see [[Resource:Editor/EDF|EDF]]. Click OK when you're done.<br />
<br />
===Creating new elements===<br />
Adding elements to your map, such as vehicles and objects, is very straightforward.<br />
* If you are in camera mode, switch to cursor mode first by pressing '''F'''.<br />
* Click the button in the element menu that represents what you want. E.g., click the button with a car on it to add a vehicle.<br />
* A new element of the selected type will be created and attached to your cursor. Move it to the location where you want it and '''left click''' to drop it off.<br />
<br />
<br />
[[Image:Editor_Addelem.png|center]]<br />
<br />
<br />
To create custom elements that are specific to a resource, hover the cursor over the element menu and turn the scroll wheel until the desired resource comes up. Note that for this to work, you first have to add the [[Resource:Editor/EDF|EDF]] file of the resource in the ''Definitions'' window.<br />
<br />
[[Image:Editor_Selectedf.png|center]]<br />
<br />
===Selecting===<br />
* '''Left click''' an element to select it in ''keyboard mode''.<br />
* '''Right click''' it to select it in ''mouse mode''.<br />
* Press the '''Spacebar''' or click in an empty area to deselect.<br />
<br />
The selected element, if any, is denoted by a yellow cone marker. Elements (particularly objects) with poor collisions can be detected easier by enabling ''High sensitivity mode'', by pressing the '''E''' key. This increases detection at the expense of accuracy.<br />
<br />
The ''Current elements'' dialog can also be used to select elements. Double-clicking an item within the list will select it in ''Keyboard mode''.<br />
<br />
===Moving===<br />
Moving elements can be done in several ways.<br />
<br />
'''With the mouse'''<br />
* Simply drag and drop with the '''left mouse button'''.<br />
Or:<br />
* Select the element in mouse mode ('''right click'''), move it to where you want it, and click to drop it off.<br />
<br />
You can also adjust the ''Hold distance'' of an element toward and away from the camera by switching to camera mode, '''right clicking''' the element, and rolling the '''mouse wheel'''.<br />
<br />
'''With the keyboard'''<br />
* Select the element in keyboard mode ('''left click''').<br />
* Use the '''arrow keys''' to move the element in the horizontal plane, and '''PgUp'''/'''PgDn''' to move it vertically. Hold '''ALT''' to decrease the movement speed, or '''SHIFT''' to increase it.<br />
<br />
By default, elements move relative to the camera and are not locked to any axes. This can be disabled in the ''Options'' menu.<br />
<br />
===Rotating===<br />
'''With the mouse'''<br />
<br />
You can rotate selected elements around the Z axis with the mouse wheel.<br />
* Select the element in keyboard mode ('''left click''') and roll the mouse wheel while holding '''Left CTRL'''.<br />
Or:<br />
* Select the element in mouse mode ('''right click'''), hold '''CTRL''', and roll the mouse wheel.<br />
<br />
'''With the keyboard'''<br />
* Select the element in keyboard mode ('''left click''').<br />
* While holding '''CTRL''' (the selection marker will turn green), use the '''arrow keys''' and '''PgUp'''/'''PgDn''' to rotate the element around the different axes.<br />
<br />
With both methods you can additionally hold '''ALT''' to decrease the rotation speed or '''SHIFT''' to increase it.<br />
<br />
<br />
[[Image:Editor_Rotateelem.png|center]]<br />
<br />
===Changing model and other properties===<br />
Most elements have a variety of options that can be altered to change their appearance and behaviour. Examples are the model, color and visual upgrades of a car.<br />
<br />
* Open the properties window of an element by either double clicking it or by selecting it and pressing '''F3'''.<br />
* Make any alterations that you want. For example, to change the model of a car or object, click the '''Browse''' button next to "model" to open the model browser.<br />
* Click OK when you're done.<br />
<br />
[[Image:Editor_Props.png|center]]<br />
<br />
===Cloning===<br />
You can clone an element by selecting it and pressing '''C'''. <br />
<br />
* In mouse mode the cloned element will be attached to your cursor. '''Left click''' to place it in the map.<br />
* In keyboard mode the cloned element will be cloned in the identical position.<br />
<br />
If you hold '''CTRL''' while clicking, the element will be cloned again and will again be attached to the cursor. This way you can easily place large quantities of something.<br />
<br />
Alternatively you can use the ''Pullout'' button located in the bottom-right corner of the properties box to clone an element.<br />
<br />
===Deleting===<br />
Simply select the element and press '''DEL''' ''(Delete)''.<br />
<br />
Alternatively you can use the ''Pullout'' button located in the bottom-right corner of the properties box to delete an element.<br />
<br />
==Creating maps for specific gamemodes==<br />
To make a map for a specific gamemode, you have to do two things:<br />
* Click the '''Map Settings''' button in the top menu, go to the '''Gamemodes''' tab and add any gamemodes that your map is to be used with.<br />
* You will likely also need to add one or more [[Resource:Editor/EDF|Editor Definition Files]]. These will allow you to place gamemode specific elements in the map, like spawnpoints, race checkpoints, or CTF flags. You can add EDF's by clicking the '''Definitions''' menu button and adding the relevant gamemodes.<br />
<br />
==Controls==<br />
Here is a list of all default controls. To change them please go to the MTA Settings menu while the Editor is started.<br />
<br />
===Camera===<br />
{|<br />
|-<br />
| camera_move_forwards<br />
| '''w'''<br />
|-<br />
| camera_move_backwards<br />
| '''s'''<br />
|-<br />
| camera_move_left<br />
| '''a'''<br />
|-<br />
| camera_move_right<br />
| '''d'''<br />
|-<br />
| high_sensitivity_mode<br />
| '''e'''<br />
|}<br />
<br />
===Cloning===<br />
{|<br />
|-<br />
| clone_selected_element<br />
| '''c'''<br />
|-<br />
| clone_drop_modifier<br />
| '''lctrl''' || ''(Left CTRL)''<br />
|}<br />
<br />
===Element manipulation===<br />
{|<br />
|-<br />
| element_move_forward<br />
| '''arrow_u''' || ''(Arrow key Up)''<br />
|-<br />
| element_move_backward<br />
| '''arrow_d''' || ''(Arrow key Down)''<br />
|-<br />
| element_move_left<br />
| '''arrow_l''' || ''(Arrow key Left)''<br />
|-<br />
| element_move_right<br />
| '''arrow_r''' || ''(Arrow key Right)''<br />
|-<br />
| element_move_downwards<br />
| '''pgdn''' || ''(Page Down)''<br />
|-<br />
| element_move_upwards<br />
| '''pgup''' || ''(Page Up)''<br />
|-<br />
| zoom_in<br />
| '''mouse_wheel_down'''<br />
|-<br />
| zoom_out<br />
| '''mouse_wheel_up'''<br />
|-<br />
| quick_rotate_increase<br />
| '''mod_rotate''' + '''mouse_wheel_up''' || ''(Left CTRL + Mouse wheel Up)''<br />
|-<br />
| quick_rotate_decrease<br />
| '''mod_rotate''' + '''mouse_wheel_down''' || ''(Left CTRL + Mouse wheel Down)''<br />
|-<br />
| mod_rotate<br />
| '''lctrl''' || ''(Left CTRL)''<br />
|-<br />
| mod_slow_speed<br />
| '''lalt''' || ''(Left ALT)''<br />
|-<br />
| mod_fast_speed<br />
| '''lshift''' || ''(Left SHIFT)''<br />
|-<br />
| destroy_selected_element<br />
| '''delete'''<br />
|-<br />
| drop_selected_element<br />
| '''space'''<br />
|-<br />
| pickup_selected_element<br />
| '''F2'''<br />
|-<br />
| reset_rotation<br />
| '''mod_rotate''' + '''r''' || ''(Left CTRL + R)''<br />
|}<br />
<br />
===GUI===<br />
{|<br />
| toggle_gui_display<br />
| '''F4'''<br />
|-<br />
| toggle_cursor<br />
| '''f'''<br />
|-<br />
| select_target_keyboard<br />
| '''mouse1''' || ''(Left Mouse button)''<br />
|-<br />
| select_target_mouse<br />
| '''mouse2''' || ''(Right Mouse button)''<br />
|-<br />
| edf_next<br />
| '''mouse_wheel_up'''<br />
|-<br />
| edf_prev<br />
| '''mouse_wheel_down'''<br />
|-<br />
| undo<br />
| '''Ctrl''' + '''z'''<br />
|-<br />
| redo<br />
| '''Ctrl''' + '''y'''<br />
|-<br />
| properties_toggle<br />
| '''F3'''<br />
|-<br />
| browser_up<br />
| '''arrow_u''' || ''(Arrow key Up)''<br />
|-<br />
| browser_down<br />
| '''arrow_d''' || ''(Arrow key Down)''<br />
|-<br />
| browser_zoom_in<br />
| '''mouse_wheel_up'''<br />
|-<br />
| browser_zoom_out<br />
| '''mouse_wheel_down'''<br />
|-<br />
| browser_confirm<br />
| '''enter'''<br />
|-<br />
| currentelements_up<br />
| '''num_8''' || ''(Numpad key 8)''<br />
|-<br />
| currentelements_down<br />
| '''num_2''' || ''(Numpad key 2)''<br />
|-<br />
| toggle_test<br />
| '''F5'''<br />
|}<br />
<br />
==Multiplayer==<br />
The editor is built with both serverside and clientside components, and therefore supports multiplayer out of the box. To use the editor in multiplayer with other players, simply copy all of the editor's resources into your server, start the '''editor''' resource and allow other players to join.<br />
<br />
Please note that currently the editor lacks any permissions system, ao all users have access to every function.<br />
<br />
==Plugins & External resources==<br />
{{Main|Resource:Editor/Plugins}}<br />
<br />
The editor allows basic importing of elements from external resources. This is useful for resources that may have to manipulate an element in a specific way that cannot be performed by the editor. For example, a map resource which uses custom models (and has a script to import these models) cannot be manipulated by default within the editor. <br />
<br />
By using the '''import <resourceName>''' command in console the resource's elements can be imported within the editor.<br />
<br />
==FAQ==<br />
==== I get a black screen when launching the Map Editor ====<br />
<br />
Usually this is caused due to incorrect installation of Map Editor resources. To get it working right, you need to download latest [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 resources (step 3)], unpack the archive and put its contents in:<br />
''MTA San Andreas\server\mods\deathmatch\resources'' , where ''MTA San Andreas'' is a folder where you've installed MTA San Andreas (default location: C:\Program Files\MTA San Andreas).<br />
<br />
Putting them in this path: MTA San Andreas\mods\deathmatch\resources '''is a common mistake''' - it won't work if you put them there. So make sure to put them in the ''italic'' path above.<br />
<br />
<br />
If this issue still occurs, even when you've checked the note above and verified that you've installed it correctly, it might be because you've got an outdated '''acl.xml''' file. You can download the default one [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/acl.xml here]. It should be placed in '''server/mods/deathmatch/''' in your MTA: San Andreas installation directory.<br />
<br />
==== I get an "Could not start the local server. See console for details" when using the "Map Editor" button ====<br />
This is because you do not have a valid editor.conf installed. You can download the default one [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/editor.conf here]. It should be placed in '''server/mods/deathmatch/''' in your MTA: San Andreas installation directory.<br />
<br />
==== I have saved a map but cannot find it in my server's resources directory, despite the Editor itself being able to see it ====<br />
This is due to the fact that Vista limits write-access for non-admin processes in Program Files directory. Files get written in the "VirtualStore" dir instead of real Program Files folder. You should be able to locate your map resource in a similar directory to:<br />
C:\Users\<USERNAME>\AppData\Local\VirtualStore\Program Files\MTA San Andreas\server\mods\deathmatch\resources\<br />
<br />
Running the Server/MTA San Andreas with Administrative rights will allow the map to be saved to the proper location.<br />
<br />
==== I have found a bug or have a suggestion/feedback for the map editor ====<br />
Please use the official [http://bugs.mtasa.com bugtracker] for reporting bugs. Feel free to also join us on [http://mtasa.com/irc.html IRC].<br />
<br />
[[ru:Resource:Editor]]</div>Archttps://wiki.multitheftauto.com/index.php?title=Resource:Editor&diff=20987Resource:Editor2009-08-06T17:27:12Z<p>Arc: </p>
<hr />
<div>{{Resource page}}<br />
The MTA:SA map editor allows you to create maps for gamemodes.<br />
<br />
==Starting==<br />
To start the editor, simply click the "Map editor" menu item in the main MTA menu.<br />
<br />
==Menus==<br />
Once the editor has started, you are presented with two menu bars: the main menu at the top, and the element menu in the lower left.<br />
<br />
===Main menu===<br />
These are the buttons in the main menu:<br />
* [[Image:Editor_New.png]] Create a new map.<br />
* [[Image:Editor_Open.png]] Open an existing map.<br />
* [[Image:Editor_Save.png]] Save the map you're working on.<br />
* [[Image:Editor_Save_as.png]] Save your map under a different name.<br />
* [[Image:Editor_Options.png]] Alter general map editor settings.<br />
* [[Image:Editor_Undo.png]] Undo the last action.<br />
* [[Image:Editor_Redo.png]] Restore the last undone action.<br />
* [[Image:Editor_Locations.png]] Stored game world locations. The editor comes with a great list of San Andreas Interior locations but you can also add your own interior and non-interior locations to the list.<br />
* [[Image:Editor_Current_elements.png]] List all the elements the map contains (objects, vehicles, markers, pickups etc.)<br />
* [[Image:Editor_Map_settings.png]] Map specific settings, like time of day, gravity etc. Here you can also specify what gamemodes the map is compatible with.<br />
* [[Image:Editor_Definitions.png]] Load [[Resource:Editor/EDF|editor definition files (EDF)]] that you want to use. <br />
* [[Image:Editor_Test.png]] Go into play mode to try out the map. This will load up the gamemode the map is made for.<br />
<br />
===Element menu===<br />
The element menu is used to add new elements to the map.<br />
* [[Image:Editor_Vehicle.png]] Create a new vehicle.<br />
* [[Image:Editor_Object.png]] Create a new object (buildings, roads and other scenery).<br />
* [[Image:Editor_Pickup.png]] Create a new pickup (health, armor, weapons).<br />
* [[Image:Editor_Marker.png]] Create a new marker.<br />
<br />
Additionally, if you have [[Resource:Editor/EDF|editor definitions loaded]], you can roll the mousewheel in this menu to bring up custom elements.<br />
<br />
==Using the editor==<br />
This section explains how to create and modify maps.<br />
<br />
===Moving around the map===<br />
When you initially start the editor, you are in ''camera mode''. You are able to use the '''WSAD''' keys to move the camera and the mouse to pan the camera. While moving around, you can hold '''ALT''' to move more slowly or '''SHIFT''' to go faster.<br />
<br />
To access the editor's interface and control panel you need to switch to ''cursor mode''. You can toggle between cursor mode and camera mode with the '''F''' key. When in cursor mode, your view is fixed, and you can use the mouse cursor to manipulate elements and use the graphical interface.<br />
<br />
Camera mode can be recognized by a crosshair in the center of the screen. You can use it to select and move elements just like in cursor mode.<br />
<br />
[[Image:Editor_Crosshair.png|center]]<br />
<br />
===Starting a new map===<br />
* Start the editor, or if it is already started, click the ''New'' menu button.<br />
* Click the ''Map settings'' button. In the ''Meta'' tab, fill in the Name and Author fields with the name of the map and your name respectively. Also open the ''Gamemodes'' tab and add the gamemodes your map is meant for (they will be moved to the ''Added gamemodes'' list). You can do this by selecting them and clicking ''Add'', or by double clicking them. Click OK when you're done.<br />
[[Image:Editor_Mapsettings.png|center]]<br />
* Click the ''Definitions'' window and add the resources of which you want to use the custom elements. These will consist of the gamemodes you selected in the ''Map settings'' window, plus eventual additional resources. For more information about editor definitions, see [[Resource:Editor/EDF|EDF]]. Click OK when you're done.<br />
<br />
===Creating new elements===<br />
Adding elements to your map, such as vehicles and objects, is very straightforward.<br />
* If you are in camera mode, switch to cursor mode first by pressing '''F'''.<br />
* Click the button in the element menu that represents what you want. E.g., click the button with a car on it to add a vehicle.<br />
* A new element of the selected type will be created and attached to your cursor. Move it to the location where you want it and '''left click''' to drop it off.<br />
<br />
<br />
[[Image:Editor_Addelem.png|center]]<br />
<br />
<br />
To create custom elements that are specific to a resource, hover the cursor over the element menu and turn the scroll wheel until the desired resource comes up. Note that for this to work, you first have to add the [[Resource:Editor/EDF|EDF]] file of the resource in the ''Definitions'' window.<br />
<br />
[[Image:Editor_Selectedf.png|center]]<br />
<br />
===Selecting===<br />
* '''Left click''' an element to select it in ''keyboard mode''.<br />
* '''Right click''' it to select it in ''mouse mode''.<br />
* Press the '''Spacebar''' or click in an empty area to deselect.<br />
<br />
The selected element, if any, is denoted by a yellow cone marker. Elements (particularly objects) with poor collisions can be detected easier by enabling ''High sensitivity mode'', by pressing the '''E''' key. This increases detection at the expense of accuracy.<br />
<br />
The ''Current elements'' dialog can also be used to select elements. Double-clicking an item within the list will select it in ''Keyboard mode''.<br />
<br />
===Moving===<br />
Moving elements can be done in several ways.<br />
<br />
'''With the mouse'''<br />
* Simply drag and drop with the '''left mouse button'''.<br />
Or:<br />
* Select the element in mouse mode ('''right click'''), move it to where you want it, and click to drop it off.<br />
<br />
You can also adjust the ''Hold distance'' of an element toward and away from the camera by switching to camera mode, '''right clicking''' the element, and rolling the '''mouse wheel'''.<br />
<br />
'''With the keyboard'''<br />
* Select the element in keyboard mode ('''left click''').<br />
* Use the '''arrow keys''' to move the element in the horizontal plane, and '''PgUp'''/'''PgDn''' to move it vertically. Hold '''ALT''' to decrease the movement speed, or '''SHIFT''' to increase it.<br />
<br />
By default, elements move relative to the camera and are not locked to any axes. This can be disabled in the ''Options'' menu.<br />
<br />
===Rotating===<br />
'''With the mouse'''<br />
<br />
You can rotate selected elements around the Z axis with the mouse wheel.<br />
* Select the element in keyboard mode ('''left click''') and roll the mouse wheel while holding '''Left CTRL'''.<br />
Or:<br />
* Select the element in mouse mode ('''right click'''), hold '''CTRL''', and roll the mouse wheel.<br />
<br />
'''With the keyboard'''<br />
* Select the element in keyboard mode ('''left click''').<br />
* While holding '''CTRL''' (the selection marker will turn green), use the '''arrow keys''' and '''PgUp'''/'''PgDn''' to rotate the element around the different axes.<br />
<br />
With both methods you can additionally hold '''ALT''' to decrease the rotation speed or '''SHIFT''' to increase it.<br />
<br />
<br />
[[Image:Editor_Rotateelem.png|center]]<br />
<br />
===Changing model and other properties===<br />
Most elements have a variety of options that can be altered to change their appearance and behaviour. Examples are the model, color and visual upgrades of a car.<br />
<br />
* Open the properties window of an element by either double clicking it or by selecting it and pressing '''F3'''.<br />
* Make any alterations that you want. For example, to change the model of a car or object, click the '''Browse''' button next to "model" to open the model browser.<br />
* Click OK when you're done.<br />
<br />
[[Image:Editor_Props.png|center]]<br />
<br />
===Cloning===<br />
You can clone an element by selecting it and pressing '''C'''. <br />
<br />
* In mouse mode the cloned element will be attached to your cursor. '''Left click''' to place it in the map.<br />
* In keyboard mode the cloned element will be cloned in the identical position.<br />
<br />
If you hold '''CTRL''' while clicking, the element will be cloned again and will again be attached to the cursor. This way you can easily place large quantities of something.<br />
<br />
Alternatively you can use the ''Pullout'' button located in the bottom-right corner of the properties box to clone an element.<br />
<br />
===Deleting===<br />
Simply select the element and press '''DEL''' ''(Delete)''.<br />
<br />
Alternatively you can use the ''Pullout'' button located in the bottom-right corner of the properties box to delete an element.<br />
<br />
==Creating maps for specific gamemodes==<br />
To make a map for a specific gamemode, you have to do two things:<br />
* Click the Map Settings button in the top menu, go to the Gamemodes tab and add any gamemodes that your map can be used with.<br />
* You will likely also need to add one or more [[EDF|Editor Definition Files]]. These will allow you to place gamemode specific elements in the map: e.g. spawnpoints, race checkpoints, or CTF flags. You can add EDF's by clicking the Definitions button.<br />
<br />
==Controls==<br />
Here is a list of all default controls. To change them please go to the MTA Settings menu while the Editor is started.<br />
<br />
===Camera===<br />
{|<br />
|-<br />
| camera_move_forwards<br />
| '''w'''<br />
|-<br />
| camera_move_backwards<br />
| '''s'''<br />
|-<br />
| camera_move_left<br />
| '''a'''<br />
|-<br />
| camera_move_right<br />
| '''d'''<br />
|-<br />
| high_sensitivity_mode<br />
| '''e'''<br />
|}<br />
<br />
===Cloning===<br />
{|<br />
|-<br />
| clone_selected_element<br />
| '''c'''<br />
|-<br />
| clone_drop_modifier<br />
| '''lctrl''' || ''(Left CTRL)''<br />
|}<br />
<br />
===Element manipulation===<br />
{|<br />
|-<br />
| element_move_forward<br />
| '''arrow_u''' || ''(Arrow key Up)''<br />
|-<br />
| element_move_backward<br />
| '''arrow_d''' || ''(Arrow key Down)''<br />
|-<br />
| element_move_left<br />
| '''arrow_l''' || ''(Arrow key Left)''<br />
|-<br />
| element_move_right<br />
| '''arrow_r''' || ''(Arrow key Right)''<br />
|-<br />
| element_move_downwards<br />
| '''pgdn''' || ''(Page Down)''<br />
|-<br />
| element_move_upwards<br />
| '''pgup''' || ''(Page Up)''<br />
|-<br />
| zoom_in<br />
| '''mouse_wheel_down'''<br />
|-<br />
| zoom_out<br />
| '''mouse_wheel_up'''<br />
|-<br />
| quick_rotate_increase<br />
| '''mod_rotate''' + '''mouse_wheel_up''' || ''(Left CTRL + Mouse wheel Up)''<br />
|-<br />
| quick_rotate_decrease<br />
| '''mod_rotate''' + '''mouse_wheel_down''' || ''(Left CTRL + Mouse wheel Down)''<br />
|-<br />
| mod_rotate<br />
| '''lctrl''' || ''(Left CTRL)''<br />
|-<br />
| mod_slow_speed<br />
| '''lalt''' || ''(Left ALT)''<br />
|-<br />
| mod_fast_speed<br />
| '''lshift''' || ''(Left SHIFT)''<br />
|-<br />
| destroy_selected_element<br />
| '''delete'''<br />
|-<br />
| drop_selected_element<br />
| '''space'''<br />
|-<br />
| pickup_selected_element<br />
| '''F2'''<br />
|-<br />
| reset_rotation<br />
| '''mod_rotate''' + '''r''' || ''(Left CTRL + R)''<br />
|}<br />
<br />
===GUI===<br />
{|<br />
| toggle_gui_display<br />
| '''F4'''<br />
|-<br />
| toggle_cursor<br />
| '''f'''<br />
|-<br />
| select_target_keyboard<br />
| '''mouse1''' || ''(Left Mouse button)''<br />
|-<br />
| select_target_mouse<br />
| '''mouse2''' || ''(Right Mouse button)''<br />
|-<br />
| edf_next<br />
| '''mouse_wheel_up'''<br />
|-<br />
| edf_prev<br />
| '''mouse_wheel_down'''<br />
|-<br />
| undo<br />
| '''Ctrl''' + '''z'''<br />
|-<br />
| redo<br />
| '''Ctrl''' + '''y'''<br />
|-<br />
| properties_toggle<br />
| '''F3'''<br />
|-<br />
| browser_up<br />
| '''arrow_u''' || ''(Arrow key Up)''<br />
|-<br />
| browser_down<br />
| '''arrow_d''' || ''(Arrow key Down)''<br />
|-<br />
| browser_zoom_in<br />
| '''mouse_wheel_up'''<br />
|-<br />
| browser_zoom_out<br />
| '''mouse_wheel_down'''<br />
|-<br />
| browser_confirm<br />
| '''enter'''<br />
|-<br />
| currentelements_up<br />
| '''num_8''' || ''(Numpad key 8)''<br />
|-<br />
| currentelements_down<br />
| '''num_2''' || ''(Numpad key 2)''<br />
|-<br />
| toggle_test<br />
| '''F5'''<br />
|}<br />
<br />
==Multiplayer==<br />
The editor is built with both serverside and clientside components, and therefore supports multiplayer out of the box. To use the editor in multiplayer with other players, simply copy all of the editor's resources into your server, start the '''editor''' resource and allow other players to join.<br />
<br />
Please note that currently the editor lacks any permissions system, ao all users have access to every function.<br />
<br />
==Plugins & External resources==<br />
{{Main|Resource:Editor/Plugins}}<br />
<br />
The editor allows basic importing of elements from external resources. This is useful for resources that may have to manipulate an element in a specific way that cannot be performed by the editor. For example, a map resource which uses custom models (and has a script to import these models) cannot be manipulated by default within the editor. <br />
<br />
By using the '''import <resourceName>''' command in console the resource's elements can be imported within the editor.<br />
<br />
==FAQ==<br />
==== I get a black screen when launching the Map Editor ====<br />
<br />
Usually this is caused due to incorrect installation of Map Editor resources. To get it working right, you need to download latest [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 resources (step 3)], unpack the archive and put its contents in:<br />
''MTA San Andreas\server\mods\deathmatch\resources'' , where ''MTA San Andreas'' is a folder where you've installed MTA San Andreas (default location: C:\Program Files\MTA San Andreas).<br />
<br />
Putting them in this path: MTA San Andreas\mods\deathmatch\resources '''is a common mistake''' - it won't work if you put them there. So make sure to put them in the ''italic'' path above.<br />
<br />
<br />
If this issue still occurs, even when you've checked the note above and verified that you've installed it correctly, it might be because you've got an outdated '''acl.xml''' file. You can download the default one [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/acl.xml here]. It should be placed in '''server/mods/deathmatch/''' in your MTA: San Andreas installation directory.<br />
<br />
==== I get an "Could not start the local server. See console for details" when using the "Map Editor" button ====<br />
This is because you do not have a valid editor.conf installed. You can download the default one [http://multitheftauto.googlecode.com/svn/trunk/MTA10_Server/mods/deathmatch/editor.conf here]. It should be placed in '''server/mods/deathmatch/''' in your MTA: San Andreas installation directory.<br />
<br />
==== I have saved a map but cannot find it in my server's resources directory, despite the Editor itself being able to see it ====<br />
This is due to the fact that Vista limits write-access for non-admin processes in Program Files directory. Files get written in the "VirtualStore" dir instead of real Program Files folder. You should be able to locate your map resource in a similar directory to:<br />
C:\Users\<USERNAME>\AppData\Local\VirtualStore\Program Files\MTA San Andreas\server\mods\deathmatch\resources\<br />
<br />
Running the Server/MTA San Andreas with Administrative rights will allow the map to be saved to the proper location.<br />
<br />
==== I have found a bug or have a suggestion/feedback for the map editor ====<br />
Please use the official [http://bugs.mtasa.com bugtracker] for reporting bugs. Feel free to also join us on [http://mtasa.com/irc.html IRC].<br />
<br />
[[ru:Resource:Editor]]</div>Archttps://wiki.multitheftauto.com/index.php?title=Client_Manual&diff=20986Client Manual2009-08-06T17:19:19Z<p>Arc: /* Running the game */</p>
<hr />
<div>__TOC__<br />
<br />
==Introduction==<br />
Multi Theft Auto: San Andreas is the latest in a series of fan-created multiplayer modifications for the Grand Theft Auto games (PC versions only). For the GTA3 and Vice City versions that run on the old core, visit [http://www.multitheftauto.com/ http://www.multitheftauto.com]. This mod is not endorsed by Rockstar Games or Take 2 Interactive.<br />
<br />
Please note that MTA:SA Deathmatch is a beta, which means it could crash or cause unexpected results.<br />
<br />
==Before you start==<br />
<br />
Before you install Multi Theft Auto: San Andreas, first make sure that there are no modifications to GTA:SA installed. These will conflict with MTA. If you would like to keep your single player mods, you can create two installations by reinstalling San Andreas to a second folder on your hard drive.<br />
<br />
Also make sure that you are running '''Windows XP''', '''Windows 2000''', '''Windows Vista''' or '''Windows Server 2003''' and that your machine is capable of running the game in single player. Note that if you are running single player on the absolute minimum requirements, you will experience slowdowns in MTA as it takes up extra processing power.<br />
<br />
'''Note: MTA:SA will only work on GTA:SA v1.0.''' If you bought the game recently, it is likely that you have a later version.<br />
<br />
Make sure you head over to the [[Known_Issues_-_FAQ|Known Issues]] page if you have issues, or join us on IRC @ irc://irc.multitheftauto.com/mta<br />
<br />
===System requirements===<br />
The minimum system requirements for Multi Theft Auto: San Andreas are slightly higher than the original minimum requirements for Grand Theft Auto: San Andreas.<br />
* Intel Pentium 4 or AMD Athlon XP<br />
* 512MB DDR RAM<br />
* Clean installation of Grand Theft Auto: San Andreas, version 1.0 (American or European)<br />
* 3.7GB of free hard disk space (3.6GB for a minimum Grand Theft Auto installation)<br />
* nVidia GeForce 4 series or ATI Radeon 8xxx series (64MB RAM and DirectX 9.0 compatible)<br />
* DirectX 9.0 compatible sound card<br />
* Keyboard and mouse<br />
* Broadband internet access (for smooth online play)<br />
<br />
For extra features, a pixel shader 2.0 compatible videocard (nVidia GeForce FX series or higher, ATI Radeon 9xxx series or higher) is recommended.<br />
<br />
For extra loading performance, more RAM is recommended.<br />
<br />
==Installing the game==<br />
<br />
'''This section will need to be updated when we get an installer'''<br />
<br />
# If you haven’t already, go to http://www.mtabeta.com register and download the MTA:SA client.<br />
# Run the installer. You will be given an introductory dialog, then presented with the End User License Agreement (EULA). You must agree to this in order to continue installation.<br />
# You will be presented with three (3) options where your able to create an account, use one your already have, or don't use an account - In this case select option Two (2)<br />
<br><br />
'''Option One Selected'''<br><br />
Proceed to create a new account at MTABeta.com, once complete enter your login details into the installer<br><br />
'''Option Two Selected'''<br><br />
Proceed to entering your account details into the installer<br />
<br><br><br />
# You will then be asked which components to install.<br />
#* '''Client''' interfaces with the game and is a required component.<br />
#* '''MTA Server''' enables you to host your own home-brew server<br />
#* '''MTA Server > Editor''' is used to create new maps, this is an optional component<br />
# You are then asked for a folder in which to install the mod. You must set this to the same folder that San Andreas is installed in. The default location is: '''C:\Program Files\Rockstar Games\GTA San Andreas\'''. Click the '''Install''' button to commence installation.<br />
# When it finishes installing, you will be given the option to start MTA: San Andreas straight away. Choose your option and then press '''Finish'''.<br />
# You will be able to launch MTA:DM from your Start Menu if you wish to play.<br />
<br />
==Running the game==<br />
# Start Multi Theft Auto by clicking the icon located in your Start Menu under '''MTA:San Andreas'''.<br />
# GTA: San Andreas will start and once it is loaded, you will be presented with the MTA:SA main menu. Here you will find several options:<br />
<br />
{| border="0" align="center"<br />
| width="188" |<br />
[[Image:MENU_QuickConnect.jpg]]<br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – this allows you to connect to a server that you already know the IP address or URL and port of. This is useful if you know precisely which server you want to join so that you don’t need to scroll through the whole server list.</font><br />
<br />
<br /><br />
|-<br />
| width="188" |<br />
[[Image:MENU_ServerBrowser.jpg|280px]]<br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – this allows you to receive a list of available servers to play on. </font><br />
<br />
<br /><br />
|-<br />
| width="188" |<br />
[[Image:Settings.jpg|280px]]<br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– this allows you to change your in-game nickname, customize controls and adjust display settings.</font><br />
<br />
<br /><br /><br />
|-<br />
| width="188" |<br />
[[Image:MENU_About.jpg|280px]]<br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– this gives you a list of contributors to the project.</font><br />
<br />
<br /><br />
|-<br />
| width="188" |<br />
<br><br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– this allows you to create your own maps, complete with checkpoints, ramps, pickups and other objects. These can then be uploaded onto a server so that you can play them with other people.</font><br />
<br />
<br /><br /><br />
|-<br />
| width="188" |<br />
<br><br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– this returns you back to your Windows desktop.</font><br />
<br />
<br /><br /><br />
|}<br />
<br />
The easiest way to play the game is to click '''Browse Servers''' on the menu. If servers have not appeared already, press the '''Refresh''' button and MTA will scan for servers, displaying them as a list.<br />
<br />
* Under the '''Name''' tab, each server's name is displayed.<br />
* Under the '''Players''' tab, the number of players and the maximum capacity of the server is displayed, in the format of [Used Slots] / [Maximum Slots].<br />
* The '''Ping''' tab displays the ping, or latency, between your machine and the server. Ping is a measure of the time it takes for "packets" of data to be received back from the server after sending them, so a higher ping means that you will experience more lag on that particular server. Generally, servers closest to your location should have the lowest pings.<br />
* The '''Host''' is the IP address of the server. You can use this address in future to connect to the same server via the Quick Connect option on the main menu.<br />
<br />
Each tab can be clicked to arrange the respective column in ascending or descending order.<br />
<br />
For optimal performance and gameplay, look for the best balance between players and ping.<br />
<br />
Once you have picked a server, select it and click the '''Connect''' button in the top right-hand corner of the dialog. If all goes well, you should connect to the server and automatically join the game.<br />
<br />
==How to Play==<br />
<br />
MTA:SA offers a comprehensive scripting system that allows map creators to customize many elements of the game in order to create their own innovative game modes. The game incorporates as many single player elements as possible but some aspects are different.<br />
<br />
There are no pedestrians and no AI traffic on the road. The only other people on the map are your opponents, or allies if it is a team game. You can talk with them using the chatbox located in the left-hand corner of the screen by pressing '''T'''. To chat only to your team members, press '''Y'''.<br />
<br />
MTA's map editor allows map creators to add various GTA objects to their maps including roads, exploding barrels, ramps, buildings, hills and more. Not only this, but the objects can be scripted to move, change model and disappear. This offers a great deal of fun and variation to the gameplay. <br />
<br />
Holding Tab will display the scoreboard. By default, only names and pings are displayed, but scripts can add extra columns that are specific to the particular gamemode being played. For example, a deathmatch game mode would definitely have a column listing total kills, but the map creator may choose to add extra columns for the number of deaths you have and how long you have been playing for, in order to put your score into perspective.<br />
<br />
==Controls==<br />
<br />
===In-Game Keys===<br />
<br />
* F8 (or Tilde Key) - Console<br />
* F9 - In-game help<br />
* F11 - Show SA map ''(the following list is for use when the map is up)''<br />
**numpad +/- - Zoom in and out<br />
**numpad 4, 8, 6, 2 - move map left, up, right, down<br />
**numpad 0 - toggle between attach to local player (map follows player blip) and free move (map stays stationary) <br />
* F12 - Take a screenshot<br />
* T - Chat<br />
* Y - Team Chat<br />
* TAB - Player List (if [[Scoreboard]] resource is running on the server)<br />
<br />
==Console Commands==<br />
<br />
'''bind defaults''' Binds control defaults in the settings menu<br />
<br />
Press '''~ (tilde)''' or '''F8''' to access the console, then type a command followed by any neccessary parameters (if applicable) then press Enter.<br />
<br />
;'''maps''' :This displays a list of all maps available on the server. <br />
<br />
;'''nick [nickname]''' :This changes your nickname whilst in-game to whatever you specify in the parameters.<br />
<br />
;'''msg [nickname] [message]''' or '''pm [nickname] [message]''' :This sends a private message to the person you specify in the [nickname] parameter. Only the person you specify can see the message. Both '''msg''' and '''pm''' perform the same function.<br />
<br />
;'''quit''' or '''exit''' :This disconnects you from the server and returns you to the Windows desktop. Performs the same function as the Quit button on the main menu.<br />
<br />
;'''ver''' :This displays the version number and copyright information for the software.<br />
<br />
;'''time''' :This displays the current time.<br />
<br />
;'''disconnect''' :This disconnects you from the server and returns you to the main menu.<br />
<br />
;'''say [text]''' :This enables you to continue talking to people in the chat box whilst the console is open.<br />
<br />
;'''ignore [nickname]''' :This will not display any text typed by the player you wish to ignore. To stop ignoring a player, type '''ignore [nickname]''' again.<br />
<br />
'''Tip:''' You can use these commands in the chatbox by putting a / (forward slash) in front of them.<br />
<br />
A list of console commands can be seen by typing '''help''' into the console and pressing Enter. The current map may also have extra commands which can be accessed by typing '''commands''' into the console.<br />
<br />
==Error codes and their meanings==<br />
'''Download errors'''<br><br />
0: UNKNOWN_ERROR<br><br />
1: INVALID_FILE_DESCRIPTORS<br><br />
2: INVALID_MAX_FILE_DESCRIPTOR<br><br />
3: INVALID_SELECT_RETURN<br><br />
4: INVALID_INITIAL_MULTI_PERFORM<br><br />
5: INVALID_MULTI_PERFORM_CODE<br><br />
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br><br />
7: UNEXPECTED_CURL_MESSAGE<br><br />
8: UNABLE_TO_CONNECT<br><br />
9: UNABLE_TO_DOWNLOAD_FILE<br><br />
10: FAILED_TO_INITIALIZE_DOWNLOAD<br><br />
<br />
'''Fatal errors'''<br><br />
1: no local player model on ingame event<br><br />
2: no local player on ingame event<br><br />
3: server downloads disabled<br><br />
4: no local player model on player-list packet<br><br />
5: no local player on player-list packet<br><br />
6: invalid custom data length on entity-add packet<br><br />
7: invalid bitstream data on entity-add packet<br><br />
8: system entity on entity-add packet<br><br />
9: failed to create object on entity-add packet<br><br />
10: failed to create pickup on entity-add packet<br><br />
11: failed to create vehicle on entity-add packet<br><br />
12: invalid team-name length on entity-add packet<br><br />
13: invalid lua-event name length in lua-event packet<br><br />
14: invalid resource name length in resource-start packet<br><br />
<br />
''''Unable to enter vehicle' errors'''<br><br />
1: script cancelled<br><br />
2: script cancelled (jack)<br><br />
3: current occupier is entering/exiting<br><br />
4: invalid seat<br><br />
5: not close enough<br><br />
6: already in a vehicle<br><br />
7: already entering/exiting<br><br />
8: invalid vehicle (trailer)<br><br />
<br />
[[es:Manual Cliente Deathmatch]]<br />
[[de:MTA DM Client Anleitung]]<br />
[[it:Manuale del Client]]<br />
[[nl:Deathmatch Client Manual]]<br />
[[ru:Deathmatch Client Manual]]</div>Archttps://wiki.multitheftauto.com/index.php?title=Client_Manual&diff=20985Client Manual2009-08-06T17:18:16Z<p>Arc: /* Running the game from ASE (The All-Seeing Eye)[obsolete] */</p>
<hr />
<div>__TOC__<br />
<br />
==Introduction==<br />
Multi Theft Auto: San Andreas is the latest in a series of fan-created multiplayer modifications for the Grand Theft Auto games (PC versions only). For the GTA3 and Vice City versions that run on the old core, visit [http://www.multitheftauto.com/ http://www.multitheftauto.com]. This mod is not endorsed by Rockstar Games or Take 2 Interactive.<br />
<br />
Please note that MTA:SA Deathmatch is a beta, which means it could crash or cause unexpected results.<br />
<br />
==Before you start==<br />
<br />
Before you install Multi Theft Auto: San Andreas, first make sure that there are no modifications to GTA:SA installed. These will conflict with MTA. If you would like to keep your single player mods, you can create two installations by reinstalling San Andreas to a second folder on your hard drive.<br />
<br />
Also make sure that you are running '''Windows XP''', '''Windows 2000''', '''Windows Vista''' or '''Windows Server 2003''' and that your machine is capable of running the game in single player. Note that if you are running single player on the absolute minimum requirements, you will experience slowdowns in MTA as it takes up extra processing power.<br />
<br />
'''Note: MTA:SA will only work on GTA:SA v1.0.''' If you bought the game recently, it is likely that you have a later version.<br />
<br />
Make sure you head over to the [[Known_Issues_-_FAQ|Known Issues]] page if you have issues, or join us on IRC @ irc://irc.multitheftauto.com/mta<br />
<br />
===System requirements===<br />
The minimum system requirements for Multi Theft Auto: San Andreas are slightly higher than the original minimum requirements for Grand Theft Auto: San Andreas.<br />
* Intel Pentium 4 or AMD Athlon XP<br />
* 512MB DDR RAM<br />
* Clean installation of Grand Theft Auto: San Andreas, version 1.0 (American or European)<br />
* 3.7GB of free hard disk space (3.6GB for a minimum Grand Theft Auto installation)<br />
* nVidia GeForce 4 series or ATI Radeon 8xxx series (64MB RAM and DirectX 9.0 compatible)<br />
* DirectX 9.0 compatible sound card<br />
* Keyboard and mouse<br />
* Broadband internet access (for smooth online play)<br />
<br />
For extra features, a pixel shader 2.0 compatible videocard (nVidia GeForce FX series or higher, ATI Radeon 9xxx series or higher) is recommended.<br />
<br />
For extra loading performance, more RAM is recommended.<br />
<br />
==Installing the game==<br />
<br />
'''This section will need to be updated when we get an installer'''<br />
<br />
# If you haven’t already, go to http://www.mtabeta.com register and download the MTA:SA client.<br />
# Run the installer. You will be given an introductory dialog, then presented with the End User License Agreement (EULA). You must agree to this in order to continue installation.<br />
# You will be presented with three (3) options where your able to create an account, use one your already have, or don't use an account - In this case select option Two (2)<br />
<br><br />
'''Option One Selected'''<br><br />
Proceed to create a new account at MTABeta.com, once complete enter your login details into the installer<br><br />
'''Option Two Selected'''<br><br />
Proceed to entering your account details into the installer<br />
<br><br><br />
# You will then be asked which components to install.<br />
#* '''Client''' interfaces with the game and is a required component.<br />
#* '''MTA Server''' enables you to host your own home-brew server<br />
#* '''MTA Server > Editor''' is used to create new maps, this is an optional component<br />
# You are then asked for a folder in which to install the mod. You must set this to the same folder that San Andreas is installed in. The default location is: '''C:\Program Files\Rockstar Games\GTA San Andreas\'''. Click the '''Install''' button to commence installation.<br />
# When it finishes installing, you will be given the option to start MTA: San Andreas straight away. Choose your option and then press '''Finish'''.<br />
# You will be able to launch MTA:DM from your Start Menu if you wish to play.<br />
<br />
==Running the game==<br />
# Start Multi Theft Auto by clicking the icon located in your Start Menu under '''MTA:San Andreas'''.<br />
# GTA: San Andreas will start and once it is loaded, you will be presented with the MTA:SA main menu. Here you will find several options:<br />
<br />
{| border="0" align="center"<br />
| width="188" |<br />
[[Image:MENU_QuickConnect.jpg]]<br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quick connect''' – this allows you to connect to a server that you already know the IP address or URL and port of. This is useful if you know precisely which server you want to join so that you don’t need to scroll through the whole server list.</font><br />
<br />
<br /><br />
|-<br />
| width="188" |<br />
[[Image:MENU_ServerBrowser.jpg|280px]]<br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Browse servers''' – this allows you to receive a list of available servers to play on. </font><br />
<br />
<br /><br />
|-<br />
| width="188" |<br />
[[Image:Settings.jpg|280px]]<br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Settings '''– this allows you to change your in-game nickname, customize controls and adjust display settings.</font><br />
<br />
<br /><br /><br />
|-<br />
| width="188" |<br />
[[Image:MENU_About.jpg|280px]]<br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– this gives you a list of contributors to the project.</font><br />
<br />
<br /><br />
|-<br />
| width="188" |<br />
<br><br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Map editor '''– this allows you to create your own maps, complete with checkpoints, ramps, pickups and other objects. These can then be uploaded onto a server so that you can play them with other people.</font><br />
<br />
<br /><br /><br />
|-<br />
| width="188" |<br />
<br><br />
| width="380" |<br />
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– this returns you back to your Windows desktop.</font><br />
<br />
<br /><br /><br />
|}<br />
<br />
The easiest way to play the game is to click '''Browse Servers''' on the menu. A new window will appear:<br />
<br />
<center>[[Image:manual_image006a.jpg]]</center> '''Will need to be updated'''<br />
<br />
If servers have not appeared already, press the '''Refresh''' button and MTA will scan for servers, displaying them as a list.<br />
<br />
* Under the '''Name''' tab, each server's name is displayed.<br />
* Under the '''Players''' tab, the number of players and the maximum capacity of the server is displayed, in the format of [Used Slots] / [Maximum Slots].<br />
* The '''Ping''' tab displays the ping, or latency, between your machine and the server. Ping is a measure of the time it takes for "packets" of data to be received back from the server after sending them, so a higher ping means that you will experience more lag on that particular server. Generally, servers closest to your location should have the lowest pings.<br />
* The '''Host''' is the IP address of the server. You can use this address in future to connect to the same server via the Quick Connect option on the main menu.<br />
<br />
Each tab can be clicked to arrange the respective column in ascending or descending order.<br />
<br />
For optimal performance and gameplay, look for the best balance between players and ping.<br />
<br />
Once you have picked a server, select it and click the '''Connect''' button in the top right-hand corner of the dialog. If all goes well, you should connect to the server and automatically join the game.<br />
<br />
==How to Play==<br />
<br />
MTA:SA offers a comprehensive scripting system that allows map creators to customize many elements of the game in order to create their own innovative game modes. The game incorporates as many single player elements as possible but some aspects are different.<br />
<br />
There are no pedestrians and no AI traffic on the road. The only other people on the map are your opponents, or allies if it is a team game. You can talk with them using the chatbox located in the left-hand corner of the screen by pressing '''T'''. To chat only to your team members, press '''Y'''.<br />
<br />
MTA's map editor allows map creators to add various GTA objects to their maps including roads, exploding barrels, ramps, buildings, hills and more. Not only this, but the objects can be scripted to move, change model and disappear. This offers a great deal of fun and variation to the gameplay. <br />
<br />
Holding Tab will display the scoreboard. By default, only names and pings are displayed, but scripts can add extra columns that are specific to the particular gamemode being played. For example, a deathmatch game mode would definitely have a column listing total kills, but the map creator may choose to add extra columns for the number of deaths you have and how long you have been playing for, in order to put your score into perspective.<br />
<br />
==Controls==<br />
<br />
===In-Game Keys===<br />
<br />
* F8 (or Tilde Key) - Console<br />
* F9 - In-game help<br />
* F11 - Show SA map ''(the following list is for use when the map is up)''<br />
**numpad +/- - Zoom in and out<br />
**numpad 4, 8, 6, 2 - move map left, up, right, down<br />
**numpad 0 - toggle between attach to local player (map follows player blip) and free move (map stays stationary) <br />
* F12 - Take a screenshot<br />
* T - Chat<br />
* Y - Team Chat<br />
* TAB - Player List (if [[Scoreboard]] resource is running on the server)<br />
<br />
==Console Commands==<br />
<br />
'''bind defaults''' Binds control defaults in the settings menu<br />
<br />
Press '''~ (tilde)''' or '''F8''' to access the console, then type a command followed by any neccessary parameters (if applicable) then press Enter.<br />
<br />
;'''maps''' :This displays a list of all maps available on the server. <br />
<br />
;'''nick [nickname]''' :This changes your nickname whilst in-game to whatever you specify in the parameters.<br />
<br />
;'''msg [nickname] [message]''' or '''pm [nickname] [message]''' :This sends a private message to the person you specify in the [nickname] parameter. Only the person you specify can see the message. Both '''msg''' and '''pm''' perform the same function.<br />
<br />
;'''quit''' or '''exit''' :This disconnects you from the server and returns you to the Windows desktop. Performs the same function as the Quit button on the main menu.<br />
<br />
;'''ver''' :This displays the version number and copyright information for the software.<br />
<br />
;'''time''' :This displays the current time.<br />
<br />
;'''disconnect''' :This disconnects you from the server and returns you to the main menu.<br />
<br />
;'''say [text]''' :This enables you to continue talking to people in the chat box whilst the console is open.<br />
<br />
;'''ignore [nickname]''' :This will not display any text typed by the player you wish to ignore. To stop ignoring a player, type '''ignore [nickname]''' again.<br />
<br />
'''Tip:''' You can use these commands in the chatbox by putting a / (forward slash) in front of them.<br />
<br />
A list of console commands can be seen by typing '''help''' into the console and pressing Enter. The current map may also have extra commands which can be accessed by typing '''commands''' into the console.<br />
<br />
==Error codes and their meanings==<br />
'''Download errors'''<br><br />
0: UNKNOWN_ERROR<br><br />
1: INVALID_FILE_DESCRIPTORS<br><br />
2: INVALID_MAX_FILE_DESCRIPTOR<br><br />
3: INVALID_SELECT_RETURN<br><br />
4: INVALID_INITIAL_MULTI_PERFORM<br><br />
5: INVALID_MULTI_PERFORM_CODE<br><br />
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS<br><br />
7: UNEXPECTED_CURL_MESSAGE<br><br />
8: UNABLE_TO_CONNECT<br><br />
9: UNABLE_TO_DOWNLOAD_FILE<br><br />
10: FAILED_TO_INITIALIZE_DOWNLOAD<br><br />
<br />
'''Fatal errors'''<br><br />
1: no local player model on ingame event<br><br />
2: no local player on ingame event<br><br />
3: server downloads disabled<br><br />
4: no local player model on player-list packet<br><br />
5: no local player on player-list packet<br><br />
6: invalid custom data length on entity-add packet<br><br />
7: invalid bitstream data on entity-add packet<br><br />
8: system entity on entity-add packet<br><br />
9: failed to create object on entity-add packet<br><br />
10: failed to create pickup on entity-add packet<br><br />
11: failed to create vehicle on entity-add packet<br><br />
12: invalid team-name length on entity-add packet<br><br />
13: invalid lua-event name length in lua-event packet<br><br />
14: invalid resource name length in resource-start packet<br><br />
<br />
''''Unable to enter vehicle' errors'''<br><br />
1: script cancelled<br><br />
2: script cancelled (jack)<br><br />
3: current occupier is entering/exiting<br><br />
4: invalid seat<br><br />
5: not close enough<br><br />
6: already in a vehicle<br><br />
7: already entering/exiting<br><br />
8: invalid vehicle (trailer)<br><br />
<br />
[[es:Manual Cliente Deathmatch]]<br />
[[de:MTA DM Client Anleitung]]<br />
[[it:Manuale del Client]]<br />
[[nl:Deathmatch Client Manual]]<br />
[[ru:Deathmatch Client Manual]]</div>Archttps://wiki.multitheftauto.com/index.php?title=Template:Client_other_events&diff=20983Template:Client other events2009-08-06T16:06:57Z<p>Arc: </p>
<hr />
<div>*[[onClientConsole]]<br />
*[[onClientRender]]<br />
{{New feature|2|DP2|<br />
*[[onClientExplosion]]<br />
}}<br />
{{New feature|3|1.0|<br />
*[[onClientChatMessage]]<br />
*[[onClientPreRender]]<br />
}}</div>Archttps://wiki.multitheftauto.com/index.php?title=OnClientWorld&diff=20982OnClientWorld2009-08-06T16:06:22Z<p>Arc: moved OnClientWorld to OnClientPreRender</p>
<hr />
<div>#REDIRECT [[OnClientPreRender]]</div>Archttps://wiki.multitheftauto.com/index.php?title=OnClientPreRender&diff=20981OnClientPreRender2009-08-06T16:06:22Z<p>Arc: moved OnClientWorld to OnClientPreRender</p>
<hr />
<div>__NOTOC__<br />
{{Client event}} <br />
This event is triggered every time before GTA renders a new frame.<br />
<br />
==Parameters==<br />
<syntaxhighlight lang="lua"><br />
float timeSlice<br />
</syntaxhighlight><br />
*'''timeSlice:''' The interval between this frame and the previous one in seconds (varies from 0.0 to 0.1).<br />
<br />
==Source==<br />
The [[event system#Event source|source]] of this event is the client's [[root element]].<br />
<br />
==Example==<br />
This example makes the camera follow the player in a GTA2-like way.<br />
<syntaxhighlight lang="lua"><br />
function updateCamera ()<br />
local x, y, z = getElementPosition ( getLocalPlayer () )<br />
setCameraMatrix ( x, y, z + 50, x, y, z )<br />
end<br />
addEventHandler ( "onClientWorld", getLocalPlayer(), updateCamera )<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
===Other client events===<br />
{{Client_other_events}}<br />
===Client event functions===<br />
{{Client_event_functions}}</div>Archttps://wiki.multitheftauto.com/index.php?title=SetVehicleGravity&diff=20602SetVehicleGravity2009-07-14T12:38:40Z<p>Arc: </p>
<hr />
<div>__NOTOC__<br />
{{Client function}}<br />
<br />
Sets the gravity vector of a vehicle. The vehicle will fall in this direction, and the camera of any occupants will also be rotated to match it. Can be used for e.g. driving on walls or upside down on ceilings.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">bool setVehicleGravity ( vehicle theVehicle, float x, float y, float z )</syntaxhighlight><br />
<br />
===Required Arguments===<br />
*'''theVehicle:''' the vehicle of which to change the gravity.<br />
*'''x, y, z:''' the components of the new gravity vector. If this vector has length 1, the strength of the gravity will be same as the global gravity for other entities. If it is 2, it will be twice as strong, etc.<br />
<br />
===Returns===<br />
Returns ''true'' if successful, ''false'' otherwise.<br />
<br />
==See Also==<br />
{{Client vehicle functions}}</div>Archttps://wiki.multitheftauto.com/index.php?title=SetVehicleGravity&diff=20601SetVehicleGravity2009-07-14T12:38:22Z<p>Arc: </p>
<hr />
<div>__NOTOC__<br />
{{Client function}}<br />
<br />
Sets the gravity vector of a vehicle. The vehicle will fall in this direction, and the camera of any occupants will also be rotated to match it. Can be used for e.g. driving on walls or driving upside down.<br />
<br />
==Syntax==<br />
<syntaxhighlight lang="lua">bool setVehicleGravity ( vehicle theVehicle, float x, float y, float z )</syntaxhighlight><br />
<br />
===Required Arguments===<br />
*'''theVehicle:''' the vehicle of which to change the gravity.<br />
*'''x, y, z:''' the components of the new gravity vector. If this vector has length 1, the strength of the gravity will be same as the global gravity for other entities. If it is 2, it will be twice as strong, etc.<br />
<br />
===Returns===<br />
Returns ''true'' if successful, ''false'' otherwise.<br />
<br />
==See Also==<br />
{{Client vehicle functions}}</div>Archttps://wiki.multitheftauto.com/index.php?title=Template:Client_vehicle_functions&diff=20394Template:Client vehicle functions2009-07-07T18:59:15Z<p>Arc: </p>
<hr />
<div>*[[addVehicleUpgrade]]<br />
*[[attachTrailerToVehicle]]<br />
*[[blowVehicle]]<br />
*[[createVehicle]]<br />
*[[detachTrailerFromVehicle]]<br />
*[[fixVehicle]]<br />
*[[getVehicleAdjustableProperty]]<br />
*[[getVehicleColor]]<br />
*[[getVehicleCompatibleUpgrades]]<br />
*[[getVehicleController]]<br />
*[[getVehicleDoorState]]<br />
*[[getVehicleLandingGearDown]]<br />
*[[getVehicleLightState]]<br />
*[[getVehicleMaxPassengers]]<br />
*[[getVehicleName]]<br />
*[[getVehicleOccupant]]<br />
*[[getVehicleOverrideLights]]<br />
*[[getVehiclePaintjob]]<br />
*[[getVehiclePanelState]]<br />
*[[getVehiclePlateText]]<br />
*[[getVehicleRotation]]<br />
*[[getVehicleSirensOn]]<br />
*[[getVehicleTowedByVehicle]]<br />
*[[getVehicleTowingVehicle]]<br />
*[[getVehicleTurnVelocity]]<br />
*[[getVehicleTurretPosition]]<br />
*[[getVehicleUpgradeOnSlot]]<br />
*[[getVehicleUpgrades]]<br />
*[[getVehicleUpgradeSlotName]]<br />
*[[getVehicleWheelStates]]<br />
*[[isVehicleFrozen]]<br />
*[[isVehicleFuelTankExplodable]]<br />
*[[isVehicleLocked]]<br />
*[[isVehicleOnGround]]<br />
*[[removeVehicleUpgrade]]<br />
*[[setVehicleAdjustableProperty]]<br />
*[[setVehicleColor]]<br />
*[[setVehicleDamageProof]]<br />
*[[setVehicleDirtLevel]]<br />
*[[setVehicleDoorState]]<br />
*[[setVehicleDoorsUndamageable]]<br />
*[[setVehicleEngineState]]<br />
*[[setVehicleFrozen]]<br />
*[[setVehicleFuelTankExplodable]]<br />
*[[setVehicleLandingGearDown]]<br />
*[[setVehicleLightState]]<br />
*[[setVehicleLocked]]<br />
*[[setVehicleOverrideLights]]<br />
*[[setVehiclePaintjob]]<br />
*[[setVehiclePanelState]]<br />
*[[setVehicleRotation]]<br />
*[[setVehicleSirensOn]]<br />
*[[setVehicleTurnVelocity]]<br />
*[[setVehicleWheelStates]]<br />
{{New feature|3|1.0|<br />
*[[getHelicopterRotorSpeed]]<br />
*[[getTrainDirection]]<br />
*[[getTrainSpeed]]<br />
*[[getVehicleGravity]]<br />
*[[getVehicleHeadLightColor]]<br />
*[[getVehicleModelFromName]]<br />
*[[getVehicleNameFromModel]]<br />
*[[getVehicleType]]<br />
*[[isTrainDerailable]]<br />
*[[isTrainDerailed]]<br />
*[[isVehicleBlown]]<br />
*[[isVehicleTaxiLightOn]]<br />
*[[setHelicopterRotorSpeed]]<br />
*[[setTrainDerailable]]<br />
*[[setTrainDerailed]]<br />
*[[setTrainDirection]]<br />
*[[setTrainSpeed]]<br />
*[[setVehicleGravity]]<br />
*[[setVehicleHeadLightColor]]<br />
*[[setVehicleTaxiLightOn]]<br />
}}<br />
{{Deprecated_feature|3|1.0|<br />
*[[getVehicleID]]<br />
*[[getVehicleIDFromName]]<br />
*[[getVehicleNameFromID]]<br />
*[[setVehicleModel]]<br />
}}</div>Archttps://wiki.multitheftauto.com/index.php?title=Template:Vehicle_functions&diff=20393Template:Vehicle functions2009-07-07T18:58:32Z<p>Arc: </p>
<hr />
<div>*[[addVehicleUpgrade]]<br />
*[[attachTrailerToVehicle]]<br />
*[[blowVehicle]]<br />
*[[createVehicle]]<br />
*[[detachTrailerFromVehicle]]<br />
*[[fixVehicle]]<br />
*[[getVehicleColor ]]<br />
*[[getVehicleCompatibleUpgrades]]<br />
*[[getVehicleController]]<br />
*[[getVehicleDoorState]]<br />
*[[getVehicleEngineState]]<br />
*[[getVehicleLandingGearDown]]<br />
*[[getVehicleLightState]]<br />
*[[getVehicleMaxPassengers]]<br />
*[[getVehicleName]]<br />
*[[getVehicleOccupant]]<br />
*[[getVehicleOverrideLights]]<br />
*[[getVehiclePaintjob]]<br />
*[[getVehiclePanelState]]<br />
*[[getVehicleRotation]]<br />
*[[getVehicleSirensOn]]<br />
*[[getVehiclesOfType]]<br />
*[[getVehicleTowedByVehicle]]<br />
*[[getVehicleTowingVehicle]]<br />
*[[getVehicleTurnVelocity]]<br />
*[[getVehicleTurretPosition]]<br />
*[[getVehicleType ]]<br />
*[[getVehicleUpgradeOnSlot]]<br />
*[[getVehicleUpgrades]]<br />
*[[getVehicleUpgradeSlotName]]<br />
*[[getVehicleWheelStates]]<br />
*[[isVehicleFrozen]]<br />
*[[isVehicleFuelTankExplodable]]<br />
*[[isVehicleLocked]]<br />
*[[isVehicleOnGround]]<br />
*[[removeVehicleUpgrade]]<br />
*[[resetVehicleExplosionTime]]<br />
*[[resetVehicleIdleTime]]<br />
*[[respawnVehicle]]<br />
*[[setVehicleColor]]<br />
*[[setVehicleDamageProof]]<br />
*[[setVehicleDirtLevel]]<br />
*[[setVehicleDoorState]]<br />
*[[setVehicleDoorsUndamageable]]<br />
*[[setVehicleEngineState]]<br />
*[[setVehicleFrozen]]<br />
*[[setVehicleFuelTankExplodable]]<br />
*[[setVehicleIdleRespawnDelay]]<br />
*[[setVehicleLandingGearDown]]<br />
*[[setVehicleLightState]]<br />
*[[setVehicleLocked]]<br />
*[[setVehicleOverrideLights]]<br />
*[[setVehiclePaintjob]]<br />
*[[setVehiclePanelState]]<br />
*[[setVehicleRespawnDelay]]<br />
*[[setVehicleRespawnPosition]]<br />
*[[setVehicleRotation]]<br />
*[[setVehicleSirensOn]]<br />
*[[setVehicleTurnVelocity]]<br />
*[[setVehicleWheelStates]]<br />
*[[spawnVehicle]]<br />
*[[toggleVehicleRespawn]]<br />
{{New feature|3|1.0|<br />
*[[getTrainDirection]]<br />
*[[getTrainSpeed]]<br />
*[[getVehicleHeadLightColor]]<br />
*[[getVehicleModelFromName]]<br />
*[[getVehicleNameFromModel]]<br />
*[[getVehicleType]]<br />
*[[isTrainDerailable]]<br />
*[[isTrainDerailed]]<br />
*[[isVehicleBlown]]<br />
*[[isVehicleTaxiLightOn]]<br />
*[[setTrainDerailable]]<br />
*[[setTrainDerailed]]<br />
*[[setTrainDirection]]<br />
*[[setTrainSpeed]]<br />
*[[setVehicleHeadLightColor]]<br />
*[[setVehicleTaxiLightOn]]<br />
}}<br />
{{Deprecated_feature|3|1.0|<br />
*[[getVehicleID]]<br />
*[[getVehicleIDFromName]]<br />
*[[getVehicleNameFromID]]<br />
*[[setVehicleModel]]<br />
}}</div>Archttps://wiki.multitheftauto.com/index.php?title=SetPickupType&diff=20383SetPickupType2009-07-07T12:41:25Z<p>Arc: </p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
This function allows changing the type of a pickup to a Weapon, Armour or Health pickup, and allows you to set the health points '''or''' the weapon and ammo that the pickup will give.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
bool setPickupType ( pickup thePickup, int type, int amount/weapon, [ int ammo ] ) <br />
</syntaxhighlight> <br />
<br />
===Required Arguments=== <br />
*'''thePickup:''' The pickup which you wish to change the settings of<br />
* '''type''': An integer representing the type of pickup. You can choose from:<br />
** '''0''': Health Pickup<br />
** '''1''': Armour Pickup<br />
** '''2''': Weapon Pickup<br />
* '''amount/weapon''': An integer representing the amount of Health points or Armour points a pickup has. If the type is a Weapon pickup, then it represents the Weapon ID of the weapon pickup. The 'ammo' field must be specified if the type is Weapon Pickup.<br />
<br />
===Optional Arguments=== <br />
{{OptionalArg}} <br />
*'''ammo''': An integer representing the amount of ammo a pickup contains. This argument is only valid when the pickup type is a Weapon Pickup, and must be specified in that case.<br />
<br />
===Returns===<br />
Returns ''true'' if successful, ''false'' otherwise.<br />
<br />
==Example== <br />
This example changes the pickup time every time someone hits it<br />
<br />
<section name="Server" class="server" show="false"><br />
<syntaxhighlight lang="lua"><br />
function onPickupHit ( ) -- when a pickup is hit<br />
local currenttype = getPickupType ( source ) -- get the current type of the pickup and store it in 'currenttype'<br />
if currenttype == 0 then -- if it is currently a health pickup<br />
setPickupType ( source, 1, 100 ) -- change it to an armour pickup with 100 hp<br />
elseif currenttype == 1 then -- else, if it is currently an armour pickup<br />
setPickupType ( source, 2, 29, 100 ) -- change it to an mp5 weapon pickup with 100 ammo<br />
elseif currenttype == 2 then -- lastly, if it is already a weapon<br />
setPickupType ( source, 0, 100 ) -- change it to a health pickup<br />
end<br />
end<br />
addEventHandler ( "onPickupHit", getRootElement ( ), onPickupHit ) -- add an event handler for onPickupHit<br />
</syntaxhighlight><br />
</section><br />
<br />
This example changes a local player's pickup every time the spacebar key is pressed down<br />
<section name="Client" class="client" show="false"><br />
<syntaxhighlight lang="lua">function changeMyPickupType ( key, keyState )<br />
local currenttype = getPickupType ( myPickup ) -- get the current type of the pickup and store it in 'currenttype'<br />
if currenttype == 0 then -- if it is currently a health pickup<br />
setPickupType ( myPickup, 1, 100 ) -- change it to an armour pickup with 100 hp<br />
elseif currenttype == 1 then -- else, if it is currently an armour pickup<br />
setPickupType ( myPickup, 2, 29, 100 ) -- change it to an mp5 weapon pickup with 100 ammo<br />
elseif currenttype == 2 then -- lastly, if it is already a weapon<br />
setPickupType ( myPickup, 0, 100 ) -- change it to a health pickup<br />
end<br />
end<br />
<br />
function clientsideResourceStart ()<br />
myPickup = createPickup ( 10.0, 10.0, 3.11, 0, 100 ) -- create myPickup at resource start<br />
bindKey ( "space", "down", changeMyPickupType ) --bind spacebar to changeMyPickupType function<br />
end<br />
addEventHandler ( "onClientResourceStart", getRootElement(), clientsideResourceStart )</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Pickup functions}}</div>Archttps://wiki.multitheftauto.com/index.php?title=SetPedAimTarget&diff=20300SetPedAimTarget2009-06-30T13:26:09Z<p>Arc: </p>
<hr />
<div>__NOTOC__<br />
{{Client function}}<br />
This function allows you to set a ped's aim target to a specific point.<br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
bool setPedAimTarget ( ped thePed, float x, float y, float z )<br />
</syntaxhighlight> <br />
<br />
===Required Arguments=== <br />
*'''thePed:''' The ped whose target you want to set. Only peds and remote players will work; this function has no effect on the local player.<br />
*'''x:''' The x coordinate of the aim target point.<br />
*'''y:''' The y coordinate of the aim target point.<br />
*'''z:''' The z coordinate of the aim target point.<br />
<br />
===Returns===<br />
Returns ''true'' if the function was successful, ''false'' otherwise.<br />
<br />
==Example==<br />
<syntaxhighlight lang="lua"><br />
function createPedAndsetHisAimTarget ()<br />
local ped = createPed (0, 0, 0, 5 ) -- create a ped, who looks like cj, in the middle of the map<br />
setPedAimTarget ( ped, 10, 10, 5 ) -- set the ped's target to a point in North-East<br />
end<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Client ped functions}}</div>Archttps://wiki.multitheftauto.com/index.php?title=SetFPSLimit&diff=20283SetFPSLimit2009-06-28T17:28:30Z<p>Arc: </p>
<hr />
<div>{{Server function}}<br />
__NOTOC__<br />
This function sets the maximum [http://en.wikipedia.org/wiki/Frame_rate FPS (Frames per second)] that players on the server can run their game at. <br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
bool setFPSLimit ( int fpsLimit ) <br />
</syntaxhighlight> <br />
<br />
===Required Arguments=== <br />
*'''fpsLimit:''' An integer value representing the maximum FPS. This value may be between '''25''' and '''100''' FPS. You can also pass '''0''' or ''false'', in which case the FPS limit will be disabled.<br />
<br />
===Returns===<br />
Returns ''true'' if successful, or ''false'' if it was not possible to set the limit or an invalid value was passed.<br />
<br />
==Example== <br />
This command sets the fps limit in a command handler.<br />
<syntaxhighlight lang="lua"><br />
addCommandHandler ( "setfps", function ( player, command, limit )<br />
if ( hasObjectPermissionTo ( player, "function.setFPSLimit" ) ) then<br />
setFPSLimit ( limit )<br />
end<br />
end )<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Server functions}}</div>Archttps://wiki.multitheftauto.com/index.php?title=SetFPSLimit&diff=20282SetFPSLimit2009-06-28T17:27:48Z<p>Arc: </p>
<hr />
<div>{{Server function}}<br />
__NOTOC__<br />
This function sets the maximum [http://en.wikipedia.org/wiki/Frame_rate FPS (Frames per second)] that players on the server can run their game at. <br />
<br />
==Syntax== <br />
<syntaxhighlight lang="lua"><br />
bool setFPSLimit ( int fpsLimit ) <br />
</syntaxhighlight> <br />
<br />
===Required Arguments=== <br />
*'''fpsLimit:''' An integer value representing the maximum FPS. This value may be between '''25''' and '''100''' FPS. You can also pass '''0''' or ''false'', in which case the FPS limit will be disabled.<br />
<br />
===Returns===<br />
Returns ''false'' if it was not possible to set the limit, or if an invalud value was set. Returns ''true'' if the operation was successful.<br />
<br />
==Example== <br />
This command sets the fps limit in a command handler.<br />
<syntaxhighlight lang="lua"><br />
addCommandHandler ( "setfps", function ( player, command, limit )<br />
if ( hasObjectPermissionTo ( player, "function.setFPSLimit" ) ) then<br />
setFPSLimit ( limit )<br />
end<br />
end )<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Server functions}}</div>Archttps://wiki.multitheftauto.com/index.php?title=GetCameraMatrix&diff=20243GetCameraMatrix2009-06-28T02:07:51Z<p>Arc: </p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
This function gets the position of the camera and the position of the point it is facing.<br />
<br />
Note: The server-side version of this function returns the last camera matrix that was set by the server, and thus does not necessarily indicate the current matrix of the camera (since it may have been changed client-side).<br />
<br />
==Syntax==<br />
<section name="Server" class="server" show="true"><br />
<syntaxhighlight lang="lua"><br />
float float float float float float float float getCameraMatrix ( player thePlayer )<br />
</syntaxhighlight><br />
<br />
===Required Arguments=== <br />
*'''thePlayer:''' The player whose camera matrix is to be returned.<br />
</section><br />
<br />
<section name="Client" class="client" show="true"><br />
<syntaxhighlight lang="lua"><br />
float float float float float float float float getCameraMatrix ( )<br />
</syntaxhighlight><br />
<br />
===Required Arguments=== <br />
''None.''<br />
</section><br />
<br />
===Returns===<br />
Returns eight ''float'' numbers if the argument(s) are valid; the first three indicate the position of the camera, the next three indicate the position of the point it's facing, and the last two are the roll and FOV (field of view). Returns ''false'' if the arguments are invalid.<br />
<br />
==Example==<br />
'''Example 1:''' This clientside example moves camera +1 unit on X axis.<br />
<syntaxhighlight lang="lua"><br />
local x, y, z, lx, ly, lz = getCameraMatrix() -- Get the current location and lookat of camera<br />
x, lx = x + 1, lx + 1 -- What will be the new x and x lookat values<br />
setCameraMatrix(x,y,z,lx,ly,lz) -- Set camera to new position<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Camera functions}}</div>Archttps://wiki.multitheftauto.com/index.php?title=GetCameraMatrix&diff=20242GetCameraMatrix2009-06-28T02:07:38Z<p>Arc: </p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
This function gets the position of the camera and the position of the point it is facing.<br />
<br />
Note: The server-side version of this function returns the last camera matrix that was set by the server, and thus does not necessarily indicate the current matrix of the camera (since it may have been changed client-side).<br />
<br />
==Syntax==<br />
<section name="Server" class="server" show="true"><br />
<syntaxhighlight lang="lua"><br />
float float float float float float floatfloat getCameraMatrix ( player thePlayer )<br />
</syntaxhighlight><br />
<br />
===Required Arguments=== <br />
*'''thePlayer:''' The player whose camera matrix is to be returned.<br />
</section><br />
<br />
<section name="Client" class="client" show="true"><br />
<syntaxhighlight lang="lua"><br />
float float float float float floatfloat float getCameraMatrix ( )<br />
</syntaxhighlight><br />
<br />
===Required Arguments=== <br />
''None.''<br />
</section><br />
<br />
===Returns===<br />
Returns eight ''float'' numbers if the argument(s) are valid; the first three indicate the position of the camera, the next three indicate the position of the point it's facing, and the last two are the roll and FOV (field of view). Returns ''false'' if the arguments are invalid.<br />
<br />
==Example==<br />
'''Example 1:''' This clientside example moves camera +1 unit on X axis.<br />
<syntaxhighlight lang="lua"><br />
local x, y, z, lx, ly, lz = getCameraMatrix() -- Get the current location and lookat of camera<br />
x, lx = x + 1, lx + 1 -- What will be the new x and x lookat values<br />
setCameraMatrix(x,y,z,lx,ly,lz) -- Set camera to new position<br />
</syntaxhighlight><br />
<br />
==See Also==<br />
{{Camera functions}}</div>Archttps://wiki.multitheftauto.com/index.php?title=SetCameraMatrix&diff=20241SetCameraMatrix2009-06-28T02:06:26Z<p>Arc: </p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
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").<br />
<br />
'''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.<br />
==Syntax==<br />
<section name="Server" class="server" show="true"><br />
<syntaxhighlight lang="lua"><br />
bool setCameraMatrix ( player thePlayer, float positionX, float positionY, float positionZ [, float lookAtX, float lookAtY, float lookAtZ, float roll = 0, float fov = 70 ] )<br />
</syntaxhighlight><br />
<br />
===Required Arguments=== <br />
*'''thePlayer:''' The player whose camera is to be changed.<br />
*'''positionX:''' The x coordinate of the camera's position.<br />
*'''positionY:''' The y coordinate of the camera's position.<br />
*'''positionZ:''' The z coordinate of the camera's position.<br />
<br />
===Optional Arguments=== <br />
*'''lookAtX:''' The x coordinate of the point the camera faces.<br />
*'''lookAtY:''' The y coordinate of the point the camera faces.<br />
*'''lookAtZ:''' The z coordinate of the point the camera faces.<br />
*'''roll:''' The camera roll angle, -180 to 180. A value of 0 means the camera sits straight, positive values will turn it counter clickwise and negative values clockwise. 180 means the camera is upside down.<br />
*'''fov:''' the field of view angle, 0 to 180. The higher this value is, the more you will be able to see what is to your sides.<br />
</section><br />
<br />
<section name="Client" class="client" show="true"><br />
<syntaxhighlight lang="lua"><br />
bool setCameraMatrix ( float positionX, float positionY, float positionZ [, float lookAtX, float lookAtY, float lookAtZ, float roll, float fov ] )<br />
</syntaxhighlight><br />
<br />
===Required Arguments=== <br />
*'''thePlayer:''' The player whose camera is to be changed.<br />
*'''positionX:''' The x coordinate of the camera's position.<br />
*'''positionY:''' The y coordinate of the camera's position.<br />
*'''positionZ:''' The z coordinate of the camera's position.<br />
<br />
===Optional Arguments=== <br />
*'''lookAtX:''' The x coordinate of the point the camera faces.<br />
*'''lookAtY:''' The y coordinate of the point the camera faces.<br />
*'''lookAtZ:''' The z coordinate of the point the camera faces.<br />
*'''roll:''' The camera roll angle, -180 to 180. A value of 0 means the camera sits straight, positive values will turn it counter clickwise and negative values clockwise. 180 means the camera is upside down.<br />
*'''fov:''' the field of view angle, 0 to 180. The higher this value is, the more you will be able to see what is to your sides.<br />
</section><br />
<br />
===Returns===<br />
Returns ''true'' if the arguments are valid, ''false'' otherwise.<br />
<br />
==Example==<br />
This code fixates the camera onto the Vinewood sign in Las Venturas for any player that joins the server:<br />
<section class="server" name="Server script" show="true"><br />
<syntaxhighlight lang="lua"><br />
function setCameraOnPlayerJoin()<br />
-- slowly fade the camera in to make the screen visible<br />
fadeCamera(source, true, 5)<br />
-- set the player's camera to a fixed position, looking at a fixed point<br />
setCameraMatrix(source, 1468.8785400391, -919.25317382813, 100.153465271, 1468.388671875, -918.42474365234, 99.881813049316)<br />
end<br />
addEventHandler("onPlayerJoin", getRootElement(), setCameraOnPlayerJoin)</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Camera functions}}</div>Archttps://wiki.multitheftauto.com/index.php?title=SetCameraMatrix&diff=20240SetCameraMatrix2009-06-27T23:18:02Z<p>Arc: </p>
<hr />
<div>__NOTOC__<br />
{{Server client function}}<br />
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").<br />
<br />
'''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.<br />
==Syntax==<br />
<section name="Server" class="server" show="true"><br />
<syntaxhighlight lang="lua"><br />
bool setCameraMatrix ( player thePlayer, float positionX, float positionY, float positionZ [, float lookAtX, float lookAtY, float lookAtZ, float roll = 0, float fov = 70 ] )<br />
</syntaxhighlight><br />
<br />
===Required Arguments=== <br />
*'''thePlayer:''' The player whose camera is to be changed.<br />
*'''positionX:''' The x coordinate of the camera's position.<br />
*'''positionY:''' The y coordinate of the camera's position.<br />
*'''positionZ:''' The z coordinate of the camera's position.<br />
<br />
===Optional Arguments=== <br />
*'''lookAtX:''' The x coordinate of the point the camera faces.<br />
*'''lookAtY:''' The y coordinate of the point the camera faces.<br />
*'''lookAtZ:''' The z coordinate of the point the camera faces.<br />
*'''roll:''' The camera roll angle, 0 to 360. A value of 0 means the camera sits straight, higher values will tilt it more and more counter clockwise. 180 means the camera is upside down.<br />
*'''fov:''' the field of view angle, 0 to 180. The higher this value is, the more you will be able to see what is to your sides.<br />
</section><br />
<br />
<section name="Client" class="client" show="true"><br />
<syntaxhighlight lang="lua"><br />
bool setCameraMatrix ( float positionX, float positionY, float positionZ [, float lookAtX, float lookAtY, float lookAtZ, float roll, float fov ] )<br />
</syntaxhighlight><br />
<br />
===Required Arguments=== <br />
*'''thePlayer:''' The player whose camera is to be changed.<br />
*'''positionX:''' The x coordinate of the camera's position.<br />
*'''positionY:''' The y coordinate of the camera's position.<br />
*'''positionZ:''' The z coordinate of the camera's position.<br />
<br />
===Optional Arguments=== <br />
*'''lookAtX:''' The x coordinate of the point the camera faces.<br />
*'''lookAtY:''' The y coordinate of the point the camera faces.<br />
*'''lookAtZ:''' The z coordinate of the point the camera faces.<br />
*'''roll:''' The camera roll angle, 0 to 360. A value of 0 means the camera sits straight, higher values will tilt it more and more counter clockwise. 180 means the camera is upside down.<br />
*'''fov:''' the field of view angle, 0 to 180. The higher this value is, the more you will be able to see what is to your sides.<br />
</section><br />
<br />
===Returns===<br />
Returns ''true'' if the arguments are valid, ''false'' otherwise.<br />
<br />
==Example==<br />
This code fixates the camera onto the Vinewood sign in Las Venturas for any player that joins the server:<br />
<section class="server" name="Server script" show="true"><br />
<syntaxhighlight lang="lua"><br />
function setCameraOnPlayerJoin()<br />
-- slowly fade the camera in to make the screen visible<br />
fadeCamera(source, true, 5)<br />
-- set the player's camera to a fixed position, looking at a fixed point<br />
setCameraMatrix(source, 1468.8785400391, -919.25317382813, 100.153465271, 1468.388671875, -918.42474365234, 99.881813049316)<br />
end<br />
addEventHandler("onPlayerJoin", getRootElement(), setCameraOnPlayerJoin)</syntaxhighlight><br />
</section><br />
<br />
==See Also==<br />
{{Camera functions}}</div>Arc