Multi Theft Auto: Wiki - User contributions [en]

User:Dpower

2015-09-01T14:10:26Z

Dpower: Blanked the page

Installing and Running MTASA Server on GNU Linux

2014-06-09T15:46:31Z

Dpower: /* 64 bit Debian/Ubuntu */

== Installation ==

=== Main binary ===
Download the latest stable Linux binaries from here:
wget <nowiki>http</nowiki>://linux.mtasa.com/dl/135/multitheftauto_linux-{{Current Version|full}}.tar.gz

Unpack into a directory:
tar -xf multitheftauto_linux*

=== Default config ===
Download the default config files:
wget <nowiki>http</nowiki>://linux.mtasa.com/dl/135/baseconfig-{{Current Version|full}}.tar.gz

Unpack and move into the deathmatch directory:<br/>
('''''Note:''' Only do this for new installations as it will overwrite any existing config files.)''
tar -xf baseconfig*
mv baseconfig*/* multitheftauto_linux*/mods/deathmatch



=== Test ===
You can now test if the server will start correctly, by entering the install directory:
cd multitheftauto_linux*

and launching:
./mta-server

== Running with 32 or 64 bit Linux==
=== Make sure your server libraries and stuff are up to date ===
On Debian/Ubuntu this is done with:
apt-get update
apt-get upgrade

== Running with 32 bit Linux ==
===32 bit Troubleshooting===
* If you get a problem with such as "libreadline.so.5: cannot open shared object file: No such file or directory.", it can be solved on 32 bit Debian/Ubuntu by doing this:

apt-get install libreadline5

* If you get a problem with such as "libncursesw.so.5 cannot open shared object file: No such file or directory", it can be solved on 32 bit Debian/Ubuntu by doing this:

apt-get install libncursesw5

== Running with 64 bit Linux ==
===Debian 7 (wheezy) 64 bit===
Before running MTASA Server, use this command line for installation of 32 bit libs :<br/>

apt-get install lib32ncursesw5 lib32readline5

===Install 32 bit libs for your 64 bit distro===
For 64 bit Debian 6, this is achieved with:<br/>
''(Some 64 bit distros have 32 bit libs already installed for you. So this step might not be required)''

apt-get install ia32-libs

===64 bit Troubleshooting===
====64 bit Debian/Ubuntu====
* If you get a problem with such as "libstdc++.so.6: cannot open shared object file: No such file or directory.", it can be solved on 64 bit Debian/Ubuntu by doing this:

apt-get install lib32stdc++6

* If you get a problem with such as "libz.so.1: cannot open shared object file: No such file or directory.", it can be solved on 64 bit Debian/Ubuntu by doing this:

apt-get install lib32z1

* If you get a problem with such as "libreadline.so.5: cannot open shared object file: No such file or directory.", it can be solved on 64 bit Debian/Ubuntu by doing this:

apt-get install lib32readline5

* If you get a problem with such as "libncursesw.so.5 cannot open shared object file: No such file or directory", it can be solved on 64 bit Debian/Ubuntu by doing this:

apt-get install lib32ncursesw5

====64 bit CentOS 6====
* If you get a problem with such as "libreadline.so.5: cannot open shared object file: No such file or directory.", edit '''''/etc/yum.conf''''' and add this line:
multilib_policy=all
Then issue this command:
yum install compat-readline5
* Further 64 bit solutions can be found [http://forum.mtasa.com/viewtopic.php?f=106&t=35328#p367282 on the forums]

== MySQL Troubleshooting==
* If you are using the inbuild MySQL functions such as [[dbConnect]] and [[dbQuery]], you will need to have '''libmysqlclient.so.15''' installed.
* If you can't get '''libmysqlclient.so.15''' installed by conventional means, then try [http://nightly.mtasa.com/files/libmysqlclient.so.15 downloading the file from here] and copying it to your Linux server '''/usr/lib/''' directory.

==Cent OS Troubleshooting==
* If you are using Cent OS and you get something like /usr/lib/libstdc++.so.6: version `GLIBCXX_3.4.9' not found (required by xmll.so) this can be resolved by doing downloading the archive [[http://archives.fedoraproject.org/pub/archive/fedora/linux/releases/9/Fedora/i386/os/Packages/libstdc++-4.3.0-8.i386.rpm here]] and unpacking it with the following command:

rpm2cpio libstdc++-4.3.0-8.i386.rpm | cpio -i --make-directories

== Server crashes ==

If your Linux server crashes, please obtain a backtrace and post a report on our [http://bugs.mtasa.com/ Bug tracker]

====To obtain a backtrace:====
===Do you have a core dump file in the the MTA server directory?===
It's usually called 'core', and usually over 100MB, and looks something like this:
[[Image:Core.png]]
====If you have a core dump file in the the MTA server directory:====
*Install gdb. To install gdb on Debian, use this command:
apt-get install gdb
*And from the MTA install directory do this command
gdb mta-server -c core
*When gdb launches, do this command to get a module list:
i sh
*And then this command to get a backtrace:
bt
*Save the output
*(To exit gdb, use the quit command)

====If you do not have a core dump file in the the MTA server directory:====
*Install gdb. To install gdb on Debian, use this command:
apt-get install gdb
*And from the MTA server directory start the mta-server like this:
gdb mta-server -ex "set print thread-events off" --eval-command run
*Now wait for a crash. (Ignore any weird screen output in the meantime)
*When a crash occurs, do this command to get a module list:
i sh
*And then this command to get a backtrace:
bt
*Save the output
*(To exit gdb, use the quit command)

== '''Server freezes''' ==

If your Linux server freezes, please obtain a backtrace with thread information and post a report on our [http://bugs.mtasa.com/ Bug tracker]

====To obtain a backtrace with thread information:====
*Install gdb. To install gdb on Debian, use this command:
apt-get install gdb
*And from the MTA server directory start the mta-server like this:
gdb mta-server -ex "set print thread-events off" --eval-command run
*Now wait for a freeze. (Ignore any weird screen output in the meantime)
*When a freeze occurs, press ctrl-c to start gdb
*Then do this command to get a module list:
i sh
*And then this command to get a backtrace:
bt
*And then this command to get thread information:
info threads
*Save the output
*(To exit gdb, use the quit command)

PregReplace

2013-06-06T11:04:56Z

Dpower:

__NOTOC__
{{Server client function}}
{{New feature/item|4.014|1.4|5106|
This function performs a regular expression search and replace and returns the replaced string.
}}

==Syntax==
<syntaxhighlight lang="lua">
string pregReplace ( string subject, string pattern, string replacement )
</syntaxhighlight>

===Required Arguments===
*'''subject:''' The input [[string]].
*'''pattern:''' The pattern [[string]] to search for in the input [[string]].
*'''replacement:''' The replacement [[string]] to replace all matches within the input [[string]].

===Returns===
Returns the replaced ''[[string]]'', or [[bool]] ''false'' otherwise.

==Example==
<section name="Shared ( client and server )" class="both" show="true">
Some examples:
<syntaxhighlight lang="lua">
addCommandHandler( 'examples',
function( )
-- Replace doh with done
outputDebugString( pregReplace( 'I doh this, guys.', 'doh', 'done' ) or 'not replaced' ) -- Result: I done this, guys
-- Remove all uppercase alphabetic characters
outputDebugString( pregReplace( 'AaaBbbZzz', '[A-Z]{1,}', '' ) or 'not replaced' ) -- Result: aabbzz
end
)
</syntaxhighlight>
</section>

==Requirements==
{{Requirements|1.4-9.05106|1.4-9.05106|}}

==See Also==
{{Utility_functions}}

PregReplace

2013-06-06T11:04:21Z

Dpower:

__NOTOC__
{{Server client function}}
{{New feature/item|4.014|1.4|5106|
This function performs a regular expression search and replace on an input string and returns the replaced string.
}}

==Syntax==
<syntaxhighlight lang="lua">
string pregReplace ( string subject, string pattern, string replacement )
</syntaxhighlight>

===Required Arguments===
*'''subject:''' The input [[string]].
*'''pattern:''' The pattern [[string]] to search for in the input [[string]].
*'''replacement:''' The replacement [[string]] to replace all matches within the input [[string]].

===Returns===
Returns the replaced ''[[string]]'', or [[bool]] ''false'' otherwise.

==Example==
<section name="Shared ( client and server )" class="both" show="true">
Some examples:
<syntaxhighlight lang="lua">
addCommandHandler( 'examples',
function( )
-- Replace doh with done
outputDebugString( pregReplace( 'I doh this, guys.', 'doh', 'done' ) or 'not replaced' ) -- Result: I done this, guys
-- Remove all uppercase alphabetic characters
outputDebugString( pregReplace( 'AaaBbbZzz', '[A-Z]{1,}', '' ) or 'not replaced' ) -- Result: aabbzz
end
)
</syntaxhighlight>
</section>

==Requirements==
{{Requirements|1.4-9.05106|1.4-9.05106|}}

==See Also==
{{Utility_functions}}

PregFind

2013-06-06T10:52:05Z

Dpower: /* Example */

__NOTOC__
{{Server client function}}
{{New feature/item|4.014|1.4|5106|
This function stops at the first occurrence of the pattern in the input string and returns the result of the search.
}}

==Syntax==
<syntaxhighlight lang="lua">
bool pregFind ( string subject, string pattern )
</syntaxhighlight>

===Required Arguments===
*'''subject:''' The input [[string]]
*'''pattern:''' The pattern [[string]] to search for in the input [[string]].

===Returns===
Returns ''true'' if the pattern was found in the input string, ''false'' otherwise.

==Example==
<section name="Shared ( client and server )" class="both" show="true">
Some examples:
<syntaxhighlight lang="lua">
addCommandHandler( 'examples',
function( )
-- find the first occurrence of 'hello world' in a string
outputDebugString( pregFind( 'hello world, hello world, hello world', 'hello world' ) and 'found' or 'not found' ) -- found
-- find the first occurrence of an integer in a string
outputDebugString( pregFind( '123', '^-{0,1}\\d+$' ) and 'found' or 'not found' ) -- found
-- check if the input string consists of at least 3 letters from a to z (both uppercase and lowercase) and does not contain any whitespace characters
outputDebugString( pregFind( 'Kenix', '^[a-zA-Z]{3,}$' ) and 'found' or 'not found' ) -- found
-- check if the input string matches the format of a role-play name
outputDebugString( pregFind( 'Garry_Newman', '([A-Z]{1,1})[a-z]{2,9}_([A-Z]{1,1})[a-z]{2,9}' ) and 'found' or 'not found' ) -- found
-- example of a search for non-ASCII characters (i.e. cyrillic) - привет
outputDebugString( pregFind( 'Всем привет парни, ещё раз привет :D', 'привет' ) and 'found' or 'not found' ) -- found
-- example of a search for a specific sequence of numbers
outputDebugString( pregFind( '5, 10', '^([1-9]{1}[0-9]{0,})+(((,\s|,)[1-9]{1}[0-9]{0,}){0,1}){1,1}' ) and 'found' or 'not found' ) -- found
end
)
</syntaxhighlight>
</section>

==Requirements==
{{Requirements|1.4-9.05106|1.4-9.05106|}}

==See Also==
{{Utility_functions}}

PregFind

2013-06-06T10:50:40Z

Dpower: grammar again

__NOTOC__
{{Server client function}}
{{New feature/item|4.014|1.4|5106|
This function stops at the first occurrence of the pattern in the input string and returns the result of the search.
}}

==Syntax==
<syntaxhighlight lang="lua">
bool pregFind ( string subject, string pattern )
</syntaxhighlight>

===Required Arguments===
*'''subject:''' The input [[string]]
*'''pattern:''' The pattern [[string]] to search for in the input [[string]].

===Returns===
Returns ''true'' if the pattern was found in the input string, ''false'' otherwise.

==Example==
<section name="Shared ( client and server )" class="both" show="true">
Some examples:
<syntaxhighlight lang="lua">
addCommandHandler( 'examples',
function( )
-- find the first occurrence of 'hello world' in a string
outputDebugString( pregFind( 'hello world, hello world, hello world', 'hello world' ) and 'found' or 'not found' ) -- found
-- find the first occurrence of an integer in a string
outputDebugString( pregFind( '123', '^-{0,1}\\d+$' ) and 'found' or 'not found' ) -- found
-- check if the input string consists of at least 3 letters from a to z and A-Z and does not contain any whitespace characters
outputDebugString( pregFind( 'Kenix', '^[a-zA-Z]{3,}$' ) and 'found' or 'not found' ) -- found
-- check if the input string matches the format of a role-play name
outputDebugString( pregFind( 'Garry_Newman', '([A-Z]{1,1})[a-z]{2,9}_([A-Z]{1,1})[a-z]{2,9}' ) and 'found' or 'not found' ) -- found
-- example of a search for non-ASCII characters (i.e. cyrillic) - привет
outputDebugString( pregFind( 'Всем привет парни, ещё раз привет :D', 'привет' ) and 'found' or 'not found' ) -- found
-- example of a search for a specific sequence of numbers
outputDebugString( pregFind( '5, 10', '^([1-9]{1}[0-9]{0,})+(((,\s|,)[1-9]{1}[0-9]{0,}){0,1}){1,1}' ) and 'found' or 'not found' ) -- found
end
)
</syntaxhighlight>
</section>

==Requirements==
{{Requirements|1.4-9.05106|1.4-9.05106|}}

==See Also==
{{Utility_functions}}

PregFind

2013-06-06T10:40:43Z

Dpower: /* Syntax */ Grammar?!

__NOTOC__
{{Server client function}}
{{New feature/item|4.014|1.4|5106|
This function find only one match and when match is founded stop working and return a result.
}}

==Syntax==
<syntaxhighlight lang="lua">
bool pregFind ( string subject, string pattern )
</syntaxhighlight>

===Required Arguments===
*'''subject:''' The input [[string]]
*'''pattern:''' The pattern [[string]] to search for in the input [[string]].

===Returns===
Returns ''true'' if the pattern was found in the input string, ''false'' otherwise.

==Example==
<section name="Shared ( client and server )" class="both" show="true">
Some examples:
<syntaxhighlight lang="lua">
addCommandHandler( 'examples',
function( )
-- hello word find
outputDebugString( pregFind( 'hello world, hello world, hello world', 'hello world' ) and 'found' or 'not found' ) -- found
-- integer number find
outputDebugString( pregFind( '123', '^-{0,1}\\d+$' ) and 'found' or 'not found' ) -- found
-- Login with a-z and A-Z symbols and have more 3 symbols and without any spaces
outputDebugString( pregFind( 'Kenix', '^[a-zA-Z]{3,}$' ) and 'found' or 'not found' ) -- found
-- RP nickname check
outputDebugString( pregFind( 'Garry_Newman', '([A-Z]{1,1})[a-z]{2,9}_([A-Z]{1,1})[a-z]{2,9}' ) and 'found' or 'not found' ) -- found
-- Russian hello ( привет ) find
outputDebugString( pregFind( 'Всем привет парни, ещё раз привет :D', 'привет' ) and 'found' or 'not found' ) -- found
-- Sequence of numbers
outputDebugString( pregFind( '5, 10', '^([1-9]{1}[0-9]{0,})+(((,\s|,)[1-9]{1}[0-9]{0,}){0,1}){1,1}' ) and 'found' or 'not found' ) -- found
end
)
</syntaxhighlight>
</section>

==Requirements==
{{Requirements|1.4-9.05106|1.4-9.05106|}}

==See Also==
{{Utility_functions}}

DxDrawLine

2011-12-26T19:29:07Z

Dpower: /* Example */

__NOTOC__
{{Client function}}
This function draws a 2D line across the screen - rendered for '''one''' frame. This should be used in conjunction with [[onClientRender]] in order to display continuously.

==Syntax==
<syntaxhighlight lang="lua">
bool dxDrawLine ( int startX, int startY, int endX, int endY, int color, [float width=1, bool postGUI=false] )
</syntaxhighlight>

===Required Arguments===
* '''startX:''' An integer representing the '''absolute''' start X position of the line, represented by pixels on the screen.
* '''startY:''' An integer representing the '''absolute''' start Y position of the line, represented by pixels on the screen.
* '''endX:''' An integer representing the '''absolute''' end X position of the line, represented by pixels on the screen.
* '''endY:''' An integer representing the '''absolute''' end Y position of the line, represented by pixels on the screen.
* '''color:''' An integer of the hex color, produced using [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).

==Optional Arguments==
{{OptionalArg}}
* '''width:''' The width/thickness of the line
* '''postGUI:''' A bool representing whether the line should be drawn on top of or behind any ingame GUI (rendered by CEGUI).

===Returns===
Returns a true if the operation was successful, false otherwise.

==Example==
<section name="Client" class="client" show="true">
Example code for drawing crosshair for Tank.
<syntaxhighlight lang="lua">
local width, height = guiGetScreenSize ( ) -- Get player's screen resolution (width and height).
local centerX, centerY = ( width / 2 ), ( height / 2 ) -- Get x and y co-ordinates of the center of the screen.
local colGreen = tocolor ( 0, 255, 0, 255 ) -- Get green color.

function create2DLine ( )
dxDrawLine ( centerX, centerY - 200, centerX, centerY - 170, colGreen, 1 ) -- Draw vertical crosshair line
dxDrawLine ( centerY - 20, centerY - 185, centerX + 20, centerY - 185, colGreen, 1 ) -- Draw horizontal crosshair line
end

function HandleTheRendering ( )
addEventHandler ( "onClientRender", root, create2DLine) -- Keep the line visible with onClientRender event.
end

addEventHandler ( "onClientResourceStart", resourceRoot, HandleTheRendering )
</syntaxhighlight>
</section>

==See Also==
{{Drawing_functions}}

DxDrawLine

2011-12-26T19:28:44Z

Dpower: /* Example */

__NOTOC__
{{Client function}}
This function draws a 2D line across the screen - rendered for '''one''' frame. This should be used in conjunction with [[onClientRender]] in order to display continuously.

==Syntax==
<syntaxhighlight lang="lua">
bool dxDrawLine ( int startX, int startY, int endX, int endY, int color, [float width=1, bool postGUI=false] )
</syntaxhighlight>

===Required Arguments===
* '''startX:''' An integer representing the '''absolute''' start X position of the line, represented by pixels on the screen.
* '''startY:''' An integer representing the '''absolute''' start Y position of the line, represented by pixels on the screen.
* '''endX:''' An integer representing the '''absolute''' end X position of the line, represented by pixels on the screen.
* '''endY:''' An integer representing the '''absolute''' end Y position of the line, represented by pixels on the screen.
* '''color:''' An integer of the hex color, produced using [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).

==Optional Arguments==
{{OptionalArg}}
* '''width:''' The width/thickness of the line
* '''postGUI:''' A bool representing whether the line should be drawn on top of or behind any ingame GUI (rendered by CEGUI).

===Returns===
Returns a true if the operation was successful, false otherwise.

==Example==
<section name="Client" class="client" show="true">
Example code for drawing crosshair for Tank.
<syntaxhighlight lang="lua">
local width, height = guiGetScreenSize ( ) -- Get player's screen resolution (width and height).
local centerX, centerY = ( x / 2 ), ( y / 2 ) -- Get x and y co-ordinates of the center of the screen.
local colGreen = tocolor ( 0, 255, 0, 255 ) -- Get green color.

function create2DLine ( )
dxDrawLine ( centerX, centerY - 200, centerX, centerY - 170, colGreen, 1 ) -- Draw vertical crosshair line
dxDrawLine ( centerY - 20, centerY - 185, centerX + 20, centerY - 185, colGreen, 1 ) -- Draw horizontal crosshair line
end

function HandleTheRendering ( )
addEventHandler ( "onClientRender", root, create2DLine) -- Keep the line visible with onClientRender event.
end

addEventHandler ( "onClientResourceStart", resourceRoot, HandleTheRendering )
</syntaxhighlight>
</section>

==See Also==
{{Drawing_functions}}

DxDrawText

2011-12-26T19:16:42Z

Dpower:

__NOTOC__
{{Client function}}

Draws a string of text on the screen for one frame. In order for the text to stay visible continuously, you need to call this function with the same parameters on each frame update (see [[onClientRender]]).

==Syntax==
<syntaxhighlight lang="lua">
bool dxDrawText ( string text, int left, int top [, int right=left, int bottom=top, int color=white,
float scale=1, mixed font="default", string alignX="left", string alignY="top",
bool clip=false, bool wordBreak=false, bool postGUI ] )
</syntaxhighlight>

===Required Arguments===
*'''text:''' the text to draw
*'''left:''' the absolute X coordinate of the top left corner of the text
*'''top:''' the absolute Y coordinate of the top left corner of the text

===Optional Arguments===
*'''right:''' the absolute X coordinate of the right side of the text bounding box. Used for text aligning, clipping and word breaking.
*'''bottom:''' the absolute Y coordinate of the bottom side of the text bounding box. Used for text aligning, clipping and word breaking.
*'''color:''' the color of the text, a value produced by [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue).
*'''scale:''' the size of the text.{{New feature|3.0110|1.1|'''scale:''' can (optionally) be specified as two floats. i.e. '''scaleX, scaleY'''}}
*'''font:''' Either a custom [[DX font]] element or the name of a built-in DX font:
{{DxFonts}}
*'''alignX:''' horizontal alignment of the text within the bounding box. Can be '''"left"''', '''"center"''' or '''"right"'''.
*'''alignY:''' vertical alignment of the text within the bounding box. Can be '''"top"''', '''"center"''' or '''"bottom"'''.
*'''clip:''' if set to ''true'', the parts of the text that don't fit within the bounding box will be cut off.
*'''wordBreak:''' if set to ''true'', the text will wrap to a new line whenever it reaches the right side of the bounding box. If ''false'', the text will always be completely on one line.
* '''postGUI:''' A bool representing whether the text should be drawn on top of or behind any ingame GUI (rendered by CEGUI).

===Returns===
Returns ''true'' if successful, ''false'' otherwise.

==Example==
<section name="Client" class="client" show="true">
This example code will add current zone name in the lower left corner of player's screens.
<syntaxhighlight lang="lua">
local screenWidth, screenHeight = guiGetScreenSize ( ) -- Get the screen resolution (width and height)

function createText ( )
local playerX, playerY, playerZ = getElementPosition ( localPlayer ) -- Get our player's coordinates.
local playerZoneName = getZoneName ( playerX, playerY, playerZ ) -- Get name of the zone the player is in.

-- Draw zone name text's shadow.
dxDrawText ( playerZoneName, 44, screenHeight - 41, screenWidth, screenHeight, tocolor ( 0, 0, 0, 255 ), 1.02, "pricedown" )
-- Draw zone name text.
dxDrawText ( playerZoneName, 44, screenHeight - 43, screenWidth, screenHeight, tocolor ( 255, 255, 255, 255 ), 1, "pricedown" )
end

function HandleTheRendering ( )
addEventHandler ( "onClientRender", root, createText ) -- keep the text visible with onClientRender.
end

addEventHandler ( "onClientResourceStart", resourceRoot, HandleTheRendering )
</syntaxhighlight>
</section>

==See Also==
{{Drawing_functions}}

AddBan

2011-12-26T19:04:49Z

Dpower:

__NOTOC__
{{Server function}}
This function will add a ban for the specified IP/username/serial to the server.

==Syntax==
<syntaxhighlight lang="lua">
ban addBan ( [ string IP, string Username, string Serial, player responsibleElement, string reason, int seconds = 0 ] )
</syntaxhighlight>
'''Note:''' One of the three: IP, Username or Serial have to be specified.

===Required Arguments===
*'''IP:''' The IP to be banned. If you don't want to ban by IP, set this to ''nil''.
'''or'''
*'''Username:''' The [http://community.mtasa.com/ MTA Community] username to be banned (now obsolete). If you don't want to ban by username, set this to ''nil''.
'''or'''
*'''Serial:''' The serial to be banned. If you don't want to ban by serial, set this to ''nil''.
''' or any combination.'''

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

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

==Example==
This example bans a player's IP with the reason "Requested" when they type "/ban-me".
<syntaxhighlight lang="lua">
function banMe ( source, command ) -- The function header and where source is defined
local ipToBan = getPlayerIP ( source ) -- Get the player's IP
addBan ( ipToBan, nil, nil, source, "Requested" ) -- Ban him with the reason; Requested
end
addCommandHandler ( "ban-me", banMe ) -- Make it trigger when a player types "/ban-me"
</syntaxhighlight>

==Example 2==
This example add command to ban player serial.
<syntaxhighlight lang="lua">
function banSerial( source, command, noob, reason )
if ( noob ) then
local theNoob = getPlayerFromName( noob )
if ( theNoob ) then
local theNoobSerial = getPlayerSerial( theNoob )
addBan( nil, nil, theNoobSerial, source, reason )
end
end
end
addCommandHandler( "ban-serial", banSerial )
</syntaxhighlight>

==See Also==
{{Admin functions}}
[[ru:addBan]]

User:Dpower

2011-07-28T15:00:29Z

Dpower: Created page with "I am NeO_D-Power. I am a Head Admin and a scripter (PHP/Lua) for [http://www.team-neo.com/ Team NeO's MTA servers]. I plan on contributing to this wiki in future. :-)"

I am NeO_D-Power.
I am a Head Admin and a scripter (PHP/Lua) for [http://www.team-neo.com/ Team NeO's MTA servers].

I plan on contributing to this wiki in future. :-)

Building MTASA Server on GNU Linux

2010-11-10T13:21:19Z

Dpower: /* Preparing your system */

== '''Building 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 is distributed as a precompiled binary library. The latest version for GNU/Linux can be found on our [http://code.google.com/p/mtasa-blue/downloads/list Downloads page] on Google Code.

'''Debian Linux'''

Includes derivative distributions such as Ubuntu.

You will need the necessary build tools, headers and libraries, which are distributed through the following Debian packages (e.g. Debian Lenny):

* '''build-essential:''' contains the necessary tools, headers and libraries to build applications
* '''automake:''' contains the automake tools
* '''libtool:''' contains the libtool software required to build libraries
* '''libcurl3-dev:''' contains the cURL library (version 3 without SSL support)
* '''libpcre3-dev:''' contains the PCRE library (version 3)
* '''libsqlite3-dev:''' contains the SQLite library (version 3)
* '''libreadline5-dev:''' contains the readline library (version 5)
* '''subversion:''' contains the tortoise client used to check out our code repository
To install these packages through apt, use the apt-get install <package list> command as in the following example (executed as root):

<syntaxhighlight lang="lua">apt-get install build-essential automake libtool libcurl4-openssl-dev libpcre3-dev libsqlite3-dev libreadline5-dev subversion</syntaxhighlight>

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

* '''sqlite:''' contains the SQLite library
* '''git:''' contains the client used to check out our code repository
* '''curl:''' contains the cURL library; to compile with SSL support, apply the net-misc/curl ssl USE flag
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:

<syntaxhighlight lang="lua">emerge -v subversion sqlite
USE=“net-misc/curl ssl” emerge -v curl
</syntaxhighlight>

'''Fedora'''

You will need these packages to be able to successfully compile a MTA server on Fedora:
* '''glibc-devel:'''
* '''curl-devel:''' contains the cURL library
* '''pcre-devel:''' contains the PCRE library
* '''sqlite3-devel:''' contains the SQLite library
* '''readline-devel:''' contains the readline library
* '''lua-devel:''' contains the Lua libraries
* '''subversion:''' contains the SVN 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 (executed as root):

<syntaxhighlight lang="lua">yum install glibc-devel curl-devel pcre-devel sqlite3-devel readline-devel lua-devel subversion</syntaxhighlight>

'''A warning for x64'''

The MTA:SA server currently cannot be properly compiled in 64-bit mode. Instead, you should compile it in 32-bit mode and run it using 32-bit compatibility mode (use the -m32 flag).

== General instructions ==

'''Downloading the source.'''

First you need to download the source.

<syntaxhighlight lang="lua">svn checkout http://mtasa-blue.googlecode.com/svn/trunk/ mtasa-blue
cd mtasa-blue
</syntaxhighlight>

'''Prepare the sparsehash library'''

You can skip this step if your distribution’s package manager provides a sparsehash package that you can install.

<syntaxhighlight lang="lua">cd vendor/sparsehash/current
autoreconf -fi
sh ./configure
make install
cd ../../..</syntaxhighlight>

'''Compiling the server'''

<syntaxhighlight lang="lua">autoreconf -fi
./configure
make install</syntaxhighlight>

Your vanilla server will now be compiled and installed into the MTA10_Server/output/ directory.

'''Run the server'''

Grab the latest net.so from the Downloads page on GitHub and place it in your output directory, install the accounts.xml, mtaserver.conf and acl.xml files into the mods/deathmatch/ directory and grab the latest resources from the [http://code.google.com/p/multitheftauto-resources/ multitheftauto-resources project]. You can then run your server.

<syntaxhighlight lang="lua">cd MTA10_Server/output
./mta-server</syntaxhighlight>

== '''Troubleshooting''' ==

Any errors during the compilation of json-c can be solved by calling autoreconf -fi from the json-c directory.

If you’re getting any unexpected errors while compiling, please check our [http://bugs.mtasa.com/ Bug tracker] or our [irc://irc.multitheftauto.com/ IRC channel]