Server Manual

2008-01-06T15:36:56Z

AlienX: /* Adding admins */

__TOC__

==Getting started==
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!

==Installing the server==
The dedicated server application is available in different flavours depending on the platform of the server.

===Linux installation===
Empty

===Windows installation===
Installation of the MTA:SA DM server on Windows is easy as pie.
*Go to the [http://mtasa.com/dp.html download page] and scroll down to the "Dedicated servers" section
*Click the Windows download link.
*Once the installer is downloaded, open it.
*Select a folder where you want to install the server.
*Click Install.
*Done!

==Configuring your server==
Begin by opening the ''''mtaserver.conf'''' file, which is located in the <SERVER>/mods/deathmatch directory in a text editor, for example Windows Notepad.

This file is fairly straightforward; every variable has a description of what to do with it and how to change it.

===Adding admins===
To add admins to your sever follow these steps: 
<ol>
<li>Browse to your servers 'deathmatch' folder and open Accounts.xml</li>
<li>Add a new account into the file with the syntax below
<div style="padding: 10px">
''''Accounts.xml syntax''''
<syntaxhighlight lang="xml">
<account name="Username" password="UserPassword" />
</syntaxhighlight>
</div>
<li>Save and close the file</li>
<li>Open acl.xml</li>
<li>Select the rights of the admin, either Moderator, SuperModerator or Admin</li>
<li>Within the group you have selected add the account you have created above with the syntax below
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<object name="user.Username" />
</syntaxhighlight>
</div>

You will finish with something like this:
<div style="padding: 10px">
<syntaxhighlight lang="xml">
<group name="Admin">
...
<object name="user.Username" />
</group>
</syntaxhighlight>
</div>

</li>
<li>
You're done! You can add as many admins as you want this way, just keep creating accounts under eachother and the same with the ACL rights. 
</li>
</ol>
'''Note''': Changing these files requires a restart of the server 
'''Note 2''': 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, through the web interface you can manage ACL rights while it's running. (This option may be a better option for you if the first does not work)

=== Configuring an external web server ===
For performance or consistency reasons, you could choose to make use of an external web server already set up and running, instead of the built-in web server. 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.

To enable downloading off an external web server, you should configure the ''httpdownload'' and ''httpdownloadurl'' tags in your server configuration:

<div style="padding: 10px">
<syntaxhighlight lang="xml"><httpdownload>1</httpdownload>
<httpdownloadurl>http://www.myserver.tld/directory/here</httpdownloadurl>
</syntaxhighlight></div>

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.

<ol>
<li>Launch the dedicated server once and exit again. This will extract the zip files into the '''<SERVER>/mods/deathmatch/resourcecache''' directory.</li>
<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:
<ul>
<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>
<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. 
 
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.
</ul>
</li>
</ol>

'''Note''': Please try to avoid any special characters (e.g. ~, !) in your download URLs. 
'''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/'')

==Starting your server==
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!

To start your server double click on MTA Server.exe, make sure you allow it through any firewalls and forward ports where nessessary.

==Installing/Updating resources on your server==
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.

# Move or copy the new resource to your <SERVER>\mods\deathmatch\resources folder.
# 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.

==Uninstalling resources==
Resources can easily be removed from your server if you no longer want them.

# Delete the ZIP file or the folder of the resource you wish to uninstall
# 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.

==Administrating your server==
You can start resources by typing the command "start resourcename" in the server console, or stop ones with "stop resourcename".

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.

For further commands, type "help" in a console.

==Starting a map/gamemode==
See the commands section of the documentation for [[Resource:Map manager|mapmanager]] for more information.

==Remotely administrating your server==
This article assumes you have setup a working account with 'Admin' user rights, and have these resources started:
# ResourceBrowser
# ResourceManager
# WebAdmin
# WebMap

You're able to access these great remote admin tools by visiting <nowiki>http://<yourserverip>:<httpport>/resourcebrowser</nowiki> in your Firefox.
'''NOTE: Internet Explorer will NOT work, it will not display the resource browser, other browsers (Opera namely) will have mixed results'''. If you want it to work in Internet Explorer, feel free to recode the resource :)

==Useful Notes==

# 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.
# In the above instructions, <SERVER> is the path to your server's main directory. In most cases this is C:\Program Files (x86)\MTA San Andreas\server

====Need further help?====
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])

Client Manual

2008-01-03T15:48:43Z

AlienX: /* Error codes and their meanings */

__TOC__

==Introduction==
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.

Please note that MTA:SA is a beta, which means it could crash or cause unexpected results.

==Before you start==

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.

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.

'''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.

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

===System requirements===
The minimum system requirements for Multi Theft Auto: San Andreas are slightly higher than the original minimum requirements for Grand Theft Auto: San Andreas.
* Intel Pentium 4 or AMD Athlon XP
* 512MB DDR RAM
* Clean installation of Grand Theft Auto: San Andreas, version 1.0 or 1.1 (American or European)
* 3.7GB of free hard disk space (3.6GB for a minimum Grand Theft Auto installation)
* NVidia GeForce 4 series or ATI Radeon 8xxx series (64MB RAM and DirectX 9.0 compatible)
* DirectX 9.0 compatible sound card
* Keyboard and mouse
* Broadband internet access (for smooth online play)

For extra features, a pixel shader 2.0 compatible videocard (NVidia GeForce FX series or higher, ATI Radeon 9xxx series or higher) is recommended.

For extra loading performance, more RAM is recommended.

==Installing the game==

'''This section will need to be updated when we get an installer'''

# If you haven’t already, go to http://www.mtabeta.com register and download the MTA:SA client.
# 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.
# You will be presented with three (3) options where your able to create an account, use one your allready have, or dont use an account - In this case select option Two (2)
 
'''Option One Selected''' 
Proceed to create a new account at MTABeta.com, once complete enter your login details into the installer 
'''Option Two Selected''' 
Proceed to entering your account details into the installer
 
# You will then be asked which components to install.
#* '''Client''' interfaces with the game and is a required component.
#* '''MTA Server''' enables you to host your own home-brew server
#* '''MTA Server > Editor''' is used to create new maps, this is an optional component
# 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.
# When it finishes installing, you will be given the option to start MTA: San Andreas straight away. Choose your option and then press '''Finish'''.
# You will be able to launch MTA:DM from your Start Menu if you wish to play.

==Running the game==
# Start Multi Theft Auto by clicking the icon located in your Start Menu under '''MTA:San Andreas'''.
# 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:

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
'''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.

 
|-
| width="188" |
[[Image:MENU_ServerBrowser.jpg|280px]]
| width="380" |
'''Browse servers''' – this allows you to receive a list of available servers to play on. 

 
|-
| width="188" |
[[Image:Settings.jpg|280px]]
| width="380" |
'''Settings '''– this allows you to change your in-game nickname, customize controls and adjust display settings.

 
|-
| width="188" |
[[Image:MENU_About.jpg|280px]]
| width="380" |
'''About '''– this gives you a list of contributors to the project.

 
|-
| width="188" |
 
| width="380" |
'''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.

 
|-
| width="188" |
 
| width="380" |
'''Quit '''– this returns you back to your Windows desktop.

 
|}

The easiest way to play the game is to click '''Browse Servers''' on the menu. A new window will appear:

<center>[[Image:manual_image006a.jpg]]</center> '''Will need to be updated'''

If servers have not appeared already, press the '''Refresh''' button and MTA will scan for servers, displaying them as a list.

* Under the '''Name''' tab, each server's name is displayed.
* 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].
* 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.
* 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.

Each tab can be clicked to arrange the respective column in ascending or descending order.

For optimal performance and gameplay, look for the best balance between players and ping.

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.

==How to Play==

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.

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'''.

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.

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.

==Controls==

===In-Game Keys===

* F8 (or Tidle Key) - Console
* F9 - Ingame help
* F12 - Take a screenshot
* T - Chat
* Y - Team Chat
* TAB - Player List (if [[Scoreboard]] resource is running on the server)

==Console Commands==

'''bind defaults''' Binds control defaults in the settings menu

Press '''~ (tilde)''' or '''F8''' to access the console, then type a command followed by any neccessary parameters (if applicable) then press Enter.

;'''maps''' :This displays a list of all maps available on the server.

;'''nick [nickname]''' :This changes your nickname whilst in-game to whatever you specify in the parameters.

;'''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.

;'''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.

;'''ver''' :This displays the version number and copyright information for the software.

;'''time''' :This displays the current time.

;'''disconnect''' :This disconnects you from the server and returns you to the main menu.

;'''say [text]''' :This enables you to continue talking to people in the chat box whilst the console is open.

;'''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.

'''Tip:''' You can use these commands in the chatbox by putting a / (forward slash) in front of them.

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.

==Error codes and their meanings==
'''Download errors''' 
0: UNKNOWN_ERROR 
1: INVALID_FILE_DESCRIPTORS 
2: INVALID_MAX_FILE_DESCRIPTOR 
3: INVALID_SELECT_RETURN 
4: INVALID_INITIAL_MULTI_PERFORM 
5: INVALID_MULTI_PERFORM_CODE 
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS 
7: UNEXPECTED_CURL_MESSAGE 
8: UNABLE_TO_CONNECT 
9: UNABLE_TO_DOWNLOAD_FILE 
10: FAILED_TO_INITIALIZE_DOWNLOAD 

'''Fatal errors''' 
1: no local player model on ingame event 
2: no local player on ingame event 
3: server downloads disabled 
4: no local player model on player-list packet 
5: no local player on player-list packet 
6: invalid custom data length on entity-add packet 
7: invalid bitstream data on entity-add packet 
8: system entity on entity-add packet 
9: failed to create object on entity-add packet 
10: failed to create pickup on entity-add packet 
11: failed to create vehicle on entity-add packet 
12: invalid team-name length on entity-add packet 
13: invalid lua-event name length in lua-event packet 
14: invalid resource name length in resource-start packet

Client Manual

2008-01-03T15:48:35Z

AlienX: /* Error codes and their meanings */

__TOC__

==Introduction==
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.

Please note that MTA:SA is a beta, which means it could crash or cause unexpected results.

==Before you start==

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.

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.

'''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.

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

===System requirements===
The minimum system requirements for Multi Theft Auto: San Andreas are slightly higher than the original minimum requirements for Grand Theft Auto: San Andreas.
* Intel Pentium 4 or AMD Athlon XP
* 512MB DDR RAM
* Clean installation of Grand Theft Auto: San Andreas, version 1.0 or 1.1 (American or European)
* 3.7GB of free hard disk space (3.6GB for a minimum Grand Theft Auto installation)
* NVidia GeForce 4 series or ATI Radeon 8xxx series (64MB RAM and DirectX 9.0 compatible)
* DirectX 9.0 compatible sound card
* Keyboard and mouse
* Broadband internet access (for smooth online play)

For extra features, a pixel shader 2.0 compatible videocard (NVidia GeForce FX series or higher, ATI Radeon 9xxx series or higher) is recommended.

For extra loading performance, more RAM is recommended.

==Installing the game==

'''This section will need to be updated when we get an installer'''

# If you haven’t already, go to http://www.mtabeta.com register and download the MTA:SA client.
# 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.
# You will be presented with three (3) options where your able to create an account, use one your allready have, or dont use an account - In this case select option Two (2)
 
'''Option One Selected''' 
Proceed to create a new account at MTABeta.com, once complete enter your login details into the installer 
'''Option Two Selected''' 
Proceed to entering your account details into the installer
 
# You will then be asked which components to install.
#* '''Client''' interfaces with the game and is a required component.
#* '''MTA Server''' enables you to host your own home-brew server
#* '''MTA Server > Editor''' is used to create new maps, this is an optional component
# 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.
# When it finishes installing, you will be given the option to start MTA: San Andreas straight away. Choose your option and then press '''Finish'''.
# You will be able to launch MTA:DM from your Start Menu if you wish to play.

==Running the game==
# Start Multi Theft Auto by clicking the icon located in your Start Menu under '''MTA:San Andreas'''.
# 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:

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
'''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.

 
|-
| width="188" |
[[Image:MENU_ServerBrowser.jpg|280px]]
| width="380" |
'''Browse servers''' – this allows you to receive a list of available servers to play on. 

 
|-
| width="188" |
[[Image:Settings.jpg|280px]]
| width="380" |
'''Settings '''– this allows you to change your in-game nickname, customize controls and adjust display settings.

 
|-
| width="188" |
[[Image:MENU_About.jpg|280px]]
| width="380" |
'''About '''– this gives you a list of contributors to the project.

 
|-
| width="188" |
 
| width="380" |
'''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.

 
|-
| width="188" |
 
| width="380" |
'''Quit '''– this returns you back to your Windows desktop.

 
|}

The easiest way to play the game is to click '''Browse Servers''' on the menu. A new window will appear:

<center>[[Image:manual_image006a.jpg]]</center> '''Will need to be updated'''

If servers have not appeared already, press the '''Refresh''' button and MTA will scan for servers, displaying them as a list.

* Under the '''Name''' tab, each server's name is displayed.
* 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].
* 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.
* 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.

Each tab can be clicked to arrange the respective column in ascending or descending order.

For optimal performance and gameplay, look for the best balance between players and ping.

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.

==How to Play==

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.

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'''.

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.

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.

==Controls==

===In-Game Keys===

* F8 (or Tidle Key) - Console
* F9 - Ingame help
* F12 - Take a screenshot
* T - Chat
* Y - Team Chat
* TAB - Player List (if [[Scoreboard]] resource is running on the server)

==Console Commands==

'''bind defaults''' Binds control defaults in the settings menu

Press '''~ (tilde)''' or '''F8''' to access the console, then type a command followed by any neccessary parameters (if applicable) then press Enter.

;'''maps''' :This displays a list of all maps available on the server.

;'''nick [nickname]''' :This changes your nickname whilst in-game to whatever you specify in the parameters.

;'''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.

;'''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.

;'''ver''' :This displays the version number and copyright information for the software.

;'''time''' :This displays the current time.

;'''disconnect''' :This disconnects you from the server and returns you to the main menu.

;'''say [text]''' :This enables you to continue talking to people in the chat box whilst the console is open.

;'''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.

'''Tip:''' You can use these commands in the chatbox by putting a / (forward slash) in front of them.

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.

==Error codes and their meanings==
'''Download errors''' 
0: UNKNOWN_ERROR 
1: INVALID_FILE_DESCRIPTORS 
2: INVALID_MAX_FILE_DESCRIPTOR 
3: INVALID_SELECT_RETURN 
4: INVALID_INITIAL_MULTI_PERFORM 
5: INVALID_MULTI_PERFORM_CODE 
6: INVALID_MULTI_PERFORM_CODE_NEW_DOWNLOADS 
7: UNEXPECTED_CURL_MESSAGE 
8: UNABLE_TO_CONNECT 
9: UNABLE_TO_DOWNLOAD_FILE 
10: FAILED_TO_INITIALIZE_DOWNLOAD 

'''Fatal errors'''
1: no local player model on ingame event 
2: no local player on ingame event 
3: server downloads disabled 
4: no local player model on player-list packet 
5: no local player on player-list packet 
6: invalid custom data length on entity-add packet 
7: invalid bitstream data on entity-add packet 
8: system entity on entity-add packet 
9: failed to create object on entity-add packet 
10: failed to create pickup on entity-add packet 
11: failed to create vehicle on entity-add packet 
12: invalid team-name length on entity-add packet 
13: invalid lua-event name length in lua-event packet 
14: invalid resource name length in resource-start packet

Client Manual

2008-01-03T15:47:34Z

2008-01-02T02:51:03Z

AlienX: /* Starting Your Server */

Server Manual

2008-01-02T02:49:49Z

AlienX: /* Configuring Your Server */

Client Manual

2008-01-02T02:49:27Z

AlienX: Undo revision 14296 by AlienX (Talk)

__TOC__

==Introduction==
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.

Please note that MTA:SA is a beta, which means it could crash or cause unexpected results.

==Before you start==

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.

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.

'''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.

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

==Installing the game==

'''This section will need to be updated when we get an installer'''

# If you haven’t already, go to http://www.mtabeta.com register and download the MTA:SA client.
# 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.
# You will be presented with three (3) options where your able to create an account, use one your allready have, or dont use an account - In this case select option Two (2)
 
'''Option One Selected''' 
Proceed to create a new account at MTABeta.com, once complete enter your login details into the installer 
'''Option Two Selected''' 
Proceed to entering your account details into the installer
 
# You will then be asked which components to install.
#* '''Client''' interfaces with the game and is a required component.
#* '''MTA Server''' enables you to host your own home-brew server
#* '''MTA Server > Editor''' is used to create new maps, this is an optional component
# 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.
# When it finishes installing, you will be given the option to start MTA: San Andreas straight away. Choose your option and then press '''Finish'''.
# You will be able to launch MTA:DM from your Start Menu if you wish to play.

==Running the game==
# Start Multi Theft Auto by clicking the icon located in your Start Menu under '''MTA:San Andreas'''.
# 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:

{| border="0" align="center"
| width="188" |
[[Image:MENU_QuickConnect.jpg]]
| width="380" |
'''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.

 
|-
| width="188" |
[[Image:MENU_ServerBrowser.jpg|280px]]
| width="380" |
'''Browse servers''' – this allows you to receive a list of available servers to play on. 

 
|-
| width="188" |
[[Image:Settings.jpg|280px]]
| width="380" |
'''Settings '''– this allows you to change your in-game nickname, customize controls and adjust display settings.

 
|-
| width="188" |
[[Image:MENU_About.jpg|280px]]
| width="380" |
'''About '''– this gives you a list of contributors to the project.

 
|-
| width="188" |
 
| width="380" |
'''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.

 
|-
| width="188" |
 
| width="380" |
'''Quit '''– this returns you back to your Windows desktop.

 
|}

The easiest way to play the game is to click '''Browse Servers''' on the menu. A new window will appear:

<center>[[Image:manual_image006a.jpg]]</center> '''Will need to be updated'''

If servers have not appeared already, press the '''Refresh''' button and MTA will scan for servers, displaying them as a list.

* Under the '''Name''' tab, each server's name is displayed.
* 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].
* 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.
* 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.

Each tab can be clicked to arrange the respective column in ascending or descending order.

For optimal performance and gameplay, look for the best balance between players and ping.

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.

==How to Play==

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.

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'''.

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.

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.

==Controls==

===In-Game Keys===

* F5 (or Tidle Key) - Console
* F12 - Take a screenshot
* T - Chat
* Y - Team Chat
* TAB - Player List

==Console Commands==

'''bind defaults''' Binds control defaults in the settings menu

Press '''~ (tilde)''' or '''F8''' to access the console, then type a command followed by any neccessary parameters (if applicable) then press Enter.

;'''maps''' :This displays a list of all maps available on the server.

;'''nick [nickname]''' :This changes your nickname whilst in-game to whatever you specify in the parameters.

;'''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.

;'''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.

;'''ver''' :This displays the version number and copyright information for the software.

;'''time''' :This displays the current time.

;'''disconnect''' :This disconnects you from the server and returns you to the main menu.

;'''say [text]''' :This enables you to continue talking to people in the chat box whilst the console is open.

;'''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.

;'''rcon_login [password]''' :This allows a player to log in as an administrator in order to access to administrative functions such as kicking and banning players whilst in-game. This requires the server to be configured for RCON access.

;'''rcon [command] [arguments]''' :This allows an admin who is logged into RCON (see rcon_login) to perform administrative functions within the server. These include kicking, banning and freezing players.

'''Tip:''' You can use these commands in the chatbox by putting a / (forward slash) in front of them.

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.

Client Manual

2008-01-02T02:48:51Z

AlienX: Removing all content from page

Server Manual

2008-01-02T02:43:13Z

AlienX: /* Configuring Your Server */

2008-01-02T02:34:32Z

AlienX: /* Example */

This file is copied from the MTA:DM Server. 
'''File Name:''' vehiclecolors.conf 
'''File Location:''' <MTAPath>\server\mods\deathmatch 
 
This file defines the color combinations a vehicle can have.

==File Syntax==
[Vehicle ID] [Color 1] [Color 2] [Color 3] [Color 4] 
 
Note that most vehicles doesn't need more than two colors You can specify a vehicle ID more than once to specify more than one combination for a vehicle. The color combination used for a vehicle is randomly decided each time a player spawns in a vehicle.
If you mess this file up, just delete it and the server will generate a new file with GTA's default values in it.

==Example==
In this example, vehicle ID 445 is being set colors for the server to use when the vehicle is created, you can add your own by adding new ones under it or anywhere inside this file as long as the syntax follows the example above. 
 

{| width="100" align="left" border="1"
|<center>
445 34 34 
445 35 35 
445 37 37 
445 39 39 
445 41 41 
445 43 43 
445 45 45 </center>
|}