Multi Theft Auto: Wiki - User contributions [en]

Installing and Running MTASA Server on GNU Linux

2014-03-17T21:38:47Z

CR=: /* Default config */

== 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 ==
===Install 32 bit libs for your 64 bit distro===
For 64 bit Debian, 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===
* 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

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

Installing and Running MTASA Server on GNU Linux

2014-03-17T21:36:11Z

CR=: /* Main binary */

== 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/134/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 ==
===Install 32 bit libs for your 64 bit distro===
For 64 bit Debian, 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===
* 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

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

GetSoundBPM

2012-12-06T12:43:19Z

CR=:

__NOTOC__
{{Client function}}
{{New feature/item|4.0140|1.3.0|4145|
This function gets the beats per minute of a specific [[sound]] element.
}}

==Syntax==
<syntaxhighlight lang="lua">int getSoundBPM( element sound )</syntaxhighlight>

===Required Arguments===
*'''sound:''' A sound element that is created using [[playSound]] or [[playSound3D]]

===Returns===
Returns the beats per minute of the given sound.

==Example==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function bpm ()
-- Long version (might be more understandable as example)
sound = playSound ( "song.mp3" ) -- Play the song
beats = getSoundBPM ( sound ) -- Get the beats per minute of the song
outputChatBox ( "Long code version: " .. beats ) -- Output the beats to the chat box

-- Short version + Would save some memory
outputChatBox ( "Short code version: " .. getSoundBPM ( playSound ( "song.mp3" ) ) )
end
addCommandHandler ( "bpm", bpm )
</syntaxhighlight>
</section>

==Requirements==
{{Requirements|n/a|1.3.0-9.04162|}}

==See Also==
{{Client_audio_functions}}

GetSoundBPM

2012-12-06T12:43:02Z

CR=:

IsElementMoving

2012-10-12T15:01:27Z

CR=:

{{Useful Function}}
<lowercasetitle/>
__NOTOC__

This function checks if an element is moving.

==Syntax==
<syntaxhighlight lang="lua"> bool isElementMoving( element theElement ) </syntaxhighlight>

===Returns===
Returns true if the element is moving, otherwise false.

===Code===
<syntaxhighlight lang="lua">function isElementMoving(theElement)
if isElement(theElement)then --First check if the given argument is an element
local x, y, z = getElementVelocity(theElement) --Get the velocity of the element given in our argument
if x == 0 and y == 0 and z == 0 then --When there is no movement on X, Y or Z return false because our element is not moving
return false
else
return true
end
end
end</syntaxhighlight>
===Example===
<section name="Client" class="client" show="true">
This piece of client side code writes the moving state to the client his screen
<syntaxhighlight lang="lua">
local screenWidth, screenHeight = guiGetScreenSize () -- Get the screen resolution (width and height)

function idleCheck ()
if isElementMoving( getLocalPlayer() ) then --Check if it is the player "strolling"
state = "Moving"
elseif isElementMoving( getPedOccupiedVehicle ( getLocalPlayer() ) ) then --Player is not "Strolling" maybe the player is in a vehicle
state = "Moving"
else --The player not moving on feet or in a vehicle
state = "Idling"
end
--Write our state string to the lower left corner of the screen
dxDrawText ( state, 40, screenHeight - 40, screenWidth, screenHeight, tocolor ( 255, 255, 255, 255 ), 1, "default" )
end

addEventHandler ( "onClientRender", getRootElement(), idleCheck ) -- keep the text visible with onClientRender.
</syntaxhighlight>
</section>
==See Also==
{{Useful_Functions}}

Talk:IsObjectMoving

2012-10-12T15:00:45Z

CR=: moved Talk:IsObjectMoving to Talk:IsElementMoving: This "useful" function is not only useful for objects but also for elements like players/vehicles (Also fixed a bug check out talk page)

#REDIRECT [[Talk:IsElementMoving]]

Talk:IsElementMoving

2012-10-12T15:00:45Z

CR=: moved Talk:IsObjectMoving to Talk:IsElementMoving: This "useful" function is not only useful for objects but also for elements like players/vehicles (Also fixed a bug check out talk page)

Does this even work? It doesn't look like it does because it will always return false as that timer will execute 3000ms after that function, not inside it. Also did you check if getElementVelocity on the object works? Maybe it does.

--[[User:Arran Fortuna|Arran Fortuna]] 14:11, 7 October 2012 (UTC)
<br/><br/>
Arran you are partly right about "Does this even work?" it can return true but this only happens when there is movement on the X axis (it still returns false if there is only movement on the Y and or Z axis.
Also fyi getElementVelocity() does work on objects because an object is also an element.

'''Things that should get changed (imo) are:'''<br/>
- isObjectMoving() should be changed to isElementMoving() (because you can use this function all elements not only objects)<br/>
- The function should not only check for the movement on the X axis but also on the Y and Z

==It would look like this==
<syntaxhighlight lang="lua">
function isElementMoving(theElement)
if isElement(theElement)then --First check if the given argument is an element
local x, y, z = getElementVelocity(theElement) --Get the velocity of the element given in our argument
if x == 0 and y == 0 and z == 0 then --When there is no movement on X, Y or Z return false because our element is not moving
return false
else
return true
end
end
end
</syntaxhighlight>

I will change the page later today and also add some sample code!<br/>
[[User:CR=|CR=]] 11:35, 12 October 2012 (UTC)

IsObjectMoving

2012-10-12T15:00:45Z

CR=: moved IsObjectMoving to IsElementMoving: This "useful" function is not only useful for objects but also for elements like players/vehicles (Also fixed a bug check out talk page)

#REDIRECT [[IsElementMoving]]

IsElementMoving

2012-10-12T15:00:45Z

CR=: moved IsObjectMoving to IsElementMoving: This "useful" function is not only useful for objects but also for elements like players/vehicles (Also fixed a bug check out talk page)

{{Useful Function}}
<lowercasetitle/>
__NOTOC__
{{Needs Example}}

This function checks if an element is moving.

==Syntax==
<syntaxhighlight lang="lua"> bool isElementMoving( element theElement ) </syntaxhighlight>

===Returns===
Returns true if the element is moving, otherwise false.

===Code===
<syntaxhighlight lang="lua">function isElementMoving(theElement)
if isElement(theElement)then --First check if the given argument is an element
local x, y, z = getElementVelocity(theElement) --Get the velocity of the element given in our argument
if x == 0 and y == 0 and z == 0 then --When there is no movement on X, Y or Z return false because our element is not moving
return false
else
return true
end
end
end</syntaxhighlight>
===Example===
<section name="Client" class="client" show="true">
This piece of client side code writes the moving state to the client his screen
<syntaxhighlight lang="lua">
local screenWidth, screenHeight = guiGetScreenSize () -- Get the screen resolution (width and height)

function idleCheck ()
if isElementMoving( getLocalPlayer() ) then --Check if it is the player "strolling"
state = "Moving"
elseif isElementMoving( getPedOccupiedVehicle ( getLocalPlayer() ) ) then --Player is not "Strolling" maybe the player is in a vehicle
state = "Moving"
else --The player not moving on feet or in a vehicle
state = "Idling"
end
--Write our state string to the lower left corner of the screen
dxDrawText ( state, 40, screenHeight - 40, screenWidth, screenHeight, tocolor ( 255, 255, 255, 255 ), 1, "default" )
end

addEventHandler ( "onClientRender", getRootElement(), idleCheck ) -- keep the text visible with onClientRender.
</syntaxhighlight>
</section>
==See Also==
{{Useful_Functions}}

IsElementMoving

2012-10-12T14:59:06Z

CR=:

Talk:IsElementMoving

2012-10-12T11:35:48Z

CR=:

SetVehicleAdjustableProperty

2012-10-09T11:05:04Z

CR=: /* Example */

{{client function}}
__NOTOC__
This function is used for adjusting the movable parts of a model, for example hydra jets or dump truck tray.
This function only works on vehicles with adjustable properties.

==Syntax==
<syntaxhighlight lang="lua">
bool setVehicleAdjustableProperty ( element theVehicle, int value )
</syntaxhighlight>

===Required Arguments===
*'''theVehicle''': The vehicle you wish to change the adjustable property of.
*'''value''': A value from 0 between ?. (Set the adjustable value between 0 and N. 0 is the default value. It is possible to force the setting beyond default maximum, for example setting above 5000 on the dump truck (normal max 2500) will cause the tray to be fully vertical.)

===Returns===
Returns true if the adjustable property was set, ''false'' otherwise.

==Example==
<section name="Client" class="client" show="true">
This clientside function allows the user to set the vehicle adjustable property of a vehicle that the user is in by typing a command:
<syntaxhighlight lang="lua">
function adjustProperty ( command, adjustValue )
--First check if our player is in a vehicle (otherwise there is nothing to adjust)
if isPedInVehicle (getLocalPlayer()) then
--Next check if there is a property to adjust on this vehicle that our player is in
if getVehicleAdjustableProperty(getPedOccupiedVehicle(getLocalPlayer())) then
--Set the vehicle property to the argument that was given with the command (adjustValue)
setVehicleAdjustableProperty (getPedOccupiedVehicle(getLocalPlayer()), adjustValue )
else
outputChatBox("You are in a vehicle that has no adjustable property!")
end
else
outputChatBox("You are not in a vehicle!")
end
end
addCommandHandler ( "adjust", adjustProperty )
</syntaxhighlight>
</section>

==See Also==
{{Client_vehicle_functions}}

SetVehicleAdjustableProperty

2012-10-09T11:04:34Z

CR=: /* Example */

{{client function}}
__NOTOC__
This function is used for adjusting the movable parts of a model, for example hydra jets or dump truck tray.
This function only works on vehicles with adjustable properties.

==Syntax==
<syntaxhighlight lang="lua">
bool setVehicleAdjustableProperty ( element theVehicle, int value )
</syntaxhighlight>

===Required Arguments===
*'''theVehicle''': The vehicle you wish to change the adjustable property of.
*'''value''': A value from 0 between ?. (Set the adjustable value between 0 and N. 0 is the default value. It is possible to force the setting beyond default maximum, for example setting above 5000 on the dump truck (normal max 2500) will cause the tray to be fully vertical.)

===Returns===
Returns true if the adjustable property was set, ''false'' otherwise.

==Example==
<section name="Client" class="client" show="true">
This clientside function allows the user to set the vehicle adjustable property of a vehicle that he/she is in by typing a command:
<syntaxhighlight lang="lua">
function adjustProperty ( command, adjustValue )
--First check if our player is in a vehicle (otherwise there is nothing to adjust)
if isPedInVehicle (getLocalPlayer()) then
--Next check if there is a property to adjust on this vehicle that our player is in
if getVehicleAdjustableProperty(getPedOccupiedVehicle(getLocalPlayer())) then
--Set the vehicle property to the argument that was given with the command (adjustValue)
setVehicleAdjustableProperty (getPedOccupiedVehicle(getLocalPlayer()), adjustValue )
else
outputChatBox("You are in a vehicle that has no adjustable property!")
end
else
outputChatBox("You are not in a vehicle!")
end
end
addCommandHandler ( "adjust", adjustProperty )
</syntaxhighlight>
</section>

==See Also==
{{Client_vehicle_functions}}

SetVehicleAdjustableProperty

2012-10-09T11:03:40Z

CR=:

{{client function}}
__NOTOC__
This function is used for adjusting the movable parts of a model, for example hydra jets or dump truck tray.
This function only works on vehicles with adjustable properties.

==Syntax==
<syntaxhighlight lang="lua">
bool setVehicleAdjustableProperty ( element theVehicle, int value )
</syntaxhighlight>

===Required Arguments===
*'''theVehicle''': The vehicle you wish to change the adjustable property of.
*'''value''': A value from 0 between ?. (Set the adjustable value between 0 and N. 0 is the default value. It is possible to force the setting beyond default maximum, for example setting above 5000 on the dump truck (normal max 2500) will cause the tray to be fully vertical.)

===Returns===
Returns true if the adjustable property was set, ''false'' otherwise.

==Example==
<section name="Client" class="client" show="true">
This clientside function allows the user to set the vehicle adjustable property by typing a command:
<syntaxhighlight lang="lua">
function adjustProperty ( command, adjustValue )
--First check if our player is in a vehicle (otherwise there is nothing to adjust)
if isPedInVehicle (getLocalPlayer()) then
--Next check if there is a property to adjust on this vehicle that our player is in
if getVehicleAdjustableProperty(getPedOccupiedVehicle(getLocalPlayer())) then
--Set the vehicle property to the argument that was given with the command (adjustValue)
setVehicleAdjustableProperty (getPedOccupiedVehicle(getLocalPlayer()), adjustValue )
else
outputChatBox("You are in a vehicle that has no adjustable property!")
end
else
outputChatBox("You are not in a vehicle!")
end
end
addCommandHandler ( "adjust", adjustProperty )
</syntaxhighlight>
</section>

==See Also==
{{Client_vehicle_functions}}

SetVehicleAdjustableProperty

2012-10-09T11:01:11Z

CR=: /* Example */

{{client function}}
__NOTOC__
This function is used for adjusting the movable parts of a model, for example hydra jets or dump truck tray.
This function only works on vehicles with adjustable properties.

==Syntax==
<syntaxhighlight lang="lua">
bool setVehicleAdjustableProperty ( element theVehicle, int value )
</syntaxhighlight>

===Required Arguments===
*'''theVehicle''': The vehicle you wish to change the adjustable property of.
*'''value''': A value from 0 between ?. (Set the adjustable value between 0 and N. 0 is the default value. It is possible to force the setting beyond default maximum, for example setting above 5000 on the dump truck (normal max 2500) will cause the tray to be fully vertical.)

===Returns===
Returns true if the adjustable property was set, ''false'' otherwise.

==Example==
<section name="Client" class="client" show="true">
This clientside function allows the user to set the vehicle adjustable property by typing a command:
<syntaxhighlight lang="lua">
function adjustProperty ( command, adjustValue )
--First check if our player is in a vehicle (otherwise there is nothing to adjust)
if isPedInVehicle (getLocalPlayer()) then
--Next check if there is a property to adjust on this vehicle that our player is in
if getVehicleAdjustableProperty(getPedOccupiedVehicle(getLocalPlayer())) then
--Set the vehicle property to the argument that was given with the command (adjustValue)
setVehicleAdjustableProperty (getPedOccupiedVehicle(getLocalPlayer()), adjustValue )
else
outputChatBox("You are in a vehicle that has no adjustable property!")
end
else
outputChatBox("You are not in a vehicle!")
end
end
addCommandHandler ( "adjust", adjustProperty )
</syntaxhighlight>
</section>

==See Also==
{{Client_vehicle_functions}}
[[Category:Needs_Example]]

Help:Editing Guidelines

2012-10-09T10:45:03Z

CR=: /* Protected Pages */

Before you contribute to the Multi Theft Auto Wiki make sure you know/understand the basics of [http://www.mediawiki.org/wiki/Help:Contents MediaWiki]. This article is a guide on how to edit the MTA Wiki properly.

== Editing Pages ==
<div style="font-size: 85%;">''MediaWiki general help page: [http://www.mediawiki.org/wiki/Help:Editing_pages Editing Pages]''</div>
=== Minor Edits ===
From Wikipedia: "A check to the "minor edit" box signifies that only superficial differences exist between the version with your edit and the previous version: typo corrections, formatting and presentational changes, rearranging of text without modifying content, etc. A minor edit is a version that the editor believes requires no review and could never be the subject of a dispute. The "minor edit" option is one of several options available only to registered users."<ref>http://en.wikipedia.org/wiki/Help:Minor_edit</ref>

=== Editing Function/Event Pages ===
[[File:Layout function page.png|thumb|Layout Function Pages]]

Specific information for editing the MTA Wiki.

===== Contents of Function/Event Pages =====
Function and event pages have a layout that is easy to identify and consistent. Before adding function and/or event pages make sure they do exist in the MTA Core!

====== Layout Function Pages ======
* No Table of Contents: <nowiki>__NOTOC__</nowiki>
* Define if function is server and/or client: <nowiki>{{Server client function}}</nowiki>
** Server only function: <nowiki>{{Server function}}</nowiki>
** Client only function: <nowiki>{{Client function}}</nowiki>
** Both client and server: <nowiki>{{Server client function}}</nowiki>
* Explain the function
* Syntax: Use <nowiki><syntaxhighlight lang="lua"></syntaxhighlight></nowiki>
** Required Arguments
** Optional Arguments (not always necessary)
* Returns
* Example
* See Also: Add the template to which function group this function belongs

====== Layout Event Pages ======
* No Table of Contents: <nowiki>__NOTOC__</nowiki>
* Define if event is server or client: <nowiki>{{server event}}</nowiki>
** Server event: <nowiki>{{Server event}}</nowiki>
** Client event: <nowiki>{{Client event}}</nowiki>
* Parameters
* Source: The source of the event.
* Example
* See Also

Events can only be server or client side not both.

===== Tips =====
* When creating a new page for a function or event, you need to edit the template for 'See Also' too. If you don't add it to a function/event group template this page is orphaned.
* When you don't want to add examples, add the <nowiki>{{Needs Example}}</nowiki> template at the top of the page.
* If you added examples to a page make sure to remove template <nowiki>{{Needs Example}}</nowiki> when necessary.

== Script Examples ==
{{note|When writing a script example always test and verify that your example is working, submitting not working examples is a waste of time for everyone.}}

* Preferably use four spaces instead of one tabulator.
* Use the syntaxhighlighting codebox provided on this wiki. (<nowiki><syntaxhighlight lang="lua">(CODE HERE)</syntaxhighlight></nowiki>)
* If the event/function is both client and server you should use the section template with server and/or client classes.
** For server side examples: <nowiki><section name="Example 1" </nowiki>'''class="server"'''<nowiki> show="true"></section></nowiki>
** For client side examples: <nowiki><section name="Example 2" </nowiki>'''class="client"'''<nowiki> show="false"></section></nowiki>

When an event/function is only client or server side you should only use the code box not the section tags.

If there are enough scripting examples, remove the template <nowiki>{{Needs Example}}</nowiki> or the <nowiki>[[Category:Needs Example]]</nowiki> when necessary.

== Templates ==
<div style="font-size: 85%;">''MediaWiki general help page: [http://www.mediawiki.org/wiki/Help:Templates Templates]''</div>
Templates are a consistent set of visual styling and can be used in articles to get the reader's attention or mark a page for example as outdated. Some templates also require arguments, for more information on how to use MTA's specific wiki templates go [[MTA Wiki:Specific Templates |here]].
{{Tip|If you want to avoid spacing between the page title and the template itself, you should include the template before __NOTOC__ other templates and/or [http://www.mediawiki.org/wiki/Help:Magic_words magic words].}}
Using templates is recommended when using the same content over a large number of pages. This will save you time when you want to change something in that content and doesn't require you to edit all the pages but just the template.

* [[MTA Wiki:Specific Templates |How to use MTA Wiki's Specific templates]]

== Protected Pages ==
Protected pages cannot be modified by normal users, if you want to change something on a protected page you will have to ask someone who has the right permissions to modify them.<ref>http://www.mediawiki.org/wiki/Help:Protected_pages</ref>

== Orphaned Pages ==
A page is considered orphaned when no other page(s) link to that page. This means no one will find it unless they use the search function.

* [[Adding Pages to Categories and Templates]]

== Icons ==
When you want to use icons, it is recommended to use general icons this improves the consistency of the wiki.

* [[MTA Wiki:Tango Icon List |Tango Icon List]]

== Helpful links ==
* [http://en.wikipedia.org/wiki/Wikipedia:Cheatsheet Wikipedia Cheatsheet] - Quick overview of general editing tags and functions.
* [http://www.mediawiki.org/wiki/Help:Contents MediaWiki Help] - General help for the MediaWiki software.

== References ==
<references></references>

[[Category:MTA Wiki:Editing]]