Multi Theft Auto: Wiki - User contributions [en]

SetTimer

2014-10-15T09:29:40Z

NeonBlack:

__NOTOC__
{{Server client function}}
This function allows you to trigger a function after a number of milliseconds have elapsed. You can call one of your own functions or a built-in function. For example, you could set a timer to spawn a player after a number of seconds have elapsed.

Once a timer has finished repeating, it no longer exists.

'''The minimum accepted interval is 50ms.'''

Multi Theft Auto guarantees that the timer will be triggered after ''at least'' the interval you specify. The resolution of the timer is tied to the frame rate (server side and client-side). All the overdue timers are triggered at a single point each frame. This means that if, for example, the player is running at 30 frames per second, then two timers specified to occur after 100ms and 110ms would more than likely occur during the same frame, as the difference in time between the two timers (10ms) is less than half the length of the frame (33ms). As with most timers provided by other languages, you shouldn't rely on the timer triggering at an exact point in the future.

==Syntax==
<syntaxhighlight lang="lua">
timer setTimer ( function theFunction, int timeInterval, int timesToExecute, [ var arguments... ] )
</syntaxhighlight>
{{OOP||Timer.create||}}
===Required Arguments===
*'''theFunction:''' The function you wish the timer to call. (Notice: Do not use a 'local' function, it must be global!)
{{New feature/item|3.0141|1.4.1|6773|
Added ''sourceTimer'' global variable to timer's callback function
}}
*'''timeInterval:''' The number of milliseconds that should elapse before the function is called. (the minimum is 50)(1000 milliseconds = 1 second)
*'''timesToExecute:''' The number of times you want the timer to execute, or 0 for infinite repetitions.

===Optional Arguments===
{{OptionalArg}}
*'''arguments:''' Any arguments you wish to pass to the function can be listed after the ''timesToExecute'' argument. Note that any tables you want to pass will get cloned, whereas metatables and functions/function references in that passed table will get lost. Also changes you make in the original table before the function gets called won't get transferred.

===Returns===
Returns a [[timer]] pointer if the timer was set successfully, ''false'' if the arguments are invalid or the timer could not be set.

==Example==
This example will output some text after a small delay.

<syntaxhighlight lang="lua">
-- define function to be called
function delayedChat ( text )
outputChatBox ( "Delayed text: " .. text )
end

-- set a timer so the function is called after 1 second
setTimer ( delayedChat, 1000, 1, "Hello, World!" )
</syntaxhighlight>

1 second after the line above has been executed, the text ''Delayed text: Hello, World!'' will be displayed in the chat box.

This example will nest a whole function within a timer. This is nice for things like setting variables without having to call a function outside of your code block.

<syntaxhighlight lang="lua">
function mainFunction()
outputChatBox ("Instant text!")
setTimer ( function()
outputChatBox ( "5 second delay text!" )
end, 5000, 1 )
end

mainFunction() --call function
</syntaxhighlight>

==See Also==
{{Utility functions}}

Mtaserver.conf

2011-12-21T12:04:57Z

NeonBlack: first part of mtaserver.conf documentation

<lowercasetitle/>
__TOC__

This page describes the syntax and usage of the file “mtaserver.conf” you can find in “<mta directory>/server/mods/deathmatch”. The file contains the configuration of the MTA:SA server.
It uses the common XML format. This article assumes the reader does already know this format.

The root node of the server configuration is <tt>config</tt>. After installing the server one can find a default server configuration in the above mentioned directory.

This article is based on the server configuration file of MTA:SA 1.2.

== Server Name ==
'''Required:''' Yes<br/>
'''Tag:''' <tt>servername</tt><br/>
'''Description:'''<br/>
: Specifies the server's name. This name is used in the server browser and in server statistics.<br/>
'''Default:''' Default MTA Server<br/>
'''XML:'''<br/>
<syntaxhighlight lang="xml">
<servername>Default MTA Server</servername></syntaxhighlight>

== Server IP ==
'''Required:''' No<br/>
'''Tag:''' <tt>serverip</tt><br/>
'''Description:'''<br/>
: Can be used to specify the IP address the MTA:SA server application shall bind to if the server has more than one IP address assigned.
: If one does not know what this means they should leave it blank.<br/>
'''XML:'''<br/>
<syntaxhighlight lang="xml">
<serverip></serverip>
</syntaxhighlight>

== Server Port ==
'''Required:''' Yes<br/>
'''Tag:''' <tt>serverport</tt><br/>
'''Description:'''<br/>
: The TCP/UDP port the MTA:SA server application shall bind to.
'''Default:''' 22003<br/>
'''XML:'''<br/>
<syntaxhighlight lang="xml">
<serverport>22003</serverport></syntaxhighlight>

== Player Limit ==
'''Required:''' Yes<br/>
'''Tag:''' <tt>maxplayers</tt><br/>
'''Description:'''<br/>
: Maximum amount of players that should be able to play on the server simultaneously. If this amount is reached new player connections will be declined.
'''Default:''' 32<br/>
'''XML:'''<br/>
<syntaxhighlight lang="xml">
<maxplayers>32</maxplayers></syntaxhighlight>

== HTTP Server ==
'''Required:''' No<br/>
'''Tag:''' <tt>httpserver</tt><br/>
'''Description:'''<br/>
: For enabling or disabling the builtin HTTP server. If it is enabled resources are able to provide access to various features via web browser.
'''Values:'''<br/>
: <tt>0</tt>: disabled<br/>
: <tt>1</tt>: enabled<br/>
'''Default:''' 1<br/>
'''XML:'''<br/>
<syntaxhighlight lang="xml">
<httpserver>1</httpserver></syntaxhighlight>

== HTTP Port ==
'''Required:''' Yes, if <tt>httpserver</tt> is set to 1, No otherwise<br/>
'''Tag:''' <tt>httpport</tt><br/>
'''Description:'''<br/>
: TCP port the builtin HTTP server shall bind to. This port needs to be used when accessing a resource via web browser.
'''Default:''' 22005<br/>
'''XML:'''<br/>
<syntaxhighlight lang="xml">
<httpport>22005</httpport></syntaxhighlight>

== HTTP Download URL ==
'''Required:''' No<br/>
'''Tag:''' <tt>httpdownloadurl</tt><br/>
'''Description:'''<br/>
: If this is set MTA:SA clients will download all the needed client files from the URL specified. If left blank they will download directly from the MTA:SA server.
: This can be used to unburden the server MTA:SA is running on. One can find the directory structure needed on the external HTTP server in “<mta directory>/server/mods/deathmatch/resource-cache/http-client-files” after the MTA:SA server has been run at least one time with all the resoruces needed.
'''XML:'''<br/>
<syntaxhighlight lang="xml">
<httpdownloadurl></httpdownloadurl></syntaxhighlight>

== Automatic Client Files Copy ==
'''Required:''' No<br/>
'''Tag:''' <tt>httpautoclientfiles</tt><br/>
'''Description:'''<br/>
: If enabled the MTA:SA server will create the “<mta directory>/server/mods/deathmatch/resource-cache/http-client-files” directory with copies of all files that get downloaded by the clients. The contents of this directory can be copied to an external server, which then can be used as external HTTP download server (see [[#HTTP Download URL|HTTP Download URL]]).
'''Values:'''<br/>
: <tt>0</tt>: disabled<br/>
: <tt>1</tt>: enabled<br/>
'''Default:''' 1<br/>
'''XML:'''<br/>
<syntaxhighlight lang="xml">
<httpautoclientfiles>1</httpautoclientfiles></syntaxhighlight>

To be continued.<br/>
[[User:NeonBlack|NeonBlack]] 13:04, 21 December 2011 (CET)

DE/Hauptseite

2011-12-21T10:44:22Z

NeonBlack: link to English main page

__NOTOC__
__NOEDITSECTION__
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="border: 1px solid #D8D8D8; padding: 5px; height: 130px;">
[[File:Mtalogo.png|left|100px]]'''Willkommen im Multi Theft Auto Wiki.''' Hier findest Du eine Fülle an Informationen zu Multi Theft Auto.

Es gibt eine Menge [[How you can help|Dinge, die Du tun kannst, um uns bei der Verbesserung von MTA zu helfen]] - erstelle eine Map, einen Gamemode, hilf uns beim Dokumentieren von Skriptfunktionen, schreibe Beispielcode, Tutorials oder reporte einfach nur die Fehler, die Du beim Spielen von MTA entdeckst.

Solltest Du Fragen oder Probleme bezüglich des Scriptings haben, so kannst Du uns gerne jederzeit in unserem [[IRC Channel|IRC Kanal]] besuchen.
<br><br>''Stop playing with yourself''
</div>
|}
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
|-
|width="50%" style="vertical-align:top;" |<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Input-gaming.png‎]]</div>
=== Spielen ===
<div style="background: #FFEEAA;">
[[File:Go-down.png|link=http://mtasa.com/]] ''' [http://mtasa.com/ Download Multi Theft Auto: San Andreas {{Current Version|full}}]'''</div>
* [[File:De.gif|Deutscher Artikel]] [[DE/MTA DM Client Anleitung|Client Anleitung]]
* [[File:Usen.gif|Englischer Artikel]] [[Changes_in_1.2|Änderungen in 1.2]]
* [[File:Usen.gif|Englischer Artikel]] [[Known_Issues_-_FAQ|Bekannte Probleme]]
* [[File:Usen.gif|Englischer Artikel]] [[Upgrading_from_MTA:Race|Wechsel von MTA:Race zu MTA:SA 1.0.x]]
* [[File:De.gif|Deutscher Artikel]] [[DE/Server Anleitung|Server Anleitung]]
* [[File:Usen.gif|Englischer Artikel]] [[Map manager|Map Manager]]

=== Map Editor ===
* [[File:De.gif|Deutscher Artikel]] [[DE/Resource:Editor|Anleitung]]
* [[File:Usen.gif|Englischer Artikel]] [[Resource:Editor/EDF|Editor Definition Format (EDF)]]
* [[File:De.gif|Deutscher Artikel]] [[Resource:DE/Editor/Plugins|Plugins]]
* [[File:Usen.gif|Englischer Artikel]] [[Resource:Editor#FAQ|Frequently Asked Questions]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Package-x-generic.png‎]]</div>

=== Datenbanken ===
Hier findest Du Informationen zu verfügbaren Module und Ressourcen.
* [[File:Usen.gif|Englischer Artikel]] [[:Category:Resource|Ressourcenkatalog]] - Hilfreich bei der Erstellung eigener Gamemodes
* [[File:Usen.gif|Englischer Artikel]] [[Client side scripts|Clientseitige Skripte]]
* [[File:Usen.gif|Englischer Artikel]] [[Modules|Module]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-development.png‎‎‎]]</div>
=== Multi Theft Auto Entwicklung ===
[[File:Go-down.png|link=http://nightly.mtasa.com/]] [http://nightly.mtasa.com/ Nightly builds]
* [[File:Usen.gif|Englischer Artikel]] [[Compiling_MTASA|MTA:SA Kompilierung unter Windows]]
* [[File:Usen.gif|Englischer Artikel]] [[Building_MTASA_Server_on_Mac_OS_X|MTA:SA Kompilierung unter Mac OS X]]
* [[File:Usen.gif|Englischer Artikel]] [[Building_MTASA_Server_on_GNU_Linux|MTA:SA Kompilierung unter GNU/Linux]]
* [[File:Usen.gif|Englischer Artikel]] [[Coding guidelines|Coding Guidelines]]
* [http://code.google.com/p/mtasa-blue Google Code SVN]
* [[File:Usen.gif|Englischer Artikel]] [[Roadmap]]
* [http://bugs.mtasa.com/ Bugtracker]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-office.png‎]]</div>

=== Wiki - Wie Du helfen kannst ===
* Vervollständige [[:Category:Incomplete|unvollständige Funktionsdokumentationen]].
* [[:Category:Needs_Example|Erstelle Beispiele für Funktionen und Events]].
* Prüfe [[:Category:Needs Checking|zu überprüfende Seiten]].
* Schreibe Tutorials und hilf Neulingen.
* Übersetze Artikel im Wiki.
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Internet-group-chat.png‎]]</div>
=== Community ===
* [http://forum.multitheftauto.com/ Forum]
* [[File:Usen.gif|Offizieller Englischer Kanal]] IRC: [irc://irc.multitheftauto.com/mta irc.multitheftauto.com #mta]
* [[File:De.gif|Inoffizieller Deutscher Kanal]] IRC: [irc://irc.multitheftauto.com/mta.german irc.multitheftauto.com #mta.german]
* [http://community.mtasa.com/ MTA Community] - Teile Deine Ressourcen mit anderen.
* [http://www.youtube.com/user/MTAQA Youtube Kanal]
</div>

| width="50%" style="vertical-align:top;" |

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Accessories-text-editor.png]]</div>
=== Scripting ===
* [[File:De.gif|Deutscher Artikel]] [[DE/MTA Scripting Grundlagen|Scripting Grundlagen]]
* [[File:Usen.gif|Englischer Artikel]] [[Introduction to Scripting the GUI|GUI Scripting Grundlagen]]
* [[File:Usen.gif|Englischer Artikel]] [[Debugging|Debugging Tutorial]] - Wie man Fehler in seinem Skript findet
* [[File:Usen.gif|Englischer Artikel]] [[Resources|Ressourcen Grundlagen]]
** [[File:Usen.gif|Englischer Artikel]] [[Resource Web Access|Webzugriff]] - Zugriff auf Ressourcen via HTTP
** [[:Category:Resource|Ressourcenkatalog]]
** [[File:Usen.gif|Englischer Artikel]] [[Meta.xml]] - Die Datei, die ein Verzeichnis zur Ressource macht
** [[File:Usen.gif|Englischer Artikel]] [[ACL]] - Access Control List (Zugriffskontrollliste): Wichtig für komplexere Ressourcen
* [[File:Usen.gif|Englischer Artikel]] [[Writing_Gamemodes|Gamemodes erstellen]]
* [[File:Usen.gif|Englischer Artikel]] [[Useful_Functions|Nützliche Funktionen]] - von Skriptern für Skripter
<div style="float:right; width: 32px;">[[File:start-here.png]]</div>
=== Allgemeine Hilfe zu Lua ===
Links und Artikel zur Sprache Lua
* [[File:De.gif|Deutscher Artikel]] [[DE/Lua Tutorial|Lua Tutorial]] - für Menschen ohne Programmiererfahrung geeignet
* [[File:De.gif|Deutscher Artikel]] [http://lua.gts-stolberg.de „Lua für Anfänger“]
* [[File:Usen.gif|Englischer Artikel]] [http://www.lua.org/pil/index.html "Programming in Lua"]
** [[File:Usen.gif|Englische Seite]] [http://www.lua.org/manual/5.1/#index Offizielle Lua Funktionsreferenz]
* [[File:Usen.gif|Englische Seite]] [http://lua-users.org/wiki/TutorialDirectory Lua Wiki]
* [[File:Usen.gif|Englischer Artikel]] [http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Allgemeine Hilfe zu Lua von Nixstaller]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#CCCCFF;">
=== Referenz ===
* [[Client Scripting Functions|Clientseitige Funktionen]]
* [[Client Scripting Events|Clientseitige Events]]
* [[Server Scripting Functions|Serverseitige Funktionen]]
* [[Server Scripting Events|Serverseitige Events]]

* [[File:Usen.gif|Englischer Artikel]] [[MTA Classes|MTA Klassen]] - Detaillierte Beschreibung aller MTA Datentypen
** [[File:Usen.gif|Englischer Artikel]] [[Element|MTA Elemente]] / [[File:Usen.gif|Englischer Artikel]] [[Element tree|Elementbaum]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:System-file-manager.png]]</div>
=== [[Id|ID Listen]] ===
* [[File:Usen.gif|Englischer Artikel]] [[Animations|Animationen]]
* [[File:Usen.gif|Englischer Artikel]] [[Vehicle IDs|Fahrzeuge]]
* [[File:Usen.gif|Englischer Artikel]] [[Vehicle Colors|Fahrzeugfarben]]
* [[File:Usen.gif|Englischer Artikel]] [[Vehicle variants|Fahrzeugvarianten]]
* [[File:Usen.gif|Englischer Artikel]] [[Garage|Garagen]]
* [[File:Usen.gif|Englischer Artikel]] [[Interior IDs|Interiors]]
* [[File:Usen.gif|Englischer Artikel]] [[CJ_Clothes|Kleidung]]
* [[File:Usen.gif|Englischer Artikel]] [[Material IDs|Materials]]
* [[File:Usen.gif|Englischer Artikel]] [[Projectiles|Projektile]]
* [[File:Usen.gif|Englischer Artikel]] [[Radar Blips|Radaricons]]
* [[File:Usen.gif|Englischer Artikel]] [[Character Skins|Skins]] ([[All Skins Page|alle]])
* [[File:Usen.gif|Englischer Artikel]] [[Sounds]]
* [[File:Usen.gif|Englischer Artikel]] [[Vehicle Upgrades|Tuningteile]]
* [[File:De.gif|Deutscher Artikel]] [[DE/Waffen|Waffen]]
* [[File:De.gif|Deutscher Artikel]] [[DE/Weather|Wetter]]
</div>
<div style="padding:4px 8px 8px 8px; margin:10px;">
[[File:Osi symbol.png|75px|link=http://opensource.org/]]
'''Multi Theft Auto''' ist '''Open Source'''.
Das heißt, dass jeder zur Verbesserung von Multi Theft Auto beitragen kann!
</div>

|-
| colspan="2" |
|}
[[en:Main Page]]
[[es:Pagina Principal]]
[[fr:Main Page‎]]
[[it:Pagina principale]]
[[nl:Main Page]]
[[pl:Main Page]]
[[ru:Main Page]]

DE/Hauptseite

2011-12-21T10:40:05Z

NeonBlack: adapted the new main page

__NOTOC__
__NOEDITSECTION__
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
<div style="border: 1px solid #D8D8D8; padding: 5px; height: 130px;">
[[File:Mtalogo.png|left|100px]]'''Willkommen im Multi Theft Auto Wiki.''' Hier findest Du eine Fülle an Informationen zu Multi Theft Auto.

Es gibt eine Menge [[How you can help|Dinge, die Du tun kannst, um uns bei der Verbesserung von MTA zu helfen]] - erstelle eine Map, einen Gamemode, hilf uns beim Dokumentieren von Skriptfunktionen, schreibe Beispielcode, Tutorials oder reporte einfach nur die Fehler, die Du beim Spielen von MTA entdeckst.

Solltest Du Fragen oder Probleme bezüglich des Scriptings haben, so kannst Du uns gerne jederzeit in unserem [[IRC Channel|IRC Kanal]] besuchen.
<br><br>''Stop playing with yourself''
</div>
|}
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |
|-
|width="50%" style="vertical-align:top;" |<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Input-gaming.png‎]]</div>
=== Spielen ===
<div style="background: #FFEEAA;">
[[File:Go-down.png|link=http://mtasa.com/]] ''' [http://mtasa.com/ Download Multi Theft Auto: San Andreas {{Current Version|full}}]'''</div>
* [[File:De.gif|Deutscher Artikel]] [[DE/MTA DM Client Anleitung|Client Anleitung]]
* [[File:Usen.gif|Englischer Artikel]] [[Changes_in_1.2|Änderungen in 1.2]]
* [[File:Usen.gif|Englischer Artikel]] [[Known_Issues_-_FAQ|Bekannte Probleme]]
* [[File:Usen.gif|Englischer Artikel]] [[Upgrading_from_MTA:Race|Wechsel von MTA:Race zu MTA:SA 1.0.x]]
* [[File:De.gif|Deutscher Artikel]] [[DE/Server Anleitung|Server Anleitung]]
* [[File:Usen.gif|Englischer Artikel]] [[Map manager|Map Manager]]

=== Map Editor ===
* [[File:De.gif|Deutscher Artikel]] [[DE/Resource:Editor|Anleitung]]
* [[File:Usen.gif|Englischer Artikel]] [[Resource:Editor/EDF|Editor Definition Format (EDF)]]
* [[File:De.gif|Deutscher Artikel]] [[Resource:DE/Editor/Plugins|Plugins]]
* [[File:Usen.gif|Englischer Artikel]] [[Resource:Editor#FAQ|Frequently Asked Questions]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Package-x-generic.png‎]]</div>

=== Datenbanken ===
Hier findest Du Informationen zu verfügbaren Module und Ressourcen.
* [[File:Usen.gif|Englischer Artikel]] [[:Category:Resource|Ressourcenkatalog]] - Hilfreich bei der Erstellung eigener Gamemodes
* [[File:Usen.gif|Englischer Artikel]] [[Client side scripts|Clientseitige Skripte]]
* [[File:Usen.gif|Englischer Artikel]] [[Modules|Module]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-development.png‎‎‎]]</div>
=== Multi Theft Auto Entwicklung ===
[[File:Go-down.png|link=http://nightly.mtasa.com/]] [http://nightly.mtasa.com/ Nightly builds]
* [[File:Usen.gif|Englischer Artikel]] [[Compiling_MTASA|MTA:SA Kompilierung unter Windows]]
* [[File:Usen.gif|Englischer Artikel]] [[Building_MTASA_Server_on_Mac_OS_X|MTA:SA Kompilierung unter Mac OS X]]
* [[File:Usen.gif|Englischer Artikel]] [[Building_MTASA_Server_on_GNU_Linux|MTA:SA Kompilierung unter GNU/Linux]]
* [[File:Usen.gif|Englischer Artikel]] [[Coding guidelines|Coding Guidelines]]
* [http://code.google.com/p/mtasa-blue Google Code SVN]
* [[File:Usen.gif|Englischer Artikel]] [[Roadmap]]
* [http://bugs.mtasa.com/ Bugtracker]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Applications-office.png‎]]</div>

=== Wiki - Wie Du helfen kannst ===
* Vervollständige [[:Category:Incomplete|unvollständige Funktionsdokumentationen]].
* [[:Category:Needs_Example|Erstelle Beispiele für Funktionen und Events]].
* Prüfe [[:Category:Needs Checking|zu überprüfende Seiten]].
* Schreibe Tutorials und hilf Neulingen.
* Übersetze Artikel im Wiki.
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Internet-group-chat.png‎]]</div>
=== Community ===
* [http://forum.multitheftauto.com/ Forum]
* [[File:Usen.gif|Offizieller Englischer Kanal]] IRC: [irc://irc.multitheftauto.com/mta irc.multitheftauto.com #mta]
* [[File:De.gif|Inoffizieller Deutscher Kanal]] IRC: [irc://irc.multitheftauto.com/mta.german irc.multitheftauto.com #mta.german]
* [http://community.mtasa.com/ MTA Community] - Teile Deine Ressourcen mit anderen.
* [http://www.youtube.com/user/MTAQA Youtube Kanal]
</div>

| width="50%" style="vertical-align:top;" |

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:Accessories-text-editor.png]]</div>
=== Scripting ===
* [[File:De.gif|Deutscher Artikel]] [[DE/MTA Scripting Grundlagen|Scripting Grundlagen]]
* [[File:Usen.gif|Englischer Artikel]] [[Introduction to Scripting the GUI|GUI Scripting Grundlagen]]
* [[File:Usen.gif|Englischer Artikel]] [[Debugging|Debugging Tutorial]] - Wie man Fehler in seinem Skript findet
* [[File:Usen.gif|Englischer Artikel]] [[Resources|Ressourcen Grundlagen]]
** [[File:Usen.gif|Englischer Artikel]] [[Resource Web Access|Webzugriff]] - Zugriff auf Ressourcen via HTTP
** [[:Category:Resource|Ressourcenkatalog]]
** [[File:Usen.gif|Englischer Artikel]] [[Meta.xml]] - Die Datei, die ein Verzeichnis zur Ressource macht
** [[File:Usen.gif|Englischer Artikel]] [[ACL]] - Access Control List (Zugriffskontrollliste): Wichtig für komplexere Ressourcen
* [[File:Usen.gif|Englischer Artikel]] [[Writing_Gamemodes|Gamemodes erstellen]]
* [[File:Usen.gif|Englischer Artikel]] [[Useful_Functions|Nützliche Funktionen]] - von Skriptern für Skripter
<div style="float:right; width: 32px;">[[File:start-here.png]]</div>
=== Allgemeine Hilfe zu Lua ===
Links und Artikel zur Sprache Lua
* [[File:De.gif|Deutscher Artikel]] [[DE/Lua Tutorial|Lua Tutorial]] - für Menschen ohne Programmiererfahrung geeignet
* [[File:De.gif|Deutscher Artikel]] [http://lua.gts-stolberg.de „Lua für Anfänger“]
* [[File:Usen.gif|Englischer Artikel]] [http://www.lua.org/pil/index.html "Programming in Lua"]
** [[File:Usen.gif|Englische Seite]] [http://www.lua.org/manual/5.1/#index Offizielle Lua Funktionsreferenz]
* [[File:Usen.gif|Englische Seite]] [http://lua-users.org/wiki/TutorialDirectory Lua Wiki]
* [[File:Usen.gif|Englischer Artikel]] [http://nixstaller.berlios.de/manual/0.2/nixstaller_9.html Allgemeine Hilfe zu Lua von Nixstaller]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; background:#CCCCFF;">
=== Referenz ===
* [[Client Scripting Functions|Clientseitige Funktionen]]
* [[Client Scripting Events|Clientseitige Events]]
* [[Server Scripting Functions|Serverseitige Funktionen]]
* [[Server Scripting Events|Serverseitige Events]]

* [[File:Usen.gif|Englischer Artikel]] [[MTA Classes|MTA Klassen]] - Detaillierte Beschreibung aller MTA Datentypen
** [[File:Usen.gif|Englischer Artikel]] [[Element|MTA Elemente]] / [[File:Usen.gif|Englischer Artikel]] [[Element tree|Elementbaum]]
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px;">
<div style="float:right; width: 32px;">[[File:System-file-manager.png]]</div>
=== [[Id|ID Listen]] ===
* [[File:Usen.gif|Englischer Artikel]] [[Animations|Animationen]]
* [[File:Usen.gif|Englischer Artikel]] [[Vehicle IDs|Fahrzeuge]]
* [[File:Usen.gif|Englischer Artikel]] [[Vehicle Colors|Fahrzeugfarben]]
* [[File:Usen.gif|Englischer Artikel]] [[Vehicle variants|Fahrzeugvarianten]]
* [[File:Usen.gif|Englischer Artikel]] [[Garage|Garagen]]
* [[File:Usen.gif|Englischer Artikel]] [[Interior IDs|Interiors]]
* [[File:Usen.gif|Englischer Artikel]] [[CJ_Clothes|Kleidung]]
* [[File:Usen.gif|Englischer Artikel]] [[Material IDs|Materials]]
* [[File:Usen.gif|Englischer Artikel]] [[Projectiles|Projektile]]
* [[File:Usen.gif|Englischer Artikel]] [[Radar Blips|Radaricons]]
* [[File:Usen.gif|Englischer Artikel]] [[Character Skins|Skins]] ([[All Skins Page|alle]])
* [[File:Usen.gif|Englischer Artikel]] [[Sounds]]
* [[File:Usen.gif|Englischer Artikel]] [[Vehicle Upgrades|Tuningteile]]
* [[File:De.gif|Deutscher Artikel]] [[DE/Waffen|Waffen]]
* [[File:De.gif|Deutscher Artikel]] [[DE/Weather|Wetter]]
</div>
<div style="padding:4px 8px 8px 8px; margin:10px;">
[[File:Osi symbol.png|75px|link=http://opensource.org/]]
'''Multi Theft Auto''' ist '''Open Source'''.
Das heißt, dass jeder zur Verbesserung von Multi Theft Auto beitragen kann!
</div>

|-
| colspan="2" |
|}
[[de:Hauptseite]]
[[es:Pagina Principal]]
[[fr:Main Page‎]]
[[it:Pagina principale]]
[[nl:Main Page]]
[[pl:Main Page]]
[[ru:Main Page]]

Talk:GetAlivePlayersInTeam

2011-05-21T12:18:27Z

NeonBlack: suggestions for improvement

==== Suggestions for Improvement ====
* don't use <tt>table</tt> as variable name, since it holds a reference to Lua's standard table functions by default
* use <tt>table.insert</tt> instead of <tt>foo[#foo+1] = bar</tt>
[ [[User:NeonBlack|NeonBlack]] 14:18, 21 May 2011 (CEST) ]

User:NeonBlack

2011-05-21T09:38:55Z

NeonBlack:

Just writing anything so that my name isn't red anymore :Þ
-- [[User:NeonBlack|NeonBlack]] 04:25, 3 August 2008 (CEST)

<span style="text-decoration: line-through;">'''NeonBlack is now known as Neon on this wiki since I wasn't able to log in using my old account (whyever).'''
-- [[User:Neon|Neon]] 14:56, 25 November 2010 (UTC)</span>

Blokker assigned my old NeonBlack account to my OpenID so that I can use it again. :D --[[User:NeonBlack|NeonBlack]] 11:38, 21 May 2011 (CEST)

==ToDo==
*Translate [[Resource:Editor]] --[[User:NeonBlack|NeonBlack]] 17:09, 31 August 2009 (UTC)

User:NeonBlack

2011-05-21T09:38:12Z

NeonBlack:

Just writing anything so that my name isn't red anymore :Þ
-- [[User:NeonBlack|NeonBlack]] 04:25, 3 August 2008 (CEST)

<span style="text-decoration: line-through;">'''NeonBlack is now known as Neon on this wiki since I wasn't able to log in using my old account (whyever).'''
-- [[User:Neon|Neon]] 14:56, 25 November 2010 (UTC)</span>

Blokker assigned my old NeonBlack account to my OpenID so that I can use it again. :D --~~

==ToDo==
*Translate [[Resource:Editor]] --[[User:NeonBlack|NeonBlack]] 17:09, 31 August 2009 (UTC)

User:NeonBlack

2011-05-21T09:37:46Z

NeonBlack:

Just writing anything so that my name isn't red anymore :Þ
-- [[User:NeonBlack|NeonBlack]] 04:25, 3 August 2008 (CEST)

<span style="text-decoration: line-through;">'''NeonBlack is now known as Neon on this wiki since I wasn't able to log in using my old account (whyever).'''
-- [[User:Neon|Neon]] 14:56, 25 November 2010 (UTC)</span>

Blokker assigned my old NeonBlack account to my OpenID so that I can use it again. :D ---~

==ToDo==
*Translate [[Resource:Editor]] --[[User:NeonBlack|NeonBlack]] 17:09, 31 August 2009 (UTC)

Template:Useful Functions

2010-07-19T10:40:04Z

NeonBlack:

*[[callClientFunction]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function allows you to call any clientside function from the server's side.</span>

*[[callServerFunction]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function allows you to call any server-side function from the client's side.</span>

*[[Check]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function checks if it's arguments are of the right types and calls the error-function if one isn't.</span>

*[[doForAllElements]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function can be used to execute a specified function for all elements of a specified type.</span>

*[[iterElements]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Returns an iterator for your for loops saving time typing ipairs( getElementsByType( type ) ), instead you type: iterElements( type ).</span>

*[[findRotation]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Takes two points and returns the direction from point A to point B.</span>

*[[FormatDate]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Formats a date on the basis of a format string and returns it.</span>

*[[getAge]] <span style="color:gray; font-family:'Georgia', sans-serif; font-size:smaller;">» This function calculates the age of a birthday.</span>

*[[getPointFromDistanceRotation]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Finds a point based on a starting point, direction and distance.</span>

*[[getTimestamp]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» With this function you can get the [http://en.wikipedia.org/wiki/Unix_time UNIX timestamp].</span>

*[[IfElse]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Returns one of two values based on a boolean expression.</span>

*[[isLeapYear]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Checks if the given year is a leap year.</span>

*[[math.round]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Rounds a number whereas the number of decimals to keep and the method may be set.</span>

*[[setTableProtected]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Protects a table and makes it read-only.</span>

*[[setVehicleGravityPoint]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This clientside function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.</span>

*[[string.explode]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function splits a string at a given separator pattern and returns a table with the pieces.</span>

*[[table.copy]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function copies a whole table and all the tables in that table.</span>

*[[table.map]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function goes through a table and replaces every field with the return of the passed function, where the field's value is passed as first argument and optionally more arguments.</span>

*[[table.size]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Finds the absolute size of a table.</span>

*[[var_dump]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">»This function outputs information about one or more variables using outputConsole(). </span>

[[Category:Useful Functions]]

IsLeapYear

2010-07-19T10:38:01Z

NeonBlack: new version of IsYearALeapYear and updated example

{{Useful Function}}
__NOTOC__
This function checks if a year is a leap year or not.

==Syntax==
<syntaxhighlight lang="lua">bool isLeapYear( [ int year=getRealTime().year+1900 ] )</syntaxhighlight>

===Optional Arguments===
* '''year''': The year you want to check. Default is your local year.

===Returns===
Returns ''true'' if the year is a leap year, ''false'' otherwise.

==Code==
<section name="Server- and/or clientside Script" class="both" show="true">
<syntaxhighlight lang="lua">
function isLeapYear(year)
if year then year = math.floor(year)
else year = getRealTime().year + 1900 end
return ((year % 4 == 0 and year % 100 ~= 0) or year % 400 == 0)
end
</syntaxhighlight>
</section>

==Example==
<section name="Server" class="server" show="true">
This example tells the player if the given year is a leap year.
<syntaxhighlight lang="lua">
-- define the command handler
addCommandHandler("isYearALeapYear", function (source, cmd, year)
-- check if the player passed a year
year = tonumber(year) or getRealTime().year + 1900
-- check if the given year is a leap year
local leapYear = IsYearALeapYear(year)
--send an answer to the player
if leapYear then
outputChatBox("The year "..year.." is a leap year.", source)
else
outputChatBox("The year "..year.." isn't a leap year.", source)
end
end, false, false)
</syntaxhighlight>
</section>

Author: NeonBlack

==See Also==
{{Useful_Functions}}

Template:Useful Function

2010-07-19T10:29:18Z

NeonBlack: lowercasetitle

<pageclass class="#228B22" subcaption="Useful Function"></pageclass>
<lowercasetitle></lowercasetitle>
[[Category:Useful Functions]]

GetTimestamp

2010-07-19T10:24:53Z

NeonBlack: completely new version with updated example

{{Useful Function}}
__NOTOC__
With this function you can get the [http://en.wikipedia.org/wiki/Unix_time UNIX timestamp].

==Syntax==
<syntaxhighlight lang="lua">int getTimestamp( [ int year = getRealTime().year + 1900, int month = getRealTime().month + 1, int day = getRealTime().day, int hour = getRealTime().hour, minute = getRealTime().minute, int second = getRealTime().second ] )</syntaxhighlight>

===Optional Arguments===
{{OptionalArg}}
* '''year''': The year of the date you want to retrieve the UNIX timestamp of. Default is your local year. Must be greater than 1969.
* '''month''': The month of the date you want to retrieve the UNIX timestamp of. Default is your local month. (1-12)
* '''day''': The day of the date you want to retrieve the UNIX timestamp of. Default is your local day. (1-31)
* '''hour''': The hour of the date you want to retrieve the UNIX timestamp of. Default is your local hour. (0-23)
* '''minute''': The minute of the date you want to retrieve the UNIX timestamp of. Default is your local minute. (0-59)
* '''second''': The second of the date you want to retrieve the UNIX timestamp of. Default is your local second. (0-59)

===Returns===
Returns an UNIX timestamp.

==Code==
{{RequiredFunctions|isLeapYear}}
<section name="Client- and/or serverside Script" class="both" show="true">
<syntaxhighlight lang="lua">
function getTimestamp(year, month, day, hour, minute, second)
-- initiate variables
local monthseconds = { 2678400, 2419200, 2678400, 2592000, 2678400, 2592000, 2678400, 2678400, 2592000, 2678400, 2592000, 2678400 }
local timestamp = 0
local datetime = getRealTime()
year, month, day = year or datetime.year + 1900, month or datetime.month + 1, day or datetime.monthday
hour, minute, second = hour or datetime.hour, minute or datetime.minute, second or datetime.second

-- calculate timestamp
for i=1970, year-1 do timestamp = timestamp + (isLeapYear(i) and 31622400 or 31536000) end
for i=1, month-1 do timestamp = timestamp + ((isLeapYear(year) and i == 2) and 2505600 or monthseconds[i]) end
timestamp = timestamp + 86400 * (day - 1) + 3600 * hour + 60 * minute + second

timestamp = timestamp - 3600 --GMT+1 compensation
if datetime.isdst then timestamp = timestamp - 3600 end

return timestamp
end
</syntaxhighlight>
</section>

==Example==
<section name="Server" class="server" show="true">
This example saves the time of the player's joining.
<syntaxhighlight lang="lua">
-- define the event handler
addEventHandler("onPlayerJoin", root, function ()
-- get the actual UNIX timestamp
local datetime = getTimestamp()
-- attach the time to the player's element
setElementData(source, "joinTime", datetime)
end)
</syntaxhighlight>
</section>

Author: NeonBlack

==See Also==
{{Useful_Functions}}

Talk:SetAccountData

2010-04-06T18:36:32Z

NeonBlack: answer

'''On April 06 2010 - 7:22 GMT''' Cezar said:<br />
How does this work? Does it save information on the client's computer? Isn't that prone to hacking?
----
Accounts are completely serverside so their data is probably serverside, too. But even if this data would be clientside MTA does save all data in a save xml format, which cannot be destroyed due to escaping and stuff, so no need to worry.<br/>
[[User:NeonBlack|NeonBlack]] 18:36, 6 April 2010 (UTC)
----

GuiGridListSetItemData

2010-04-06T18:29:41Z

NeonBlack: added note

{{Client function}}
__NOTOC__
This function sets a Item Data associated to a grid list item.<br/>
'''Note:''' This function will only work '''after''' you set the item's text using [[guiGridListSetItemText]]!

==Syntax==
<syntaxhighlight lang="lua">
bool guiGridListSetItemData ( element gridList, int rowIndex, int columnIndex, string data )
</syntaxhighlight>

===Required Arguments===
*'''gridList:''' A gridlist element of the data you wish to set to
*'''rowIndex:''' The row of the item you wish to set to
*'''columnIndex:''' The column of the item you wish to set to
*'''data:''' The data you wish to set to the item.

===Returns===
Returns ''true'' if the data was set successfully, false otherwise

==Example==
This page lacks an example
<syntaxhighlight lang="lua">
--Add an example here
</syntaxhighlight>

==See Also==
{{GUI functions}}
[[Category:Needs Example]]

GuiGridListGetItemData

2010-04-06T18:29:09Z

NeonBlack: added note

{{Client function}}
__NOTOC__
With this function you can retrieve the [[string]] data associated with an item in a [[Element/GUI/Gridlist|grid list]]. This is not the text that is displayed on the item, but an internal string that you can use to hold extra information about the item.<br/>
'''Note:''' This function will only work '''after''' you set the item's text using [[guiGridListSetItemText]]!

==Syntax==
<syntaxhighlight lang="lua">
string guiGridListGetItemData ( element gridList, int rowIndex, int columnIndex )
</syntaxhighlight>

===Required Arguments===
*'''gridList:''' the grid list containing the item you're interested in
*'''rowIndex:''' the row index of the item
*'''columnIndex:''' the column index of the item

===Returns===
Returns a [[string]] with the item data of the specified item if succesful, ''false'' if one of the arguments was invalid.

==Example==
This example displays a random item data from the gridlist.
<syntaxhighlight lang="lua">
function clientsideResourceStart ()
local numberList = guiCreateGridList ( 0.80, 0.10, 0.15, 0.60, true )
local column = guiGridListAddColumn ( numberList, "Column Title", 0.85 )
if ( column ) then
local row = guiGridListAddRow ( numberList )
local myItem = guiGridListSetItemText ( numberList, row, column, tostring( math.random(0, 10) ^ 100 ), false, false )
local myItemData = guiGridListGetItemData ( numberList, row, column )
outputChatBox ( "My gridlist item data: " .. myItemData )
end
end
addEventHandler ( "onClientResourceStart", getRootElement(), clientsideResourceStart )
</syntaxhighlight>

==See Also==
{{GUI functions}}

Talk:GuiGridListGetItemData

2010-04-06T18:27:24Z

NeonBlack: Created page with 'Regarding this function: http://bugs.mtasa.com/view.php?id=4459<br/> ~~~~'

Regarding this function: http://bugs.mtasa.com/view.php?id=4459<br/>
[[User:NeonBlack|NeonBlack]] 18:27, 6 April 2010 (UTC)

Talk:GuiGridListSetItemData

2010-04-06T18:26:43Z

NeonBlack:

Regarding this function: http://bugs.mtasa.com/view.php?id=4459<br/>
[[User:NeonBlack|NeonBlack]] 18:26, 6 April 2010 (UTC)

Talk:GuiGridListSetItemData

2010-04-06T18:26:20Z

NeonBlack: Created page with 'Regarding this function: http://bugs.mtasa.com/view.php?id=4459 ~~~~'

Regarding this function: http://bugs.mtasa.com/view.php?id=4459
[[User:NeonBlack|NeonBlack]] 18:26, 6 April 2010 (UTC)

SetTimer

2010-03-31T15:44:34Z

NeonBlack: /* Syntax */ added information on tables and their metatables as arguments

BindKey

2010-03-27T17:29:28Z

NeonBlack: /* Optional Arguments */ arguments may not be functions !!?

{{Server client function}}
__NOTOC__
Binds a player's key to a handler function or command, which will be called when the key is pressed.

==Syntax==
<section name="Server - Syntax 1" class="server" show="true">
<syntaxhighlight lang="lua">bindKey ( player thePlayer, string key, string keyState, function handlerFunction, [ var arguments, ... ] )</syntaxhighlight>

===Required Arguments===
*'''thePlayer:''' The player you wish to bind the key of.
*'''key:''' The key or control you wish to bind to the command. See [[key names]] for a list of possible keys and [[control names]] for a list of possible controls.
*'''keyState:''' A string that has one of the following values:
**'''"up":''' If the bound key should trigger the function when the key is released
**'''"down":''' If the bound key should trigger the function when the key is pressed
**'''"both":''' If the bound key should trigger the function when the key is pressed or released
*'''handlerFunction:''' The function that will be triggered when the player's key is pressed. This function should have the form:
:<syntaxhighlight lang="lua">function functionName ( player keyPresser, string key, string keyState, [ var arguments, ... ] )</syntaxhighlight>
:The values passed to this function are:
:*'''keyPresser:''' The player who pressed the key
:*'''key:''' The key that was pressed
:*'''keyState:''' The state of the key that was pressed, ''down'' if it was pressed, ''up'' if it was released.
:*'''arguments''' The optional arguments you specified when calling [[bindKey]] (see below).
</section>

{{New feature|3|1.0|
<section name="Server - Syntax 2" class="server" show="false">
This alternative syntax allows you to bind a key with a command. This will also allow users to customize the control in their Settings menu. Use in conjunction with [[addCommandHandler]] to add handler functions to the keybind.

<syntaxhighlight lang="lua">bindKey ( player thePlayer, string key, string keyState, string commandName, string arguments )</syntaxhighlight>

===Required Arguments===
*'''thePlayer:''' The player you wish to bind the key of.
*'''key:''' The key or control you wish to bind to the command. See [[key names]] for a list of possible keys.
*'''keyState:''' A string that has one of the following values:
**'''"up":''' If the bound key should trigger the function when the key is released
**'''"down":''' If the bound key should trigger the function when the key is pressed
**'''"both":''' If the bound key should trigger the function when the key is pressed or released
*'''commandName:''' The name of the command that the key should be binded to.
*'''arguments''' Space delimited arguments that are entered as if one was typing the command.
</section>
}}

<section name="Client - Syntax 1" class="client" show="true">
<syntaxhighlight lang="lua">bindKey ( string key, string keyState, function handlerFunction, [ var arguments, ... ] ) </syntaxhighlight>

===Required Arguments===
*'''key:''' The key or control you wish to bind to the command. See [[key names]] for a list of possible keys and [[control names]] for a list of possible controls.
*'''keyState:''' A string that has one of the following values:
**'''"up":''' If the bound key should trigger the function when the key is released
**'''"down":''' If the bound key should trigger the function when the key is pressed
**'''"both":''' If the bound key should trigger the function when the key is pressed or released

*'''handlerFunction:''' The function that will be triggered when the player's key is pressed. This function should have the form:
:<syntaxhighlight lang="lua">function functionName ( string key, string keyState, [ var arguments, ... ] )</syntaxhighlight>
:The values passed to this function are:
:*'''key:''' The key that was pressed
:*'''keyState:''' The state of the key that was pressed, ''down'' if it was pressed, ''up'' if it was released.
:*'''arguments''' The optional arguments you specified when calling [[bindKey]] (see below).
</section>

{{New feature|3|1.0|
<section name="Client - Syntax 2" class="client" show="false">
This alternative syntax allows you to bind a key with a command. This will also allow users to customize the control in their Settings menu. Use in conjunction with [[addCommandHandler]] to add handler functions to the keybind.

<syntaxhighlight lang="lua">bindKey ( string key, string keyState, string commandName, string arguments )</syntaxhighlight>

===Required Arguments===
*'''key:''' The key or control you wish to bind to the command. See [[key names]] for a list of possible keys.
*'''keyState:''' A string that has one of the following values:
**'''"up":''' If the bound key should trigger the function when the key is released
**'''"down":''' If the bound key should trigger the function when the key is pressed
**'''"both":''' If the bound key should trigger the function when the key is pressed or released
*'''commandName:''' The name of the command that the key should be binded to.
*'''arguments''' Space delimited arguments that are entered as if one was typing the command.
</section>
}}

===Optional Arguments===
{{OptionalArg}}
*'''arguments:''' Any arguments you may want to pass to the function when the key is pressed by the user. Any number of arguments of can be specified, each being passed to the designated function. You may not pass functions.

==Example==
Example 1
<section name="Server" class="server" show="true">
This example will bind a player's 'F1' key and 'fire' control to 1 input function.
<syntaxhighlight lang="lua">
function funcInput ( player, key, keyState )
local state = "let go of"
if ( keyState == "down" ) then
state = "pressed"
end
outputChatBox ( getPlayerName ( player) .. " " .. state .. " the " .. key .. " key!" )
end

function bindTheKeys ( player, commandName )
bindKey ( player, "F1", "down", funcInput ) -- bind the player's F1 down key
bindKey ( player, "F1", "up", funcInput ) -- bind the player's F1 up key
bindKey ( player, "fire", "both", funcInput ) -- bind the player's fire down and up control
end
addCommandHandler ( "bindme", bindTheKeys )
</syntaxhighlight>
</section>

Example 2
<section name="Client" class="client" show="true">
This example will bind a player's 'F1' key and 'fire' control to 1 input function, clientside.
<syntaxhighlight lang="lua">
function funcInput ( key, keyState )
local state = "let go of"
if ( keyState == "down" ) then
state = "pressed"
end
outputChatBox ( "You " .. state .. " the " .. key .. " key!" )
end

function bindTheKeys ()
bindKey ( "F1", "down", funcInput ) -- bind the player's F1 down key
bindKey ( "F1", "up", funcInput ) -- bind the player's F1 up key
bindKey ( "fire", "both", funcInput ) -- bind the player's fire down and up control
end
addCommandHandler ( "bindme", bindTheKeys )
</syntaxhighlight>
</section>

==See Also==
{{Input functions}}

XmlNodeGetAttribute

2010-03-25T18:16:41Z

NeonBlack: /* Returns */ added default return value if attribute does not exist

__NOTOC__
{{Server client function}}
This function is used to return an attribute of a node in a configuration file.

==Syntax==
<syntaxhighlight lang="lua">
string xmlNodeGetAttribute ( xmlnode node, string name )
</syntaxhighlight>

===Required Arguments===
*'''node:''' The node from which you wish to return the attribute
*'''name:''' The name of the attribute.

===Returns===
Returns the attribute in string form or ''false'', if the attribute is not defined.

==Example==
Suppose we have a gametype where only one type of car is used, and this type should not depend on the map but rather be set in an external configuration file and be used in all maps. Here's an example where the configuration file is an XML document:

settings.xml
<syntaxhighlight lang="xml">
<car model="528" posX="123.4" posY="456.7" posZ="12.3" rot="90.0" />
</syntaxhighlight>

Lua code
<syntaxhighlight lang="lua">
local xml = getResourceConfig("settings.xml") -- load XML file and get its root element
local carmodel = xmlNodeGetAttribute(xml, "model") -- get attribute of root element
local carX = xmlNodeGetAttribute(xml, "posX")
local carY = xmlNodeGetAttribute(xml, "posY")
local carZ = xmlNodeGetAttribute(xml, "posZ")
local carA = xmlNodeGetAttribute(xml, "rot")
createVehicle(carmodel, carX, carY, carZ, 0.0, 0.0, carA)
</syntaxhighlight>

==See Also==
{{XML_functions}}

Template:Useful Functions

2010-02-06T22:45:15Z

NeonBlack: added a space

*[[callClientFunction]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function allows you to call any clientside function from the server's side.</span>

*[[callServerFunction]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function allows you to call any server-side function from the client's side.</span>

*[[Check]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function checks if it's arguments are of the right types and calls the error-function if one isn't.</span>

*[[doForAllElements]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function can be used to execute a specified function for all elements of a specified type.</span>

*[[findRotation]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Takes two points and returns the direction from point A to point B.</span>

*[[FormatDate]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Formats a date on the basis of a format string and returns it.</span>

*[[getAge]] <span style="color:gray; font-family:'Georgia', sans-serif; font-size:smaller;">» This function calculates the age of a birthday.</span>

*[[getPointFromDistanceRotation]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Finds a point based on a starting point, direction and distance.</span>

*[[GetTimestamp]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» With this function you can get the [http://en.wikipedia.org/wiki/Unix_time UNIX timestamp].</span>

*[[IfElse]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Returns one of two values based on a boolean expression.</span>

*[[IsYearALeapYear]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Checks if the given year is a leap year.</span>

*[[math.round]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Rounds a number whereas the number of decimals to keep and the method may be set.</span>

*[[setTableProtected]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Protects a table and makes it read-only.</span>

*[[setVehicleGravityPoint]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This clientside function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.</span>

*[[string.explode]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function splits a string at a given separator pattern and returns a table with the pieces.</span>

*[[table.copy]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function copies a whole table and all the tables in that table.</span>

*[[table.map]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function goes through a table and replaces every field with the return of the passed function, where the field's value is passed as first argument and optionally more arguments.</span>

*[[table.size]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Finds the absolute size of a table.</span>

*[[var_dump]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">»This function outputs information about one or more variables using outputConsole(). </span>

[[Category:Useful Functions]]

Template:Useful Functions

2010-02-06T22:44:41Z

NeonBlack: sorted alphabetically and added closing span at getAge

*[[callClientFunction]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function allows you to call any clientside function from the server's side.</span>

*[[callServerFunction]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function allows you to call any server-side function from the client's side.</span>

*[[Check]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function checks if it's arguments are of the right types and calls the error-function if one isn't.</span>

*[[doForAllElements]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function can be used to execute a specified function for all elements of a specified type.</span>

*[[findRotation]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Takes two points and returns the direction from point A to point B.</span>

*[[FormatDate]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Formats a date on the basis of a format string and returns it.</span>

*[[getAge]] <span style="color:gray; font-family:'Georgia', sans-serif; font-size:smaller;">»This function calculates the age of a birthday.</span>

*[[getPointFromDistanceRotation]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Finds a point based on a starting point, direction and distance.</span>

*[[GetTimestamp]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» With this function you can get the [http://en.wikipedia.org/wiki/Unix_time UNIX timestamp].</span>

*[[IfElse]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Returns one of two values based on a boolean expression.</span>

*[[IsYearALeapYear]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Checks if the given year is a leap year.</span>

*[[math.round]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Rounds a number whereas the number of decimals to keep and the method may be set.</span>

*[[setTableProtected]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Protects a table and makes it read-only.</span>

*[[setVehicleGravityPoint]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This clientside function sets a vehicle's gravity in the direction of a 3 dimensional coordinate with the strength specified.</span>

*[[string.explode]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function splits a string at a given separator pattern and returns a table with the pieces.</span>

*[[table.copy]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function copies a whole table and all the tables in that table.</span>

*[[table.map]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function goes through a table and replaces every field with the return of the passed function, where the field's value is passed as first argument and optionally more arguments.</span>

*[[table.size]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Finds the absolute size of a table.</span>

*[[var_dump]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">»This function outputs information about one or more variables using outputConsole(). </span>

[[Category:Useful Functions]]

Math.round

2010-02-03T14:51:21Z

NeonBlack: /* Example */ Again... Like always .__.

{{Useful Function}}
<lowercasetitle></lowercasetitle>
__NOTOC__
This function is a full featured round function for Lua's math-library.
Bear in mind that both the floor and the ceil method may not work properly clientside when you pass something greater than 0 as second argument. This is because of some weird clientside number bug. It's fixed for the round method.

==Syntax==
<syntaxhighlight lang="lua">int/float math.round( float number, [ int decimals = 0, string method = "round" ] )</syntaxhighlight>

===Required Arguments===
* '''number''': The number to round.

===Optional Arguments===
{{OptionalArg}}
* '''decimals''': The number of decimals to keep.
* '''method''': The round method that should be used. Valid values are "round" (which is default), "floor" and "ceil".

===Returns===
Returns the rounded number.

==Code==
<section name="Server- and/or clientside Script" class="both" show="true">
<syntaxhighlight lang="lua" lang="lua">
function math.round(number, decimals, method)
decimals = decimals or 0
local factor = 10 ^ decimals
if (method == "ceil" or method == "floor") then return math[method](number * factor) / factor
else return tonumber(("%."..decimals.."f"):format(number)) end
end
</syntaxhighlight>
</section>

==Example==
<section name="Serverside Example" class="server" show="true">
This example adds a command that outputs the players current position approximated to three decimals.
<syntaxhighlight lang="lua" lang="lua">
addCommandHandler("pos", function ()
local x, y, z = getElementPosition(getPedOccupiedVehicle(source) or source)
outputChatBox("Your current position: ["..math.round(x, 3).."|"..math.round(y, 3).."|"..math.round(z, 3).."]", source)
end, false, false)
</syntaxhighlight>
</section>

Author: NeonBlack

==See Also==
{{Useful_Functions}}

Math.round

2010-02-03T14:50:53Z

NeonBlack: /* Example */ Typical mistake >.<

{{Useful Function}}
<lowercasetitle></lowercasetitle>
__NOTOC__
This function is a full featured round function for Lua's math-library.
Bear in mind that both the floor and the ceil method may not work properly clientside when you pass something greater than 0 as second argument. This is because of some weird clientside number bug. It's fixed for the round method.

==Syntax==
<syntaxhighlight lang="lua">int/float math.round( float number, [ int decimals = 0, string method = "round" ] )</syntaxhighlight>

===Required Arguments===
* '''number''': The number to round.

===Optional Arguments===
{{OptionalArg}}
* '''decimals''': The number of decimals to keep.
* '''method''': The round method that should be used. Valid values are "round" (which is default), "floor" and "ceil".

===Returns===
Returns the rounded number.

==Code==
<section name="Server- and/or clientside Script" class="both" show="true">
<syntaxhighlight lang="lua" lang="lua">
function math.round(number, decimals, method)
decimals = decimals or 0
local factor = 10 ^ decimals
if (method == "ceil" or method == "floor") then return math[method](number * factor) / factor
else return tonumber(("%."..decimals.."f"):format(number)) end
end
</syntaxhighlight>
</section>

==Example==
<section name="Serverside Example" class="server" show="true">
This example adds a command that outputs the players actual position approximated to three decimals.
<syntaxhighlight lang="lua" lang="lua">
addCommandHandler("pos", function ()
local x, y, z = getElementPosition(getPedOccupiedVehicle(source) or source)
outputChatBox("Your current position: ["..math.round(x, 3).."|"..math.round(y, 3).."|"..math.round(z, 3).."]", source)
end, false, false)
</syntaxhighlight>
</section>

Author: NeonBlack

==See Also==
{{Useful_Functions}}

XmlNodeGetChildren

2009-11-29T19:38:11Z

NeonBlack: /* Example */ fixed syntax highlighting

__NOTOC__
{{Server client function}}

This function returns all children of a particular XML node, or a particular child node.

==Syntax==
<syntaxhighlight lang="lua">table/xmlnode xmlNodeGetChildren ( xmlnode parent, [ int index ] )</syntaxhighlight>

===Required Arguments===
* '''parent:''' This is the [[xmlnode]] you want to retrieve one or all child nodes of.

===Optional Arguments===
* '''index:''' If you only want to retrieve one particular child node, specify its (0-based) index here. For example if you only want the first node, specify 0; the fifth node has index 4, etc.

===Returns===
If '''index''' isn't specified, returns a table containing all child nodes. If '''index''' is specified, returns the corresponding child node if it exists. Returns ''false'' in case of failure.

==Example==
<section name="Server" class="server" show="true">
Suppose you have an .xml file with random welcome messages:
<syntaxhighlight lang="lua" lang="xml">
<messages>
<message>Welcome to the deathmatch server, enjoy your stay.</message>
<message>Welcome. Be sure to get your free pizza at Matt's!</message>
<message>Party going on at the LS beach, be there</message>
</messages>
</syntaxhighlight>

To show a random message from this list to joining players, you could use the following code:
<syntaxhighlight lang="lua" lang="lua">
addEventHandler("onResourceStart", getResourceRootElement(getThisResource()),
function()
local xml = xmlLoadFile("welcome.xml") -- open the XML file
local messageNodes = xmlNodeGetChildren(xml) -- get all child nodes of the root node (<messages>)
g_WelcomeMessages = {} -- create a new global variable to store the welcome messages
for i,node in ipairs(messageNodes) do -- loop over all the message nodes
g_WelcomeMessages[i] = xmlNodeGetValue(node) -- retrieve the text in each node
end
xmlUnloadFile(xml) -- close the XML file
end
)

addEventHandler("onPlayerJoin", getRootElement(),
function()
local numMessages = #g_WelcomeMessages -- get the number of messages
local message = g_WelcomeMessages[math.random(numMessages)] -- pick a random message
outputChatBox(message, source, 0, 255, 0) -- display it to the joining player
end
)
</syntaxhighlight>
</section>

==See Also==
{{XML functions}}

GetVehicleEngineState

2009-10-29T19:37:36Z

NeonBlack: /* Example */ fixed a typo

__NOTOC__
{{Server client function}}
This function returns a vehicle's engine state (on or off).

==Syntax==
<section name="Server and Client" class="both" show="true">
<syntaxhighlight lang="lua">
bool getVehicleEngineState ( vehicle theVehicle )
</syntaxhighlight>

===Required Arguments===
*'''theVehicle''': The [[vehicle]] you wish to change the engine state of.

===Returns===
Returns '''true''' if the vehicle's engine is started, '''false''' otherwise.
</section>

==Example==
<section name="Serverside example" class="server" show="true">
This example will switch the vehicle engine state with the command "/switchengine".
<syntaxhighlight lang="lua">
function switchEngine ( playerSource )
local theVehicle = getPlayerOccupiedVehicle ( playerSource )

-- Check if the player is in any vehicle and if he is the driver
if theVehicle and getVehicleController ( theVehicle ) == playerSource then
local state = getVehicleEngineState ( theVehicle )
setVehicleEngineState ( theVehicle, not state )
end
end
addCommandHandler ( "switchengine", switchEngine )
</syntaxhighlight>
</section>

==See Also==
{{Vehicle functions}}

[[Category:Changes_in_1.0]]

DE/Lua Tutorial

2009-10-28T16:57:14Z

NeonBlack: /* Eingebettetes Pseudo-if-Statement */ fixed a typo

__TOC__

==Vorwort==
Da es bis auf einige knappe und teils unprofessionelle Tutorials kein deutsches Lua Tutorial gibt, habe ich beschlossen, nun ein eigenes zu schreiben, welches alle für MTA notwendigen Grundlagen einfach und übersichtlich erklärt.
Weiterführende Möglichkeiten und Funktionen können der [http://www.lua.org/manual/5.1/ Offiziellen Lua Dokumentation] entnommen werden, die es jedoch nicht auf Deutsch gibt.

Ein weiterer Grund ist, dass ich schon von einigen gehört habe und auch so schon den Verdacht hatte, dass MTA einfach so wenige deutsche Spieler und vor allem Server hat (gibt es überhaupt '''einen''' deutschen?), weil die meisten Probleme mit den englischen Dokumentationen haben oder der Meinung sind, dass für MTA ja sowieso kein deutscher Support vorhanden ist.

Soviel nun dazu, wie es zu der Idee des deutschen Lua Tutorials kam.
Fangen wir an mit dem Erlernen einer neuen Sprache!

==Grundlagen==
===Lua, eine Skriptsprache===
Lua (portugiesisch für Mond) ist eine Skriptsprache zum Einbinden in Programme, um diese leichter weiterentwickeln und warten zu können. Insbesondere die geringe Größe des Interpreters von 120 KB und die hohe Geschwindigkeit verglichen mit anderen Skriptsprachen überzeugen viele Entwickler davon, Lua einzusetzen.

Die Syntax lehnt sich an die von Pascal an, was besonders Anfängern den Einstieg in Lua erleichtert. Im Gegensatz zu von Pascal abgeleiteten Sprachen nutzt Lua jedoch „==“ und nicht „=“ als Vergleichsoperator.

(Quelle: [http://de.wikipedia.org/wiki/Lua Wikipedia])

Einige werden sich bei dieser Einführung vielleicht gefragt haben, was der Unterschied zwischen Skript- und Programmiersprache ist und was ein Interpreter sein soll. Im folgenden will ich diese beiden Fragen so kurz und einfach wie möglich klären.

Eine '''Programmiersprache''' (z.B. C, C++, Pascal, Delphi) wird - wie der Name schon sagt - verwendet, um Programme zu schreiben. Ein Programm liegt bekannterweise in Form einer Executable (*.exe) vor. Diese kann weitgehend unabhängig von irgendwelchen Betriebssystemen oder der Umgebung selbstständig ausgeführt werden (z.B. durch Doppelklick). Weitgehend deswegen, da einige Programme aufgrund von Speicherersparnissen sogenannte Programmbibliotheken (original Dynamic Link Library, kurz dll) benötigen, um zu funktionieren. Erklärungen dazu findet ihr [http://de.wikipedia.org/wiki/Dynamic_Link_Library hier].<br>
Um einen Programmquellcode, d.h. einen Text, der in einer Programmiersprache geschrieben wurde, aus dem Textdokumentformat in eine Anwendung (original Executable, kurz exe) umzuwandeln, benötigt man nun einen Compiler (zu Deutsch Kompilierer oder Übersetzer), der die Programmiersprache aus der menschenlesbaren Form in die maschinenlesbare Form umwandelt. Neben dieser Hauptaufgabe übernimmt der Compiler natürlich noch weitere Aufgaben, auf die ich jetzt aber nicht genauer eingehen werde. Infos dazu findet ihr [http://de.wikipedia.org/wiki/Compiler hier].<br>
Die maschinenlesbare Form ist für Menschen unlesbar.

Eine '''Skriptsprache''' (z.B. JavaScript, DOS-Batch(Win) bzw. Shell-Scripts(UNIX)) hingegen liegt standardmäßig in der menschenlesbaren Form vor. Skriptsprachen werden - wie im ersten Satz bereits erwähnt - vor allem von Programmen benutzt, um benutzerdefinierte Abläufe verwenden zu können. Zur Ausführung von Scripts wird ein sogenannter Interpreter benötigt, der das Skript liest und es Schritt für Schritt in die Maschinensprache umwandelt und ausführt. Manche Skriptsprachen kann man mit einem Precompiler (zu Deutsch Vorkompilierer oder Vorübersetzer) vorkompilieren. Diesen könnte man auch den Vorkauer vom Interpreter nennen, da er das Script schon zum Teil in die Maschinensprache umwandelt, jedoch nicht so extrem wie der Compiler der Programmiersprachen. Das Ergebnis davon ist logischerweise die schnellere Ausführung des Skripts.

Genug der langweiligen Definitionen. Klären wir lieber, was man denn alles braucht, um ein Lua Script zu schreiben.

===Materialien===
Lua Skripte werden üblicherweise als Textdateien mit der Endung .lua gespeichert. Die Endung ist jedoch nicht von belang. Es kann jede beliebige Endung gewählt werden.

Wie jede normale Textdatei kann man also auch Lua Skripte mit dem standard Texteditor des vorhandenen Betriebssystems schreiben, editieren und lesen. Ich persönlich empfehle jedoch das Programm Notepad++, welches [http://notepad-plus.sourceforge.net/de/site.htm hier] heruntergeladen werden kann. Das Programm ist Freeware und wird regelmäßig aktualisiert und erweitert. Der Vorteil daran ist, dass es ein professionelles Syntax-Highlighting eingebaut hat, welches Schlagwörter und Standardfunktionen farblich oder anderweitig hervorhebt und somit die Übersichtlichkeit erheblich verbessert.<br>
Standardmäßig wird die Sprache Lua automatisch an der Dateiendung .lua erkannt, solltest Du eine andere Endung verwenden und trotzdem das Lua Syntax-Highlighting verwenden wollen, kannst Du es oben im Menü „Sprachen“ einstellen.

Wer ohne MTA seine kleinen Lua Skripte testen oder ausführen möchte, kann sich [http://luabinaries.luaforge.net/download.html hier] einen kostenlosen standalone Interpreter herunterladen. Wenn Du Dir nicht sicher bist, welche Windows Edition Du hast, dann hast Du wahrscheinlich eine 32 Bit Version, welche auf dieser Seite der „Windows x86 Executables“ entspricht. Die aktuelle Version (Win 32 Bit) dafür gibt es bei einem Klick auf [http://luaforge.net/frs/download.php/3134/lua5_1_3_Win32_bin.zip lua5_1_3_Win32_bin.zip].<br>
Nach dem Download kann der Standalone Interpreter mit einem Doppelklick auf die „lua5.1.exe“ gestartet werden. Dort kann man dann direkt Lua Befehle eingeben oder ein Script laden. Dies geht wie folgt:
<syntaxhighlight lang="lua">dofile("dateiname.lua")</syntaxhighlight>

==Kommentare==
Um sein Skript übersichtlicher zu gestalten, kann man mit Kommentaren bestimmte Zeilen eräutern, Bereiche abgrenzen, alten Code deaktivieren, ohne ihn zu entfernen und generell das Skript übersichtlicher gestalten.<br>
Kommentare werden vom Interpreter vollkommen ignoriert und sind nur für den Menschen lesbar und von Belang.

===Einzeilig===
<syntaxhighlight lang="lua">-- Dies ist ein einzeiliger Kommentar. Er gilt von -- bis zum Ende dieser Zeile.
-- Automatische Zeilenumbrüche, die eingefügt werden, wenn die Zeilenlänge überschritten wurde, zählen nicht.</syntaxhighlight>

===Mehrzeilig===
<syntaxhighlight lang="lua">--[[ Dieser Kommentar
geht über beliebig viele Zeilen
und endet mit ]]</syntaxhighlight>

==Variablen==
===Einführung===
Eine Variable kann man sich wie eine kleine Kiste vorstellen, auf der außen ein Bezeichner (oder Name) steht und die einen Wert enthält. Während der Bezeichner immer gleich ist, kann der Inhalt variieren.
Jede Variable hat einen Variablentypen, der bei Programmiersprachen normalerweise zu Beginn des Programmes fest definiert wird und sich nicht ändern kann. Da Lua aber ja keine Programmiersprache ist, muss der Variablentyp zu Beginn und auch sonst nie festgelegt werden und kann sich beliebig oft verändern. Der Interpreter erkennt Variablentypen automatisch und nimmt dem Skripter somit eine Menge Arbeit (vor allem bzgl. der Planung) ab.

===Typen===
Im Folgenden will ich die wichtigsten Variablentypen auflisten und kurz beschreiben.
;Integer (ganze Zahlen)
:Umfasst alle Ganzzahlen, sowohl negative als auch positive.
:Beispiele: -8, 0, 12, 2
;Float (Komma- bzw. gebrochene Zahlen)
:Umfasst alle Fließkommazahlen, sowohl negative als auch positive. Wichtig dabei ist, dass anstelle des Kommas (,) ein Dezimalpunkt (.) zum Trennen des ganzen vom gebrochenen Teil verwendet werden muss.
:Beispiele: -77.2, 0.0, 3.14159, 9.81
;String (Zeichenkette)
:Kann jedes beliebige Zeichen enthalten. Eine maximale Länge ist mir nicht bekannt. Strings müssen immer in Anführungszeichen(" oder ') eingschlossen werden.
:Beispiele: "hallo", 'Lua ist toll!', "", " :D "
;Boolean (Schalter)
:Kann zwei verschiedene Werte enthalten: ''true'' (dt. wahr bzw. an) oder ''false'' (dt. falsch bzw. aus). ''true'' entspricht dabei nicht dem Wert 1 und ''false'' nicht dem Wert 0.
:Beispiele: ''true'', ''false''
;Nil (Leer oder Nichts)
:''nil'' ist sowohl ein Wert als auch ein Typ. Eine Variable vom Typ ''nil'' enthält automatisch den Wert ''nil''. ''nil'' bedeutet ganz einfach nichts. Wenn eine Variable ''nil'' ist, existiert sie nicht. ''nil'' entspricht weder dem Wert 0 noch dem Wert ''false'' noch dem Wert ""!
:Beispiele: ''nil''
Ich werde auf jeden Variablentypen noch detaillierter eingehen. Außerdem wurden hier die Variablentypen '''function''' und '''table''' nicht aufgeführt, da diese jeweils ein eigenes Kapitel bekommen. Zwei weitere Typen, die diese Liste vervollständigen, sind '''userdata''' und '''thread''', auf die ich jedoch in diesem Tutorial nicht weiter eingehen werde, da vor allem letzteres vollkommen irrelevant für MTA ist.

===Definition===
Eine Variable definieren bedeutet im Grunde genommen eine Variable anlegen. In Lua muss einer Variable bei der Definition ein Wert zugewiesen werden. ''nil'' ist dabei als Wert auch möglich, macht jedoch wenig Sinn, da jede beliebige Variablenbezeichnung automatisch den Wert ''nil'' enthält.

Man unterscheidet zwischen '''lokalen''' und '''globalen''' Variablen. Um eine Variable als lokal zu definieren muss das Schlüsselwort ''local'' davor geschrieben werden. Lokal bedeutet für uns im Moment noch ganz einfach, dass die Variable nur im aktuellen Script verfügbar ist. Sollten also z.B. von einem Programm zwei verschiedene Lua Skripte geladen sein und benutzt werden, können diese untereinander auf die globalen Variablen des jeweils anderen Skripts zugreifen, auf die lokalen jedoch nicht. Generell empfiehlt es sich, immer lokale Variablen zu nehmen, falls man nicht explizit eine globale benötigt, da so vermieden wird, dass mehrere parallel laufende Skripte aufgrund von gleichen Variablenbezeichnern durcheinander kommen.

====Einzeln====
Definieren wir uns also nun unsere erste lokale Variable und geben ihr einen ganzzahligen Inhalt:
<syntaxhighlight lang="lua">local zahl = 7 -- weist der lokalen Variable zahl den Wert 7 zu</syntaxhighlight>

Eine globale Variable erhält man, indem man einfach das ''local'' weglässt:
<syntaxhighlight lang="lua">gZahl = 13 -- weist der globalen Variable gZahl den Wert 13 zu</syntaxhighlight>

Das selbe geht natürlich nun auch mit allen anderen Variablentypen:
<syntaxhighlight lang="lua">local ganzzahl = -5
local kommazahl = 0.008
local zeichenkette = "Hello World"
local schalter = true
local nichts = nil -- diese Zeile kann man sich im Grunde genommen sparen, da jede nicht definierte Variable automatisch den Wert nil hat</syntaxhighlight>

Längere Strings mit mehreren Zeilenumbrüchen können in einer vereinfachten Weise zugewiesen werden. Dies funktioniert so ähnlich wie bei Kommentaren. Anstelle von Anführungszeichen verwendet man <nowiki>[[ als Anfangs- und ]]</nowiki> als Endmarkierung des Strings.
<syntaxhighlight lang="lua">local text = [[Willkommen auf unserem Server.
Bitte halte Dich an die Regeln.
MfG die Administration]]</syntaxhighlight>
Alternativ kann in einem String, der in doppelten Anführungszeichen (") eingeschlossen ist, folgende Steuerzeichen enthalten:
;\n
:Entspricht einem Zeilenumbruch.
;\t
:Entspricht einem Tabulator.
;\"
:Wird verwendet, um doppelte Anführungszeichen in einem String, der von doppelten Anführungszeichen eingeschlossen ist, darzustellen, ohne dass der Interpreter diese fälschlicherweise als Stringende auffasst.
;\'
:Wie \", nur gilt dies in Strings, die von einfachen Anführungszeichen eingeschlossen sind.
;\\
:Entspricht einem Backslash (\)

====Mehrere====
Man kann in einer Zeile mehrere Variablen definieren, indem man sie mit Kommas voneinander trennt. Die Variablentypen können dabei alle unterschiedlich sein. Hier mal ein Beispiel:
<syntaxhighlight lang="lua">local frucht, anzahl, reif = "apfel", 4, true</syntaxhighlight>
''local'' darf dabei nur einmal am Zeilenanfang stehen und bewirkt, dass alle dahinter aufgelisteten Variablen lokal werden.<br>
Sollten links neben dem Gleichheitszeichen mehr Variablenbezeichner stehen als rechts Werte, so bleiben die überschüssigen Variablen ''nil''. Im umgekehrten Fall werden überschüssige Werte rechts einfach ignoriert.

==Operatoren==
===Arithmetische===
Arithmetische Operatoren werden verwendet, um Berechnungen durchzuführen. Somit kann man entweder mit Variablen, festen Zahlen oder einer Mischung neue Werte berechnen oder verändern.<br>
Bei Berechnungen gilt stets: '''Punkt- vor Strichrechnung'''.
<br><br>
;Plus (+)
:Addiert zwei Werte miteinander.
<syntaxhighlight lang="lua">local a, b = 3, 8
local c = a + b -- a + b entspricht hier der Rechnung 3 + 8, c erhält nun also den Wert 11</syntaxhighlight>
;Minus (-)
:Subtrahiert den zweiten vom ersten Wert.
<syntaxhighlight lang="lua">local a, b = 3, 8
local c = a - b -- a - b entspricht hier der Rechnung 3 - 8, c erhält nun also den Wert -5</syntaxhighlight>
;Mal (*)
:Multipliziert zwei Werte miteinander.
<syntaxhighlight lang="lua">local a, b = 3, 8
local c = a * b -- a * b entspricht hier der Rechnung 3 * 8, c erhält nun also den Wert 24</syntaxhighlight>
;Geteilt (/)
:Dividiert den ersten durch den zweiten Wert. Hierbei entsteht in den meisten Fällen eine Kommazahl!
<syntaxhighlight lang="lua">local a, b = 3, 8
local c = a / b -- a / b entspricht hier der Rechnung 3 / 8, c erhält nun also den Wert 0.375</syntaxhighlight>
<br>
;Modulo (%)
:Ermittelt den Rest, der übrig bleibt, wenn man die erste Zahl durch die zweite teilt.
:Der Modulo-Operator gehört zur Punktrechnung.
<syntaxhighlight lang="lua">local a, b = 14, 3
local c = a % b -- a % b entspricht hier der Rechnung 14 % 3, c erhält nun also den Wert 2, da 14 / 3 = 4 REST 2</syntaxhighlight>
;Minus (-) (als Vorzeichen)
:Dient zur Darstellung einer negativen Zahl, also einer Zahl unter 0.
<syntaxhighlight lang="lua">local a = -3 -- entspricht der Rechnung a = 0 - 3</syntaxhighlight>
;Hoch (^)
:Potenziert die erste Zahl mit der zweiten.
:Potenzen werden noch '''vor''' der Punktrechnung ausgerechnet.
<syntaxhighlight lang="lua">local a, b = 3, 8
local c = a ^ b -- a ^ b entspricht hier der Rechnung 3 ^ 8 (3<sup>8</sup>), c erhält nun also den Wert 6561</syntaxhighlight>
<br>

===Logische===
Logische Operatoren werden Benutzt, um Werte miteinander zu vergleichen und mehrere Bedingungen zu verknüpfen. Wir werden genauer auf sie zurückkommen, wenn es um Bedingungen geht. Bis dahin reicht es, wenn man sich merkt, dass ein logischer Vergleich entweder ''true'' (wenn die Aussage wahr ist) oder ''false'' (wenn die Aussage falsch ist) ergibt.
<br><br>
;Gleich (==)
:Prüft, ob zwei Werte gleich sind.
<syntaxhighlight lang="lua">local a = (5 == 5) -- a ist true, da die Aussage wahr ist
local b = (5 == 8) -- b ist false, da die Aussage falsch ist</syntaxhighlight>
;Ungleich (~=)
:Prüft, ob zwei Werte ungleich sind.
<syntaxhighlight lang="lua">local a = (5 ~= 5) -- a ist false, da die Aussage falsch ist
local b = (5 ~= 8) -- b ist true, da die Aussage wahr ist</syntaxhighlight>
;Größer als (>)
:Prüft, ob der erste Wert größer als der zweite ist.
<syntaxhighlight lang="lua">local a = (5 > 5) -- a ist false, da die Aussage falsch ist
local b = (5 > 8) -- b ist false, da die Aussage falsch ist
local c = (8 > 5) -- c ist true, da die Aussage wahr ist</syntaxhighlight>
;Größer als oder gleich (>=)
:Prüft, ob der erste Wert größer als der zweite ist oder dem zweiten gleicht.
<syntaxhighlight lang="lua">local a = (5 >= 5) -- a ist true, da die Aussage wahr ist
local b = (5 >= 8) -- b ist false, da die Aussage falsch ist
local c = (8 >= 5) -- c ist true, da die Aussage wahr ist</syntaxhighlight>
;Kleiner als (<)
:Prüft, ob der erste Wert kleiner als der zweite ist.
<syntaxhighlight lang="lua">local a = (5 < 5) -- a ist false, da die Aussage falsch ist
local b = (5 < 8) -- b ist true, da die Aussage wahr ist
local c = (8 < 5) -- c ist false, da die Aussage falsch ist</syntaxhighlight>
;Kleiner als oder gleich (<=)
:Prüft, ob der erste Wert kleiner als der zweite ist oder dem zweiten gleicht.
<syntaxhighlight lang="lua">local a = (5 <= 5) -- a ist true, da die Aussage wahr ist
local b = (5 <= 8) -- b ist true, da die Aussage wahr ist
local c = (8 <= 5) -- c ist false, da die Aussage falsch ist</syntaxhighlight>
<br>
;Und (and)
:Verknüpft zwei Bedingungen miteinander.
<syntaxhighlight lang="lua">local a = (true and false) -- a ist false, da nicht beide Aussagen wahr sind
local b = (5 < 8) and (7 == 7) -- b ist true, da beide Aussagen wahr sind
local c = (8 > 5) and (1 ~= 2) and (0 <= -7) -- c ist false, da die dritte Aussage falsch ist</syntaxhighlight>
;Oder (or)
:Verknüpft zwei Bedingungen miteinander.
<syntaxhighlight lang="lua">local a = (true or false) -- a ist true, da die erste Aussage wahr ist
local b = (5 < 8) or (7 == 7) -- b ist true, da mindestens eine der Aussagen wahr ist
local c = (8 > 5) or (1 ~= 2) or (0 <= -7) -- c ist true, da mindestens eine der Aussagen wahr ist</syntaxhighlight>
;Nicht (not)
:Kehrt einen Booleanwert um.
<syntaxhighlight lang="lua">local a = not true -- a ist false
local b = not false -- b ist true
local c = not (0 == 8) -- c ist true, da die Aussage falsch ist</syntaxhighlight>
<br>

===Sonstige===
Lua hat noch zwei weitere Operatoren, die sich jedoch nicht in die oberen Gruppen eingliedern lassen.
<br>
;Länge (#)
:Steht für die Länge eines Strings oder einer Table.
<syntaxhighlight lang="lua">local sprache = "deutsch"
local laenge = #sprache -- laenge wird hier auf 7 gesetzt, da das Wort "deutsch" 7 Buchstaben hat</syntaxhighlight>
;Verknüpfung (..)
:Verknüpft zwei Strings miteinander.
<syntaxhighlight lang="lua">local geschlecht, alter = "männlich", "18"
local satz = "Ich bin "..geschlecht.." und "..alter.." Jahre alt." -- weist satz den Wert "Ich bin männlich und 18 Jahre alt." zu</syntaxhighlight>
<br><br>
Natürlich können auch alle anderen Variablentypen mit- und untereinander verglichen werden.<br>
Der Längenoperator (#) sowie der Verknüpfungsoperator (..) sind nur für Strings gedacht, wobei der erste später noch bei Tables eine Rolle spielen wird und der zweite es nicht so genau nimmt mit den Variablentypen. Bei Booleans und ''nil'' jedoch führt er in jedem Fall zu einem Fehler. Wir kommen später noch darauf zu sprechen, wie man soetwas umgeht.<br>
Für Integer und Floats sind alle Vergleichsoperatoren und die arithmetischen verfügbar. Strings unterstützen nur die Vergleichsoperatoren, wobei man mit den größer/kleiner Operatoren zwei Strings nach dem Alphabet ordnen kann.
<syntaxhighlight lang="lua">"a" < "b" -- ergibt true, da a vor b im Alphabet kommt</syntaxhighlight>
Strings, Booleans und ''nil'' kann man nur untereinander vergleichen, nicht miteinander. Miteinander führt in jedem Fall zu ''false''.

==Bedingungen==
===Einführung===
Bedingungen sind dazu da, um bestimmte Anweisungen nur auszuführen, wenn ein bestimmter Sachverhalt gegeben ist.
Ein Beispiel wäre, wenn ein Spieler einem anderen Spieler eine private Nachricht senden möchte. Dann kann er das natürlich nur tun, wenn der adressierte Spieler auch online ist.
Also soll die Nachricht in einem solchen Fall gesendet werden, andernfalls dem Sender jedoch eine Fehlermeldung ausgegeben werden.

===Syntax===
Die Syntax einer Bedingung, die man übrigens auch „if-Statement“ (if = engl. für wenn) oder im Englischen „condition“ nennt, ist recht simpel.
<syntaxhighlight lang="lua">if <bedingung> then
-- Anweisung(en), die ausgeführt werden soll(en), wenn die Bedingung wahr (=true) ist
end</syntaxhighlight>
Für <bedingung> darf hier jeder Audruck eingesetzt werden, der letztendlich irgendeinen Wert ergibt.
Sollte <bedingung> ''nil'' oder ''false'' sein, so wird die Anweisung zwischen then und end nicht ausgeführt, andernfalls wird sie ausgeführt.

===Else-Statement===
Auf jedes if-Statement darf ein else-Statement (else = engl. für sonst) folgen. Dieses benötigt kein then und auch keine Bedingung, sondern wird ausgeführt, wenn die Bedingung des if-Statements ''nil'' oder ''false'' ist. Das else-Statement ist optional!
<syntaxhighlight lang="lua">if <bedingung> then
-- Anweisung(en), die ausgeführt werden soll(en), wenn die Bedingung erfüllt wird
else
-- Anweisung(en), die ausgeführt werden soll(en), wenn die Bedingung nicht erfüllt wird
end</syntaxhighlight>

===Elseif-Statement===
Das elseif-Statement ist ein spezielles Statement, was es erlaubt, einer unübersichtlichen Verschachtelung zu entgehen, indem es die Möglichkeit bietet, einem else-Statement auch eine Bedingung zu geben. Ein if-Statement darf beliebig viele elseif-Statements enthalten. Diese müssen jedoch zwischen dem if- und dem else-Statement (falls vorhanden) stehen. Für die Bedingung gilt hier das selbe, wie für das if-Statement. Wichtig ist, dass demnach auch hier ein then erforderlich ist. Genauso wie das else-Statement ist jedoch auch das elseif-Statement optional!
<syntaxhighlight lang="lua">if <bedingung1> then
-- Anweisung(en), die ausgeführt werden soll(en), wenn die Bedingung 1 erfüllt wird
elseif <bedingung2> then
-- Anweisung(en), die ausgeführt werden soll(en), wenn die Bedingung 2 erfüllt wird
else
-- Anweisung(en), die ausgeführt werden soll(en), wenn weder Bedingung 1 noch Bedingung 2 erfüllt werden
end</syntaxhighlight>

===Bedingungen formulieren===
Bei der Bedingung eines if-Statements muss nicht zwangsläufig ein Boolean herauskommen. Wie bereits erwähnt, ist die Bedingung immer dann wahr, wenn sie weder ''nil'' noch ''false'' ist.
D.h., dass auch Werte wie 0, "Hallo" und 3.14159 als „wahr“ gelten. Natürlich ist das auch bei ''true'' der Fall.

Um komplexere Bedingungen zu formulieren, werden auf jeden Fall die bereits aufgelisteten logischen Operatoren benötigt.
Mit diesen kann man für jeden nur erdenklichen Fall eine Bedingung formulieren.

Wenn logische (Vergleichs-)Operatoren (==, ~=, <, >, <=, >=) angewandt werden, kommt dabei immer ein Boolean raus, wie man auch schon an den gegebenen Beispielen erkennen kann.
Verknüfungen (and, or) sind dazu gedacht, um z.B. zu überprüfen, ob mehrere oder wenigstens eine Bedingung von vielen erfüllt werden oder nicht. Der not-Operator ermöglicht es, zu überprüfen, ob eine Bedingung nicht erfüllt wird.

Zu dem and- und dem or-Operator möchte ich an dieser Stelle noch etwas ergänzen. Der and-Operator wird zunächst einmal dazu verwendet, um herauszufinden, ob zwei Bedingungen gleichzeitig erfüllt sind. Der or-Operator wird dazu benutzt, um herauszufinden, ob eine von zweien oder beide Bedingungen erfüllt sind.

Weder der and- noch der or-Operator geben aber zwangsläufig einen Boolean zurück.
<syntaxhighlight lang="lua">local foo = wert1 and wert2</syntaxhighlight>
Sollte wert1 ''nil'' oder ''false'' sein, so entspricht dieser Ausdruck dem folgenden:
<syntaxhighlight lang="lua">local foo = wert1</syntaxhighlight>
Ist wert1 weder ''nil'' noch ''false'', so entspricht der Ausdruck dem hier:
<syntaxhighlight lang="lua">local foo = wert2</syntaxhighlight>

Bei or ist es ähnlich, nur umgekehrt.
<syntaxhighlight lang="lua">local foo = wert1 or wert2</syntaxhighlight>
Sollte wert1 ''nil'' oder ''false'' sein, so entspricht dieser Ausdruck dem folgenden:
<syntaxhighlight lang="lua">local foo = wert2</syntaxhighlight>
Ist wert1 weder ''nil'' noch ''false'', so entspricht der Ausdruck dem hier:
<syntaxhighlight lang="lua">local foo = wert1</syntaxhighlight>

===Beispiele===
====50-50-Chance====
Dieses Beispiel simuliert einen Münzwurf. math.random() und print() sind standard Lua-Funktionen. Zum Thema Funktionen komme ich später. Für dieses Beispiel reicht es, wenn ihr wisst, dass math.random() eine Zufallszahl (float) zwischen 0 und 1 zurückgibt und print("text") den in den Klammern eingeschlossenen String in die Konsole ausgibt.
<syntaxhighlight lang="lua">local zufall = math.random()
if (zufall < 0.5) then
print("Kopf")
else
print("Zahl")
end</syntaxhighlight>
====Der Nutzen von elseif====
Im Folgenden wollen wir herausfinden, ob eine Zahl positiv, negativ oder 0 ist. Dazu möchte ich zuerst ein Beispiel ohne und danach eines mit elseif zeigen, um meine Aussage, dass elseif Verschachtelungen spart, zu verifizieren.
<syntaxhighlight lang="lua">local zahl = 14

--ohne elseif
if (zahl < 0) then
print("Die Zahl ist negativ.")
else
if (zahl == 0) then
print("Die Zahl entspricht 0.")
else
print("Die Zahl ist positiv.")
end
end

--mit elseif
if (zahl < 0) then
print("Die Zahl ist negativ.")
elseif (zahl == 0) then
print("Die Zahl entspricht 0.")
else
print("Die Zahl ist positiv.")
end</syntaxhighlight>
Je komplexer das ganze if-Statement, desto nützlicher wird elseif sein.
====Eingebettetes Pseudo-if-Statement====
In vielen Script- und Programmiersprachen gibt es ein gekürztes if-Statement. In Javascript z.B. geht das wie folgt:
<syntaxhighlight lang="lua">var nachricht = "Du benutzt zurzeit " + (ie ? "den Internet Explorer" : "einen guten Browser") + ".";</syntaxhighlight>
Wir gehen dabei davon aus, dass in der Variable ie ein Boolean gespeichert ist, der ''true'' ist, wenn der Benutzer den Internet Explorer benutzt, ansonsten ''false''.
Diese Art von eingebetteten if-Statements gibt es noch in vielen anderen Sprachen, unter anderen in PHP, Java und C(++). In meinem Beispiel kann man sich das ? als then und den : als else vorstellen. Dann sollte es eigentlich nicht allzu schwer sein, diese Art von if-Statement zu verstehen.

So direkt gibt es das bei Lua nicht, aber mit and und or kann man sich ein Konstrukt bauen, welches auf die gleiche Weise funktioniert. Dazu werde ich einfach mal das obere Beispiel in Lua umwandeln, auch, wenn Lua eigentlich nicht viel mit Browsern am Hut hat.
<syntaxhighlight lang="lua">local nachricht = "Du benutzt zurzeit "..(ie and "den Internet Explorer" or "einen guten Browser").."."</syntaxhighlight>
Zuerst ist das and an der Reihe. Es schmeißt den String "den Internet Explorer" raus, wenn ie ''false'' (oder ''nil'') ist und zurück bleibt auf jeden Fall ''false'' (oder ''nil''). Das wird dann vom or rausgeschmissen und zurück bleibt "einen guten Browser".
Wenn ie weder ''false'' noch ''nil'' ist, schmeißt and die Variable ie raus und zurück bleibt "den Internet Explorer". Da dieser String weder ''false'' noch ''nil'' ist, wird er vom or beibelassen und "einen guten Browser" rausgeschmissen.
Entschuldigt meine Ausdrucksweise mit dem rausschmeißen, aber das schien mir die beste Möglichkeit, diese Methode verständlich zu erklären.

==Tabellen==
===Einführung===
Tabellen sind spezielle Variablen, die mehrere Werte enthalten können.
Damit wir Tabellen verwenden können, führe ich nun erst einmal den Variablentyp „table“ ein. Mit einer table-Variable kann man ersteinmal kaum Operationen durchführen. Dazu benötigt man Funktionen, zu denen wir aber erst später kommen.

===Definition===
Um eine Variable als (leere) table zu definieren, benutzt man diesen Ausdruck:
<syntaxhighlight lang="lua">local tabelle = {}</syntaxhighlight>

Ohne Funktionen macht das noch recht wenig Sinn. Um einer Tabelle direkt mehrere Werte zuzuweisen, schreibt man diese einfach durch Kommata getrennt zwischen die geschweiften Klammern.
<syntaxhighlight lang="lua">local tabelle1 = { "Apfel", 14, 3.14159, true }</syntaxhighlight>
Eine table kann alle möglichen Typen von Variablen enthalten. So zum Beispiel auch andere Tabellen.
<syntaxhighlight lang="lua">local tabelle2 = { 1, { 1.25, 1.5, 1.75 }, 2, { 2.25, 2.5, 2.75 } }</syntaxhighlight>

Um nun auf die Elemente einer table zugreifen zu können, benutzt man Indizes (Indizes ist der Plural von Index). Jedes Element in einer table hat einen Index. Wenn man die Tabellen so definiert, wie ich es gemacht habe, so wird jedem Element ein integer als Index zugewiesen, wobei das erste Element die 1 als Index bekommt, das zweite die 2 usw.
Der ungefähre Wert von Pi (3.14159) in der oberen Tabelle hat den Index 3. Um anhand eines Indizes ein Element einer Tabelle abzufragen, schreibt man den Index einfach in eckigen Klammern hinter den Tabellennamen.
tabelle1[3] entspricht also dem Wert 3.14159.
Wenn das Element der Tabelle selbst noch eine Tabelle ist, wie z.B. das Element mit dem index 2 aus tabelle2, dann setzt man die Indizes einfach hintereinander. Der Wert 2.25 ist demnach in tabelle2[4][1] gespeichert.

===Ganzzahlige Indizes===
Um gezielt bestimmten Indizes einen Wert zuzuweisen, kann man folgende Schreibweise verwenden:
<syntaxhighlight lang="lua">local auskunft = { [11] = "elf", [88] = "achtundachtzig", [0] = "null" }</syntaxhighlight>
Dabei spielt es keine Rolle, in welcher Reihenfolge die Indizes einen Wert zugewiesen bekommen und es spiel auch keine Rolle, ob die Indizes positiv oder negativ sind.
Es muss jedoch beachtet werden, dass etwas wie { [1] = "eins", "zwei" } dem Index 1 den Wert "zwei" zuweisen würde, da Lua immer bei 1 anfängt zu zählen, egal, ob der Scripter den Index 1 bereits definiert hat.

===Zeichenketten als Indizes===
Ein Index kann auch ein String sein. Dazu verwendet man folgende Schreibweise:
<syntaxhighlight lang="lua">lua konstanten = { ["pi"] = 3.14159, ["e"] = 2.71828 }</syntaxhighlight>
Ansprechen kann man diese Werte genauso wie bei integer-Indizes. konstanten["pi"] ist also 3.14159.

Eine Besonderheit bei Zeichenketten als Index ist, dass es eine vereinfachte Schreibweise gibt. Sowohl bei der Definition als auch bei der Abfrage der Elemente. Das obige Beispiel kann auch so realisiert werden:
<syntaxhighlight lang="lua">lua konstanten = { pi = 3.14159, e = 2.71828 }</syntaxhighlight>
Zum Abfragen der Elemente kann man die Schreibweise konstanten.pi bzw. konstanten.e verwenden.
Man sollte aber bedenken, dass Schlüsselwörter wie z.B. if oder local als Indizes besser mit ["if"] und ["local"] definiert werden.

===Beliebige Indizes===
Ein Index muss nicht unbedingt ein integer oder ein string sein. Genauer gesagt kann ein Index ein beliebiger Wert (außer ''nil'') sein.
Somit wäre z.B. auch das möglich:
<syntaxhighlight lang="lua">local tabelle = { [true] = "wahr", [3.14159] = "pi", [0] = 1, 123 }</syntaxhighlight>
Die Zahl 123 hätte hier übrigens den Index 1.

===Einzelzuweisungen===
Man muss nicht immer alle Werte einer table auf einmal definieren. Jedes Tabellenelement lässt sich wie eine normale Variable behandeln.
<syntaxhighlight lang="lua">local tabelle = {}
tabelle[true] = "wahr"
tabelle.pi = 3.14159
tabelle[2] = { 1, 2, 3 }
tabelle[2][0] = 0</syntaxhighlight>
Jedes undefinierte Element hat - genauso wie jede undefinierte Variable - den Wert ''nil''.

===Verlinkungen===
<syntaxhighlight lang="lua">local tabelle1 = { 1, 2, 3 }
local tabelle2 = tabelle1
tabelle1[1] = 4</syntaxhighlight>
In der zweiten Zeile dieses Beispiels wird die tabelle1 nicht in die Variable tabelle2 kopiert, sondern tabelle2 verweist ab sofort auf tabelle1. Am Ende des Codes wäre also tabelle2[1] auch 4, obwohl es nicht explizit zugewiesen wurde.

Um eine Tabelle zu kopieren, könnt ihr euch die Useful Function [[table.copy]] aus der Wiki kopieren und diese dazu verwenden.

==Schleifen==
===Einführung===
Schleifen verwendet man immer dann, wenn man eine oder mehrere Anweisungen mehr als einmal direkt hintereinander ausführen möchte oder wenn man eine oder mehrere Anweisungen für jedes Element einer table ausführen möchte.
Es gibt drei verschiedene Arten von Schleifen. Diese werde ich jetzt hier einzeln vorstellen.

===While-Schleife===
Die while-Schleife wiederholt eine oder mehrere Anweisungen solange, bis eine bestimmte Bedingung nicht mehr erfüllt wird.
Die Syntax ist die folgende:
<syntaxhighlight lang="lua">while [bedingung] do
-- Anweisung(en)
end</syntaxhighlight>

Beispiel:
<syntaxhighlight lang="lua">local zahl = 10
while (zahl >= 0) do
print(zahl)
zahl = zahl - 1
end</syntaxhighlight>
Das Beispiel gibt nacheinander alle Zahlen von 10 bis 0 aus. Nach der Schleife hat zahl dann den Wert -1.

===Repeat-Until-Schleife===
Die repeat-until-Schleife wiederholt eine oder mehrere Anweisungen solange, bis eine bestimmte Bedingung erfüllt ist. Sie führt diese Anweisung(en) aber in jedem Fall einmal aus.
Die Syntax lautet:
<syntaxhighlight lang="lua">repeat
-- Anweisung(en)
until [bedingung]</syntaxhighlight>

Das obere Beispiel lässt sich hiermit wie folgt realisieren:
<syntaxhighlight lang="lua">local zahl = 10
repeat
print(zahl)
zahl = zahl - 1
until (zahl < 0)</syntaxhighlight>

===For-Schleife===
Es gibt zwei verschiedene for-Schleifen. Einmal die einfache numerische for-Schleife und zum Anderen die generische for-Schleife, mit der man u.a. alle Elemente einer tabelle durchlaufen kann. Mit der generischen for-Schleife kann man noch ganz andere wesentlich komplexere Operationen durchführen, die ich hier aber nicht erklären werde, da sie auch - zumindest beim Scripten für MTA - nicht wirklich benötigt werden.
====Numerisch====
Syntax:
<syntaxhighlight lang="lua">for [laufvariable], [maximum], [schrittweite] do
-- Anweisung(en)
end</syntaxhighlight>
Die Laufvariable wird nach jedem Durchlauf der Schleife um die Schrittweite erhöht, bis sie größer oder gleich dem Maximum ist. Alle drei Werte müssen numerisch sein, d.h. ein integer oder ein float. Die Schrittweite kann auch weggelassen werden. Sie ist dann automatisch 1.
Unser Beispiel von oben sähe mit einer for-Schleife so aus:
<syntaxhighlight lang="lua">for i=10, 0, -1 do
print(i)
end</syntaxhighlight>
Die Variable i ist nur innerhalb der Schleife verfügbar. Damit sie auch nach der Schleife noch verfügbar ist, muss man sie schon vor der Schleife deklarieren.
====Generisch====
Die generische for-Schleife wird hauptsächlich dazu verwendet, um tables zu durchlaufen. Ich werde sie daher auch nur in diesem Zusammenhang erläutern.
Die Syntax für den Fall, dass man eine table durchlaufen will, ist:
<syntaxhighlight lang="lua">for [index], [wert] in pairs([tabelle]) do
-- Anweisung(en)
end</syntaxhighlight>
Diese Schleife geht durch alle Elemente der Tabelle und führt die Anweisungen somit für alle Elemente der Tabelle aus, wobei Index jedes Mal dem aktuellen Index des Tabellenelements und Wert jedes Mal dem aktuellen Wert des Tabellenelements entspricht.
Anstelle von pairs() kann man auch ipairs() nehmen, wenn man nur alle ganzzahligen Indizes durchlaufen möchte.
Hier mal ein Beispiel:
<syntaxhighlight lang="lua">local tabelle = { eins = 1, "hallo", pi = 3.14159 }

-- mit pairs
for index, wert in pairs(tabelle) do
print(tostring(index).."="..tostring(wert)..", ")
end
-- Ausgabe: "eins=1, 1=hallo, pi=3.14159, "

-- mit ipairs
for index, wert in ipairs(tabelle) do
print(tostring(index).."="..tostring(wert)..", ")
end
-- Ausgabe: "1=hallo, "</syntaxhighlight>
tostring() ist übrigens eine Funktion, die eine beliebige Variable in einen string umwandelt. Wenn man Variablen mit einem string verknüpfen will und sich nicht sicher ist, ob diese Variablen string sind oder nicht, sollte man auf jeden Fall diese Funktion verwenden, da ansonsten Fehler auftreten können. (Lua gibt einen Error aus, wenn man z.B. soetwas versucht: "Hallo "..nil..".")

===Schleifenabbruch===
Mit dem Schlüsselwort break kann man eine Schleife sofort abbrechen.
Hier ein kurzes Beispiel dazu:
<syntaxhighlight lang="lua">local zahl = 10
while (true) do
print(zahl)
zahl = zahl - 1
if (zahl < 0) then
break
end
end</syntaxhighlight>
Diese Schleife würde auch alle Zahlen von 10 bis 0 nacheinander ausgeben, nur dass der Abbruch manuell erfolgt, wenn zahl negativ wird. Ohne diese Bedingung würde die Schleife endlos laufen.

==Funktionen==
===Einführung===
Funktionen sind im Grunde genommen Anweisungsblöcke, die - meist in Abhängigkeit von übergebenen Werten - mehrmals an unterschiedlichen Orten im Script bzw. zu unterschiedlichen Zeiten ausgeführt werden sollen.
Da eine Funktion - sofern sie mehr als einmal ausgeführt werden soll bzw. mehr als einmal benötigt wird - auch in einer Variable gespeichert werden kann, kann man den Variablentyp function einführen, der in Lua auch tatsächlich existiert.
Funktionen können Werte übergeben bekommen und auch Werte zurückgeben.

===Definition===
Die allgemeine Syntax für das Definieren einer Funktion ist die folgende:
<syntaxhighlight lang="lua">function [funktionsname]([parameterliste])
-- Anweisung(en)
end</syntaxhighlight>

Ein Beispiel für eine Funktion, die das Quadrat einer Zahl zurückgibt, wäre:
<syntaxhighlight lang="lua">function quadrat(zahl)
return zahl * zahl
end</syntaxhighlight>

Alternativ kann eine Funktion übrigens auch so einer Variable zugewiesen werden:
<syntaxhighlight lang="lua">quadrat = function (zahl) return zahl * zahl end</syntaxhighlight>

===Rückgabewerte===
return wird verwendet, um die Funktion einen Wert zurückgeben zu lassen. Nach einem return-Befehl bricht die Funktion alle Tätigkeiten ab und ist beendet.
Um einen Rückgabewert verwenden zu können, müssen wir aber ersteinmal wissen, wie man eine Funktion dazu bringt, die Anweisungen, die sie enthält, auszuführen.
Das geht allgemein mit funktionsname(parameterliste).
Als Beispiel für unsere quadrat-Funktion:
<syntaxhighlight lang="lua">local vier = quadrat(2)</syntaxhighlight>

Wenn wir quadrat(2) ausführen, dann wird der obrige Code ausgeführt, wobei die Variable zahl den Wert 2 zugewiesen bekommt. zahl ist dabei jedoch nur innerhalb der Funktion definiert.
Die Variable vier bekommt nun den Wert 2 * 2, also 4 zugewiesen.

<syntaxhighlight lang="lua">local vier = quadrat</syntaxhighlight>
würde die Funktion quadrat in die Variable vier kopieren. Man könnte nun also auch vier(2) aufrufen, um 4 zu bekommen.

Eine Funktion kann auch mehrere Funktionswerte zurückgeben. Das ist vor allem dann sinnvoll, wenn es sich um Positionen handelt, was bei MTA ja nicht selten vorkommt.
Beispiel:
<syntaxhighlight lang="lua">function berechnungen(zahl1, zahl2)
return zahl1 + zahl2, zahl1 - zahl2, zahl1 * zahl2, zahl1 / zahl2
end

local summe, differenz, produkt, quotient = berechnungen(5, 10)</syntaxhighlight>
Damit wird summe = 15, differenz = -5, produkt = 50 und quotient = 0.5.

===Lua Standardfunktionen===
Funktionen wie tostring, print und math.random sind Standardfunktionen von Lua. Eine komplette Liste aller Lua Standardfunktionen bekommt ihr auf der [http://www.lua.org/manual/5.1/#index offiziellen Lua Webseite] (Englisch).

Die Standard-string-Funktionen erlauben eine besondere Syntax, die ich hier kurz erläutern möchte, da sie von vielen erfahrenen Scriptern genutzt wird und es hilfreich ist, wenn man etwas damit anfangen kann.
<syntaxhighlight lang="lua">local name = "Firzen Polas"
local laenge = string.len(name)</syntaxhighlight>
Dieser Code weist der Variable laenge die Länge des strings "Firzen Polas", also 12, zu.
Alternativ kann man auch den folgenden Code verwenden:
<syntaxhighlight lang="lua">local name = "Firzen Polas"
local laenge = name:len()</syntaxhighlight>
Vorraussetzung ist, dass die Variable vor dem Doppelpunkt ein string ist. Bei den math- und table-Funktionen funktioniert dies nicht.

===Rekursive Funktionen===
Rekursive Funktionen sind eine effektive Alternative zu Schleifen - zumindest in manchen seltenen Fällen. Das berühmteste Beispiel ist das Berechnen einer Fakultät.
Zur Information: n! (sprich: n Fakultät) bezeichnet das Produkt aller Ganzzahlen von n bis 1, also quasi 1*2*3*4*...*n.
Beispiel: 3! = 1 * 2 * 3 = 6
<syntaxhighlight lang="lua">function fakultaet(zahl)
if (zahl > 0) then
return zahl * fakultaet(zahl - 1)
else
return 1
end
end</syntaxhighlight>
Mit Schleife sähe das so aus:
<syntaxhighlight lang="lua">function fakultaet(zahl)
if (zahl == 0) then
return 1
end
for i=zahl-1, 1, -1 do
zahl = zahl * i
end
return zahl
end</syntaxhighlight>

===Variable Parameterzahl===
Manchmal benötigt eine Funktion nicht zwingend eine bestimmte Anzahl von Parametern oder soll eine variable Anzahl an Parametern akzeptieren.
Dies lässt sich realisieren mit drei Punkten am Ende der Parameterliste.
<syntaxhighlight lang="lua">function aufsummieren(...)
local parameter = {...}
local summe = 0
for _, zahl in pairs(parameter)
summe = summe + tonumber(zahl)
end
return summe
end</syntaxhighlight>
... entspricht dabei innerhalb der Funktion der Parameterliste als normale Liste.
D.h., wenn man aufsummieren(1, 2, 3, 4) aufruft, dann wird parameter = {1, 2, 3, 4}.

==Fragen, Anregungen, Kritik==
Sollten noch irgendwelche Fragen offen sein, so könnt ihr jederzeit in unserem [irc://irc.gtanet.com/#mta.german IRC Channel] oder in unserem [http://sebihunter.de/wbb/ Forum] vorbeischauen und eure Fragen dort loswerden.
Außerdem haben wir in unserem IRC Channel einen Lua Bot, an dem ihr Funktionen, die auf den standard Lua Funktionen basieren, ausprobieren könnt.

Anregungen und Kritik nehme ich dort auch entgegen. Alternativ könnt ihr diese hier in die Diskussion schreiben.
Falls ihr Fehler findet, behebt diese bitte oder gebt mir Bescheid.

Ich hoffe, das Tutorial konnte euch weiterhelfen. Wenn ihr nun Hilfe braucht bei eurem ersten Gamemode in MTA, dann solltet ihr euch die [[DE/MTA_Scripting_Grundlagen|MTA Scripting Grundlagen]] durchlesen. Viel Erfolg.

DE/Hauptseite

2009-10-27T18:17:55Z

NeonBlack: fixed a typo

<div style="background: #FFEEAA; padding: 5px; float:right; width: 30%;">Aktuelle stabile Version von '''Multi Theft Auto: San Andreas Deathmatch''' ist '''{{Current Version|full}}'''. Diese kann auf der [http://mtasa.com/ Hauptseite] heruntergeladen werden.
<p>
Du kannst dir auch die [http://nightly.mtasa.com/ neueste nightly Version] herunterladen, die die neuesten Updates beinhaltet.
</p>
</div>
__NOTOC__
Willkommen im Multi Theft Auto: San Andreas Deathmatch Entwickler-Wiki. Du findest hier eine Fülle an Informationen zu der Entwicklung von Gamemodes und Maps für Multi Theft Auto.

Es gibt viele [[How you can help|Dinge, die Du tun kannst, um zur Verbesserung MTAs beizutragen]] - erstelle eine Map, einen Gamemode, ein Hilfsdokument zu einer Scriptfunktion, einen Beispielcode für das Wiki, schreibe ein Tutorial oder spiele einfach nur MTA und poste die Bugs, die Du dabei findest, im [http://bugs.mtasa.com Mantis Bugtracker].

Falls Du irgendwelche Fragen oder Probleme bezüglich Scripting hast, kannst Du uns gerne in unserem [[IRC Channel]] besuchen.
Mittlerweile haben sich auch einige deutsche MTA Scripter und Spieler zusammengetan und einen [irc://irc.gtanet.com/#mta.german deutschen MTA IRC Channel] sowie ein [http://sebihunter.de/wbb/ deutsches MTA Forum] gegründet. Dort könnt ihr auch jederzeit gerne vorbeischauen, wenn ihr Hilfe braucht.

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Einführung====

* [[DE/MTA_SA_Installation_&_Benutzung|MTA:SA Installation & Benutzung]] [[Image:De.gif|Deutscher Artikel]]
* [[DE/MTA_DM_Server_Anleitung|MTA DM Server Anleitung]] [[Image:00%.png|7% fertiggestellt]]
* [[Known_Issues_-_FAQ|Bekannte Probleme]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[DE/MTA_Scripting_Grundlagen|Scripting Grundlagen]] [[Image:De.gif|Deutscher Artikel]]
* [[Introduction to Scripting the GUI|Einführung in's GUI Scripting]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Debugging|Debugging Tutorial]] [[Image:usen.gif|Nur in Englisch verfügbar]] - So findest Du Fehler in Deinem Script
* [[MTA Classes|MTA Klassen]] [[Image:usen.gif|Nur in Englisch verfügbar]] - Detaillierte Beschreibung aller MTA Klassen
** [[Element|MTA Elemente]] / [[Element tree|Elementbaum]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Resources|Einführung in die Ressourcen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
** [[Resource Web Access|Webzugriff über Ressourcen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
** [[:Category:Resource|Ressourcenkatalog]] [[Image:usen.gif|Nur in Englisch verfügbar]]
** [[Meta.xml]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Resource:Mapmanager|Map Manager]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Writing_Gamemodes|Erstellung von Gamemodes]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Useful_Functions|Nützliche Funktionen]] [[Image:usen.gif|Nur in Englisch verfügbar]] - nützliche Funktionen von Scriptern für Scripter
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Datenbanken====
Diese Abteilung behandelt die Möglichkeiten von LUA mit MTA sowie die bereitgestellten Ressourcen.
* [[:Category:Resource|Ressourcenkatalog]] [[Image:usen.gif|Nur in Englisch verfügbar]] - Grundlagen, um ein korrektes Script zu erstellen
* [[Client side scripts|Clientseitige Scripts]] [[Image:usen.gif|Nur in Englisch verfügbar]]
</div>
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Generelle Hilfe zu Lua====
*[[DE/Lua_Tutorial|Ausführliches Lua Tutorial]] [[Image:De.gif|Deutscher Artikel]] - Neues Tutorial, in dem Lua sehr ausführlich erklärt wird
*[http://lua.lickert.net/ Deutsches LUA Tutorial]
*[http://lua.gts-stolberg.de/ Anderes deutsches LUA Tutorial] - Grundlagen verständlich vermittelt, jedoch lässt die Sprache insgesamt etwas zu wünschen übrig...
*[http://www.lua.org/pil/index.html "Programming in LUA" Anleitung] [[Image:usen.gif|Nur in Englisch verfügbar]]
*[http://lua-users.org/wiki/TutorialDirectory LUA Wiki] [[Image:usen.gif|Nur in Englisch verfügbar]]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Map Editor====
*[[Resource:Editor|Anleitung]] [[Image:usen.gif|Nur in Englisch verfügbar]]
*[[Resource:Editor/EDF|Editor Definitionsformat]] [[Image:usen.gif|Nur in Englisch verfügbar]]
*[[Resource:Editor/Plugins|Plugins]] [[Image:usen.gif|Nur in Englisch verfügbar]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">

====Referenz====
* [[Client Scripting Functions|Clientseitige Funktionen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Client Scripting Events|Clientseitige Events]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Server Scripting Functions|Serverseitige Funktionen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Server Scripting Events|Serverseitige Events]] [[Image:usen.gif|Nur in Englisch verfügbar]]

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====ID-Listen====
* [[Animations|Animationen]]
* [[Vehicle IDs|Fahrzeuge]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Template:Vehicle_colors|Fahrzeugfarben]]
* [[Vehicle_default_colors|Farbzuweisungen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Garage|Garagen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[CJ Clothes|Kleidung]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Template:Projectiles|Projektile]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Template:Blip_Icons|Radaricons]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Character Skins|Skins]] ([[All Skins Page|alle]]) [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Template:Sounds|Sounds]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Vehicle Upgrades|Tuningteile]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Weapons|Waffen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Weather|Wetter]] [[Image:usen.gif|Nur in Englisch verfügbar]]
</div>

|-
| colspan="2" |
|}
[[en:Main Page]]
[[es:Pagina Principal]]
[[it:Pagina principale]]
[[nl:Main Page]]
[[pl:Main Page]]
[[ru:Main Page]]

DE/Hauptseite

2009-10-27T18:14:21Z

NeonBlack: link update

<div style="background: #FFEEAA; padding: 5px; float:right; width: 30%;">Aktuelle stabile Version von '''Multi Theft Auto: San Andreas Deathmatch''' ist '''{{Current Version|full}}'''. Diese kann auf der [http://mtasa.com/ Hauptseite] heruntergeladen werden.
<p>
Du kannst dir auch die [http://nightly.mtasa.com/ neueste nightly Version] herunterladen, die die neuesten Updates beinhaltet.
</p>
</div>
__NOTOC__
Willkommen im Multi Theft Auto: San Andreas Deathmatch Entwickler-Wiki. Du findest hier eine Fülle an Informationen zu der Entwicklung von Gamemodes und Maps für Multi Theft Auto.

Es gibt viele [[How you can help|Dinge, die Du tun kannst, um zur Verbesserung MTAs beizutragen]] - erstelle eine Map, einen Gamemode, ein Hilfsdokument zu einer Scriptfunktion, einen Beispielcode für das Wiki, schreibe ein Tutorial oder spiele einfach nur MTA und poste die Bugs, die Du dabei findest, im [http://bugs.mtasa.com Mantis Bugtracker].

Falls Du irgendwelche Fragen oder Probleme bezüglich Scripting hast, kannst Du uns gerne in unserem [[IRC Channel]] besuchen.
Mittlerweile haben sich auch einige deutsche MTA Scripter und Spieler zusammengetan und einen [irc://irg.gtanet.com/#mta.german deutschen MTA IRC Channel] sowie ein [http://sebihunter.de/wbb/ deutsches MTA Forum] gegründet. Dort könnt ihr auch jederzeit gerne vorbeischauen, wenn ihr Hilfe braucht.

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Einführung====

* [[DE/MTA_SA_Installation_&_Benutzung|MTA:SA Installation & Benutzung]] [[Image:De.gif|Deutscher Artikel]]
* [[DE/MTA_DM_Server_Anleitung|MTA DM Server Anleitung]] [[Image:00%.png|7% fertiggestellt]]
* [[Known_Issues_-_FAQ|Bekannte Probleme]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[DE/MTA_Scripting_Grundlagen|Scripting Grundlagen]] [[Image:De.gif|Deutscher Artikel]]
* [[Introduction to Scripting the GUI|Einführung in's GUI Scripting]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Debugging|Debugging Tutorial]] [[Image:usen.gif|Nur in Englisch verfügbar]] - So findest Du Fehler in Deinem Script
* [[MTA Classes|MTA Klassen]] [[Image:usen.gif|Nur in Englisch verfügbar]] - Detaillierte Beschreibung aller MTA Klassen
** [[Element|MTA Elemente]] / [[Element tree|Elementbaum]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Resources|Einführung in die Ressourcen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
** [[Resource Web Access|Webzugriff über Ressourcen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
** [[:Category:Resource|Ressourcenkatalog]] [[Image:usen.gif|Nur in Englisch verfügbar]]
** [[Meta.xml]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Resource:Mapmanager|Map Manager]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Writing_Gamemodes|Erstellung von Gamemodes]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Useful_Functions|Nützliche Funktionen]] [[Image:usen.gif|Nur in Englisch verfügbar]] - nützliche Funktionen von Scriptern für Scripter
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Datenbanken====
Diese Abteilung behandelt die Möglichkeiten von LUA mit MTA sowie die bereitgestellten Ressourcen.
* [[:Category:Resource|Ressourcenkatalog]] [[Image:usen.gif|Nur in Englisch verfügbar]] - Grundlagen, um ein korrektes Script zu erstellen
* [[Client side scripts|Clientseitige Scripts]] [[Image:usen.gif|Nur in Englisch verfügbar]]
</div>
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Generelle Hilfe zu Lua====
*[[DE/Lua_Tutorial|Ausführliches Lua Tutorial]] [[Image:De.gif|Deutscher Artikel]] - Neues Tutorial, in dem Lua sehr ausführlich erklärt wird
*[http://lua.lickert.net/ Deutsches LUA Tutorial]
*[http://lua.gts-stolberg.de/ Anderes deutsches LUA Tutorial] - Grundlagen verständlich vermittelt, jedoch lässt die Sprache insgesamt etwas zu wünschen übrig...
*[http://www.lua.org/pil/index.html "Programming in LUA" Anleitung] [[Image:usen.gif|Nur in Englisch verfügbar]]
*[http://lua-users.org/wiki/TutorialDirectory LUA Wiki] [[Image:usen.gif|Nur in Englisch verfügbar]]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Map Editor====
*[[Resource:Editor|Anleitung]] [[Image:usen.gif|Nur in Englisch verfügbar]]
*[[Resource:Editor/EDF|Editor Definitionsformat]] [[Image:usen.gif|Nur in Englisch verfügbar]]
*[[Resource:Editor/Plugins|Plugins]] [[Image:usen.gif|Nur in Englisch verfügbar]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">

====Referenz====
* [[Client Scripting Functions|Clientseitige Funktionen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Client Scripting Events|Clientseitige Events]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Server Scripting Functions|Serverseitige Funktionen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Server Scripting Events|Serverseitige Events]] [[Image:usen.gif|Nur in Englisch verfügbar]]

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====ID-Listen====
* [[Animations|Animationen]]
* [[Vehicle IDs|Fahrzeuge]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Template:Vehicle_colors|Fahrzeugfarben]]
* [[Vehicle_default_colors|Farbzuweisungen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Garage|Garagen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[CJ Clothes|Kleidung]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Template:Projectiles|Projektile]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Template:Blip_Icons|Radaricons]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Character Skins|Skins]] ([[All Skins Page|alle]]) [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Template:Sounds|Sounds]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Vehicle Upgrades|Tuningteile]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Weapons|Waffen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Weather|Wetter]] [[Image:usen.gif|Nur in Englisch verfügbar]]
</div>

|-
| colspan="2" |
|}
[[en:Main Page]]
[[es:Pagina Principal]]
[[it:Pagina principale]]
[[nl:Main Page]]
[[pl:Main Page]]
[[ru:Main Page]]

Talk:Modules/MTA-MySQL/mysql connect

2009-10-05T11:46:23Z

NeonBlack: wrong syntax?

'''database''' seems to be a required argument. If ''nil'' is passed as '''database''' the following error message is output:<br/>
“ERROR: .../*.lua:*: Wrong parameter count for `mysql_connect'”<br/>
May someone test it and either validate or veto?<br/>
([[User:NeonBlack|NeonBlack]] 11:46, 5 October 2009 (UTC))
----

DE/MTA Scripting Grundlagen

2009-09-21T08:17:53Z

NeonBlack: /* Beschreibung */ fixed typo

==Vorwort==
Nachdem ich bereits vor kurzer Zeit mein [[DE/Lua_Tutorial|Lua Tutorial]] fertiggestellt habe, folgt nun eine Einführung in die Grundlagen des MTA Scriptings, in der diesmal direkter Bezug auf MTA genommen wird.

In Kürze wird es hier im Wiki einen blank Gamemode geben, den man sich herunterladen kann und als Basis für seinen eigenen verwenden kann. Die soll vor allem Anfängern den Einstieg in's MTA Scripting erleichtern.

==Grundlagen==
In diesem Tutorial wird häufig die Rede von Server und Client sein. Ein Client ist quasi ein Spieler, allgemein ist damit jedoch das Programm gemeint, was der Spieler auf dem Rechner installiert hat und mit dem er MTA spielen kann. Mit Server ist einfach der MTA Server gemeint.
Die Hauptaufgabe des Servers besteht darin, Daten von allen Clients bezüglich Position usw. einzusammeln und gleichzeitig an jeweils alle anderen Clients zu verteilen. Im Gegensatz zum Client ist der Server nicht in der Lage physikalische oder graphische Effekte zu berechnen, weswegen viele Funktionen von MTA, die eines dieser beiden Bereiche beeinflussen, clientseitig sind.

MTA unterscheidet zwischen zwei verschiedenen Ausführungsorten. D.h., dass es Scripts gibt, die vom Server ausgeführt und mit allen Clients synchronisiert werden und welche, die von jedem Client selbst ausgeführt werden und '''nicht''' mit allen anderen Clients synchronisiert werden.
Clientseitig bedeutet, dass etwas nur vom Client ausgeführt wird/werden kann, serverseitig, dass es nur vom Server ausgeführt wird/werden kann. Die meisten Funktionen von MTA können jedoch auf beiden Seiten ausgeführt werden.
Ziel ist es, diese Gegebenheit zu nutzen und den Server somit so gut wie möglich zu entlasten, was nicht immer einfach ist.

Bei MTA spricht man übrigens nicht von Scripts oder Gamemodes, sondern allgemein von Ressourcen. Eine Ressource ist ein Verzeichnis mit einem oder mehreren Scripts.
Beim Start des MTA Servers wird der ressources Ordner durchsucht und jedes Verzeichnis, dass eine gültige meta.xml enthält, der Liste der verfügbaren Ressourcen hinzugefügt.

==Meta.xml==
===Sinn und Zweck===
Die meta.xml ist eine wichtige Datei, die in jedem Ressourcenordner vorhanden sein muss, damit diese vom MTA Server erkannt wird und ausgeführt werden kann.
Sie definiert, aus welchen Dateien sich die Ressource zusammensetzt und unter anderem auch, welche dieser Dateien beim Connecten an den Client gesendet werden sollen.

Alle Daten in der meta.xml sind im XML-Format. Ein sogenannter XML-Tag ist ein Datenset, was in etwa so aussieht:
<tagname attribut="wert">inhalt</tagname> oder <tagname attribut="wert" />, wenn der Inhalt entfällt.
Ein XML-Tag kann beliebig viele Attribute enthalten.

Nähere Informationen zum Thema XML entnehmt ihr aber bitte dem [http://de.wikipedia.org/wiki/Xml Wikipedia-Artikel] darüber.

===Mögliche Tags===
<syntaxhighlight lang="lua" lang="xml"><info author="Autor" version="Version" name="Name" description="Beschreibung" type="Typ" /></syntaxhighlight>
*Jede Ressource sollte einen info-Tag in der meta.xml enthalten. Werte des info-Tags kann man übrigens mit [[getResourceInfo]] auslesen.
**'''author''': Das ist normalerweise der Name desjenigen, der die Ressource erstellt hat.
**'''version''': Die Version der vorliegenden Ressource. Für alle, die gerne mit wahllosen Versionsnummern um sich schmeißen.
**'''name''': Der Name der Ressource.
**'''description''': Eine kurze Beschreibung der Ressource.
**'''type''': Typ der Ressource. Kann den Wert "gamemode", "script" oder "map" enthalten.

<syntaxhighlight lang="lua" lang="xml"><script src="Dateipfad und -name" type="Typ" /></syntaxhighlight>
*Mit dem script-Tag werden Lua-Scriptdateien in die Ressource eingebunden. Das sind die wohl wichtigsten Dateien der meisten Ressourcen.
**'''src''': Der Pfad zur Scriptdatei relativ zum Odner der jeweiligen Ressource mit dem Dateinamen natürlich.
**'''type''': Typ des Scripts. Kann entweder "server" oder "client" sein. Bei ersterem wird das Script serverseitig ausgeführt, bei letzterem jedem Client beim Verbindungsaufbau gesendet und clientseitig ausgeführt.

<syntaxhighlight lang="lua" lang="xml"><map src="Dateipfad und -name" /></syntaxhighlight>
*Mit dem map-Tag werden Mapdateien eingebunden, die automatisch beim Ressourcenstart geladen werden. Mit den [[Server_Scripting_Functions#Map_functions|Mapfunktionen]] kann man nachträglich noch Maps laden. Eine Map ist übrigens eine Karte, genauer ein Set von ObjektIDs mit Koordinaten und Rotationsangaben.
**'''src''': Der Pfad zur Mapdatei relativ zum Odner der jeweiligen Ressource mit dem Dateinamen natürlich.

<syntaxhighlight lang="lua" lang="xml"><file src="Dateipfad und -name" /></syntaxhighlight>
*Der file-Tag zeichnet eine beliebige Datei als clientseitig aus. Während Scripts vom Typ "client" automatisch heruntergeladen werden, werden es die darin enthaltenen Bilder, Models oder Texturen nicht. Alle Dateien, die im clientseitigen Script verwendet werden, müssen mit dem file-Tag als clientseitig ausgezeichnet werden.
**'''src''': Der Pfad zur Datei relativ zum Odner der jeweiligen Ressource mit dem Dateinamen natürlich.

<syntaxhighlight lang="lua" lang="xml"><include ressource="Ressourcenname" /></syntaxhighlight>
*Manchmal möchte man, dass eine Ressource beim Start automatisch andere Ressourcen mit startet. Dies kann man mit dem include-Tag erreichen.
**'''ressource''': Der Name der Ressource, d.h. der Name des Ordners, in dem die Ressource sich befindet. (Muss sich im resources-Ordner befinden.)

<syntaxhighlight lang="lua" lang="xml"><config src="Dateipfad und -name" type="Typ" /></syntaxhighlight>
*Konfigurationsdateien sind XML-Dateien, in denen bestimmte Einstellungen für einen Ressource vorgenommen werden können, auf die per Script zugegriffen werden kann. Unter den [[Server_Scripting_Functions#Resource_functions|Ressourcenfunktionen]] finden sich solche zum Auslesen und Ändern der Konfiguration.
**'''src''': Der Pfad zur Konfigurationsdatei relativ zum Odner der jeweiligen Ressource mit dem Dateinamen natürlich.
**'''type''': Typ der Konfiguration. Kann entweder "server" oder "client" sein. Bei ersterem wird die Konfigurationsdatei serverseitig eingebunden, bei letzterem jedem Client beim Verbindungsaufbau gesendet und clientseitig eingebunden.

<syntaxhighlight lang="lua" lang="xml"><export function="Funktionsname" type="Typ" http="true/false" /></syntaxhighlight>
*Den export-Tag kann man benutzen, um eine Funktion aus der aktuellen Ressource in anderen laufenden Ressourcen verfügbar zu machen.
**'''function''': Der Name der Funktion.
**'''type''': Typ des Exports. Kann entweder "server" oder "client" sein. Bei ersterem wird die Funktion serverseitig exportiert, bei letzterem clientseitig.
**'''http''': Legt fest, ob die exportierte Funktion auch via HTTP aufgerufen werden kann. Kann demnach entweder "true" (ja) oder "false" (nein) sein.

<syntaxhighlight lang="lua" lang="xml"><html src="Dateipfad und -name" default="true/false" raw="true/false" /></syntaxhighlight>
*Wenn über MTAs eingebauten HTTP-Server Zugang zu einer im Ressourcenordner liegenden Datei ermöglichen will, so muss man diese mit dem html-Tag in der meta.xml einbinden.
**'''src''': Der Pfad zur Datei relativ zum Odner der jeweiligen Ressource mit dem Dateinamen natürlich.
**'''default''': Wenn das HTML-Dokument standardmäßig angezeigt werden soll, wenn über den Browser auf den Ressourcenordner zugegriffen wird, dann muss default="true" sein, ansonsten "false".
**'''raw''': Wenn es sich um eine Datei im binären Format handelt, z.B. einem Bild, dann sollte raw auf "true" gesetzt werden.

<syntaxhighlight lang="lua" lang="xml"><settings /></syntaxhighlight>

===Beispiel===
<syntaxhighlight lang="lua" lang="xml"><meta>
<info author="Slothman" type="gamemode" name="Stealth" />
<config src="help.xml" type="client"/>

<script src="stealthmain_server.lua" />
<script src="noiseblip.lua" />
<script src="mission_timer.lua" />
<script src="gadgets_server.lua" />
<script src="gadgets_client.lua" type="client"/>
<script src="stealthmain_client.lua" type="client"/>
<script src="noisebar.lua" type="client"/>
<script src="spycam.lua" type="client"/>

<file src="riot_shield.txd" />
<file src="riot_shield.dff" />
<file src="riot_shield.col" />
<file src="armor.png" />
<file src="camera.png" />
<file src="cloak.png" />
<file src="goggles.png" />
<file src="mine.png" />
<file src="radar.png" />
<file src="shield.png" />

<include resource="scoreboard" />
<include resource="killmessages" />
<include resource="maplimits" />

<settings>
<setting name="roundlimit" value="[6]" /> 
<setting name="teamdamage" value="[1]" /> 
<setting name="teambalance" value="[1]" /> 
<setting name="spazammo" value="[25]" /> 
<setting name="m4ammo" value="[100]" />
<setting name="shotgunammo" value="[25]" />
<setting name="sniperammo" value="[20]" />
<setting name="ak47ammo" value="[120]" />
<setting name="rifleammo" value="[40]" />
<setting name="deserteagleammo" value="[45]" />
<setting name="pistolammo" value="[132]" />
<setting name="uziammo" value="[150]" />
<setting name="tec9ammo" value="[150]" />
<setting name="silencedammo" value="[65]" />
<setting name="grenadeammo" value="[4]" />
<setting name="satchelammo" value="[4]" />
<setting name="teargasammo" value="[4]" />
<setting name="molatovammo" value="[4]" />
</settings>
</meta></syntaxhighlight>

==Elemente==
===Was sind Elemente?===
Ein Element in MTA kann alles sein. Sei es ein Spieler, ein Fahrzeug, ein Objekt, ein Marker, ein GUI-Element oder aber auch eine Ressource. Und das waren nicht mal alle möglichen Elementtypen.

Im Script sind Elemente durch Userdata-Pointer vertreten. Man kann mit ihnen eigentlich nichts anderes machen, als sie speichern oder an MTA-Funktionen übergeben und sie haben auch keinen darstellbaren Wert.
Wendet man tostring auf einen Userdata-Pointer an, so erhält man einen String in der Form "userdata: 0x090A34D". Die type-Funktion gibt "userdata" zurück, wenn man ihr ein Element übergibt.

===Der Elementbaum===
Den Elementbaum kann man sich wie einen Stammbaum vorstellen, nur dass der Ursprung bekannt ist.
Der Ursprung des Elementbaumes ist die sogenannte root (engl. für Wurzel). Aus ihr entspringen alle Elemente des ganzen Servers.

Bevor ich nun versuche, ein Bild zu beschreiben, wie man sich das vorstellen soll, zeige ich lieber ein Beispiel für einen MTA Elementbaum im XML-Format. Dieser ist jedoch an einigen Stellen stark vereinfacht, da er sonst den Rahmen sprengen würde, jedoch verschlechtert das die Verbildlichung nicht.

<syntaxhighlight lang="lua" lang="xml"><root>
<console/>
<player dontRespawn="false"/>
<player dontRespawn="false" lastSpawnarea=""/>
<resource id="resourcebrowser"/>
<resource id="ajax"/>
<resource id="resourcemanager"/>
<resource id="spawnmanager"/>
<resource id="mapmanager"/>
<resource id="runcode"/>
<resource id="fr">
<map id="dynamic">
<vehicle/>
</map>
</resource>
<resource id="elementbrowser"/>
<resource id="assault">
<map id="dynamic">
<team/>
<team/>
<blip/>
<marker/>
<colshape/>
<blip/>
<blip/>
</map>
</resource>
<resource id="as-farm">
<map id="dynamic"/>
<map id="as-farm.map">
<meta>
<author/>
<version/>
<name/>
<description/>
</meta>
<spawngroup req="" type="attacker">
<spawnarea posY="-8.3976354598999" posX="20.182683944702" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="32.166355133057" posX="-46.90763092041" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="35.214984893799" posX="-33.486911773682" skins="9" ... />
</spawngroup>
<spawngroup req="" type="attacker">
<spawnarea posY="35.214984893799" posX="-33.486911773682" skins="9" ... />
</spawngroup>
<objective id="first" type="checkpoint" description="Breach into the farm" ... />
<pickup type="weapon" ... />
</map>
</resource>
</root></syntaxhighlight>

Wie man in diesem Beispiel sehr schön sehen kann, sind alle Spieler, Ressourcen und die Konsole (das schwarze Serverfenster) direkte Kindelemente vom root-Element. Letzteres könnt ihr im Script übrigens mit [[getRootElement]] bekommen.
Maps und Fahrzeuge wiederrum sind Kindelemente der jeweiligen Ressourcen und so weiter.

===Elemente in MTA-Funktionen===
Die meisten MTA-Funktionen verlangen ein oder mehrere Elemente als Parameter oder geben eines zurück. Wenn man ein Element übergibt, was Kindelemente enthält, z.B. das root-Element, dann wendet MTA die Funktion auf alle Kindelemente des übergebenen Elements an, die dem Elementtypen entsprechen, der von der Funktion erwartet wird.
Der Typ eines Elements lässt sich mit [[getElementType]] herausfinden.

==Events==
===Beschreibung===
Ein Event ist ein Ereignis. Das kann z.B. der Tod eines Spielers sein, aber auch das Beenden einer Ressource oder das Klicken auf einen Button.

Ein Eventhandler ist eine Funktion, in unserem Fall eine Lua-Funktion, die aufgerufen wird, wenn ein bestimmtes Event stattfindet. Generell ist alles in MTA eventgesteuert und was nicht eventgesteuert ist, ist zeitgesteuert.

Mit der Funktion [[addEventHandler]] kann man in MTA eine Eventhandlerfunktion hinzufügen. Im Wiki finden sich Listen mit vorhandenen [[Server_Scripting_Events|serverseitigen Events]] und auch [[Client_Scripting_Events|clientseitigen Events]].

Wenn ein Event eintritt, dann werden alle dazugehörigen Eventhandlerfunktionen in einer Umgebung aufgerufen, die die Variable source definiert als den Pointer zu dem Element, welches das Event hervorgerufen hat.
Das heißt im Klartext, dass in jeder Eventhandlerfunktion die Variable source das Element enthält, was das Ereignis herbeigeführt hat.

Die Variablen root und resourceRoot sind in jeder Ressource vordefiniert, wobei root dem Rückgabewert von [[getRootElement]] und resourceRoot dem von [[getResourceRootElement]] entsprechen.

===Serverseitiges Beispiel===
<syntaxhighlight lang="lua" lang="lua">local gSpawnPosition = { 0, 0, 3 } -- Spawnposition

function onPlayerJoin()
spawnPlayer(source, unpack(gSpawnPosition)) -- spawne den Spieler
setCameraTarget(source) -- setze das Ziel seiner Kamera auf sich selbst
fadeCamera(source, true) -- blende die Umgebung ein

outputChatBox(getPlayerNametagText(source).." hat den Server betreten.") -- sende Nachricht an alle Spieler
end

function onPlayerQuit(quitType)
outputChatBox(getPlayerNametagText(source).." hat den Server verlassen. (Grund: "..quitType..")") -- sende Nachricht an alle Spieler
end

function onPlayerWasted()
spawnPlayer(source, getElementPosition(source)) -- respawne den Spieler
end

function onResourceStart()
for _, player in next, getElementsByType("player") do -- für jedes Spielerelement...
spawnPlayer(player, unpack(gSpawnPosition)) -- ...spawne den Spieler
fadeCamera(player, true) -- ...blende die Umgebung ein
end
end

function onResourceStop()
for _, player in next, getElementsByType("player") do-- für jedes Spielerelement...
fadeCamera(player, false) -- ...blende die Umgebung aus
end
end

-- füge die Eventhandler hinzu
addEventHandler("onPlayerJoin", root, onPlayerJoin)
addEventHandler("onPlayerQuit", root, onPlayerQuit)
addEventHandler("onPlayerWasted", root, onPlayerWasted)
addEventHandler("onResourceStart", resourceRoot, onResourceStart)
addEventHandler("onResourceStop", resourceRoot, onResourceStop)</syntaxhighlight>
Man sollte immer bedenken, dass Spielerelemente auf dem gleichen Level sind wie Ressourcenelemente, d.h., dass Spieler auch ohne dass Ressourcen laufen auf dem Server sein können, also auch schon, wenn eine Ressource startet.

==Commands==
===Beschreibung===
Commands sind Befehle, die der Spieler beginnend mit einem Schrägstrich (/) im Chat benutzen kann, um bestimmte Funktionen auszuführen.
Aufgrund der großen Bandbreite von alternativen Eingabemethoden wie Klicken auf Elemente in der Spielwelt oder GUI-Elemente zählen Commands eher zu den veralteten und unbequemen Eingabemethoden.

Der Ablauf ist ganz einfach: Der Spieler gibt einen Command ein, eventuell mit einem oder mehreren Parametern und MTA ruft eine Lua Funktion auf, der das Element des Spielers, der eingegebene Command sowie die übergebenen Parameter übermittelt werden.
Bei der Eingabe werden die Parameter einfach durch Leerzeichen getrennt. Beispiel: /command param1 param2 param3

Commandhandlerfunktionen werden in MTA mit der Funktion [[addCommandHandler]] hinzugefügt. Dazu nun einfach mal ein Beispiel für ein einfaches PM-System.

===Serverseitiges Beispiel===
<syntaxhighlight lang="lua" lang="lua">function cmdPrivateMessage(source, cmd, targetname, ...)
--[[ da auch die eigentliche Nachricht an den Leerzeichen gespalten und als einzelne Parameter übergeben wird,
muss man mit dem ...-Parameter eine nicht festgelegte Anzahl Parameter (jeder in diesem Fall ein Wort)
entgegennehmen und diese wieder zusammenfügen ]]
local message = table.concat({...}, " ")

if (message == "") then -- wenn die Nachricht leer ist, wenn also kein Spielername und/oder keine Nachricht übergeben wurde
outputChatBox("Syntax: /pm [str:Spielername] [str:Nachricht]", source, 240, 0, 0) -- Ausgabe der korrekten Syntax
return -- Abbruch der Funktion
end

local target = getPlayerFromNick(targetname) -- suche nach einem Spielerelement mit dem gegebenen Namen
if (not target) then -- wenn kein Spielerelement gefunden wurde
outputChatBox(targetname.." existiert nicht oder ist offline.", source, 240, 0 , 0) -- Ausgabe einer Fehlermeldung
return -- Abbruch der Funktion
end

-- ab hier ist gewährleistet, dass alle benötigten Daten vorhanden und gültig sind
outputChatBox("PM an "..targetname..": "..message, source, 200, 60, 0) -- Ausgabe einer Nachricht an den Sender
outputChatBox("PM von "..getPlayerNametagText(source)..": "..message, target, 240, 100, 0) -- Ausgabe einer Nachricht an den Empfänger
end

-- Hinzufügen des Commandhandlers
addCommandHandler("pm", cmdPrivateMessage, false, false)</syntaxhighlight>
Commandparameter werden immer als strings übergeben.

DE/Hauptseite

2009-09-04T13:09:43Z

NeonBlack: /* Einführung */ added linkt o new mta:sa manual

<div style="background: #FFEEAA; padding: 5px; float:right; width: 30%;">Aktuelle stabile Version von '''Multi Theft Auto: San Andreas Deathmatch''' ist '''{{Current Version|full}}'''. Diese kann auf der [http://mtasa.com/ Hauptseite] heruntergeladen werden.
<p>
Du kannst dir auch die [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 neueste nightly Version] herunterladen, die die neuesten Updates beinhaltet.
</p>
</div>
__NOTOC__
Willkommen im Multi Theft Auto: San Andreas Deathmatch Entwickler-Wiki. Du findest hier eine Fülle an Informationen zu der Entwicklung von Gamemodes und Maps für Multi Theft Auto.

Es gibt viele [[How you can help|Dinge, die Du tun kannst, um zur Verbesserung MTAs beizutragen]] - erstelle eine Map, einen Gamemode, ein Hilfsdokument zu einer Scriptfunktion, einen Beispielcode für das Wiki, schreibe ein Tutorial oder spiele einfach nur MTA und poste die Bugs, die Du dabei findest, im [http://bugs.mtasa.com Mantis Bugtracker].

Falls Du irgendwelche Fragen oder Probleme bezüglich Scripting hast, kannst Du uns gerne in unserem [[IRC Channel]] besuchen.
Mittlerweile haben sich auch einige deutsche MTA Scripter und Spieler zusammengetan und einen [irc://irg.gtanet.com/#mta.german deutschen MTA IRC Channel] sowie ein [http://sebihunter.de/wbb/ deutsches MTA Forum] gegründet. Dort könnt ihr auch jederzeit gerne vorbeischauen, wenn ihr Hilfe braucht.

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Einführung====

* [[DE/MTA_SA_Installation_&_Benutzung|MTA:SA Installation & Benutzung]] [[Image:De.gif|Deutscher Artikel]]
* [[DE/MTA_DM_Server_Anleitung|MTA DM Server Anleitung]] [[Image:00%.png|7% fertiggestellt]]
* [[Known_Issues_-_FAQ|Bekannte Probleme]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[DE/MTA_Scripting_Grundlagen|Scripting Grundlagen]] [[Image:De.gif|Deutscher Artikel]]
* [[Introduction to Scripting the GUI|Einführung in's GUI Scripting]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Debugging|Debugging Tutorial]] [[Image:usen.gif|Nur in Englisch verfügbar]] - So findest Du Fehler in Deinem Script
* [[MTA Classes|MTA Klassen]] [[Image:usen.gif|Nur in Englisch verfügbar]] - Detaillierte Beschreibung aller MTA Klassen
** [[Element|MTA Elemente]] / [[Element tree|Elementbaum]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Resources|Einführung in die Ressourcen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
** [[Resource Web Access|Webzugriff über Ressourcen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
** [[:Category:Resource|Ressourcenkatalog]] [[Image:usen.gif|Nur in Englisch verfügbar]]
** [[Meta.xml]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Resource:Mapmanager|Map Manager]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Writing_Gamemodes|Erstellung von Gamemodes]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Useful_Functions|Nützliche Funktionen]] [[Image:usen.gif|Nur in Englisch verfügbar]] - nützliche Funktionen von Scriptern für Scripter
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Datenbanken====
Diese Abteilung behandelt die Möglichkeiten von LUA mit MTA sowie die bereitgestellten Ressourcen.
* [[:Category:Resource|Ressourcenkatalog]] [[Image:usen.gif|Nur in Englisch verfügbar]] - Grundlagen, um ein korrektes Script zu erstellen
* [[Client side scripts|Clientseitige Scripts]] [[Image:usen.gif|Nur in Englisch verfügbar]]
</div>
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Generelle Hilfe zu Lua====
*[[DE/Lua_Tutorial|Ausführliches Lua Tutorial]] [[Image:De.gif|Deutscher Artikel]] - Neues Tutorial, in dem Lua sehr ausführlich erklärt wird
*[http://lua.lickert.net/ Deutsches LUA Tutorial]
*[http://lua.gts-stolberg.de/ Anderes deutsches LUA Tutorial] - Grundlagen verständlich vermittelt, jedoch lässt die Sprache insgesamt etwas zu wünschen übrig...
*[http://www.lua.org/pil/index.html "Programming in LUA" Anleitung] [[Image:usen.gif|Nur in Englisch verfügbar]]
*[http://lua-users.org/wiki/TutorialDirectory LUA Wiki] [[Image:usen.gif|Nur in Englisch verfügbar]]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Map Editor====
*[[Resource:Editor|Anleitung]] [[Image:usen.gif|Nur in Englisch verfügbar]]
*[[Resource:Editor/EDF|Editor Definitionsformat]] [[Image:usen.gif|Nur in Englisch verfügbar]]
*[[Resource:Editor/Plugins|Plugins]] [[Image:usen.gif|Nur in Englisch verfügbar]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">

====Referenz====
* [[Client Scripting Functions|Clientseitige Funktionen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Client Scripting Events|Clientseitige Events]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Server Scripting Functions|Serverseitige Funktionen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Server Scripting Events|Serverseitige Events]] [[Image:usen.gif|Nur in Englisch verfügbar]]

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====ID-Listen====
* [[Animations|Animationen]]
* [[Vehicle IDs|Fahrzeuge]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Template:Vehicle_colors|Fahrzeugfarben]]
* [[Vehicle_default_colors|Farbzuweisungen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Garage|Garagen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[CJ Clothes|Kleidung]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Template:Projectiles|Projektile]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Template:Blip_Icons|Radaricons]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Character Skins|Skins]] ([[All Skins Page|alle]]) [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Template:Sounds|Sounds]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Vehicle Upgrades|Tuningteile]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Weapons|Waffen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Weather|Wetter]] [[Image:usen.gif|Nur in Englisch verfügbar]]
</div>

|-
| colspan="2" |
|}
[[en:Main Page]]
[[es:Pagina Principal]]
[[it:Pagina principale]]
[[nl:Main Page]]
[[pl:Main Page]]
[[ru:Main Page]]

DE/Hauptseite

2009-09-04T13:08:13Z

NeonBlack: /* Generelle Hilfe zu Lua */ added german flag

<div style="background: #FFEEAA; padding: 5px; float:right; width: 30%;">Aktuelle stabile Version von '''Multi Theft Auto: San Andreas Deathmatch''' ist '''{{Current Version|full}}'''. Diese kann auf der [http://mtasa.com/ Hauptseite] heruntergeladen werden.
<p>
Du kannst dir auch die [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 neueste nightly Version] herunterladen, die die neuesten Updates beinhaltet.
</p>
</div>
__NOTOC__
Willkommen im Multi Theft Auto: San Andreas Deathmatch Entwickler-Wiki. Du findest hier eine Fülle an Informationen zu der Entwicklung von Gamemodes und Maps für Multi Theft Auto.

Es gibt viele [[How you can help|Dinge, die Du tun kannst, um zur Verbesserung MTAs beizutragen]] - erstelle eine Map, einen Gamemode, ein Hilfsdokument zu einer Scriptfunktion, einen Beispielcode für das Wiki, schreibe ein Tutorial oder spiele einfach nur MTA und poste die Bugs, die Du dabei findest, im [http://bugs.mtasa.com Mantis Bugtracker].

Falls Du irgendwelche Fragen oder Probleme bezüglich Scripting hast, kannst Du uns gerne in unserem [[IRC Channel]] besuchen.
Mittlerweile haben sich auch einige deutsche MTA Scripter und Spieler zusammengetan und einen [irc://irg.gtanet.com/#mta.german deutschen MTA IRC Channel] sowie ein [http://sebihunter.de/wbb/ deutsches MTA Forum] gegründet. Dort könnt ihr auch jederzeit gerne vorbeischauen, wenn ihr Hilfe braucht.

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Einführung====

* [[DE/MTA_DM_Client_Anleitung|MTA DM Client Anleitung]] [[Image:100%.png|100% übersetzt]]
* [[DE/MTA_DM_Server_Anleitung|MTA DM Server Anleitung]] [[Image:00%.png|7% fertiggestellt]]
* [[Known_Issues_-_FAQ|Bekannte Probleme]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[DE/MTA_Scripting_Grundlagen|Scripting Grundlagen]] [[Image:De.gif|Deutscher Artikel]]
* [[Introduction to Scripting the GUI|Einführung in's GUI Scripting]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Debugging|Debugging Tutorial]] [[Image:usen.gif|Nur in Englisch verfügbar]] - So findest Du Fehler in Deinem Script
* [[MTA Classes|MTA Klassen]] [[Image:usen.gif|Nur in Englisch verfügbar]] - Detaillierte Beschreibung aller MTA Klassen
** [[Element|MTA Elemente]] / [[Element tree|Elementbaum]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Resources|Einführung in die Ressourcen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
** [[Resource Web Access|Webzugriff über Ressourcen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
** [[:Category:Resource|Ressourcenkatalog]] [[Image:usen.gif|Nur in Englisch verfügbar]]
** [[Meta.xml]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Resource:Mapmanager|Map Manager]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Writing_Gamemodes|Erstellung von Gamemodes]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Useful_Functions|Nützliche Funktionen]] [[Image:usen.gif|Nur in Englisch verfügbar]] - nützliche Funktionen von Scriptern für Scripter
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Datenbanken====
Diese Abteilung behandelt die Möglichkeiten von LUA mit MTA sowie die bereitgestellten Ressourcen.
* [[:Category:Resource|Ressourcenkatalog]] [[Image:usen.gif|Nur in Englisch verfügbar]] - Grundlagen, um ein korrektes Script zu erstellen
* [[Client side scripts|Clientseitige Scripts]] [[Image:usen.gif|Nur in Englisch verfügbar]]
</div>
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Generelle Hilfe zu Lua====
*[[DE/Lua_Tutorial|Ausführliches Lua Tutorial]] [[Image:De.gif|Deutscher Artikel]] - Neues Tutorial, in dem Lua sehr ausführlich erklärt wird
*[http://lua.lickert.net/ Deutsches LUA Tutorial]
*[http://lua.gts-stolberg.de/ Anderes deutsches LUA Tutorial] - Grundlagen verständlich vermittelt, jedoch lässt die Sprache insgesamt etwas zu wünschen übrig...
*[http://www.lua.org/pil/index.html "Programming in LUA" Anleitung] [[Image:usen.gif|Nur in Englisch verfügbar]]
*[http://lua-users.org/wiki/TutorialDirectory LUA Wiki] [[Image:usen.gif|Nur in Englisch verfügbar]]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Map Editor====
*[[Resource:Editor|Anleitung]] [[Image:usen.gif|Nur in Englisch verfügbar]]
*[[Resource:Editor/EDF|Editor Definitionsformat]] [[Image:usen.gif|Nur in Englisch verfügbar]]
*[[Resource:Editor/Plugins|Plugins]] [[Image:usen.gif|Nur in Englisch verfügbar]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">

====Referenz====
* [[Client Scripting Functions|Clientseitige Funktionen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Client Scripting Events|Clientseitige Events]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Server Scripting Functions|Serverseitige Funktionen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Server Scripting Events|Serverseitige Events]] [[Image:usen.gif|Nur in Englisch verfügbar]]

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====ID-Listen====
* [[Animations|Animationen]]
* [[Vehicle IDs|Fahrzeuge]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Template:Vehicle_colors|Fahrzeugfarben]]
* [[Vehicle_default_colors|Farbzuweisungen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Garage|Garagen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[CJ Clothes|Kleidung]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Template:Projectiles|Projektile]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Template:Blip_Icons|Radaricons]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Character Skins|Skins]] ([[All Skins Page|alle]]) [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Template:Sounds|Sounds]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Vehicle Upgrades|Tuningteile]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Weapons|Waffen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Weather|Wetter]] [[Image:usen.gif|Nur in Englisch verfügbar]]
</div>

|-
| colspan="2" |
|}
[[en:Main Page]]
[[es:Pagina Principal]]
[[it:Pagina principale]]
[[nl:Main Page]]
[[pl:Main Page]]
[[ru:Main Page]]

DE/MTA SA Installation & Benutzung

2009-09-04T13:06:29Z

NeonBlack: new german mta:sa 1.0 client manual

==Einführung==
Multi Theft Auto: San Andreas ist eine von Fans programmierte OpenSource Multiplayer Modifikation für Rockstar Games' Spiel Grand Theft Auto San Andreas. Sie wurde von Rockstar Games weder genehmigt noch verboten.
Mit ihr ist es möglich, über das Internet oder ein Netzwerk mit anderen Spielern zusammen zu spielen. Dazu können eigene Maps und Gamemodes erstellt werden, die das Spiel individualisieren und dem Singleplayer gegenüber eine ganze Menge neuer Möglichkeiten bringen. Durch die hohe Zahl an Funktionen sind der Gestaltung eines eigenen MTA:SA Servers nahezu keine Grenzen mehr gesetzt. Außderdem wird an der Modifikation ständig weitergearbeitet.
Die aktuelle stabile Version ist MTA:SA 1.0.

==Vorbereitung==

===Vorraussetzungen===
#Es wird Grand Theft Auto San Andreas 1.0 benötigt. Sollte das Spiel um 2006/2007 oder später erworben worden sein, so kann es bereits sein, dass eine neuere Version vorhanden ist. In einem solchen Fall muss der [http://grandtheftauto.filefront.com/file/GTA_SA_Downgrader_Patch;74661 Downgrade Patch] installiert werden.
#Grand Theft Auto San Andreas sollte ungemoddet sein. Das bedeutet: '''Keine''' Modifikationen, außer
#einer US exe. Am leichtesten zu bekommen als NoCD Crack. ([http://lmgtfy.com/?q=Grand+Theft+Auto+San+Andreas+NoCD+EXE Google!])

===Herunterladen des Installers===
Um MTA:SA zu installieren, wird natürlich noch der neueste Installer benötigt. Dieser kann auf [http://www.mtasa.com/124.html der MTA San Andreas Downloadseite] heruntergeladen werden.

==Installation==
===Windows===
Mit einem Doppelklick auf den Installer startet die Installation automatisch. Normalerweise braucht man einfach nur auf „Weiter“ zu klicken, da die richtigen Voreinstellungen bereits da sind. MTA:SA findet das Verzeichnis von GTA San Andreas normalerweise auch automatisch. Wenn nicht, muss es halt manuell angegeben werden.

===Linux===
-- Fehlt noch! --

==Benutzung==
===Das MTA Menü===
[[Image:mta_menu.jpg|MTA:SA 1.0 Menu]]<br/>
Nach einem Doppelklick auf die MTA:SA Verknüpfung, die vom Installer automatisch auf dem Desktop eingerichtet wurde, kommt man in's '''MTA Menü'''.

===Quick Connect===
[[Image:mta_quick_connect.png|MTA:SA 1.0 Quick Connect]]<br/>
Mit '''Quick Connect''' (dt. schnell verbinden) kann man anhand einer IP Adresse und eines Ports zu einem MTA:SA Server verbinden.

===Browse Servers===
[[Image:mta_server_browser.png|MTA:SA 1.0 Server Browser]]<br/>
Im '''Server Browser''' werden alle MTA:SA Server aufgelistet, die dies in ihren Einstellungen aktiviert haben.
Folgende Listen können durch Klick auf einen der Tabs oben angezeigt werden:
*'''Internet''': Alle Server, die in ihren Einstellungen die Anzeige im Server Browser aktiviert haben.
*'''LAN''': Server, die sich im lokalen Netzwerk befinden und die Anzeige in der Netzwerkserverliste aktiviert haben.
*'''Favourites''': Eine private Liste, die vom Spieler selbst gefüllt werden kann.
*'''Recently Played''': Eine Liste mit allen Servern, die in letzter Zeit vom Spieler besucht wurden.

Unter den Tabs finden sich einige Filtereinstellungen, beginnend mit einem Suchfeld, in dem die Serverliste nach einem bestimmten Begriff durchsucht werden kann. Die anderen seien hier kurz erläutert:
*'''Include Empty''': Wenn aktiviert, werden auch Server angezeigt, auf denen zurzeit niemand spielt.
*'''Include Full''': Wenn aktiviert, werden auch Server angezeigt, deren Spielerlimit bereits erreicht ist.
*'''Include Locked''': Wenn aktiviert, werden auch Server angezeigt, die mit einem Passwort geschützt sind.
*'''Include Offline''': Diese Option ist nur in der Favoritenliste verfügbar. Wenn sie aktiviert ist, werden auch Server angezeigt, die momentan offline sind.

Bei einem Klick auf einen Server in der Liste werden rechts die Spieler, die zurzeit auf diesem spielen, in der '''Player List''' angezeigt. Sollte der Server ein Passwort erwarten, so muss dieses in das '''Password'''-Eingabefeld rechts eingegeben werden.<br/>
Mit dem '''Connect'''-Button rechts oben wird zu dem aktuell markierten Server eine Verbindung aufgebaut, sofern dieser noch nicht voll ist und das Passwort stimmt, falls vorhanden. Mit '''Refresh''' wird die gesamte Serverliste neu geladen.<br/>
Unten findet sich außerdem noch ein Button '''Add to Favourites''', mit dem der ausgewählte Server zur Favoritenliste hinzugefügt werden kann. In der Favoritenliste ist das Gegenstück dazu, '''Remove from Favourites''', welches den ausgewählten Server wieder aus der Liste entfernt. Außerdem gibt es dort den Button '''Add by host/ip''', mit dem man einen Server anhand seiner IP Adresse und seines Ports zu den Favoriten hinzufügen kann.

===Host Game===
[[Image:mta_host_game_general.png|MTA:SA 1.0 Host Game (General)]]<br/>
Mit '''Host Game''' (dt. ein Spiel veranstalten) kann man einen eigenen Server eröffnen, auf dem man selbst und andere Spieler dann spielen können. (Wenn man mit dem Internet verbunden ist, die Firewall richtig konfiguriert ist, die Ports freigegeben sind, usw.)

Die Felder und Einstellungen:
*'''Server Name''': Der Name des Servers, der in der Serverliste angezeigt werden soll.
*'''Password''': Das Passwort des Servers. Wenn leer gelassen, kann man den Server ohne Angabe eines Passworts betreten.
*'''Max Players''': Die maximale Anzahl an Spielern, die gleichzeitig auf dem Server sein können sollen.
*'''Broadcast''': Hier wird eingestellt, auf welchen Listen der Server angezeigt werden soll.
**'''LAN''': Der Server wird in der LAN-Liste für alle Spieler im Netzwerk angezeigt.
**'''Internet''': Der Server wird in der Internet-Liste für alle Spieler angezeigt.

Im Tab '''Resources''' kann eingestellt erden, welche Ressourcen der Server starten soll. Dabei stehen links alle, die gestartet werden sollen und rechts alle, die verfügbar sind. Die Buttons mit den Pfeilen sind wohl selbsterklärend.

===Map Editor===
[[Image:mta_map_editor.jpg|MTA:SA 1.0 Map Editor Startbildschirm]]<br/>
Der '''Map Editor''' (dt. Karteneditor) ist eine Ressource, mit der man einfach und professionell Fahrzeuge und Objekte in San Andreas platzieren kann. Er hat ein eingebautes Tutorial. Dennoch existiert ein ausführliches Tutorial im dazugehörigen [[Map editor|Wiki Artikel]] [[Image:Usen.gif|Nur in Englisch verfügbar]].

===Settings===
In den '''Settings''' (dt. Einstellungen) werden alle möglichen Einstellungen für MTA:SA vorgenommen.<br/>
Hier mal eine Übersicht der vorhandenen Tabs und den Bedeutungen derer Inhalte:
====Multiplayer====
*'''Nick''': Der Nickname, der im Spiel verwendet werden soll.
*'''Connection''': Der Typ der Internetverbindung.
*'''Save Server Passwords''': Wenn aktiviert, braucht man bei passwortgeschützten Servern nur einmal das Passwort einzugeben. Dieses wird dann gespeichert.
====Video====
*'''General'''
**'''Resolution''': Bildschirmauflösung im Format Breite x Höhe x Farbtiefe (in Bit)
***'''Windowed''': Fenstermodus
***'''Wide Screen''': Breitbild
*'''Map rendering Options'''
**'''Opacity''': Deckkraft der Karte, die mit F11 angezeigt werden kann
====Audio====
*'''Radio Volume''': Radiolautstärke
*'''SFX Volume''': Lautstärke der Audioeffekte und Geräusche
*'''MTA Volume''': Lautstärke der Sounds, die durch MTA erzeugt werden
====Binds====
Hier kann die Tastatursteuerung konfiguriert werden. Mit '''Load defaults''' wird die Steuerung auch Standardeinstellungen zurückgesetzt.
====Controls====
Hier können Mauseinstellungen vorgenommen und ein Joystick/Controller konfiguriert werden.
====Community====
Hier kann man seine Accountdaten von [http://community.mtasa.com/ community.mtasa.com] angeben, um sich als Community Mitglied auszuweisen.
====Chatbox====
Hier kann die Chatbox konfiguriert werden.

===Quit===
Mit einem Klick auf '''Quit''' wird MTA:SA sofort beendet.

==Hotkeys==
Folgende Hotkeys können im Spiel verwendet werden:
*'''F8''' oder '''^''': Öffnet die Konsole, die ein Chatlog enthält und Copypaste-Funktionen bereitstellt. Befehle werden hier ohne / eingegeben
*'''F9''': Öffnet das Hilfefenster, wenn die ''helpmanager'' Ressource läuft.
*'''F11''': Zeigt eine Karte von San Andreas an, bei der folgende Steuerungen möglich sind:
**'''Num+''' bzw. '''Num-''': Rein- und rauszoomen
**'''Num8''', '''Num6''', '''Num4''' bzw. '''Num2''': Die Karte nach oben, rechts, links bzw. unten verschieben
**'''Num0''': (De-)Aktiviert, dass die Karte automatisch dem Spieler folgt
*'''F12''': Screenshot (wird in .../MTA San Andreas/screenshots als PNG abgespeichert)
*'''T''': Öffentlicher Chat
*'''Y''': Teamchat
*'''Tab''': Zeigt eine Spielerliste an, wenn die ''scoreboard'' Ressource läuft

==Konsolenbefehle==
Im Folgenden sollen die wichtigsten Befehle, die in der F8-Konsole eingegeben werden können, erläutert werden:
*'''commands''': Zeigt serverspezifische Befehle an.
*'''disconnect''': Beendet Deine Verbindung zum Server.
*'''exit''': Beendet MTA:SA sofort. Alternativ geht auch '''quit'''.
*'''help''': Zeigt alle verfügbaren Konsolenbefehle an.
*'''ignore''' ''<name>'': Ignoriert alle Nachrichten von ''<name>''. Beim zweiten Mal wird ''<name>'' wieder von der Ignorierliste genommen.
*'''maps''': Zeigt eine Liste mit allen verfügbaren Maps auf dem Server an.
*'''msg''' ''<name> <nachricht>'': Sendet ''<nachricht>'' als private Nachricht an ''<name>''. Anstelle von '''msg''' geht auch '''pm'''.
*'''nick''' ''<name>'': Ändert den eigenen Nick zu ''<name>''.
*'''reconnect''': Beendet Deine Verbindung zum Server und baut sie direkt danach neu auf.
*'''say''' ''<nachricht>'': Sendet ''<nachricht>'' in den öffentlichen Chat.
*'''time''': Zeigt die aktuelle Zeit an.
*'''ver''': Zeigt die aktuelle Version und die Copyright Informationen zum eigenen Client an.
'''Tipp''': Diese Befehle können auch in die normale Chateingabezeile eingegeben werden, wenn ihnen ein Schrägstrich (/) vorgestellt wird.

File:Mta map editor.jpg

2009-09-04T12:20:05Z

NeonBlack: MTA:SA 1.0 Map Editor Start Screen

MTA:SA 1.0 Map Editor Start Screen

File:Mta host game general.png

2009-09-04T11:59:59Z

NeonBlack: MTA:SA 1.0 Host Game window (General Tab)

MTA:SA 1.0 Host Game window (General Tab)

File:Mta server browser.png

2009-09-04T11:38:16Z

NeonBlack: MTA:SA 1.0 Server Browser window

MTA:SA 1.0 Server Browser window

File:Mta quick connect.png

2009-09-04T11:30:40Z

NeonBlack: MTA:SA 1.0 Quick Connect window

MTA:SA 1.0 Quick Connect window

File:Mta menu.jpg

2009-09-04T11:16:12Z

NeonBlack: uploaded a new version of "File:Mta menu.jpg": MTA:SA 1.0 menu

User:NeonBlack

2009-08-31T17:09:55Z

NeonBlack: ToDo List :D

Just writing anything so that my name isn't red anymore :Þ
--[[User:NeonBlack|NeonBlack]] 04:25, 3 August 2008 (CEST)

==ToDo==
*Translate [[Resource:Editor]] --[[User:NeonBlack|NeonBlack]] 17:09, 31 August 2009 (UTC)

ToggleControl

2009-08-28T16:48:21Z

NeonBlack: Needs checking!

__NOTOC__
{{Server client function}}
{{Needs Checking|By enabling a control all bindings belonging to it seem to be deleted. (tested clientside) --[[User:NeonBlack|NeonBlack]] 16:48, 28 August 2009 (UTC)}}
Enables or disables the use of a GTA control for a specific player.

==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">bool toggleControl ( player thePlayer, string control, bool enabled ) </syntaxhighlight>

===Required Arguments===
*'''thePlayer:''' The player you wish to toggle the control ability of.
*'''control:''' The control that you want to toggle the ability of. See [[control names]] for a list of possible controls.
*'''enable:''' A boolean value representing whether or not the key will be usable or not.
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">bool toggleControl ( string control, bool enabled ) </syntaxhighlight>

===Required Arguments===
*'''control:''' The control that you want to toggle the ability of. See [[control names]] for a list of possible controls.
*'''enable:''' A boolean value representing whether or not the key will be usable or not.
</section>

==Returns==
This function ''true'' if the control was set successfully, ''false'' otherwise.

==Example==
<section name="Example 1" class="server" show="true">
This function will disable the use of the vehicle secondary-fire key for anyone in a Hydra, consequently removing the ability to fire rockets.
<syntaxhighlight lang="lua">
function disableFireForHydra ( theVehicle, seat, jacked )
if ( getVehicleID ( theVehicle ) == 520 ) then -- if they entered a hydra
toggleControl ( source, "vehicle_secondary_fire", false ) -- disable their fire key
else -- if they entered another vehicle
toggleControl ( source, "vehicle_secondary_fire", true ) -- enable their fire key
end
end
addEventHandler ( "onPlayerVehicleEnter", getRootElement(), disableFireForHydra )
</syntaxhighlight>
''Note: The same can be achieved by using [[setVehicleGunsEnabled]]''.
</section>
<section name="Example 2" class="client" show="false">
This function will disable the use of the vehicle secondary-fire key for anyone in a Hydra, consequently removing the ability to fire rockets.
<syntaxhighlight lang="lua">
function disableFireForHydra ( theVehicle, seat )
if ( getVehicleID ( theVehicle ) == 520 ) then -- if they entered a hydra
toggleControl ( "vehicle_secondary_fire", false ) -- disable their fire key
else -- if they entered another vehicle
toggleControl ( "vehicle_secondary_fire", true ) -- enable their fire key
end
end
addEventHandler ( "onClientPlayerEnterVehicle", getLocalPlayer(), disableFireForHydra )
</syntaxhighlight>
''Note: The same can be achieved by using [[setVehicleGunsEnabled]]''.
</section>

==See Also==
{{Input functions}}

DE/Hauptseite

2009-08-23T10:49:43Z

NeonBlack:

<div style="background: #FFEEAA; padding: 5px; float:right; width: 30%;">Aktuelle stabile Version von '''Multi Theft Auto: San Andreas Deathmatch''' ist '''{{Current Version|full}}'''. Diese kann auf der [http://mtasa.com/ Hauptseite] heruntergeladen werden.
<p>
Du kannst dir auch die [http://code.google.com/p/multitheftauto/wiki/NightlyBuilds?tm=2 neueste nightly Version] herunterladen, die die neuesten Updates beinhaltet.
</p>
</div>
__NOTOC__
Willkommen im Multi Theft Auto: San Andreas Deathmatch Entwickler-Wiki. Du findest hier eine Fülle an Informationen zu der Entwicklung von Gamemodes und Maps für Multi Theft Auto.

Es gibt viele [[How you can help|Dinge, die Du tun kannst, um zur Verbesserung MTAs beizutragen]] - erstelle eine Map, einen Gamemode, ein Hilfsdokument zu einer Scriptfunktion, einen Beispielcode für das Wiki, schreibe ein Tutorial oder spiele einfach nur MTA und poste die Bugs, die Du dabei findest, im [http://bugs.mtasa.com Mantis Bugtracker].

Falls Du irgendwelche Fragen oder Probleme bezüglich Scripting hast, kannst Du uns gerne in unserem [[IRC Channel]] besuchen.
Mittlerweile haben sich auch einige deutsche MTA Scripter und Spieler zusammengetan und einen [irc://irg.gtanet.com/#mta.german deutschen MTA IRC Channel] sowie ein [http://sebihunter.de/wbb/ deutsches MTA Forum] gegründet. Dort könnt ihr auch jederzeit gerne vorbeischauen, wenn ihr Hilfe braucht.

<div style="clear:both;"></div>
{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

|-
| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">
====Einführung====

* [[DE/MTA_DM_Client_Anleitung|MTA DM Client Anleitung]] [[Image:100%.png|100% übersetzt]]
* [[DE/MTA_DM_Server_Anleitung|MTA DM Server Anleitung]] [[Image:00%.png|7% fertiggestellt]]
* [[Known_Issues_-_FAQ|Bekannte Probleme]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[DE/MTA_Scripting_Grundlagen|Scripting Grundlagen]] [[Image:De.gif|Deutscher Artikel]]
* [[Introduction to Scripting the GUI|Einführung in's GUI Scripting]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Debugging|Debugging Tutorial]] [[Image:usen.gif|Nur in Englisch verfügbar]] - So findest Du Fehler in Deinem Script
* [[MTA Classes|MTA Klassen]] [[Image:usen.gif|Nur in Englisch verfügbar]] - Detaillierte Beschreibung aller MTA Klassen
** [[Element|MTA Elemente]] / [[Element tree|Elementbaum]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Resources|Einführung in die Ressourcen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
** [[Resource Web Access|Webzugriff über Ressourcen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
** [[:Category:Resource|Ressourcenkatalog]] [[Image:usen.gif|Nur in Englisch verfügbar]]
** [[Meta.xml]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Resource:Mapmanager|Map Manager]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Writing_Gamemodes|Erstellung von Gamemodes]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Useful_Functions|Nützliche Funktionen]] [[Image:usen.gif|Nur in Englisch verfügbar]] - nützliche Funktionen von Scriptern für Scripter
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Datenbanken====
Diese Abteilung behandelt die Möglichkeiten von LUA mit MTA sowie die bereitgestellten Ressourcen.
* [[:Category:Resource|Ressourcenkatalog]] [[Image:usen.gif|Nur in Englisch verfügbar]] - Grundlagen, um ein korrektes Script zu erstellen
* [[Client side scripts|Clientseitige Scripts]] [[Image:usen.gif|Nur in Englisch verfügbar]]
</div>
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Generelle Hilfe zu Lua====
*[[DE/Lua_Tutorial|Ausführliches Lua Tutorial]] - Neues Tutorial, in dem Lua sehr ausführlich erklärt wird
*[http://lua.lickert.net/ Deutsches LUA Tutorial]
*[http://lua.gts-stolberg.de/ Anderes deutsches LUA Tutorial] - Grundlagen verständlich vermittelt, jedoch lässt die Sprache insgesamt etwas zu wünschen übrig...
*[http://www.lua.org/pil/index.html "Programming in LUA" Anleitung] [[Image:usen.gif|Nur in Englisch verfügbar]]
*[http://lua-users.org/wiki/TutorialDirectory LUA Wiki] [[Image:usen.gif|Nur in Englisch verfügbar]]
</div>

| width="50%" style="vertical-align:top;" |
<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====Map Editor====
*[[Resource:Editor|Anleitung]] [[Image:usen.gif|Nur in Englisch verfügbar]]
*[[Resource:Editor/EDF|Editor Definitionsformat]] [[Image:usen.gif|Nur in Englisch verfügbar]]
*[[Resource:Editor/Plugins|Plugins]] [[Image:usen.gif|Nur in Englisch verfügbar]]
</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px; background:#CCCCFF;">

====Referenz====
* [[Client Scripting Functions|Clientseitige Funktionen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Client Scripting Events|Clientseitige Events]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Server Scripting Functions|Serverseitige Funktionen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Server Scripting Events|Serverseitige Events]] [[Image:usen.gif|Nur in Englisch verfügbar]]

</div>

<div style="border: 1px dotted #AAAAAA;padding:4px 8px 8px 8px;margin:10px;">

====ID-Listen====
* [[Animations|Animationen]]
* [[Vehicle IDs|Fahrzeuge]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Template:Vehicle_colors|Fahrzeugfarben]]
* [[Vehicle_default_colors|Farbzuweisungen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Garage|Garagen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[CJ Clothes|Kleidung]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Template:Projectiles|Projektile]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Template:Blip_Icons|Radaricons]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Character Skins|Skins]] ([[All Skins Page|alle]]) [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Template:Sounds|Sounds]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Vehicle Upgrades|Tuningteile]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Weapons|Waffen]] [[Image:usen.gif|Nur in Englisch verfügbar]]
* [[Weather|Wetter]] [[Image:usen.gif|Nur in Englisch verfügbar]]
</div>

|-
| colspan="2" |
|}
[[en:Main Page]]
[[es:Pagina Principal]]
[[it:Pagina principale]]
[[nl:Main Page]]
[[pl:Main Page]]
[[ru:Main Page]]

Talk:Table.size

2009-08-18T22:18:10Z

NeonBlack:

What about using the builtin lua function:

table.getn(table)

--[[User:Subenji99|Subenji99]] 06:54, 13 July 2009 (CEST)
----
table.getn was replaced by the #-operator, which returns the number of table elements with a numerical (!) index.<br/>
table.size counts all elements regardless of which type their index is.<br/>
Of course it's a bad idea to use this function for a table with only numerical indices.<br/>
[[User:NeonBlack|NeonBlack]] 16:19, 13 July 2009 (CEST)
----
Indded, I actually just attempted it with non-numerical indices and found it didn't work. I stand corrected. :D

I shall leave my humiliation (lol) here so anyone else wondering what the point of this function would be can see that it is for non-numerical indices.

Oh, reading up, I'd like to point out that if you structure your table, planning for this, you can still use the # operator.
you have to count the additions you make to your table then use table.setn like so:

table.setn(table, <number of values>)

if you are using a loop to create your table, it would be a simple matter to add it after:

table = {}
local count = 0
for _,v in pairs(results) do
table[v] = someFunction(v)
count = count + 1
end
table.setn(table, count)

[http://www.lua.org/pil/19.1.html Array Size]

In my case though, this function was still required as the table I was checking against was a returned table from an exported function of mapmanager.

--[[User:Subenji99|Subenji99]] 20:43, 13 July 2009 (CEST)
----
You should really update your Lua skills. table.setn is deprecated like table.getn is, too.<br/>
Of course setting the n of the table would be much more efficient than iterating through it to get the size, but it's as I already said deprecated.<br/>
Alternatively you could use a mostly unused index for storing the size like _ for example. But I don't think iterating through the table and just increasing one value each step isn't that expensive.<br/>
[[User:NeonBlack|NeonBlack]] 20:50, 14 July 2009 (CEST)

== Sebas ==

Please keep using pairs instead of next for new people :)
----
I don't think that's useful. People should learn to use next instead of pairs. Apart from that it's no code for learning but more a code for copying.<br/>
[[User:NeonBlack|NeonBlack]] 22:18, 18 August 2009 (UTC)

Table.size

2009-08-18T17:33:38Z

NeonBlack: /* Code */ pairs -> next!

{{Useful Function}}
<lowercasetitle></lowercasetitle>
__NOTOC__
This function returns the total size of a table and not only the highest numerical index like table.maxn or the number of fields that have a numerical index like the #-operator.

==Syntax==
<syntaxhighlight lang="lua">int table.size( table tab )</syntaxhighlight>

===Required Arguments===
* '''tab''': The table to retrieve the total size of.

===Returns===
Returns the total number of fields the table contains.

==Code==
<section name="Server- and/or clientside Script" class="both" show="true">
<syntaxhighlight lang="lua">
function table.size(tab)
local length = 0
for _ in next, tab do length = length + 1 end
return length
end
</syntaxhighlight>
</section>

==Example==
<section name="Server- and/or clientside Script" class="both" show="true">
<syntaxhighlight lang="lua">
local tab = { 1, 2, 3, [25] = 4, five = 5, foo = "bar" }
print(tostring(#tab)) --prints: 4 (because there are 4 fields with a numerical index)
print(tostring(table.maxn(tab))) --prints: 25 (because the highest numerical index is 25)
print(tostring(table.size(tab))) --prints: 6 (because the table has 6 fields in total)
</syntaxhighlight>
</section>

Author: NeonBlack

==See Also==
{{Useful_Functions}}

User:NeonBlack

2009-08-16T08:20:11Z

NeonBlack:

Just writing anything so that my name isn't red anymore :Þ
--[[User:NeonBlack|NeonBlack]] 04:25, 3 August 2008 (CEST)

Math.round

2009-08-15T08:25:57Z

NeonBlack: /* Example */ <.<

{{Useful Function}}
<lowercasetitle></lowercasetitle>
__NOTOC__
This function is a full featured round function for Lua's math-library.
Bear in mind that both the floor and the ceil method may not work properly clientside when you pass something greater than 0 as second argument. This is because of some weird clientside number bug. It's fixed for the round method.

==Syntax==
<syntaxhighlight lang="lua">int/float math.round( float number, [ int decimals = 0, string method = "round" ] )</syntaxhighlight>

===Required Arguments===
* '''number''': The number to round.

===Optional Arguments===
{{OptionalArg}}
* '''decimals''': The number of decimals to keep.
* '''method''': The round method that should be used. Valid values are "round" (which is default), "floor" and "ceil".

===Returns===
Returns the rounded number.

==Code==
<section name="Server- and/or clientside Script" class="both" show="true">
<syntaxhighlight lang="lua" lang="lua">
function math.round(number, decimals, method)
decimals = decimals or 0
local factor = 10 ^ decimals
if (method == "ceil" or method == "floor") then return math[method](number * factor) / factor
else return tonumber(("%."..decimals.."f"):format(number)) end
end
</syntaxhighlight>
</section>

==Example==
<section name="Serverside Example" class="server" show="true">
This example adds a command that outputs the players actual position approximated to three decimals.
<syntaxhighlight lang="lua" lang="lua">
addCommandHandler("pos", function ()
local x, y, z = getElementPosition(getPedOccupiedVehicle(source) or source)
outputChatBox("Your actual position: ["..math.round(x, 3).."|"..math.round(y, 3).."|"..math.round(z, 3).."]", source)
end, false, false)
</syntaxhighlight>
</section>

Author: NeonBlack

==See Also==
{{Useful_Functions}}

Template:Useful Functions

2009-08-15T08:25:19Z

NeonBlack: added math.round

*[[callClientFunction]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function allows you to call any clientside function from the server's side.</span>

*[[callServerFunction]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function allows you to call any server-side function from the client's side.</span>

*[[Check]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function checks if it's arguments are of the right types and calls the error-function if one isn't.</span>

*[[doForAllElements]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function can be used to execute a specified function for all elements of a specified type.</span>

*[[findRotation]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Takes two points and returns the direction from point A to point B.</span>

*[[FormatDate]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Formats a date on the basis of a format string and returns it.</span>

*[[getPointFromDistanceRotation]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Finds a point based on a starting point, direction and distance.</span>

*[[GetTimestamp]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» With this function you can get the [http://en.wikipedia.org/wiki/Unix_time UNIX timestamp].</span>

*[[IfElse]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Returns one of two values based on a boolean expression.</span>

*[[IsYearALeapYear]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Checks if the given year is a leap year.</span>

*[[math.round]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Rounds a number whereas the number of decimals to keep and the method may be set.</span>

*[[setTableProtected]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Protects a table and makes it read-only.</span>

*[[string.explode]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function splits a string at a given separator pattern and returns a table with the pieces.</span>

*[[table.copy]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function copies a whole table and all the tables in that table.</span>

*[[table.map]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» This function goes through a table and replaces every field with the return of the passed function, where the field's value is passed as first argument and optionally more arguments.</span>

*[[table.size]] <span style="color:gray; font-family:'Georgia',sans-serif; font-size:smaller;">» Finds the absolute size of a table.</span>

[[Category:Useful Functions]]

Math.round

2009-08-15T08:22:44Z

NeonBlack: new useful function: math.round

{{Useful Function}}
<lowercasetitle></lowercasetitle>
__NOTOC__
This function is a full featured round function for Lua's math-library.
Bear in mind that both the floor and the ceil method may not work properly clientside when you pass something greater than 0 as second argument. This is because of some weird clientside number bug. It's fixed for the round method.

==Syntax==
<syntaxhighlight lang="lua">int/float math.round( float number, [ int decimals = 0, string method = "round" ] )</syntaxhighlight>

===Required Arguments===
* '''number''': The number to round.

===Optional Arguments===
{{OptionalArg}}
* '''decimals''': The number of decimals to keep.
* '''method''': The round method that should be used. Valid values are "round" (which is default), "floor" and "ceil".

===Returns===
Returns the rounded number.

==Code==
<section name="Server- and/or clientside Script" class="both" show="true">
<syntaxhighlight lang="lua" lang="lua">
function math.round(number, decimals, method)
decimals = decimals or 0
local factor = 10 ^ decimals
if (method == "ceil" or method == "floor") then return math[method](number * factor) / factor
else return tonumber(("%."..decimals.."f"):format(number)) end
end
</syntaxhighlight>
</section>

==Example==
<section name="Serverside Example" class="server" show="true">
This example adds a command that outputs the players actual position approximated to three decimals.
<syntaxhighlight lang="lua" lang="lua">
addCommandHandler("pos", function ()
local x, y, z = getElementPosition(getPedOccupiedVehicle(source) or source)
outputChatBox("Your actual position: ["..math.format(x, 3).."|"..math.format(y, 3).."|"..math.format(z, 3).."]", source)
end, false, false)
</syntaxhighlight>
</section>

Author: NeonBlack

==See Also==
{{Useful_Functions}}

DE/Lua Tutorial

2009-08-09T09:43:41Z

NeonBlack: /* Einzeln */

__TOC__

==Vorwort==
Da es bis auf einige knappe und teils unprofessionelle Tutorials kein deutsches Lua Tutorial gibt, habe ich beschlossen, nun ein eigenes zu schreiben, welches alle für MTA notwendigen Grundlagen einfach und übersichtlich erklärt.
Weiterführende Möglichkeiten und Funktionen können der [http://www.lua.org/manual/5.1/ Offiziellen Lua Dokumentation] entnommen werden, die es jedoch nicht auf Deutsch gibt.

Ein weiterer Grund ist, dass ich schon von einigen gehört habe und auch so schon den Verdacht hatte, dass MTA einfach so wenige deutsche Spieler und vor allem Server hat (gibt es überhaupt '''einen''' deutschen?), weil die meisten Probleme mit den englischen Dokumentationen haben oder der Meinung sind, dass für MTA ja sowieso kein deutscher Support vorhanden ist.

Soviel nun dazu, wie es zu der Idee des deutschen Lua Tutorials kam.
Fangen wir an mit dem Erlernen einer neuen Sprache!

==Grundlagen==
===Lua, eine Skriptsprache===
Lua (portugiesisch für Mond) ist eine Skriptsprache zum Einbinden in Programme, um diese leichter weiterentwickeln und warten zu können. Insbesondere die geringe Größe des Interpreters von 120 KB und die hohe Geschwindigkeit verglichen mit anderen Skriptsprachen überzeugen viele Entwickler davon, Lua einzusetzen.

Die Syntax lehnt sich an die von Pascal an, was besonders Anfängern den Einstieg in Lua erleichtert. Im Gegensatz zu von Pascal abgeleiteten Sprachen nutzt Lua jedoch „==“ und nicht „=“ als Vergleichsoperator.

(Quelle: [http://de.wikipedia.org/wiki/Lua Wikipedia])

Einige werden sich bei dieser Einführung vielleicht gefragt haben, was der Unterschied zwischen Skript- und Programmiersprache ist und was ein Interpreter sein soll. Im folgenden will ich diese beiden Fragen so kurz und einfach wie möglich klären.

Eine '''Programmiersprache''' (z.B. C, C++, Pascal, Delphi) wird - wie der Name schon sagt - verwendet, um Programme zu schreiben. Ein Programm liegt bekannterweise in Form einer Executable (*.exe) vor. Diese kann weitgehend unabhängig von irgendwelchen Betriebssystemen oder der Umgebung selbstständig ausgeführt werden (z.B. durch Doppelklick). Weitgehend deswegen, da einige Programme aufgrund von Speicherersparnissen sogenannte Programmbibliotheken (original Dynamic Link Library, kurz dll) benötigen, um zu funktionieren. Erklärungen dazu findet ihr [http://de.wikipedia.org/wiki/Dynamic_Link_Library hier].<br>
Um einen Programmquellcode, d.h. einen Text, der in einer Programmiersprache geschrieben wurde, aus dem Textdokumentformat in eine Anwendung (original Executable, kurz exe) umzuwandeln, benötigt man nun einen Compiler (zu Deutsch Kompilierer oder Übersetzer), der die Programmiersprache aus der menschenlesbaren Form in die maschinenlesbare Form umwandelt. Neben dieser Hauptaufgabe übernimmt der Compiler natürlich noch weitere Aufgaben, auf die ich jetzt aber nicht genauer eingehen werde. Infos dazu findet ihr [http://de.wikipedia.org/wiki/Compiler hier].<br>
Die maschinenlesbare Form ist für Menschen unlesbar.

Eine '''Skriptsprache''' (z.B. JavaScript, DOS-Batch(Win) bzw. Shell-Scripts(UNIX)) hingegen liegt standardmäßig in der menschenlesbaren Form vor. Skriptsprachen werden - wie im ersten Satz bereits erwähnt - vor allem von Programmen benutzt, um benutzerdefinierte Abläufe verwenden zu können. Zur Ausführung von Scripts wird ein sogenannter Interpreter benötigt, der das Skript liest und es Schritt für Schritt in die Maschinensprache umwandelt und ausführt. Manche Skriptsprachen kann man mit einem Precompiler (zu Deutsch Vorkompilierer oder Vorübersetzer) vorkompilieren. Diesen könnte man auch den Vorkauer vom Interpreter nennen, da er das Script schon zum Teil in die Maschinensprache umwandelt, jedoch nicht so extrem wie der Compiler der Programmiersprachen. Das Ergebnis davon ist logischerweise die schnellere Ausführung des Skripts.

Genug der langweiligen Definitionen. Klären wir lieber, was man denn alles braucht, um ein Lua Script zu schreiben.

===Materialien===
Lua Skripte werden üblicherweise als Textdateien mit der Endung .lua gespeichert. Die Endung ist jedoch nicht von belang. Es kann jede beliebige Endung gewählt werden.

Wie jede normale Textdatei kann man also auch Lua Skripte mit dem standard Texteditor des vorhandenen Betriebssystems schreiben, editieren und lesen. Ich persönlich empfehle jedoch das Programm Notepad++, welches [http://notepad-plus.sourceforge.net/de/site.htm hier] heruntergeladen werden kann. Das Programm ist Freeware und wird regelmäßig aktualisiert und erweitert. Der Vorteil daran ist, dass es ein professionelles Syntax-Highlighting eingebaut hat, welches Schlagwörter und Standardfunktionen farblich oder anderweitig hervorhebt und somit die Übersichtlichkeit erheblich verbessert.<br>
Standardmäßig wird die Sprache Lua automatisch an der Dateiendung .lua erkannt, solltest Du eine andere Endung verwenden und trotzdem das Lua Syntax-Highlighting verwenden wollen, kannst Du es oben im Menü „Sprachen“ einstellen.

Wer ohne MTA seine kleinen Lua Skripte testen oder ausführen möchte, kann sich [http://luabinaries.luaforge.net/download.html hier] einen kostenlosen standalone Interpreter herunterladen. Wenn Du Dir nicht sicher bist, welche Windows Edition Du hast, dann hast Du wahrscheinlich eine 32 Bit Version, welche auf dieser Seite der „Windows x86 Executables“ entspricht. Die aktuelle Version (Win 32 Bit) dafür gibt es bei einem Klick auf [http://luaforge.net/frs/download.php/3134/lua5_1_3_Win32_bin.zip lua5_1_3_Win32_bin.zip].<br>
Nach dem Download kann der Standalone Interpreter mit einem Doppelklick auf die „lua5.1.exe“ gestartet werden. Dort kann man dann direkt Lua Befehle eingeben oder ein Script laden. Dies geht wie folgt:
<syntaxhighlight lang="lua">dofile("dateiname.lua")</syntaxhighlight>

==Kommentare==
Um sein Skript übersichtlicher zu gestalten, kann man mit Kommentaren bestimmte Zeilen eräutern, Bereiche abgrenzen, alten Code deaktivieren, ohne ihn zu entfernen und generell das Skript übersichtlicher gestalten.<br>
Kommentare werden vom Interpreter vollkommen ignoriert und sind nur für den Menschen lesbar und von Belang.

===Einzeilig===
<syntaxhighlight lang="lua">-- Dies ist ein einzeiliger Kommentar. Er gilt von -- bis zum Ende dieser Zeile.
-- Automatische Zeilenumbrüche, die eingefügt werden, wenn die Zeilenlänge überschritten wurde, zählen nicht.</syntaxhighlight>

===Mehrzeilig===
<syntaxhighlight lang="lua">--[[ Dieser Kommentar
geht über beliebig viele Zeilen
und endet mit ]]</syntaxhighlight>

==Variablen==
===Einführung===
Eine Variable kann man sich wie eine kleine Kiste vorstellen, auf der außen ein Bezeichner (oder Name) steht und die einen Wert enthält. Während der Bezeichner immer gleich ist, kann der Inhalt variieren.
Jede Variable hat einen Variablentypen, der bei Programmiersprachen normalerweise zu Beginn des Programmes fest definiert wird und sich nicht ändern kann. Da Lua aber ja keine Programmiersprache ist, muss der Variablentyp zu Beginn und auch sonst nie festgelegt werden und kann sich beliebig oft verändern. Der Interpreter erkennt Variablentypen automatisch und nimmt dem Skripter somit eine Menge Arbeit (vor allem bzgl. der Planung) ab.

===Typen===
Im Folgenden will ich die wichtigsten Variablentypen auflisten und kurz beschreiben.
;Integer (ganze Zahlen)
:Umfasst alle Ganzzahlen, sowohl negative als auch positive.
:Beispiele: -8, 0, 12, 2
;Float (Komma- bzw. gebrochene Zahlen)
:Umfasst alle Fließkommazahlen, sowohl negative als auch positive. Wichtig dabei ist, dass anstelle des Kommas (,) ein Dezimalpunkt (.) zum Trennen des ganzen vom gebrochenen Teil verwendet werden muss.
:Beispiele: -77.2, 0.0, 3.14159, 9.81
;String (Zeichenkette)
:Kann jedes beliebige Zeichen enthalten. Eine maximale Länge ist mir nicht bekannt. Strings müssen immer in Anführungszeichen(" oder ') eingschlossen werden.
:Beispiele: "hallo", 'Lua ist toll!', "", " :D "
;Boolean (Schalter)
:Kann zwei verschiedene Werte enthalten: ''true'' (dt. wahr bzw. an) oder ''false'' (dt. falsch bzw. aus). ''true'' entspricht dabei nicht dem Wert 1 und ''false'' nicht dem Wert 0.
:Beispiele: ''true'', ''false''
;Nil (Leer oder Nichts)
:''nil'' ist sowohl ein Wert als auch ein Typ. Eine Variable vom Typ ''nil'' enthält automatisch den Wert ''nil''. ''nil'' bedeutet ganz einfach nichts. Wenn eine Variable ''nil'' ist, existiert sie nicht. ''nil'' entspricht weder dem Wert 0 noch dem Wert ''false'' noch dem Wert ""!
:Beispiele: ''nil''
Ich werde auf jeden Variablentypen noch detaillierter eingehen. Außerdem wurden hier die Variablentypen '''function''' und '''table''' nicht aufgeführt, da diese jeweils ein eigenes Kapitel bekommen. Zwei weitere Typen, die diese Liste vervollständigen, sind '''userdata''' und '''thread''', auf die ich jedoch in diesem Tutorial nicht weiter eingehen werde, da vor allem letzteres vollkommen irrelevant für MTA ist.

===Definition===
Eine Variable definieren bedeutet im Grunde genommen eine Variable anlegen. In Lua muss einer Variable bei der Definition ein Wert zugewiesen werden. ''nil'' ist dabei als Wert auch möglich, macht jedoch wenig Sinn, da jede beliebige Variablenbezeichnung automatisch den Wert ''nil'' enthält.

Man unterscheidet zwischen '''lokalen''' und '''globalen''' Variablen. Um eine Variable als lokal zu definieren muss das Schlüsselwort ''local'' davor geschrieben werden. Lokal bedeutet für uns im Moment noch ganz einfach, dass die Variable nur im aktuellen Script verfügbar ist. Sollten also z.B. von einem Programm zwei verschiedene Lua Skripte geladen sein und benutzt werden, können diese untereinander auf die globalen Variablen des jeweils anderen Skripts zugreifen, auf die lokalen jedoch nicht. Generell empfiehlt es sich, immer lokale Variablen zu nehmen, falls man nicht explizit eine globale benötigt, da so vermieden wird, dass mehrere parallel laufende Skripte aufgrund von gleichen Variablenbezeichnern durcheinander kommen.

====Einzeln====
Definieren wir uns also nun unsere erste lokale Variable und geben ihr einen ganzzahligen Inhalt:
<syntaxhighlight lang="lua">local zahl = 7 -- weist der lokalen Variable zahl den Wert 7 zu</syntaxhighlight>

Eine globale Variable erhält man, indem man einfach das ''local'' weglässt:
<syntaxhighlight lang="lua">gZahl = 13 -- weist der globalen Variable gZahl den Wert 13 zu</syntaxhighlight>

Das selbe geht natürlich nun auch mit allen anderen Variablentypen:
<syntaxhighlight lang="lua">local ganzzahl = -5
local kommazahl = 0.008
local zeichenkette = "Hello World"
local schalter = true
local nichts = nil -- diese Zeile kann man sich im Grunde genommen sparen, da jede nicht definierte Variable automatisch den Wert nil hat</syntaxhighlight>

Längere Strings mit mehreren Zeilenumbrüchen können in einer vereinfachten Weise zugewiesen werden. Dies funktioniert so ähnlich wie bei Kommentaren. Anstelle von Anführungszeichen verwendet man <nowiki>[[ als Anfangs- und ]]</nowiki> als Endmarkierung des Strings.
<syntaxhighlight lang="lua">local text = [[Willkommen auf unserem Server.
Bitte halte Dich an die Regeln.
MfG die Administration]]</syntaxhighlight>
Alternativ kann in einem String, der in doppelten Anführungszeichen (") eingeschlossen ist, folgende Steuerzeichen enthalten:
;\n
:Entspricht einem Zeilenumbruch.
;\t
:Entspricht einem Tabulator.
;\"
:Wird verwendet, um doppelte Anführungszeichen in einem String, der von doppelten Anführungszeichen eingeschlossen ist, darzustellen, ohne dass der Interpreter diese fälschlicherweise als Stringende auffasst.
;\'
:Wie \", nur gilt dies in Strings, die von einfachen Anführungszeichen eingeschlossen sind.
;\\
:Entspricht einem Backslash (\)

====Mehrere====
Man kann in einer Zeile mehrere Variablen definieren, indem man sie mit Kommas voneinander trennt. Die Variablentypen können dabei alle unterschiedlich sein. Hier mal ein Beispiel:
<syntaxhighlight lang="lua">local frucht, anzahl, reif = "apfel", 4, true</syntaxhighlight>
''local'' darf dabei nur einmal am Zeilenanfang stehen und bewirkt, dass alle dahinter aufgelisteten Variablen lokal werden.<br>
Sollten links neben dem Gleichheitszeichen mehr Variablenbezeichner stehen als rechts Werte, so bleiben die überschüssigen Variablen ''nil''. Im umgekehrten Fall werden überschüssige Werte rechts einfach ignoriert.

==Operatoren==
===Arithmetische===
Arithmetische Operatoren werden verwendet, um Berechnungen durchzuführen. Somit kann man entweder mit Variablen, festen Zahlen oder einer Mischung neue Werte berechnen oder verändern.<br>
Bei Berechnungen gilt stets: '''Punkt- vor Strichrechnung'''.
<br><br>
;Plus (+)
:Addiert zwei Werte miteinander.
<syntaxhighlight lang="lua">local a, b = 3, 8
local c = a + b -- a + b entspricht hier der Rechnung 3 + 8, c erhält nun also den Wert 11</syntaxhighlight>
;Minus (-)
:Subtrahiert den zweiten vom ersten Wert.
<syntaxhighlight lang="lua">local a, b = 3, 8
local c = a - b -- a - b entspricht hier der Rechnung 3 - 8, c erhält nun also den Wert -5</syntaxhighlight>
;Mal (*)
:Multipliziert zwei Werte miteinander.
<syntaxhighlight lang="lua">local a, b = 3, 8
local c = a * b -- a * b entspricht hier der Rechnung 3 * 8, c erhält nun also den Wert 24</syntaxhighlight>
;Geteilt (/)
:Dividiert den ersten durch den zweiten Wert. Hierbei entsteht in den meisten Fällen eine Kommazahl!
<syntaxhighlight lang="lua">local a, b = 3, 8
local c = a / b -- a / b entspricht hier der Rechnung 3 / 8, c erhält nun also den Wert 0.375</syntaxhighlight>
<br>
;Modulo (%)
:Ermittelt den Rest, der übrig bleibt, wenn man die erste Zahl durch die zweite teilt.
:Der Modulo-Operator gehört zur Punktrechnung.
<syntaxhighlight lang="lua">local a, b = 14, 3
local c = a % b -- a % b entspricht hier der Rechnung 14 % 3, c erhält nun also den Wert 2, da 14 / 3 = 4 REST 2</syntaxhighlight>
;Minus (-) (als Vorzeichen)
:Dient zur Darstellung einer negativen Zahl, also einer Zahl unter 0.
<syntaxhighlight lang="lua">local a = -3 -- entspricht der Rechnung a = 0 - 3</syntaxhighlight>
;Hoch (^)
:Potenziert die erste Zahl mit der zweiten.
:Potenzen werden noch '''vor''' der Punktrechnung ausgerechnet.
<syntaxhighlight lang="lua">local a, b = 3, 8
local c = a ^ b -- a ^ b entspricht hier der Rechnung 3 ^ 8 (3<sup>8</sup>), c erhält nun also den Wert 6561</syntaxhighlight>
<br>

===Logische===
Logische Operatoren werden Benutzt, um Werte miteinander zu vergleichen und mehrere Bedingungen zu verknüpfen. Wir werden genauer auf sie zurückkommen, wenn es um Bedingungen geht. Bis dahin reicht es, wenn man sich merkt, dass ein logischer Vergleich entweder ''true'' (wenn die Aussage wahr ist) oder ''false'' (wenn die Aussage falsch ist) ergibt.
<br><br>
;Gleich (==)
:Prüft, ob zwei Werte gleich sind.
<syntaxhighlight lang="lua">local a = (5 == 5) -- a ist true, da die Aussage wahr ist
local b = (5 == 8) -- b ist false, da die Aussage falsch ist</syntaxhighlight>
;Ungleich (~=)
:Prüft, ob zwei Werte ungleich sind.
<syntaxhighlight lang="lua">local a = (5 ~= 5) -- a ist false, da die Aussage falsch ist
local b = (5 ~= 8) -- b ist true, da die Aussage wahr ist</syntaxhighlight>
;Größer als (>)
:Prüft, ob der erste Wert größer als der zweite ist.
<syntaxhighlight lang="lua">local a = (5 > 5) -- a ist false, da die Aussage falsch ist
local b = (5 > 8) -- b ist false, da die Aussage falsch ist
local c = (8 > 5) -- c ist true, da die Aussage wahr ist</syntaxhighlight>
;Größer als oder gleich (>=)
:Prüft, ob der erste Wert größer als der zweite ist oder dem zweiten gleicht.
<syntaxhighlight lang="lua">local a = (5 >= 5) -- a ist true, da die Aussage wahr ist
local b = (5 >= 8) -- b ist false, da die Aussage falsch ist
local c = (8 >= 5) -- c ist true, da die Aussage wahr ist</syntaxhighlight>
;Kleiner als (<)
:Prüft, ob der erste Wert kleiner als der zweite ist.
<syntaxhighlight lang="lua">local a = (5 < 5) -- a ist false, da die Aussage falsch ist
local b = (5 < 8) -- b ist true, da die Aussage wahr ist
local c = (8 < 5) -- c ist false, da die Aussage falsch ist</syntaxhighlight>
;Kleiner als oder gleich (<=)
:Prüft, ob der erste Wert kleiner als der zweite ist oder dem zweiten gleicht.
<syntaxhighlight lang="lua">local a = (5 <= 5) -- a ist true, da die Aussage wahr ist
local b = (5 <= 8) -- b ist true, da die Aussage wahr ist
local c = (8 <= 5) -- c ist false, da die Aussage falsch ist</syntaxhighlight>
<br>
;Und (and)
:Verknüpft zwei Bedingungen miteinander.
<syntaxhighlight lang="lua">local a = (true and false) -- a ist false, da nicht beide Aussagen wahr sind
local b = (5 < 8) and (7 == 7) -- b ist true, da beide Aussagen wahr sind
local c = (8 > 5) and (1 ~= 2) and (0 <= -7) -- c ist false, da die dritte Aussage falsch ist</syntaxhighlight>
;Oder (or)
:Verknüpft zwei Bedingungen miteinander.
<syntaxhighlight lang="lua">local a = (true or false) -- a ist true, da die erste Aussage wahr ist
local b = (5 < 8) or (7 == 7) -- b ist true, da mindestens eine der Aussagen wahr ist
local c = (8 > 5) or (1 ~= 2) or (0 <= -7) -- c ist true, da mindestens eine der Aussagen wahr ist</syntaxhighlight>
;Nicht (not)
:Kehrt einen Booleanwert um.
<syntaxhighlight lang="lua">local a = not true -- a ist false
local b = not false -- b ist true
local c = not (0 == 8) -- c ist true, da die Aussage falsch ist</syntaxhighlight>
<br>

===Sonstige===
Lua hat noch zwei weitere Operatoren, die sich jedoch nicht in die oberen Gruppen eingliedern lassen.
<br>
;Länge (#)
:Steht für die Länge eines Strings oder einer Table.
<syntaxhighlight lang="lua">local sprache = "deutsch"
local laenge = #sprache -- laenge wird hier auf 7 gesetzt, da das Wort "deutsch" 7 Buchstaben hat</syntaxhighlight>
;Verknüpfung (..)
:Verknüpft zwei Strings miteinander.
<syntaxhighlight lang="lua">local geschlecht, alter = "männlich", "18"
local satz = "Ich bin "..geschlecht.." und "..alter.." Jahre alt." -- weist satz den Wert "Ich bin männlich und 18 Jahre alt." zu</syntaxhighlight>
<br><br>
Natürlich können auch alle anderen Variablentypen mit- und untereinander verglichen werden.<br>
Der Längenoperator (#) sowie der Verknüpfungsoperator (..) sind nur für Strings gedacht, wobei der erste später noch bei Tables eine Rolle spielen wird und der zweite es nicht so genau nimmt mit den Variablentypen. Bei Booleans und ''nil'' jedoch führt er in jedem Fall zu einem Fehler. Wir kommen später noch darauf zu sprechen, wie man soetwas umgeht.<br>
Für Integer und Floats sind alle Vergleichsoperatoren und die arithmetischen verfügbar. Strings unterstützen nur die Vergleichsoperatoren, wobei man mit den größer/kleiner Operatoren zwei Strings nach dem Alphabet ordnen kann.
<syntaxhighlight lang="lua">"a" < "b" -- ergibt true, da a vor b im Alphabet kommt</syntaxhighlight>
Strings, Booleans und ''nil'' kann man nur untereinander vergleichen, nicht miteinander. Miteinander führt in jedem Fall zu ''false''.

==Bedingungen==
===Einführung===
Bedingungen sind dazu da, um bestimmte Anweisungen nur auszuführen, wenn ein bestimmter Sachverhalt gegeben ist.
Ein Beispiel wäre, wenn ein Spieler einem anderen Spieler eine private Nachricht senden möchte. Dann kann er das natürlich nur tun, wenn der adressierte Spieler auch online ist.
Also soll die Nachricht in einem solchen Fall gesendet werden, andernfalls dem Sender jedoch eine Fehlermeldung ausgegeben werden.

===Syntax===
Die Syntax einer Bedingung, die man übrigens auch „if-Statement“ (if = engl. für wenn) oder im Englischen „condition“ nennt, ist recht simpel.
<syntaxhighlight lang="lua">if <bedingung> then
-- Anweisung(en), die ausgeführt werden soll(en), wenn die Bedingung wahr (=true) ist
end</syntaxhighlight>
Für <bedingung> darf hier jeder Audruck eingesetzt werden, der letztendlich irgendeinen Wert ergibt.
Sollte <bedingung> ''nil'' oder ''false'' sein, so wird die Anweisung zwischen then und end nicht ausgeführt, andernfalls wird sie ausgeführt.

===Else-Statement===
Auf jedes if-Statement darf ein else-Statement (else = engl. für sonst) folgen. Dieses benötigt kein then und auch keine Bedingung, sondern wird ausgeführt, wenn die Bedingung des if-Statements ''nil'' oder ''false'' ist. Das else-Statement ist optional!
<syntaxhighlight lang="lua">if <bedingung> then
-- Anweisung(en), die ausgeführt werden soll(en), wenn die Bedingung erfüllt wird
else
-- Anweisung(en), die ausgeführt werden soll(en), wenn die Bedingung nicht erfüllt wird
end</syntaxhighlight>

===Elseif-Statement===
Das elseif-Statement ist ein spezielles Statement, was es erlaubt, einer unübersichtlichen Verschachtelung zu entgehen, indem es die Möglichkeit bietet, einem else-Statement auch eine Bedingung zu geben. Ein if-Statement darf beliebig viele elseif-Statements enthalten. Diese müssen jedoch zwischen dem if- und dem else-Statement (falls vorhanden) stehen. Für die Bedingung gilt hier das selbe, wie für das if-Statement. Wichtig ist, dass demnach auch hier ein then erforderlich ist. Genauso wie das else-Statement ist jedoch auch das elseif-Statement optional!
<syntaxhighlight lang="lua">if <bedingung1> then
-- Anweisung(en), die ausgeführt werden soll(en), wenn die Bedingung 1 erfüllt wird
elseif <bedingung2> then
-- Anweisung(en), die ausgeführt werden soll(en), wenn die Bedingung 2 erfüllt wird
else
-- Anweisung(en), die ausgeführt werden soll(en), wenn weder Bedingung 1 noch Bedingung 2 erfüllt werden
end</syntaxhighlight>

===Bedingungen formulieren===
Bei der Bedingung eines if-Statements muss nicht zwangsläufig ein Boolean herauskommen. Wie bereits erwähnt, ist die Bedingung immer dann wahr, wenn sie weder ''nil'' noch ''false'' ist.
D.h., dass auch Werte wie 0, "Hallo" und 3.14159 als „wahr“ gelten. Natürlich ist das auch bei ''true'' der Fall.

Um komplexere Bedingungen zu formulieren, werden auf jeden Fall die bereits aufgelisteten logischen Operatoren benötigt.
Mit diesen kann man für jeden nur erdenklichen Fall eine Bedingung formulieren.

Wenn logische (Vergleichs-)Operatoren (==, ~=, <, >, <=, >=) angewandt werden, kommt dabei immer ein Boolean raus, wie man auch schon an den gegebenen Beispielen erkennen kann.
Verknüfungen (and, or) sind dazu gedacht, um z.B. zu überprüfen, ob mehrere oder wenigstens eine Bedingung von vielen erfüllt werden oder nicht. Der not-Operator ermöglicht es, zu überprüfen, ob eine Bedingung nicht erfüllt wird.

Zu dem and- und dem or-Operator möchte ich an dieser Stelle noch etwas ergänzen. Der and-Operator wird zunächst einmal dazu verwendet, um herauszufinden, ob zwei Bedingungen gleichzeitig erfüllt sind. Der or-Operator wird dazu benutzt, um herauszufinden, ob eine von zweien oder beide Bedingungen erfüllt sind.

Weder der and- noch der or-Operator geben aber zwangsläufig einen Boolean zurück.
<syntaxhighlight lang="lua">local foo = wert1 and wert2</syntaxhighlight>
Sollte wert1 ''nil'' oder ''false'' sein, so entspricht dieser Ausdruck dem folgenden:
<syntaxhighlight lang="lua">local foo = wert1</syntaxhighlight>
Ist wert1 weder ''nil'' noch ''false'', so entspricht der Ausdruck dem hier:
<syntaxhighlight lang="lua">local foo = wert2</syntaxhighlight>

Bei or ist es ähnlich, nur umgekehrt.
<syntaxhighlight lang="lua">local foo = wert1 or wert2</syntaxhighlight>
Sollte wert1 ''nil'' oder ''false'' sein, so entspricht dieser Ausdruck dem folgenden:
<syntaxhighlight lang="lua">local foo = wert2</syntaxhighlight>
Ist wert1 weder ''nil'' noch ''false'', so entspricht der Ausdruck dem hier:
<syntaxhighlight lang="lua">local foo = wert1</syntaxhighlight>

===Beispiele===
====50-50-Chance====
Dieses Beispiel simuliert einen Münzwurf. math.random() und print() sind standard Lua-Funktionen. Zum Thema Funktionen komme ich später. Für dieses Beispiel reicht es, wenn ihr wisst, dass math.random() eine Zufallszahl (float) zwischen 0 und 1 zurückgibt und print("text") den in den Klammern eingeschlossenen String in die Konsole ausgibt.
<syntaxhighlight lang="lua">local zufall = math.random()
if (zufall < 0.5) then
print("Kopf")
else
print("Zahl")
end</syntaxhighlight>
====Der Nutzen von elseif====
Im Folgenden wollen wir herausfinden, ob eine Zahl positiv, negativ oder 0 ist. Dazu möchte ich zuerst ein Beispiel ohne und danach eines mit elseif zeigen, um meine Aussage, dass elseif Verschachtelungen spart, zu verifizieren.
<syntaxhighlight lang="lua">local zahl = 14

--ohne elseif
if (zahl < 0) then
print("Die Zahl ist negativ.")
else
if (zahl == 0) then
print("Die Zahl entspricht 0.")
else
print("Die Zahl ist positiv.")
end
end

--mit elseif
if (zahl < 0) then
print("Die Zahl ist negativ.")
elseif (zahl == 0) then
print("Die Zahl entspricht 0.")
else
print("Die Zahl ist positiv.")
end</syntaxhighlight>
Je komplexer das ganze if-Statement, desto nützlicher wird elseif sein.
====Eingebettetes Pseudo-if-Statement====
In vielen Script- und Programmiersprachen gibt es ein gekürztes if-Statement. In Javascript z.B. geht das wie folgt:
<syntaxhighlight lang="lua">var nachricht = "Du benutzt zurzeit " + (ie ? "den Internet Explorer" : "einen guten Browser") + ".";</syntaxhighlight>
Wir gehen dabei davon aus, dass in der Variable ie ein Boolean gespeichert ist, der ''true'' ist, wenn der Benutzer den Internet Explorer benutzt, ansonsten ''false''.
Diese Art von eingebetteten if-Statements gibt es noch in vielen anderen Sprachen, unter anderen in PHP, Java und C(++). In meinem Beispiel kann man sich das ? als then und den : als else vorstellen. Dann sollte es eigentlich nicht allzu schwer sein, diese Art von if-Statement zu verstehen.

So direkt gibt es das bei Lua nicht, aber mit and und or kann man sich ein Konstrukt bauen, welches auf die gleiche Weise funktioniert. Dazu werde ich einfach mal das obere Beispiel in Lua umwandeln, auch, wenn Lua eigentlich nicht viel mit Browsern am Hut hat.
<syntaxhighlight lang="lua">local nachricht = "Du benutzt zurzeit "..(ie and "den Internet Explorer" or "einen guten Browser").."."</syntaxhighlight>
Zuerst ist das and an der Reihe. Es schmeißt den String "den Internet Explorer" raus, wenn ie ''false'' (oder ''nil'') ist und zurück bleibt auf jeden Fall ''false'' (oder ''nil''). Das wird dann vom or rausgeschmissen und zurück bleibt "einen guten Browser".
Wenn ie weder ''false'' noch ''nil'' ist, schmeißt and die Vairable ie raus und zurück bleibt "den Internet Explorer". Da dieser String weder ''false'' noch ''nil'' ist, wird er vom or beibelassen und "einen guten Browser" rausgeschmissen.
Entschuldigt meine Ausdrucksweise mit dem rausschmeißen, aber das schien mir die beste Möglichkeit, diese Methode verständlich zu erklären.

==Tabellen==
===Einführung===
Tabellen sind spezielle Variablen, die mehrere Werte enthalten können.
Damit wir Tabellen verwenden können, führe ich nun erst einmal den Variablentyp „table“ ein. Mit einer table-Variable kann man ersteinmal kaum Operationen durchführen. Dazu benötigt man Funktionen, zu denen wir aber erst später kommen.

===Definition===
Um eine Variable als (leere) table zu definieren, benutzt man diesen Ausdruck:
<syntaxhighlight lang="lua">local tabelle = {}</syntaxhighlight>

Ohne Funktionen macht das noch recht wenig Sinn. Um einer Tabelle direkt mehrere Werte zuzuweisen, schreibt man diese einfach durch Kommata getrennt zwischen die geschweiften Klammern.
<syntaxhighlight lang="lua">local tabelle1 = { "Apfel", 14, 3.14159, true }</syntaxhighlight>
Eine table kann alle möglichen Typen von Variablen enthalten. So zum Beispiel auch andere Tabellen.
<syntaxhighlight lang="lua">local tabelle2 = { 1, { 1.25, 1.5, 1.75 }, 2, { 2.25, 2.5, 2.75 } }</syntaxhighlight>

Um nun auf die Elemente einer table zugreifen zu können, benutzt man Indizes (Indizes ist der Plural von Index). Jedes Element in einer table hat einen Index. Wenn man die Tabellen so definiert, wie ich es gemacht habe, so wird jedem Element ein integer als Index zugewiesen, wobei das erste Element die 1 als Index bekommt, das zweite die 2 usw.
Der ungefähre Wert von Pi (3.14159) in der oberen Tabelle hat den Index 3. Um anhand eines Indizes ein Element einer Tabelle abzufragen, schreibt man den Index einfach in eckigen Klammern hinter den Tabellennamen.
tabelle1[3] entspricht also dem Wert 3.14159.
Wenn das Element der Tabelle selbst noch eine Tabelle ist, wie z.B. das Element mit dem index 2 aus tabelle2, dann setzt man die Indizes einfach hintereinander. Der Wert 2.25 ist demnach in tabelle2[4][1] gespeichert.

===Ganzzahlige Indizes===
Um gezielt bestimmten Indizes einen Wert zuzuweisen, kann man folgende Schreibweise verwenden:
<syntaxhighlight lang="lua">local auskunft = { [11] = "elf", [88] = "achtundachtzig", [0] = "null" }</syntaxhighlight>
Dabei spielt es keine Rolle, in welcher Reihenfolge die Indizes einen Wert zugewiesen bekommen und es spiel auch keine Rolle, ob die Indizes positiv oder negativ sind.
Es muss jedoch beachtet werden, dass etwas wie { [1] = "eins", "zwei" } dem Index 1 den Wert "zwei" zuweisen würde, da Lua immer bei 1 anfängt zu zählen, egal, ob der Scripter den Index 1 bereits definiert hat.

===Zeichenketten als Indizes===
Ein Index kann auch ein String sein. Dazu verwendet man folgende Schreibweise:
<syntaxhighlight lang="lua">lua konstanten = { ["pi"] = 3.14159, ["e"] = 2.71828 }</syntaxhighlight>
Ansprechen kann man diese Werte genauso wie bei integer-Indizes. konstanten["pi"] ist also 3.14159.

Eine Besonderheit bei Zeichenketten als Index ist, dass es eine vereinfachte Schreibweise gibt. Sowohl bei der Definition als auch bei der Abfrage der Elemente. Das obige Beispiel kann auch so realisiert werden:
<syntaxhighlight lang="lua">lua konstanten = { pi = 3.14159, e = 2.71828 }</syntaxhighlight>
Zum Abfragen der Elemente kann man die Schreibweise konstanten.pi bzw. konstanten.e verwenden.
Man sollte aber bedenken, dass Schlüsselwörter wie z.B. if oder local als Indizes besser mit ["if"] und ["local"] definiert werden.

===Beliebige Indizes===
Ein Index muss nicht unbedingt ein integer oder ein string sein. Genauer gesagt kann ein Index ein beliebiger Wert (außer ''nil'') sein.
Somit wäre z.B. auch das möglich:
<syntaxhighlight lang="lua">local tabelle = { [true] = "wahr", [3.14159] = "pi", [0] = 1, 123 }</syntaxhighlight>
Die Zahl 123 hätte hier übrigens den Index 1.

===Einzelzuweisungen===
Man muss nicht immer alle Werte einer table auf einmal definieren. Jedes Tabellenelement lässt sich wie eine normale Variable behandeln.
<syntaxhighlight lang="lua">local tabelle = {}
tabelle[true] = "wahr"
tabelle.pi = 3.14159
tabelle[2] = { 1, 2, 3 }
tabelle[2][0] = 0</syntaxhighlight>
Jedes undefinierte Element hat - genauso wie jede undefinierte Variable - den Wert ''nil''.

===Verlinkungen===
<syntaxhighlight lang="lua">local tabelle1 = { 1, 2, 3 }
local tabelle2 = tabelle1
tabelle1[1] = 4</syntaxhighlight>
In der zweiten Zeile dieses Beispiels wird die tabelle1 nicht in die Variable tabelle2 kopiert, sondern tabelle2 verweist ab sofort auf tabelle1. Am Ende des Codes wäre also tabelle2[1] auch 4, obwohl es nicht explizit zugewiesen wurde.

Um eine Tabelle zu kopieren, könnt ihr euch die Useful Function [[table.copy]] aus der Wiki kopieren und diese dazu verwenden.

==Schleifen==
===Einführung===
Schleifen verwendet man immer dann, wenn man eine oder mehrere Anweisungen mehr als einmal direkt hintereinander ausführen möchte oder wenn man eine oder mehrere Anweisungen für jedes Element einer table ausführen möchte.
Es gibt drei verschiedene Arten von Schleifen. Diese werde ich jetzt hier einzeln vorstellen.

===While-Schleife===
Die while-Schleife wiederholt eine oder mehrere Anweisungen solange, bis eine bestimmte Bedingung nicht mehr erfüllt wird.
Die Syntax ist die folgende:
<syntaxhighlight lang="lua">while [bedingung] do
-- Anweisung(en)
end</syntaxhighlight>

Beispiel:
<syntaxhighlight lang="lua">local zahl = 10
while (zahl >= 0) do
print(zahl)
zahl = zahl - 1
end</syntaxhighlight>
Das Beispiel gibt nacheinander alle Zahlen von 10 bis 0 aus. Nach der Schleife hat zahl dann den Wert -1.

===Repeat-Until-Schleife===
Die repeat-until-Schleife wiederholt eine oder mehrere Anweisungen solange, bis eine bestimmte Bedingung erfüllt ist. Sie führt diese Anweisung(en) aber in jedem Fall einmal aus.
Die Syntax lautet:
<syntaxhighlight lang="lua">repeat
-- Anweisung(en)
until [bedingung]</syntaxhighlight>

Das obere Beispiel lässt sich hiermit wie folgt realisieren:
<syntaxhighlight lang="lua">local zahl = 10
repeat
print(zahl)
zahl = zahl - 1
until (zahl < 0)</syntaxhighlight>

===For-Schleife===
Es gibt zwei verschiedene for-Schleifen. Einmal die einfache numerische for-Schleife und zum Anderen die generische for-Schleife, mit der man u.a. alle Elemente einer tabelle durchlaufen kann. Mit der generischen for-Schleife kann man noch ganz andere wesentlich komplexere Operationen durchführen, die ich hier aber nicht erklären werde, da sie auch - zumindest beim Scripten für MTA - nicht wirklich benötigt werden.
====Numerisch====
Syntax:
<syntaxhighlight lang="lua">for [laufvariable], [maximum], [schrittweite] do
-- Anweisung(en)
end</syntaxhighlight>
Die Laufvariable wird nach jedem Durchlauf der Schleife um die Schrittweite erhöht, bis sie größer oder gleich dem Maximum ist. Alle drei Werte müssen numerisch sein, d.h. ein integer oder ein float. Die Schrittweite kann auch weggelassen werden. Sie ist dann automatisch 1.
Unser Beispiel von oben sähe mit einer for-Schleife so aus:
<syntaxhighlight lang="lua">for i=10, 0, -1 do
print(i)
end</syntaxhighlight>
Die Variable i ist nur innerhalb der Schleife verfügbar. Damit sie auch nach der Schleife noch verfügbar ist, muss man sie schon vor der Schleife deklarieren.
====Generisch====
Die generische for-Schleife wird hauptsächlich dazu verwendet, um tables zu durchlaufen. Ich werde sie daher auch nur in diesem Zusammenhang erläutern.
Die Syntax für den Fall, dass man eine table durchlaufen will, ist:
<syntaxhighlight lang="lua">for [index], [wert] in pairs([tabelle]) do
-- Anweisung(en)
end</syntaxhighlight>
Diese Schleife geht durch alle Elemente der Tabelle und führt die Anweisungen somit für alle Elemente der Tabelle aus, wobei Index jedes Mal dem aktuellen Index des Tabellenelements und Wert jedes Mal dem aktuellen Wert des Tabellenelements entspricht.
Anstelle von pairs() kann man auch ipairs() nehmen, wenn man nur alle ganzzahligen Indizes durchlaufen möchte.
Hier mal ein Beispiel:
<syntaxhighlight lang="lua">local tabelle = { eins = 1, "hallo", pi = 3.14159 }

-- mit pairs
for index, wert in pairs(tabelle) do
print(tostring(index).."="..tostring(wert)..", ")
end
-- Ausgabe: "eins=1, 1=hallo, pi=3.14159, "

-- mit ipairs
for index, wert in ipairs(tabelle) do
print(tostring(index).."="..tostring(wert)..", ")
end
-- Ausgabe: "1=hallo, "</syntaxhighlight>
tostring() ist übrigens eine Funktion, die eine beliebige Variable in einen string umwandelt. Wenn man Variablen mit einem string verknüpfen will und sich nicht sicher ist, ob diese Variablen string sind oder nicht, sollte man auf jeden Fall diese Funktion verwenden, da ansonsten Fehler auftreten können. (Lua gibt einen Error aus, wenn man z.B. soetwas versucht: "Hallo "..nil..".")

===Schleifenabbruch===
Mit dem Schlüsselwort break kann man eine Schleife sofort abbrechen.
Hier ein kurzes Beispiel dazu:
<syntaxhighlight lang="lua">local zahl = 10
while (true) do
print(zahl)
zahl = zahl - 1
if (zahl < 0) then
break
end
end</syntaxhighlight>
Diese Schleife würde auch alle Zahlen von 10 bis 0 nacheinander ausgeben, nur dass der Abbruch manuell erfolgt, wenn zahl negativ wird. Ohne diese Bedingung würde die Schleife endlos laufen.

==Funktionen==
===Einführung===
Funktionen sind im Grunde genommen Anweisungsblöcke, die - meist in Abhängigkeit von übergebenen Werten - mehrmals an unterschiedlichen Orten im Script bzw. zu unterschiedlichen Zeiten ausgeführt werden sollen.
Da eine Funktion - sofern sie mehr als einmal ausgeführt werden soll bzw. mehr als einmal benötigt wird - auch in einer Variable gespeichert werden kann, kann man den Variablentyp function einführen, der in Lua auch tatsächlich existiert.
Funktionen können Werte übergeben bekommen und auch Werte zurückgeben.

===Definition===
Die allgemeine Syntax für das Definieren einer Funktion ist die folgende:
<syntaxhighlight lang="lua">function [funktionsname]([parameterliste])
-- Anweisung(en)
end</syntaxhighlight>

Ein Beispiel für eine Funktion, die das Quadrat einer Zahl zurückgibt, wäre:
<syntaxhighlight lang="lua">function quadrat(zahl)
return zahl * zahl
end</syntaxhighlight>

Alternativ kann eine Funktion übrigens auch so einer Variable zugewiesen werden:
<syntaxhighlight lang="lua">quadrat = function (zahl) return zahl * zahl end</syntaxhighlight>

===Rückgabewerte===
return wird verwendet, um die Funktion einen Wert zurückgeben zu lassen. Nach einem return-Befehl bricht die Funktion alle Tätigkeiten ab und ist beendet.
Um einen Rückgabewert verwenden zu können, müssen wir aber ersteinmal wissen, wie man eine Funktion dazu bringt, die Anweisungen, die sie enthält, auszuführen.
Das geht allgemein mit funktionsname(parameterliste).
Als Beispiel für unsere quadrat-Funktion:
<syntaxhighlight lang="lua">local vier = quadrat(2)</syntaxhighlight>

Wenn wir quadrat(2) ausführen, dann wird der obrige Code ausgeführt, wobei die Variable zahl den Wert 2 zugewiesen bekommt. zahl ist dabei jedoch nur innerhalb der Funktion definiert.
Die Variable vier bekommt nun den Wert 2 * 2, also 4 zugewiesen.

<syntaxhighlight lang="lua">local vier = quadrat</syntaxhighlight>
würde die Funktion quadrat in die Variable vier kopieren. Man könnte nun also auch vier(2) aufrufen, um 4 zu bekommen.

Eine Funktion kann auch mehrere Funktionswerte zurückgeben. Das ist vor allem dann sinnvoll, wenn es sich um Positionen handelt, was bei MTA ja nicht selten vorkommt.
Beispiel:
<syntaxhighlight lang="lua">function berechnungen(zahl1, zahl2)
return zahl1 + zahl2, zahl1 - zahl2, zahl1 * zahl2, zahl1 / zahl2
end

local summe, differenz, produkt, quotient = berechnungen(5, 10)</syntaxhighlight>
Damit wird summe = 15, differenz = -5, produkt = 50 und quotient = 0.5.

===Lua Standardfunktionen===
Funktionen wie tostring, print und math.random sind Standardfunktionen von Lua. Eine komplette Liste aller Lua Standardfunktionen bekommt ihr auf der [http://www.lua.org/manual/5.1/#index offiziellen Lua Webseite] (Englisch).

Die Standard-string-Funktionen erlauben eine besondere Syntax, die ich hier kurz erläutern möchte, da sie von vielen erfahrenen Scriptern genutzt wird und es hilfreich ist, wenn man etwas damit anfangen kann.
<syntaxhighlight lang="lua">local name = "Firzen Polas"
local laenge = string.len(name)</syntaxhighlight>
Dieser Code weist der Variable laenge die Länge des strings "Firzen Polas", also 12, zu.
Alternativ kann man auch den folgenden Code verwenden:
<syntaxhighlight lang="lua">local name = "Firzen Polas"
local laenge = name:len()</syntaxhighlight>
Vorraussetzung ist, dass die Variable vor dem Doppelpunkt ein string ist. Bei den math- und table-Funktionen funktioniert dies nicht.

===Rekursive Funktionen===
Rekursive Funktionen sind eine effektive Alternative zu Schleifen - zumindest in manchen seltenen Fällen. Das berühmteste Beispiel ist das Berechnen einer Fakultät.
Zur Information: n! (sprich: n Fakultät) bezeichnet das Produkt aller Ganzzahlen von n bis 1, also quasi 1*2*3*4*...*n.
Beispiel: 3! = 1 * 2 * 3 = 6
<syntaxhighlight lang="lua">function fakultaet(zahl)
if (zahl > 0) then
return zahl * fakultaet(zahl - 1)
else
return 1
end
end</syntaxhighlight>
Mit Schleife sähe das so aus:
<syntaxhighlight lang="lua">function fakultaet(zahl)
if (zahl == 0) then
return 1
end
for i=zahl-1, 1, -1 do
zahl = zahl * i
end
return zahl
end</syntaxhighlight>

===Variable Parameterzahl===
Manchmal benötigt eine Funktion nicht zwingend eine bestimmte Anzahl von Parametern oder soll eine variable Anzahl an Parametern akzeptieren.
Dies lässt sich realisieren mit drei Punkten am Ende der Parameterliste.
<syntaxhighlight lang="lua">function aufsummieren(...)
local parameter = {...}
local summe = 0
for _, zahl in pairs(parameter)
summe = summe + tonumber(zahl)
end
return summe
end</syntaxhighlight>
... entspricht dabei innerhalb der Funktion der Parameterliste als normale Liste.
D.h., wenn man aufsummieren(1, 2, 3, 4) aufruft, dann wird parameter = {1, 2, 3, 4}.

==Fragen, Anregungen, Kritik==
Sollten noch irgendwelche Fragen offen sein, so könnt ihr jederzeit in unserem [irc://irc.gtanet.com/#mta.german IRC Channel] oder in unserem [http://sebihunter.de/wbb/ Forum] vorbeischauen und eure Fragen dort loswerden.
Außerdem haben wir in unserem IRC Channel einen Lua Bot, an dem ihr Funktionen, die auf den standard Lua Funktionen basieren, ausprobieren könnt.

Anregungen und Kritik nehme ich dort auch entgegen. Alternativ könnt ihr diese hier in die Diskussion schreiben.
Falls ihr Fehler findet, behebt diese bitte oder gebt mir Bescheid.

Ich hoffe, das Tutorial konnte euch weiterhelfen. Wenn ihr nun Hilfe braucht bei eurem ersten Gamemode in MTA, dann solltet ihr euch die [[DE/MTA_Scripting_Grundlagen|MTA Scripting Grundlagen]] durchlesen. Viel Erfolg.