Multi Theft Auto: Wiki - User contributions [en]

Building MTASA Server on GNU Linux

2025-05-28T16:04:26Z

Claus: /* Ubuntu 20.04 */

{{Needs Checking|Confirm steps work.}}

== Installing and Running MTASA server on Linux ==
{{Note|This article is only for developers who changed the server code. If you are looking for the precompiled server (for normal server owners). Go to: [http://linux.mtasa.com/ linux.mtasa.com] and see [[Installing and Running MTASA Server on GNU_Linux]]}}


== Preparing your system ==

In order to build the Multi Theft Auto dedicated server, you will have to set up your system with the correct libraries and tools. How these are installed depends on your distribution.

Our network module (net.dll or net.so) is distributed as a precompiled binary library. The file for GNU/Linux can be found inside the lastest Linux nightly from [http://nightly.mtasa.com/ here]. Use the net.so from {{Current Version|master}} if you are compiling from the trunk, or the net.so from {{Current Version|full}} if you are compiling the {{Current Version|full}} branch. Be sure the read the top of ''Server/version.h'' as it contains directions on how to compile the different build types.

=== Ubuntu 20.04 ===

The following instructions are specifically for Ubuntu 20.04.

You will need to install the required build tools, headers, and libraries. These can be installed using the following packages:

* '''g++-10:''' package provides the GNU C++ compiler version 10. It is used to compile C++ source code into executable programs or libraries
* '''build-essential:''' provides tools, headers, and libraries required to build applications
* '''automake:''' provides tools for automatically generating Makefiles
* '''libtool:''' required for building shared libraries
* '''libreadline-gplv2-dev:''' provides the GNU readline library (version 5)
* '''libncurses5-dev:''' provides tools for writing to the console screen
* '''libncursesw5-dev:''' provides wide character support for ncurses
* '''default-libmysqlclient-dev:''' provides the MySQL client development files
* '''git:''' version control tool used to clone the code repository
* '''unzip:''' archive unpacking utility

To install all required packages, run the following commands in the terminal (execute as root):

apt-get update
apt-get install g++-10
apt-get install build-essential automake libtool
apt-get install libreadline-gplv2-dev libncurses5-dev libncursesw5-dev
apt-get install default-libmysqlclient-dev git unzip

=== Gentoo Linux ===
You will need the necessary build tools, headers and libraries. Because Gentoo’s portage system is designed to compile any packages on your own system, the necessary build tools will have already been installed. This only leaves you to install the necessary libraries:


* '''git:''' contains the git client used to check out our code repository
To compile and install these packages through ''emerge'', use the '''emerge -v <package list>''' command. The -v option shows additional * * information and can be omitted. (If you want to use any USE flags, prepend emerge with USE="use flags here". You can also use the -pv option to verify that you’re using the correct flags.) Refer to the [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=1 Gentoo Handbook] or manual for more information on emerge.

Example:

emerge -v git sqlite
USE=“net-misc/curl ssl” emerge -v curl

=== Fedora ===

You will need these packages to be able to successfully compile a MTA server on Fedora:
* '''glibc-devel:'''

* '''readline-devel:''' contains the readline library

* '''git:''' contains the git client to check out the source code
To install these packages through yum, use the yum install <package list> command as in the following example (execute as root):

yum install glibc-devel readline-devel git

== General instructions for {{Current Version|master}} ==

'''Downloading the source.'''

First, you need to download the source. Either clone as shown below or [https://github.com/multitheftauto/mtasa-blue/archive/master.zip download a zip snapshot]

git clone <nowiki>https</nowiki>://github.com/multitheftauto/mtasa-blue.git mtasa-blue
cd mtasa-blue
sudo chmod -R 777 .

Then compile it thus:

./linux-build.sh

Then copy the configuration files, network module and resources into '''Bin/server''' by running this command:

./linux-install-data.sh

And the resources and stuff should be downloaded and stuff. As well as the net_d.dll file.

=== '''Troubleshooting''' ===

If you’re getting any unexpected errors while compiling, please check our [https://github.com/multitheftauto/mtasa-blue/issues GitHub issues] or our [https://discord.com/invite/GNN6PRtTnu development-focused Discord server].

<ul>
<li>If you get a message saying "Killed" when running premake5 gmake (linux-build.sh), that usually means you ran out of memory.<br />
You can confirm this by searching for kill logs by running <code>sudo dmesg | grep -i kill</code><br />
A possible solution for this might be to [https://opensource.com/article/18/9/swap-space-linux-systems turn on swap] or upgrade your system memory temporarily.<br />
1 GB is likely '''not''' enough of memory to complete the build.
</li>
</ul>

[[ru:Building MTASA Server on GNU Linux]]
[[Category: Development]]

Building MTASA Server on GNU Linux

2025-05-28T15:55:13Z

Claus: /* General instructions for {{Current Version|master}} */

{{Needs Checking|Confirm steps work.}}

== Installing and Running MTASA server on Linux ==
{{Note|This article is only for developers who changed the server code. If you are looking for the precompiled server (for normal server owners). Go to: [http://linux.mtasa.com/ linux.mtasa.com] and see [[Installing and Running MTASA Server on GNU_Linux]]}}


== Preparing your system ==

In order to build the Multi Theft Auto dedicated server, you will have to set up your system with the correct libraries and tools. How these are installed depends on your distribution.

Our network module (net.dll or net.so) is distributed as a precompiled binary library. The file for GNU/Linux can be found inside the lastest Linux nightly from [http://nightly.mtasa.com/ here]. Use the net.so from {{Current Version|master}} if you are compiling from the trunk, or the net.so from {{Current Version|full}} if you are compiling the {{Current Version|full}} branch. Be sure the read the top of ''Server/version.h'' as it contains directions on how to compile the different build types.

=== Ubuntu 20.04 ===

The following instructions are specifically for Ubuntu 20.04.

You will need to install the required build tools, headers, and libraries. These can be installed using the following packages:

* '''build-essential:''' provides tools, headers, and libraries required to build applications
* '''automake:''' provides tools for automatically generating Makefiles
* '''libtool:''' required for building shared libraries
* '''libreadline-gplv2-dev:''' provides the GNU readline library (version 5)
* '''libncurses5-dev:''' provides tools for writing to the console screen
* '''libncursesw5-dev:''' provides wide character support for ncurses
* '''default-libmysqlclient-dev:''' provides the MySQL client development files
* '''git:''' version control tool used to clone the code repository
* '''unzip:''' archive unpacking utility

To install all required packages, run the following commands in the terminal (execute as root):

apt-get update
apt-get install build-essential automake libtool
apt-get install libreadline-gplv2-dev libncurses5-dev libncursesw5-dev
apt-get install default-libmysqlclient-dev git unzip

=== Gentoo Linux ===
You will need the necessary build tools, headers and libraries. Because Gentoo’s portage system is designed to compile any packages on your own system, the necessary build tools will have already been installed. This only leaves you to install the necessary libraries:


* '''git:''' contains the git client used to check out our code repository
To compile and install these packages through ''emerge'', use the '''emerge -v <package list>''' command. The -v option shows additional * * information and can be omitted. (If you want to use any USE flags, prepend emerge with USE="use flags here". You can also use the -pv option to verify that you’re using the correct flags.) Refer to the [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=1 Gentoo Handbook] or manual for more information on emerge.

Example:

emerge -v git sqlite
USE=“net-misc/curl ssl” emerge -v curl

=== Fedora ===

You will need these packages to be able to successfully compile a MTA server on Fedora:
* '''glibc-devel:'''

* '''readline-devel:''' contains the readline library

* '''git:''' contains the git client to check out the source code
To install these packages through yum, use the yum install <package list> command as in the following example (execute as root):

yum install glibc-devel readline-devel git

== General instructions for {{Current Version|master}} ==

'''Downloading the source.'''

First, you need to download the source. Either clone as shown below or [https://github.com/multitheftauto/mtasa-blue/archive/master.zip download a zip snapshot]

git clone <nowiki>https</nowiki>://github.com/multitheftauto/mtasa-blue.git mtasa-blue
cd mtasa-blue
sudo chmod -R 777 .

Then compile it thus:

./linux-build.sh

Then copy the configuration files, network module and resources into '''Bin/server''' by running this command:

./linux-install-data.sh

And the resources and stuff should be downloaded and stuff. As well as the net_d.dll file.

=== '''Troubleshooting''' ===

If you’re getting any unexpected errors while compiling, please check our [https://github.com/multitheftauto/mtasa-blue/issues GitHub issues] or our [https://discord.com/invite/GNN6PRtTnu development-focused Discord server].

<ul>
<li>If you get a message saying "Killed" when running premake5 gmake (linux-build.sh), that usually means you ran out of memory.<br />
You can confirm this by searching for kill logs by running <code>sudo dmesg | grep -i kill</code><br />
A possible solution for this might be to [https://opensource.com/article/18/9/swap-space-linux-systems turn on swap] or upgrade your system memory temporarily.<br />
1 GB is likely '''not''' enough of memory to complete the build.
</li>
</ul>

[[ru:Building MTASA Server on GNU Linux]]
[[Category: Development]]

FormatNumber

2025-04-18T13:47:47Z

Claus:

{{Useful Function}} __NOTOC__
This function formats large numbers by adding commas to it. For example, 100000 becomes 100 000<br>

==Syntax==
<syntaxhighlight lang="lua">string formatNumber( int/string number, [ string sep = " " ] )</syntaxhighlight>

===Required Arguments===
* '''number''': The number to be converted.

===Optional Arguments===
* '''sep''': A string of the character you want to split

===Returns===
Returns a string containing the converted number.

==Code==
<section name="Example 1: Shared" class="both" show="true">
<syntaxhighlight lang="lua">
function formatNumber( number, sep )
local debugInfo = debug.getinfo( 2, "Sl" )
local debugSource = debugInfo and debugInfo.short_src or "unknown"
local debugLine = debugInfo and debugInfo.currentline or "unknown"

if not tonumber( number ) then
outputDebugString(
"Bad argument @'formatNumber' [Expected number at argument 1, got "..type(number).."] "..
"Called from: "..debugSource.." (line "..debugLine..")",
2
)
error( "Bad argument", 2 )
end

if sep ~= nil and type( sep ) ~= "string" then
outputDebugString(
"Bad argument @'formatNumber' [Expected string or nil at argument 2, got "..type(sep).."] "..
"Called from: "..debugSource.." (line "..debugLine..")",
2
)
error( "Bad argument", 2 )
end

sep = sep or " "

local moneyStr = tostring( math.floor( tonumber( number ) ) )
local isNegative = moneyStr:sub( 1, 1 ) == "-"

if isNegative then
moneyStr = moneyStr:sub( 2 )
end

local len = moneyStr:len( )
for i = 1, math.ceil( len / 3 ) - 1 do
local pos = len - 3 * i + 1
moneyStr = moneyStr:sub( 1, pos - 1 ) .. sep .. moneyStr:sub( pos )
end

return ( isNegative and "-" or "") .. moneyStr
end
</syntaxhighlight>
</section>

==Example==

<section name="Client" class="client" show="true">
This example converts a player's money, and outputs it to the chatbox when they type 'money' into the console:
<syntaxhighlight lang="lua">
function convertPlayerMoney()
local pMoney = getPlayerMoney()
local convertedMoney = formatNumber(pMoney)
outputChatBox(convertedMoney)
end
addCommandHandler("money", convertPlayerMoney)
</syntaxhighlight>

</section>

==See Also==
{{Useful_Functions}}

FormatNumber

2025-04-18T13:47:33Z

Claus: /* Syntax */

{{Useful Function}} __NOTOC__
This function formats large numbers by adding commas to it. For example, 100000 becomes 100.000<br>

==Syntax==
<syntaxhighlight lang="lua">string formatNumber( int/string number, [ string sep = " " ] )</syntaxhighlight>

===Required Arguments===
* '''number''': The number to be converted.

===Optional Arguments===
* '''sep''': A string of the character you want to split

===Returns===
Returns a string containing the converted number.

==Code==
<section name="Example 1: Shared" class="both" show="true">
<syntaxhighlight lang="lua">
function formatNumber( number, sep )
local debugInfo = debug.getinfo( 2, "Sl" )
local debugSource = debugInfo and debugInfo.short_src or "unknown"
local debugLine = debugInfo and debugInfo.currentline or "unknown"

if not tonumber( number ) then
outputDebugString(
"Bad argument @'formatNumber' [Expected number at argument 1, got "..type(number).."] "..
"Called from: "..debugSource.." (line "..debugLine..")",
2
)
error( "Bad argument", 2 )
end

if sep ~= nil and type( sep ) ~= "string" then
outputDebugString(
"Bad argument @'formatNumber' [Expected string or nil at argument 2, got "..type(sep).."] "..
"Called from: "..debugSource.." (line "..debugLine..")",
2
)
error( "Bad argument", 2 )
end

sep = sep or " "

local moneyStr = tostring( math.floor( tonumber( number ) ) )
local isNegative = moneyStr:sub( 1, 1 ) == "-"

if isNegative then
moneyStr = moneyStr:sub( 2 )
end

local len = moneyStr:len( )
for i = 1, math.ceil( len / 3 ) - 1 do
local pos = len - 3 * i + 1
moneyStr = moneyStr:sub( 1, pos - 1 ) .. sep .. moneyStr:sub( pos )
end

return ( isNegative and "-" or "") .. moneyStr
end
</syntaxhighlight>
</section>

==Example==

<section name="Client" class="client" show="true">
This example converts a player's money, and outputs it to the chatbox when they type 'money' into the console:
<syntaxhighlight lang="lua">
function convertPlayerMoney()
local pMoney = getPlayerMoney()
local convertedMoney = formatNumber(pMoney)
outputChatBox(convertedMoney)
end
addCommandHandler("money", convertPlayerMoney)
</syntaxhighlight>

</section>

==See Also==
{{Useful_Functions}}

FormatNumber

2025-04-18T13:47:06Z

Claus: /* Code */

{{Useful Function}} __NOTOC__
This function formats large numbers by adding commas to it. For example, 100000 becomes 100.000<br>

==Syntax==
<syntaxhighlight lang="lua">string formatNumber( int/string number, [ string sep = "." ] )</syntaxhighlight>

===Required Arguments===
* '''number''': The number to be converted.

===Optional Arguments===
* '''sep''': A string of the character you want to split

===Returns===
Returns a string containing the converted number.

==Code==
<section name="Example 1: Shared" class="both" show="true">
<syntaxhighlight lang="lua">
function formatNumber( number, sep )
local debugInfo = debug.getinfo( 2, "Sl" )
local debugSource = debugInfo and debugInfo.short_src or "unknown"
local debugLine = debugInfo and debugInfo.currentline or "unknown"

if not tonumber( number ) then
outputDebugString(
"Bad argument @'formatNumber' [Expected number at argument 1, got "..type(number).."] "..
"Called from: "..debugSource.." (line "..debugLine..")",
2
)
error( "Bad argument", 2 )
end

if sep ~= nil and type( sep ) ~= "string" then
outputDebugString(
"Bad argument @'formatNumber' [Expected string or nil at argument 2, got "..type(sep).."] "..
"Called from: "..debugSource.." (line "..debugLine..")",
2
)
error( "Bad argument", 2 )
end

sep = sep or " "

local moneyStr = tostring( math.floor( tonumber( number ) ) )
local isNegative = moneyStr:sub( 1, 1 ) == "-"

if isNegative then
moneyStr = moneyStr:sub( 2 )
end

local len = moneyStr:len( )
for i = 1, math.ceil( len / 3 ) - 1 do
local pos = len - 3 * i + 1
moneyStr = moneyStr:sub( 1, pos - 1 ) .. sep .. moneyStr:sub( pos )
end

return ( isNegative and "-" or "") .. moneyStr
end
</syntaxhighlight>
</section>

==Example==

<section name="Client" class="client" show="true">
This example converts a player's money, and outputs it to the chatbox when they type 'money' into the console:
<syntaxhighlight lang="lua">
function convertPlayerMoney()
local pMoney = getPlayerMoney()
local convertedMoney = formatNumber(pMoney)
outputChatBox(convertedMoney)
end
addCommandHandler("money", convertPlayerMoney)
</syntaxhighlight>

</section>

==See Also==
{{Useful_Functions}}

Compatibility FAQ

2025-04-14T12:10:50Z

Claus: /* Compatibility Comparison */

== Compatibility Comparison ==
{{Warning|Using the legacy build is not without risk, there are known security issues in the Chrome Embedded Framework (CEF) that MTA:SA 1.5.7 uses for Windows XP and Vista. It is recommended that you upgrade from XP or Vista to a supported Windows version. (Windows XP and Vista are no longer supported by MTA after September 2019.) |true}}
{| class="wikitable"
|-
! Operating System
! Service Pack/Version
! Release Date
! Supported by Microsoft<ref>https://support.microsoft.com/en-us/help/13853/windows-lifecycle-fact-sheet</ref>
! Does MTA:SA {{Current Version|full}} work?
! Chrome Embedded Framework
Updates
! Future MTA:SA
releases/updates
|-
| Windows XP
| Service Pack 3
| August 2001
| {{No}}
| {{No}}
| {{No}}
| {{No|1.5.7 was the last version}}
|-
| Windows Vista
| Service Pack 2
| November 2006
| {{No}}
| {{No}}
| {{No}}
| {{No|1.5.7 was the last version}}
|-
| Windows 7
| Service Pack 1
| July 2009
| {{No}}
| {{Yes}}
| {{Yes}}
| {{Yes}}
|-
| Windows 8.0
| {{n/a}}
| August 2012
| {{No}}
| {{n/a}}
| {{n/a}}
| {{n/a}}
|-
| Windows 8.1
| {{n/a}}
| August 2013
| {{No}}
| {{Yes}}
| {{Yes}}
| {{Yes}}
|-
|rowspan=13 | Windows 10<ref>([https://support.microsoft.com/en-us/help/13853/windows-lifecycle-fact-sheet])</ref>
| 1507
| July 2015
| {{No}}
| {{n/a}}
| {{n/a}}
| {{n/a}}
|-
| 1511
| November 2015
| {{No}}
| {{n/a}}
| {{n/a}}
| {{n/a}}
|-
| 1607
| August 2016
| {{No}}
| {{n/a}}
| {{n/a}}
| {{n/a}}
|-
| 1703
| April 2017
| {{No}}
| {{n/a}}
| {{n/a}}
| {{n/a}}
|-
| 1709
| October 2017
| {{No}}
| {{n/a}}
| {{n/a}}
| {{n/a}}
|-
| 1803
| April 2018
| {{No}}
| {{n/a}}
| {{n/a}}
| {{n/a}}
|-
| 1809
| September 2018
| {{No}}
| {{n/a}}
| {{n/a}}
| {{n/a}}
|-
| 1903
| May 2019
| {{No}}
| {{n/a}}
| {{n/a}}
| {{n/a}}
|-
| 1909
| November 2019
| {{No}}
| {{n/a}}
| {{n/a}}
| {{n/a}}
|-
| 2004
| May 2020
| {{No}}
| {{Yes}}
| {{Yes}}
| {{Yes}}
|-
| 20H2
| October 2020
| {{No}}
| {{Yes}}
| {{Yes}}
| {{Yes}}
|-
| 21H1
| May 2021
| {{No}}
| {{Yes}}
| {{Yes}}
| {{Yes}}
|-
| 21H2
| Nov 2021
| {{Yes}}
| {{Yes}}
| {{Yes}}
| {{Yes}}
|-
|rowspan=3 | Windows 11<ref>([https://support.microsoft.com/en-us/help/13853/windows-lifecycle-fact-sheet])</ref>
| 21H2
| October 2021
| {{Yes}}
| {{Yes}}
| {{Yes}}
| {{Yes}}
|-
| 22H2
| September 2022
| {{Yes}}
| {{Yes}}
| {{Yes}}
| {{Yes}}
|-
| 23H2
| October 2023
| {{Yes}}
| {{Yes}}
| {{Yes}}
| {{Yes}}
|-
|}

* Please use a supported version of Windows 10 to run MTA.
* There are no guarantees that MTA will work on older not by Microsoft supported Windows 8 and 10 versions.

== FAQ - Frequently Asked Questions ==
=== Google is dropping XP/Vista support for Chrome browser? What does this even have to do with MTA:SA? ===
As you may know from our previous [https://forum.mtasa.com/topic/75559-mtasa-15-release-candidate-is-ready-for-testing/ news posts], MTA:SA uses CEF (Chrome Embedded Framework) components for providing some functionality for the mod since version 1.5. Being Chromium-based, CEF components are also being phased out for users of older Operating Systems and will simply not work on them.<ref>https://bitbucket.org/chromiumembedded/cef</ref>

=== Does MTA:SA 1.5.7 work fine on Windows XP and Windows Vista? ===
Yes, it works fine if you install it through the legacy build. We still can not really recommend using these systems anymore due to the reasons listed below.

CEF compatibility issue aside, these Operating Systems (XP especially) are really old nowadays. You are putting yourself at risk if you use them as they are either no longer supported by Microsoft (XP) or the support will be discontinued soon (April 2017 - Vista).

=== What will happen if I try to use the regular build of 1.5.7 on Windows XP/Vista? ===
MTA:SA installer will display an error and will not let you install the mod on such systems. You will be asked to download the legacy build from our website.

=== And what will happen if I try to use the legacy build of 1.5.7 on Windows 7 and above? ===
Similarly, MTA:SA installer will display an error and will not let you install the mod on such systems. You will be asked to download the regular build from our website.

=== Why couldn't you just stick to the older version of CEF then so that XP/Vista would be still supported? / What about releasing two versions of the mod? A regular one with newest CEF and a legacy one with the older CEF build that still works on XP/Vista? ===
Hey, but we actually do provide a legacy build for MTA:SA 1.5.7 for XP/Vista users with an older version of CEF components.

The problem with sticking with either of these options is that we would have to continue providing a version that is vulnerable to any present and future security exploits that exist in Chromium and are already widely used. We do not want to put our users at risk because of that. CEF developers themselves do not want to provide long-term security support for such a build either. <ref>http://www.magpcss.org/ceforum/viewtopic.php?f=6&t=14187</ref>

=== I am playing the mod on Windows 7/Windows 8/Windows 8.1/Windows 10 or newer. Am I affected by this? ===
No, you will not be affected at all. In fact, you will have a better experience with built-in web browser components than before due to security and performance fixes included in the newer CEF versions.

=== I am using Windows XP/Vista and I would still like to play future versions of MTA:SA. What can I do about it? ===
If you are using Windows XP or Windows Vista, you should upgrade your OS to a newer one. You will likely be required to do a clean install for that, so back up your stuff first. You should use these tools first to see if your PC is capable of upgrading to newer OS:

Windows 7: [https://www.microsoft.com/en-us/download/details.aspx?id=20 Windows 7 Upgrade Advisor]
Windows 8/10: [http://go.microsoft.com/fwlink?linkid=259439 Windows 8 Upgrade Assistant]

Is your PC toaster-tier which does not support Windows 8 or even 7? That means it is probably the right time to buy something more modern.

But fear not, if you are already using Windows 7 or newer, just install the newest build of MTA:SA 1.5.7 and you are set! And if you don't want to upgrade your OS or PC, well, we will keep offering the legacy build that works on XP/Vista for a while...

== Notes ==
<references />

== See also ==
* [https://forum.mtasa.com/topic/89685-mtasa-windows-xpvista-cef-components-and-you/ Topic about the compatibility changes]

Client Manual

2025-04-14T09:10:12Z

Claus: /* Launching MTA */

This article will guide you through the initial installation of '''Multi Theft Auto: San Andreas'''. You can also find a short introduction on how to play on an MTA server.

==Before you start==
[[File:Emblem-important.svg|24px]] '''Before you install Multi Theft Auto: San Andreas, make sure that you have GTA:SA installed (see [[Where to buy GTASA]])''', and that it contains no modifications (these may conflict with MTA). If you would like to keep your single-player mods, you can create two installations by reinstalling GTA: San Andreas to a second folder on your hard drive.

Also, make sure 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.

===System requirements===
====Minimum 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:
* Windows 7 or newer (Microsoft supported) operating system ([[Compatibility FAQ|XP and Vista do not work and are obsolete]])
* Intel Pentium 4 or AMD Athlon XP
* 1 GB RAM
* Clean installation of Grand Theft Auto: San Andreas, version 1.0 (American or European)
* 3.7GB of free hard disk space (3.6GB for a minimum Grand Theft Auto installation; remember that MTA caches files from the servers that you play on and require disk space)
* Nvidia GeForce 4 series or ATI Radeon 8xxx series (64MB VRAM and DirectX 9.0 compatible)
* DirectX 9.0 compatible sound card
* Keyboard and mouse
* Internet access

====Recommended system requirements====
* Windows 10 operating system
* Intel Core 2 Duo Processor or AMD equivalent
* 2 GB RAM
* Clean installation of Grand Theft Auto: San Andreas, version 1.0 (American or European)
* >5GB of free hard disk space (Remember that MTA caches files from the servers that you play on and require disk space)
* Nvidia GeForce FX series or higher, ATI Radeon 9xxx series or higher, Pixel Shader 2.0 compatible
* DirectX 9.0 compatible sound card
* Keyboard and mouse
* Broadband internet access (for smooth online play)

====Notes====
* The minimum system requirements are considered the bare minimum for MTA: San Andreas, the performance can depend on the game modes that are running and the player count.
* For extra loading performance, more RAM is recommended.
* Make sure Windows is fully up to date.
* Make sure you head over to the [[Known_Issues_-_FAQ|Known Issues]] page if you have issues, or join us on [https://discord.com/invite/mtasa Discord] and do so in the #help-support channel.

==Installing MTA==
# '''If you haven't already, ensure GTA: San Andreas is installed on your PC. See [[Where to buy GTASA]] for information on how to obtain the game.'''
# Download the MTA:SA client from the download page at [http://multitheftauto.com multitheftauto.com].
# Run the installer. For Windows Vista and 7 it is required to run this with administrator rights (the installer will ask.)
# You need to accept the license that comes with MTA:SA (GPLv3).
# You will be asked which components to install:
#* '''Game Client''' interfaces with the game and is a required component. '''This is enough to play on multiplayer servers.'''
#* '''Dedicated Server''' enables you to host your own home-brew server.
#** '''Core components''' and '''Game module''' are required components for the dedicated server.
#** '''Core resources''' required resources for dedicated server.
#** '''Optional resources''' additional resources for your dedicated server, gamemodes and maps.
#** '''Editor''' is used to create new maps, this is an optional component.
#* '''Development''' development tools.
#** '''Module SDK''' development SDK for creating your own MTA server modules, this component requires C++ knowledge.
#* '''Start menu group''' creates a start menu group for the installed components.
#* '''Desktop icon''' creates a desktop icon for the client.
# You are then asked for a folder in which to install MTA. This can by anywhere and '''should not be in you San Andreas directory'''. Avoid special folders like OneDrive or other cloud-synced directories.
# 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\'''. '''Reminder: you need to have the game installed before installing MTA. See [[Where to buy GTASA]].'''
# When the installation completes, 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 San Andreas'' from your Start Menu if you wish to play.

==Launching MTA==
# 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 (you could also watch a how-to tutorial [http://www.youtube.com/watch?v=ShiqnOazNYw here]):

{| border="0" align="center"

| width="188" |
[[File:Server Browser List.png|600px|center]]
| width="380" |
<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 />
|-
| width="188" |
[[File:Host Game 1.6.png|300px|center]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Host game''' – this allows you to start a local server. </font>

<br />
|-
| width="188" |
[[File:Menu Settings 1.6.png|300px|center]]
| width="380" |
<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 />
|-
| width="188" |
[[File:About Menu 1.6.png|300px|center]]
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''About '''– this gives you a list of contributors to the project.</font>

<br />
|-
| width="188" |
[[Image:Map_Editor.jpg|280px|center]]
| width="380" |
<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 />
|-
| width="188" |
<br>
| width="380" |
<font size="-1" face="tahoma,helvetica,arial,sans-serif">'''Quit '''– this returns you back to your Windows desktop.</font>

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

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

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.

==Default Controls==

===In-Game Keys===

* F8 (or Tilde Key) - Console
* F11 - Show SA map ''(the following list is for use when the map is up)''
**numpad /- - Zoom in and out
**numpad 4, 8, 6, 2 - move map left, up, right, down
**numpad 0 - toggle between attach to local player (map follows player blip) and free move (map stays stationary)
* F12 - Take a screenshot
* T - Chat
* Y - Team Chat

===Resource Specific Keys===
These keys depend on the scripts that are running on the server.

* F9 - In-game help (Help manager resource)
* Z - Push to talk, if voice is enabled on the server.
* 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 necessary 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.

;'''sver''' :This displays the version number of the server you are connected to.

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

For information on more commands see: [[Client Commands]]

==Error codes and their meanings==
=== Download errors ===
:{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
!Code
!scope="col" class="unsortable" | Meaning
|-
|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===
:{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
!Code
!scope="col" class="unsortable" | Meaning
|-
|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
|}

==='Unable to enter vehicle' errors===
:{| class="wikitable sortable" style="width: auto; table-layout: fixed;"
|-
!Code
!scope="col" class="unsortable" | Meaning
|-
|1
|script cancelled
|-
|2
|script cancelled (jack)
|-
|3
|current occupier is entering/exiting
|-
|4
|invalid seat
|-
|5
|not close enough
|-
|6
|already in a vehicle
|-
|7
|already entering/exiting
|-
|8
|invalid vehicle (trailer)
|}

==Special: Playing MTA on Linux, macOS or Steam Deck?==
If you're one of those who use other precious systems, and want to have the client working on your device,
please read the [[Client on Linux Manual]], [[Client on Mac OS X Manual]] or [[Client on Steam Deck Manual]].

[[ar:دليل_اللاعب]]
[[cs:Client Manual]]
[[de:MTA DM Client Anleitung]]
[[en:Client Manual]]
[[es:Manual Cliente Deathmatch]]
[[fr:Manuel Client]]
[[hu:Client Manual]]
[[it:Manuale del Client]]
[[nl:Deathmatch Client Manual]]
[[pl:Client Manual]]
[[pt-br:Manual do Cliente]]
[[ru:Deathmatch Client Manual]]
[[zh-cn:客户端手册]]

[[Category:Support]]

File:About Menu 1.6.png

2025-04-14T09:08:17Z

Claus:

About Menu 1.6

File:Menu Settings 1.6.png

2025-04-14T09:07:57Z

Claus:

Menu Settings 1.6

File:Host Game 1.6.png

2025-04-14T09:06:51Z

Claus:

Host Game 1.6

File:Server Browser List.png

2025-04-14T09:01:00Z

Claus:

Browse servers – this allows you to receive a list of available servers to play on.

Building MTASA Server on GNU Linux

2025-04-14T08:30:30Z

Claus: /* Ubuntu Linux */

{{Needs Checking|Confirm steps work.}}

== Installing and Running MTASA server on Linux ==
{{Note|This article is only for developers who changed the server code. If you are looking for the precompiled server (for normal server owners). Go to: [http://linux.mtasa.com/ linux.mtasa.com] and see [[Installing and Running MTASA Server on GNU_Linux]]}}


== Preparing your system ==

In order to build the Multi Theft Auto dedicated server, you will have to set up your system with the correct libraries and tools. How these are installed depends on your distribution.

Our network module (net.dll or net.so) is distributed as a precompiled binary library. The file for GNU/Linux can be found inside the lastest Linux nightly from [http://nightly.mtasa.com/ here]. Use the net.so from {{Current Version|master}} if you are compiling from the trunk, or the net.so from {{Current Version|full}} if you are compiling the {{Current Version|full}} branch. Be sure the read the top of ''Server/version.h'' as it contains directions on how to compile the different build types.

=== Ubuntu 20.04 ===

The following instructions are specifically for Ubuntu 20.04.

You will need to install the required build tools, headers, and libraries. These can be installed using the following packages:

* '''build-essential:''' provides tools, headers, and libraries required to build applications
* '''automake:''' provides tools for automatically generating Makefiles
* '''libtool:''' required for building shared libraries
* '''libreadline-gplv2-dev:''' provides the GNU readline library (version 5)
* '''libncurses5-dev:''' provides tools for writing to the console screen
* '''libncursesw5-dev:''' provides wide character support for ncurses
* '''default-libmysqlclient-dev:''' provides the MySQL client development files
* '''git:''' version control tool used to clone the code repository
* '''unzip:''' archive unpacking utility

To install all required packages, run the following commands in the terminal (execute as root):

apt-get update
apt-get install build-essential automake libtool
apt-get install libreadline-gplv2-dev libncurses5-dev libncursesw5-dev
apt-get install default-libmysqlclient-dev git unzip

=== Gentoo Linux ===
You will need the necessary build tools, headers and libraries. Because Gentoo’s portage system is designed to compile any packages on your own system, the necessary build tools will have already been installed. This only leaves you to install the necessary libraries:


* '''git:''' contains the git client used to check out our code repository
To compile and install these packages through ''emerge'', use the '''emerge -v <package list>''' command. The -v option shows additional * * information and can be omitted. (If you want to use any USE flags, prepend emerge with USE="use flags here". You can also use the -pv option to verify that you’re using the correct flags.) Refer to the [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=1 Gentoo Handbook] or manual for more information on emerge.

Example:

emerge -v git sqlite
USE=“net-misc/curl ssl” emerge -v curl

=== Fedora ===

You will need these packages to be able to successfully compile a MTA server on Fedora:
* '''glibc-devel:'''

* '''readline-devel:''' contains the readline library

* '''git:''' contains the git client to check out the source code
To install these packages through yum, use the yum install <package list> command as in the following example (execute as root):

yum install glibc-devel readline-devel git

== General instructions for {{Current Version|master}} ==

'''Downloading the source.'''

First, you need to download the source. Either clone as shown below or [https://github.com/multitheftauto/mtasa-blue/archive/master.zip download a zip snapshot]

git clone <nowiki>https</nowiki>://github.com/multitheftauto/mtasa-blue.git mtasa-blue
cd mtasa-blue

Then compile it thus:

./linux-build.sh

Then copy the configuration files, network module and resources into '''Bin/server''' by running this command:

./linux-install-data.sh

And the resources and stuff should be downloaded and stuff. As well as the net_d.dll file.

=== '''Troubleshooting''' ===

If you’re getting any unexpected errors while compiling, please check our [https://github.com/multitheftauto/mtasa-blue/issues GitHub issues] or our [https://discord.com/invite/GNN6PRtTnu development-focused Discord server].

<ul>
<li>If you get a message saying "Killed" when running premake5 gmake (linux-build.sh), that usually means you ran out of memory.<br />
You can confirm this by searching for kill logs by running <code>sudo dmesg | grep -i kill</code><br />
A possible solution for this might be to [https://opensource.com/article/18/9/swap-space-linux-systems turn on swap] or upgrade your system memory temporarily.<br />
1 GB is likely '''not''' enough of memory to complete the build.
</li>
</ul>

[[ru:Building MTASA Server on GNU Linux]]
[[Category: Development]]