DE/MTA Scripting Grundlagen - Revision history

Necktrox: Reverted edits by N0pe (talk) to last revision by Jusonex

2018-03-06T19:21:17Z

Reverted edits by N0pe (talk) to last revision by Jusonex

← Older revision		Revision as of 19:21, 6 March 2018
Line 79:		Line 79:
	===Beispiel===		===Beispiel===
	<syntaxhighlight lang="xml"><meta>		<syntaxhighlight lang="xml"><meta>
	<info author="~~n0pe~~" type="gamemode" name="Stealth" />		<info author="Slothman" type="gamemode" name="Stealth" />
	<config src="help.xml" type="client"/>		<config src="help.xml" type="client"/>

Line 127:		Line 127:
	</settings>		</settings>
	</meta></syntaxhighlight>		</meta></syntaxhighlight>



	==Elemente==		==Elemente==

N0pe: /* Beispiel */

2018-03-06T19:16:35Z

Beispiel

← Older revision		Revision as of 19:16, 6 March 2018
Line 79:		Line 79:
	===Beispiel===		===Beispiel===
	<syntaxhighlight lang="xml"><meta>		<syntaxhighlight lang="xml"><meta>
	<info author="~~Slothman~~" type="gamemode" name="Stealth" />		<info author="n0pe" type="gamemode" name="Stealth" />
	<config src="help.xml" type="client"/>		<config src="help.xml" type="client"/>

Line 127:		Line 127:
	</settings>		</settings>
	</meta></syntaxhighlight>		</meta></syntaxhighlight>



	==Elemente==		==Elemente==

Jusonex: Undo revision 52374 by N0pe (talk)

2017-09-26T22:19:07Z

Undo revision 52374 by N0pe (talk)

← Older revision		Revision as of 22:19, 26 September 2017
Line 79:		Line 79:
	===Beispiel===		===Beispiel===
	<syntaxhighlight lang="xml"><meta>		<syntaxhighlight lang="xml"><meta>
	<info author="~~n0pe~~" type="gamemode" name="Stealth" />		<info author="Slothman" type="gamemode" name="Stealth" />
	<config src="help.xml" type="client"/>		<config src="help.xml" type="client"/>

Line 127:		Line 127:
	</settings>		</settings>
	</meta></syntaxhighlight>		</meta></syntaxhighlight>



	==Elemente==		==Elemente==

N0pe: /* Beispiel */

2017-09-26T14:10:51Z

Beispiel

← Older revision		Revision as of 14:10, 26 September 2017
Line 79:		Line 79:
	===Beispiel===		===Beispiel===
	<syntaxhighlight lang="xml"><meta>		<syntaxhighlight lang="xml"><meta>
	<info author="~~Slothman~~" type="gamemode" name="Stealth" />		<info author="n0pe" type="gamemode" name="Stealth" />
	<config src="help.xml" type="client"/>		<config src="help.xml" type="client"/>

Line 127:		Line 127:
	</settings>		</settings>
	</meta></syntaxhighlight>		</meta></syntaxhighlight>



	==Elemente==		==Elemente==

Talidan at 20:26, 23 September 2016

2016-09-23T20:26:20Z

NeonBlack: /* Beschreibung */ fixed typo

2009-09-21T08:17:53Z

Beschreibung: fixed typo

← Older revision		Revision as of 08:17, 21 September 2009
Line 216:		Line 216:
	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]].		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 ~~Veriable~~ source definiert als den Pointer zu dem Element, welches das Event hervorgerufen hat.		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.		Das heißt im Klartext, dass in jeder Eventhandlerfunktion die Variable source das Element enthält, was das Ereignis herbeigeführt hat.

NeonBlack: added commands and updated some things

2009-07-21T12:22:16Z

added commands and updated some things

Show changes

NeonBlack: first part of the german mta scripting basics tutorial

2009-07-21T01:34:58Z

first part of the german mta scripting basics tutorial

New page

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

Ich möchte hier keine ganzen Gamemodes veröffentlichen und auch nicht zeigen, wie man einen vollständigen Gamemode schreibt, sondern lediglich einige Basics vermitteln, die in keinem Gamemode fehlen sollten/können.

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

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

← Older revision		Revision as of 20:26, 23 September 2016
Line 32:		Line 32:

	===Mögliche Tags===		===Mögliche Tags===
	<syntaxhighlight ~~lang="lua"~~ lang="xml"><info author="Autor" version="Version" name="Name" description="Beschreibung" type="Typ" /></syntaxhighlight>		<syntaxhighlight 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.		*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.		**'''author''': Das ist normalerweise der Name desjenigen, der die Ressource erstellt hat.
Line 40:		Line 40:
	**'''type''': Typ der Ressource. Kann den Wert "gamemode", "script" oder "map" enthalten.		**'''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>		<syntaxhighlight 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.		*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.		**'''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.		**'''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>		<syntaxhighlight 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.		*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.		**'''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>		<syntaxhighlight 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.		*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.		**'''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>		<syntaxhighlight 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.		*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.)		**'''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>		<syntaxhighlight 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.		*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.		**'''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.		**'''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>		<syntaxhighlight 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.		*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.		**'''function''': Der Name der Funktion.
Line 68:		Line 68:
	**'''http''': Legt fest, ob die exportierte Funktion auch via HTTP aufgerufen werden kann. Kann demnach entweder "true" (ja) oder "false" (nein) sein.		**'''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>		<syntaxhighlight 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.		*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.		**'''src''': Der Pfad zur Datei relativ zum Odner der jeweiligen Ressource mit dem Dateinamen natürlich.
Line 74:		Line 74:
	**'''raw''': Wenn es sich um eine Datei im binären Format handelt, z.B. einem Bild, dann sollte raw auf "true" gesetzt werden.		**'''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>		<syntaxhighlight lang="xml"><settings /></syntaxhighlight>


	===Beispiel===		===Beispiel===
	<syntaxhighlight ~~lang="lua"~~ lang="xml"><meta>		<syntaxhighlight lang="xml"><meta>
	<info author="Slothman" type="gamemode" name="Stealth" />		<info author="Slothman" type="gamemode" name="Stealth" />
	<config src="help.xml" type="client"/>		<config src="help.xml" type="client"/>
Line 144:		Line 144:
	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.		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>		<syntaxhighlight lang="xml"><root>
	<console/>		<console/>
	<player dontRespawn="false"/>		<player dontRespawn="false"/>
Line 222:		Line 222:

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

	function onPlayerJoin()		function onPlayerJoin()
Line 275:		Line 275:

	===Serverseitiges Beispiel===		===Serverseitiges Beispiel===
	<syntaxhighlight ~~lang="lua"~~ lang="lua">function cmdPrivateMessage(source, cmd, targetname, ...)		<syntaxhighlight lang="lua">function cmdPrivateMessage(source, cmd, targetname, ...)
	--[[ da auch die eigentliche Nachricht an den Leerzeichen gespalten und als einzelne Parameter übergeben wird,		--[[ 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)		muss man mit dem ...-Parameter eine nicht festgelegte Anzahl Parameter (jeder in diesem Fall ein Wort)