MTA-Wiki - Verstehen & Nutzen

Wenn ihr nun auf eine Funktions-Seite geht, findet ihr eine Seite voll mit Informationen.
Am Anfang wird man nicht verstehen, was alles bedeuten soll - jedoch werde ich es euch hier erklären.

Nehmen wir als Beispiel die Funktion setElementData.
https://wiki.multitheftauto.com/wiki/SetElementData

Hier achten wir zuerst rechts darauf, ob es clientseitig, serverseitig oder shared ist.
Diese Info bekommen wir zum einen durch die Farbe des Rahmen und zum anderen durch die Wörter rechts oben in der Ecke:

Direkt unter dem Funktions-Namen bekommen wir Infos darüber, was die Funktion ungefähr tut.
Unter diesem Text findet ihr noch weitere Infos (Notes, Tipps).
Außerdem gibt es manchmal auch rechts weitere Hinweise wie z.B. hier:

Es ist sehr wichtig die Texte alle zu lesen, um Fehler zu vermeiden!

Nun kommen wir zum Syntax:

Hierbei hatte ich am Anfang die größten Probleme, denn ich habe nichts verstanden.
Jedoch ist es ganz einfach, wenn man es einmal verstanden hat.

ACHTUNG: Wenn ihr Wörter wie boolean, integer usw. nicht kennt, solltet ihr euch hier erkundigen:
https://wiki.multitheftauto.co…_Tutorial#Einf.C3.BChrung

Hier erfahren wir, dass die Funktion setElementData heißt und ein bool(ean) zurück gibt.

Hier sehen wir die Argumente, die wir der Funktion übergeben.
Die grünen Wörter geben den Typen an, die schwarzen Wörter ungefähr das, was wir da eintragen sollen.
Die Argumente in der eckigen Klammer sind optional/freiwillig.
Wenn wir hier also synchronize nicht angeben, wird automatisch true genutzt.

Hier auf dem Bild können wir also rauslesen:
Die Funktion setElementData gibt einen boolean zurück.
Wir müssen der Funktion das Element, einen key als Zeichenkette und einen Wert übergeben.
Optional können wir einen boolean für synchronize übergeben - tun wir das nicht, wird automatisch true genutzt.

Nun wissen wir jedoch nicht, was genau theElement, key, value oder synchronize sind - oder was gibt dieses boolean an, welches wir zurück bekommen?
Dafür gehen wir etwas runter:

Hier bekommen wir direkt unsere Infos:
theElement ist das Element, welchem wir die Daten anbinden wollen.
key ist der "Schlüssel", unter welchem wir die Daten verstauen wollen (max. 31 Zeichen).
value ist der Wert, eben die Daten.
synchronize ist optional und bestimmt, ob die Daten synchronisiert werden sollen mit server und clients.
Der bool, welcher zurückgegeben wird, zeigt uns an, ob die Daten ordentlich angebunden werden konnten - true für ja, false für nein.

Durch diese Informationen konnen wir schon die Funktion benutzen:

local player = getPlayerFromName ( "[TDS]Bonus" )
setElementData ( player, "babalevel", 9999999999999999999 )


-- player => thePlayer
-- "babalevel" => key
-- 9999... => value
-- nil/nichts => synchronize, welches durch nil/nichts automatisch true ist

Etwas unten finden wir nun auch Bugs, welche gemeldet wurden, Beispiele (orange = serverseitig, rot = clientseitig) und ähnliche Themen.

Viele Funktionen, die shared sind, haben verschiedene Syntaxen clientseitig und serverseitig.
Zum Beispiel kann man bei createBlip serverseitig angeben, von welchen Spielern der/das Blip gesehen werden können soll.
Clientseitig kann man das jedoch nicht einstellen, denn der client ist der einzige, der den/das Blip sehen kann.
Oder als anderes Beispiel kann ich serverseitig bei fadeCamera einen Spieler angeben, dessen "Kamera" ich "faden" will.
Clientseitig geht das jedoch schlecht, denn ich kann von meinem PC aus nicht einfach deine Kamera "faden", daher kann man hier keinen Spieler angeben.

Meistens gibt es bei shared-Funktionen bei den Syntaxen einen Unterschied - Angabe des Spielers, wie vorhin schon erwähnt.
Der Server kann jeden Spieler beeinflussen. Wenn du einen Spieler beeinflussen willst, dann musst du den Spieler angeben, denn woher soll der Server wissen, wen du meinst?
Wenn du jedoch clientseitig einen Spieler beeinflussen willst, dann kannst du nur dich selbst beeinflussen (z.B. setPlayerBlurLevel). Daher gibt man bei einigen Funktionen clientseitig kein Element an, denn das Element ist der Client selbst.
Bei Funktionen wie z.B. setPedAnimation gibt es clientseitig trotzdem die Möglichkeit der Spieler-Angabe, denn man kann hier auch ein Ped angeben, muss also nicht unbedingt sich selbst angeben.

Mit Events kann man ganz einfach von einem Client mit dem Server kommunizieren und umgekehrt.
Man kann Informationen übergeben oder einfach nur Funktionen auf der anderen Seite ausführen lassen.
Außerdem kann man sehr gut bestimmte Ereignisse abfangen und da eine Funktion ausführen lassen.

Hier gibt es wieder verschiedene Kategorien:
Clientseitige-Events, serverseitige-Events und custom-Events.
Clientseitige-Events kann man nur clientseitig nutzen, serverseitige-Events nur serverseitig und custom-Events erstellt man selber.

Events werden getriggert (sozusagen "gesendet"), wenn etwas bestimmtes passiertes.
Wenn z.B. jemand stirbt, wird onPlayerWasted zum Server und onClientPlayerWasted zu den Clients getriggert.
Diese Events kann man abfangen, indem man die Funktion addEventHandler nutzt.
https://wiki.multitheftauto.com/wiki/AddEventHandler
Sind also gut, um etwas passieren zu lassen, wenn etwas bestimmtes passiert ist.

Wenn man ein Event mit addEventHandler abfängt, wird die dort angegebene Funktion aufgerufen.
Diese Funktion kriegt dann zuallerst immer den source ("Quelle") des Events.
source wird dann für die Funktion als Variable erstellt und kann genutzt werden, ist immer ein Element.
Was das source ist, erfahrt ihr immer auf der Seite des Events.
Bei z.B. onPlayerWasted wäre das der Spieler, der gestorben ist.

https://wiki.multitheftauto.com/wiki/OnPlayerWasted

Außerdem kann ein Event einige Parameter an die Funktion, die wir in addEventHandler nutzen, übergeben.
Zum Beispiel gibt das Event onPlayerWasted 5 Parameter an die Funktion:
totalAmmo, killer, killerWeapon, bodypart, stealth

Diese bekommt ihr in der Funktion, wenn ihr nach function bei den Klammern die Variablen-Namen angibt.
z.B. so:

addEventHandler ( "onPlayerWasted", root, function ( ammo, derkiller17, waffe, koerperteil, wardasstealthamk ) ... end

Nun könnt ihr dann die Variablen so nutzen, denn hier ist dann ammo eben totalAmmo usw.
Achtet jedoch darauf, dass die Namen keinen Unterschied machen (außer eben Optik - vorausgesetzt es werden nur erlaubte Zeichen genutzt).
Wenn ihr nur bodyPart haben wollt, aber den Rest nicht, könnt ihr nicht einfach nur bodyPart reinschreiben.
Die erste Variable in der Klamme ist bei onPlayerWasted IMMER totalAmmo, also könnt ihr dafür sowas tun:

addEventHandler ( "onPlayerWasted", root, function ( _, _, _, koerperteil ) ... end

Somit nehmen wir nur diesen Parameter, welcher uns auch interessiert. Der Rest wird verworfen, stealth nehmen wir gar nicht erst an.

Nun können wir schon unseren ersten Code schreiben:

addEventHandler ( "onPlayerWasted", getPlayerFromName("dennismitzwein"), function ( _, killer ) 
    if getPlayerName ( killer ) == "Bonus" then
        outputChatBox ( "Bonus, dein Vater, hat dich zerstört!", source )
    end
end

Bei diesem Code kriegt dennismitzwein (falls er während der Funktions-Erstellung online war) die Nachricht "Bonus, dein Vater, hat dich zerstört!", wenn eben Bonus ihn tötet.
Wir hängen durch getPlayerFromName... direkt nach onPlayerWasted das Event NUR an dennismitzwein. source ist der Spieler, der gestorben ist, also dennismitzwein, da das Event nur an ihn angehangen wurde.

ACHTUNG: Wenn ihr ein Event an ein Element anhängt, dann muss das Element zu diesem Zeitpunkt auch existent sein.
Wenn dennismitzwein offline wäre, während das Script gestartet ist, wäre das Event nicht an ihn angehangen wurde - da käme nur ein Warning heraus.

Custom-Events sind nun etwas anders als vordefinierte Events, denn hierbei erstellen wir selber das Event, geben an ob es clientseitig oder serverseitig sein soll und welche Parameter es an die Funktion übergeben soll.

Wir wollen zum Beispiel clientseitig ein Button machen.
Wenn wir das Button drücken, soll an dennismitzwein eine Nachricht kommen mit "Du Lappen" - doch wie machen wir das?
outputChatBox kann man clientseitig nur nutzen, um sich selbst eine Nachricht zu senden, also müssen wir mit dem Server arbeiten.

Hier kommen custom-Events zur Rettung:
Wir erstellen ein custom-Event und können so mit dem Server kommunizieren.

Dazu nutzen wir zuerst addEvent.
https://wiki.multitheftauto.com/wiki/AddEvent
Mit dieser Funktion können wir das Event sozusagen erstellen.
Wir nutzen addEvent serverseitig, um das Event zu erstellen.
Als nächstes nutzen wir addEventHandler, um serverseitig das Event abzufangen.
Danach nutzen wir clientseitig triggerServerEvent, um das Event dem Server zu senden.

Dann sieht das Ganze ungefähr so aus:

-- clientseitig --
triggerServerEvent ( "sendDennisLappenMessage", localPlayer, "Du Lappen" )  -- "send..." ist das Event, localPlayer die Quelle/source, "Du Lappen" eines der Parameter


-- serverseitig --
addEvent ( "sendDennisLappenMessage", true )  -- erstellen das Event und mit true lassen wir zu, dass es von clients gesendet werden kann
addEventHandler ( "sendDennisLappenMessage", root, function ( msg )   -- fange das Event ab - durch root kann es von allen clients kommen. Die Funktion bekommt msg als Parameter.
    outputChatBox ( getPlayerFromName(client)..": "..msg, getPlayerFromName ( "dennismitzwein" ) )    -- hier senden wir die Nachricht an dennismitzwein - da "Du Lappen" genutzt wurde, wird ihm "Bonus: Du Lappen" gesendet.
end )

Wenn ihr den code gelesen habt, werdet ihr vielleicht das "client" erkennen im outputChatBox.
Woher kommt es?
Ganz einfach:
Wenn wir per triggerServerEvent ein Event senden, kriegt die Funktion serverseitig außerdem weitere Variablen, nachzulesen hier:
https://wiki.multitheftauto.co…Predefined_variables_list
client ist der Client, welcher das Event gesendet hat.
source ist das Element, welches bei triggerServerEvent als 2. Argument angegeben wurde. Da wir localPlayer angegeben haben, ist der client gleichzeitig auch der source.

Um euren Code sicherer zu machen, solltet ihr bei triggerServerEvent immer mit client statt source arbeiten.
Bei client wisst ihr zu 100% sicher, wer das Event gesendet hat.
Bei source wisst ihr es nicht sicher, denn statt localPlayer hätte da auch ein anderes Element stehen können.

Useful Functions sind Funktionen, die nicht in MTA sind, sondern von Leuten selbst erstellt wurden - eine Art Codeschnipsel eben.
Um eine useful function nutzen zu können, müsst ihr daher die Funktion zuallererst in euer Script reintun - erst dann könnt ihr die Funktion nutzen.
Diese Funktionen sind nicht notwendig, aber sehr hilfreich - anschauen lohnt sich!

Das MTA Wiki besteht nicht nur aus Infos zu Funktionen und Events, sondern hat viel mehr Infos.
Ich würde euch raten überall mal rumzugehen und es euch durchzulesen, das wird euch als Anfänger eine Menge helfen.
Da dieses Tutorial schon lange genug ist, werde ich die einzelnen Punkte nicht durchgehen.