Multi Theft Auto: Wiki - User contributions [en]

Changes in 1.3.1

2012-08-15T13:20:11Z

JoeBullet: IsPedTargetingMarkerEnabled -> isPedTargetingMarkerEnabled

== Main Additions / Changes ==
* Added Custom Vehicle Sirens
* Fixed map files are downloading very slow issue
* Fixed timeouts on map change
* Fixed various issues, crashes and freezes
* Updated max players to 4096
* Added BASS Effects
* Added Analog Controls States
* Added bullet sync
* Fixed several custom model replacing issues

== Client ==

=== New Functions ===

* Added [[setObjectBreakable]]
* Added [[isObjectBreakable]]
* Added [[dxSetBlendMode]]
* Added [[dxGetBlendMode]]
* Added [[dxDrawMaterialLine3D]]
* Added [[dxDrawMaterialSectionLine3D]]
* Added [[getLatentEventHandles]]
* Added [[getLatentEventStatus]]
* Added [[cancelLatentEvent]]
* Added [[triggerLatentServerEvent]]
* Added [[getVehicleSirenParams]]
* Added [[getVehicleSirens]]
* Added [[setVehicleSirens]]
* Added [[getSoundProperties]]
* Added [[setSoundProperties]]
* Added [[getSoundFFTData]]
* Added [[setSoundPanningEnabled]]
* Added [[isSoundPanningEnabled]]
* Added [[setWorldSoundEnabled]]
* Added [[isWorldSoundEnabled]]
* Added [[resetWorldSounds]]
* Added [[getSoundBPM]]
* Added [[getSoundLevelData]]
* Added [[getSoundWaveData]]
* Added [[setPedAnalogControlState]]
* Added [[getPedAnalogControlState]]
* Added [[setAnalogControlState]]
* Added [[getAnalogControlState]]
* Added [[setPedTargetingMarkerEnabled]]
* Added [[isPedTargetingMarkerEnabled]]
* Added [[setElementMatrix]]
* Added [[warpPedIntoVehicle]]
* Added [[removePedFromVehicle]]

=== New Events ===

* Added [[onClientPedHeliKilled]]
* Added [[onClientPlayerHeliKilled]]
* Added [[onClientPlayerHitByWaterCannon]]
* Added [[onClientPedHitByWaterCannon]]
* Added [[onClientPlayerPickupHit]]
* Added [[onClientPlayerPickupLeave]]
* Added [[onClientSoundBeat]]

=== Changes / Bug Fixes ===

* Fixed 'not being able to enter vehicles' bug
* Added order priority to [[addEventHandler]]
* Fixed 'engineless' NRG-500 Variant
* Added option to skip Dual Monitor Resolution Select
* Made [[playSound3D]] use the camera position instead of the player position when determining the distance
* Added color coding and sub-pixel positioning options to [[dxDrawText]]
* Added ability to create and modify cubemaps and volume textures - Details: [[dxCreateTexture]]
* Added model cache system to reduce loading delays
* Added CJ clothes cache to help reduce game freezes
* Sped up event handling system for server and client
* Added element option to [[engineApplyShaderToWorldTexture]]
* Added optional bool to [[getElementMatrix]] ( element, bool )
* Added unrar for smoother update procedure
* Fixed custom model replacement errors sometimes with weapons & weapon pickups.
* Fixed vehicle upgrade custom models not showing immediately
* Fixed accuracy of hit point in [[onClientPlayerWeaponFire]] and added shot origin parameter
* Fixed [[setPedAimTarget]] direction being all wrong
* Fixed issue when peds' bullets origin from wrong position
* Fixed custom models not rendering correctly sometimes parameter
* Fixed custom model LOD distance is not reseting after quiting
* Added size limit for clientscript.log file
* Added ability to shoot with any weapon with jetpack
* Made timers less crashy
* Fixed some animation crashes
* Fixed [[getPedMoveState]] returns false when moving in crouch state
* Fixed a bug when a resource that replace an object model (dff) and texture (txd) is stopped the object texture get white
* Added ped pixel shaders
* Added ability to layer multiple shaders on a world texture
* Fixed Windows 8 missing dll error
* Fixed [[setElementPosition]] for vehicles on a non streamed in position will make the vehicle spin very quickly

== Server ==

=== New Functions ===

* Added [[fetchRemote]]
* Added [[reloadBans]]
* Added [[getAllAccountData]]
* Added [[getLatentEventHandles]]
* Added [[getLatentEventStatus]]
* Added [[cancelLatentEvent]]
* Added [[removeVehicleSirens]]
* Added [[getVehicleSirenParams]]
* Added [[getVehicleSirens]]
* Added [[setVehicleSirens]]
* Added [[addVehicleSirens]]
* Added [[setJetpackWeaponEnabled]]
* Added [[getJetpackWeaponEnabled]]

=== New Events ===

* None yet

=== Changes / Bug Fixes ===

* Fixed map files are downloading very slow issue
* Fixed timeouts on map change
* Tweaks and fixes for vehicle sync
* Added order priority to [[addEventHandler]]
* Improved performance when the server has a large number of IP bans
* Added debug info to timers
* Added adjustable sync rates to [[setServerConfigSetting]] and the server config - Details: [[Sync_interval_settings]]
* Fixed lightsync vehicles ghost streaming in when locally they are miles away
* Fixed server sometimes not appearing in the browser
* Added server setting to reduce CPU usage
* Sped up event handling system for server and client
* Tweaked server networking
* Improved Lua errors for server element functions
* Reduced CPU usage more
* Made timers less crashy
* Added vehicle extrapolation - Details: [[mtaserver.conf#vehext_percent|mtaserver.conf -> vehext_]]
* Fixed server crash when towing a clientside vehicle
* Added option to suppress certain MySQL error messages
* Large amount of other crashfixes, improvements and tweaks

== Resources ==
* Updated parachute to fix high CPU usage on clients
* Added Visualiser resource
* Added GUI Siren Editor
* Fixed a reload exploit where you could jump and then reload for an instant reload
* Made reload with jetpack work again

== Editor ==
* Fixed Map editor not saving locations of objects on Linux machines
* Added cancel option when starting map editor from menu.

[[Category:Changelog]]

ProcessLineOfSight

2012-06-14T21:46:14Z

JoeBullet: Explained ignoreSomeObjectsForCamera

{{Important Note|This function doesn't return some parameters. See the [[http://bugs.mtasa.com/view.php?id=7003 bugtracker]] for updates and more information. }}
{{Needs_Checking|Explain ignoreSomeObjectsForCamera and ignoredElement with examples?
--[[User:Ransom|Ransom]] 07:18, 3 February 2011 (UTC)}}
{{Client function}}
__NOTOC__
This function casts a ray between two points in the world, and tells you information about the point that was hit, if any. The two positions '''must''' be within the local player's draw distance as the collision data is not loaded outside this area, and the call will just fail as if the ray didn't hit.

This function is relatively expensive to call, so over use of this in scripts may have a detrimental effect on performance.

This function is useful for checking for collisions and for editor-style scripts. If you wish to find what element is positioned at a particular point on the screen, use this function combined with [[getWorldFromScreenPosition]]. If you wish to just know if something is hit, and don't care about what or where was hit, use [[isLineOfSightClear]].

==Syntax==
Return values labelled for ease of reference.
<syntaxhighlight lang="lua">
bool -- hit
float float float -- hitX, hitY, hitZ
element -- hitElement
float float float -- normalX, normalY, normalZ
int -- material
int -- lighting
int -- piece
int -- worldModelID
float float float -- worldModelPositionX,Y,Z
float float float -- worldModelRotationX,Y,Z
int -- worldLODModelID
processLineOfSight ( float startX, float startY, float startZ,
float endX, float endY, float endZ,
[ bool checkBuildings = true,
bool checkVehicles = true,
bool checkPlayers = true,
bool checkObjects = true,
bool checkDummies = true,
bool seeThroughStuff = false,
bool ignoreSomeObjectsForCamera = false,
bool shootThroughStuff = false,
element ignoredElement = nil,
bool includeWorldModelInformation = false ] )
</syntaxhighlight>

===Required Arguments===
*'''startX:''' The start ''x'' position
*'''startY:''' The start ''y'' position
*'''startZ:''' The start ''z'' position
*'''endX:''' The end ''x'' position
*'''endY:''' The end ''y'' position
*'''endZ:''' The end ''z'' position

===Optional Arguments===
{{OptionalArg}}
*'''checkBuildings:''' Allow the line of sight to be blocked by GTA's internally placed buildings, i.e. the world map.
*'''checkVehicles:''' Allow the line of sight to be blocked by [[Vehicle|vehicles]].
*'''checkPlayers:''' Allow the line of sight to be blocked by [[Player|players]].
*'''checkObjects:''' Allow the line of sight to be blocked by [[Object|objects]].
*'''checkDummies:''' Allow the line of sight to be blocked by GTA's internal dummies. These are not used in the current MTA version so this argument can be set to ''false''.
*'''seeThroughStuff:''' Allow the line of sight to be blocked by translucent game objects, e.g. glass.
*'''ignoreSomeObjectsForCamera:''' Allow the line of sight to be blocked by objects that have (K) property enabled in "object.dat" data file.
*'''shootThroughStuff:''' Allow the line of sight to be blocked by things that can be shot through
*'''ignoredElement:''' Allow the line of sight to pass through a certain specified element. This is usually set by the object you are tracing from.
{{New feature|3.0110|1.1|
*'''includeWorldModelInformation :''' Include the results of hitting a world model.
}}

===Returns===
*'''hit:''' ''true'' if there is a collision, ''false'' otherwise
The other values are only filled if there is a collision, they contain ''nil'' otherwise
*'''hitX, hitY, hitZ:''' collision position
*'''hitElement:''' the MTA element hit if any, ''nil'' otherwise
{{New feature|3.0110|1.1|
*'''normalX, normalY, normalZ:''' the normal of the surface hit
*'''material:''' an integer representing the [[Material IDs|GTASA material ID]] of the surface hit when applicable (world, objects)
*'''lighting:''' an integer between 0 (fully dark) and 255 (bright) representing the lighting intensity of the surface hit. This intensity is related to the lighting intensity the ped gets when standing on this surface (more than 100 in general, less than 20 in dark areas, and 0 to 1 in stealth parts of Madd Dogg's mansion)
*'''piece:''' an integer representing the part of the element hit if hitElement is a vehicle or a ped/player, ''0'' otherwise.
**For a ped/player, piece represents the body part hit:
{{BodyParts}}
**For vehicles, piece represents the vehicle part hit:
{{VehicleParts}}
*'''worldModelID:''' If includeWorldModelInformation was set to ''true'' and a world model was hit, this will contain the model ID.
*'''worldModelPositionX,Y,Z:''' If worldModelID is set, this will contain the world model position.
*'''worldModelRotationX,Y,Z:''' If worldModelID is set, this will contain the world model rotation.
*'''worldLODModelID:''' If worldModelID is set, this will contain the LOD model ID if applicable.
}}

==Example==
This example shows how you can tell what position and element the camera is looking at, up to 50 units away.
<syntaxhighlight lang="lua">
local w, h = guiGetScreenSize ()
local tx, ty, tz = getWorldFromScreenPosition ( w/2, h/2, 50 )
local px, py, pz = getCameraMatrix()
hit, x, y, z, elementHit = processLineOfSight ( px, py, pz, tx, ty, tz )
if hit then
outputChatBox ( "Looking at " .. x .. ", " .. y .. ", " .. z )
if elementHit then
outputChatBox ( "Hit element " .. getElementType(elementHit) )
end
end
</syntaxhighlight>

==See Also==
{{Client world functions}}

Talk:Building MTASA Server on GNU Linux

2011-01-06T13:44:53Z

JoeBullet:

@x86 It's required to have root premissions to run "apt-get", also it says "(executed as root)" i.e 'sudo'.
--[[User:JoeBullet|JoeBullet]] 13:44, 6 January 2011 (UTC)

Talk:Building MTASA Server on GNU Linux

2011-01-06T13:44:36Z

JoeBullet: Created page with "@x86 It's required to have root premissions to run "apt-get", also it says "(executed as root)" i.e 'sudo'."

@x86 It's required to have root premissions to run "apt-get", also it says "(executed as root)" i.e 'sudo'.

Building MTASA Server on GNU Linux

2011-01-06T11:17:58Z

JoeBullet:

== '''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 (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 1.1 if you are compiling from the trunk, or the net.so from 1.0.4 if you are compiling the 1.0.4 branch. Be sure the read the top of ''MTA10_Server/version.h'' as it contains directions on how to compile the different build types.

'''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 SVN client used to check out our code repository
* '''libncurses5-dev:''' contains software for controlling writing to the console screen
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">sudo apt-get install build-essential automake libtool libcurl4-openssl-dev libpcre3-dev libsqlite3-dev libreadline5-dev subversion libncurses5-dev libncursesw5-dev</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
* '''subversion:''' contains the SVN 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 net.so from the latest nightly and place it in your output directory, install the mtaserver.conf and acl.xml files into the ''mods/deathmatch/'' directory and put the latest resources from [http://code.google.com/p/multitheftauto-resources/ multitheftauto-resources project] into the ''mods/deathmatch/resources/'' directory . 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]

Building MTASA Server on GNU Linux

2011-01-06T11:17:29Z

JoeBullet:

== '''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 (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 1.1 if you are compiling from the trunk, or the net.so from 1.0.4 if you are compiling the 1.0.4 branch. Be sure the read the top of ''MTA10_Server/version.h'' as it contains directions on how to compile the different build types.

'''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 SVN client used to check out our code repository
* '''libncurses5-dev, libncursesw5-dev''' contains software for controlling writing to the console screen
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">sudo apt-get install build-essential automake libtool libcurl4-openssl-dev libpcre3-dev libsqlite3-dev libreadline5-dev subversion libncurses5-dev libncursesw5-dev</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
* '''subversion:''' contains the SVN 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 net.so from the latest nightly and place it in your output directory, install the mtaserver.conf and acl.xml files into the ''mods/deathmatch/'' directory and put the latest resources from [http://code.google.com/p/multitheftauto-resources/ multitheftauto-resources project] into the ''mods/deathmatch/resources/'' directory . 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]

Building MTASA Server on GNU Linux

2011-01-06T11:16:49Z

JoeBullet:

== '''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 (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 1.1 if you are compiling from the trunk, or the net.so from 1.0.4 if you are compiling the 1.0.4 branch. Be sure the read the top of ''MTA10_Server/version.h'' as it contains directions on how to compile the different build types.

'''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 SVN client used to check out our code repository
* '''libncurses5-dev''' contains software for controlling writing to the console screen
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">sudo apt-get install build-essential automake libtool libcurl4-openssl-dev libpcre3-dev libsqlite3-dev libreadline5-dev subversion libncurses5-dev libncursesw5-dev</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
* '''subversion:''' contains the SVN 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 net.so from the latest nightly and place it in your output directory, install the mtaserver.conf and acl.xml files into the ''mods/deathmatch/'' directory and put the latest resources from [http://code.google.com/p/multitheftauto-resources/ multitheftauto-resources project] into the ''mods/deathmatch/resources/'' directory . 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]

Building MTASA Server on GNU Linux

2011-01-06T10:21:31Z

JoeBullet:

== '''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 (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 1.1 if you are compiling from the trunk, or the net.so from 1.0.4 if you are compiling the 1.0.4 branch. Be sure the read the top of ''MTA10_Server/version.h'' as it contains directions on how to compile the different build types.

'''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 SVN 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">sudo apt-get install build-essential automake libtool libcurl4-openssl-dev libpcre3-dev libsqlite3-dev libreadline5-dev subversion libncurses5-dev libncursesw5-dev</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
* '''subversion:''' contains the SVN 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 net.so from the latest nightly and place it in your output directory, install the mtaserver.conf and acl.xml files into the ''mods/deathmatch/'' directory and put the latest resources from [http://code.google.com/p/multitheftauto-resources/ multitheftauto-resources project] into the ''mods/deathmatch/resources/'' directory . 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]