Multi Theft Auto: Wiki - User contributions [en]

Template:DE/Projektile

2012-08-13T21:01:30Z

Justus H.: Added projectile ID 58

{| class="wikitable" style="width: auto; text-align: center; table-layout: fixed;"
|-
!ID
!Name/Beschreibung
|-
|'''16'''
|Granate
|-
|'''17'''
|Tränengas Granate
|-
|'''18'''
|Molotov
|-
|'''19'''
|Rakete (Normal)
|-
|'''20'''
|Rakete (Wärme suchend)
|-
|'''21'''
|Luft Bombe
|-
|'''39'''
|Rucksack Ladung
|-
|'''58'''
|Leuchtkugel von Hydra
|-
|}

DE/Server Anleitung

2012-08-13T20:58:19Z

Justus H.: brought page up to date

==Vorwort==
Einen MTA Server einzurichten ist einfacher, als es aussieht. Wenn Du dieser Anleitung folgst, brauchst Du nur wenige Minuten, um Deinen eigenen MTA Server zu konfigurieren.

==Installation==
===Windows (1.3)===
Der Windows-Server ist in der Installation des Clients bereits integriert
* Aktuellen Client von [http://mirror.mtasa.com/mtasa/main/mtasa-1.3.exe www.multitheftauto.com] herunterladen
* Während der Installation wird der Server standardmäßig installiert
* Zusätzlich kann man noch die [http://code.google.com/p/mtasa-resources/downloads/list aktuellen Resourcen von der Google-Code-Seite] herunterladen. Diese werden dann in ''server/mods/deathmatch/resources'' entpackt.

===Linux (1.3)===
* Aktuellen Server von [http://linux.mtasa.com/dl/130/multitheftauto_linux-1.3.0.tar.gz linux.mtasa.com] herunterladen und entpacken
* Die Konfigurationsdateien herunterladen und in den Ordner ''mods/deathmatch/'' entpacken
* Zusätzlich kann man noch die [http://code.google.com/p/mtasa-resources/downloads/list aktuellen Resourcen von der Google-Code-Seite] herunterladen. Diese werden dann in ''server/mods/deathmatch/resources'' entpackt.

==Den Server konfigurieren==
Der Server kann sowohl über die Konsole (das Fenster, das sich öffnet, wenn man die MTA Server.exe aufmacht) als auch im Spiel oder über das Webinterface verwaltet werden. Für die letzten beiden Optionen ist es nötig, mindestens einen Administrator hinzuzufügen.

===Allgemein===
Die hauptsächlichen Konfigurationsoptionen eures Server befinden sich in '''<server>/mods/deathmatch/mtaserver.conf'''.
Zugangsberechtigungen in '''<server>/mods/deathmatch/accounts.xml''' zu finden. (Gespeicherte Accounts in '''<server>/mods/deathmatch/internal.db''')

===Port-Konfiguration===
Hier wird erklärt welche Ports ihr öffnen müsst, damit auch andere Spieler auf eurem Server spielen können.

Als erstes öffnet ihr die Datei '''<server>/mods/deathmatch/mtaserver.conf'''' und sucht nach diesen Zeilen:
<syntaxhighlight lang="xml">
<serverport>22004</serverport>
<httpport>22005</httpport>
</syntaxhighlight>
Diese geben den Port für den Gameserver (in diesem Fall 22004) und für den eingebauten Webserver (22005) an.

Um den Server überhaupt von Außen erreichbar zu machen, müssen die entsprechenden Ports freigegeben werden. Auf der Seite [http://portforward.com/ portforward.com] wird für viele Router erklärt, wie dies funktioniert. Auch in eurer Firewall müssen (falls vorhanden) die Ports konfiguriert werden. Der MTA-Server an sich benötigt '''UDP''' für <serverport>, und sofern ihr keinen externen Webserver (später dazu mehr) nutzen wollt, noch eine TCP-Freigabe für <httpport>.

Um festzulegen, ob euer Server für Jeden in der Serverliste angezeigt werden soll, ist folgende Option vorhanden:
<syntaxhighlight lang="xml">
<ase>1</ase> 
<object name="user.BennyLava" />
</group>
...
</acl>
</syntaxhighlight>
Resourcen und Accounts kann man in Gruppen einordnen, und jeder Gruppe ist mindestens eine [[Access Control List]] zugeordnet. Diese gibt an, welche Rechte die Resource oder der Benutzer haben, welche Befehle jemand ausführen oder nicht ausführen darf und welche der Scripting-Funktionen nur bestimmten Resourcen zur Verfügung stehen. Alle registrierten und unregistrierten Benutzer fallen standardmäßig in die Gruppe ''Everyone'', die einigen Beschränkungen unterliegt, so fehlt beispielsweise das Recht zum Kicken und Bannen.

''Weitere Informationen zur ACL finden sich auf einer [[Access Control List|Extraseite]].''

===Das Webinterface===
===externen Webserver einrichten===
==Den Server verwalten==
Sobald man auf dem Server ist, kann man sich nun mit '''/login <passwort>''', oder falls der Benutzername unterschiedlich zum Accountname (in der ACL) ist, '''/login <accontname> <passwort>'''.

War dies erfolgreich, ist man Admin und kann einige Befehle, die speziell für Administratoren gedacht sind, nutzen.

Abgesehen von den in der '''mtaserver.conf''' eingestellten Resourcen für den Server-Start kann man jederzeit weitere starten oder bereits laufende anhalten, dazu gibt es die die Befehle
* '''start <Name der Resource>''', die die Resource mit dem Namen startet,
* '''stop <Name der Resource>''', um die Resource wieder zu stoppen, und
* '''restart <Name der Resource>''', welcher die Resource erst anhält und wieder startet.

Eine Übersicht über alle Befehle kann man mittels '''help''' in der Server- oder Ingame-Konsole (standardmäßig mit F8 bzw. ` erreichbar) anzeigen lassen.

Resourcen können weitere Funktionen und Befehle bereitstellen. Als Beispiel sei hier nur das Admin-Panel genannt, welches sich beim Einloggen mit der Meldung ''Press 'p' to open your admin panel'' zu Wort meldet. Durch Drücken dieser Taste erhält man Zugriff auf eine grafische Oberfläche, die viele zusätzliche Funktionen bereitstellt, unter anderem Kicken, Bannen und Teleportieren.

==Resourcen hinzufügen/aktualisieren==
Die Resourcen können entweder als ZIP-Archive gepackt sein oder einfache Ordner, in denen sich die zugehörigen Dateien befinden - beides wird von MTA unterstützt.
# Die Resource (ZIP oder Ordner) nach ''<server>/mods/deathmatch/resources'' kopieren
# Als Admin in der Konsole '''refresh''' eingeben. Dies durchsucht den kompletten resources-Ordner nach geänderten Resourcen, neue Resourcen werden der internen Liste hinzugefügt und nicht mehr existierende angehalten und gelöscht.

==Resourcen entfernen==
Sofern Resourcen nicht mehr benötigt werden, kann man diese ähnlich einfach entfernen:
# Den Ordner oder das ZIP-Archiv aus ''<server>/mods/deathmatch/resources'' löschen
# Als Admin in der Konsole '''refresh''' eingeben.

==Einen Gamemode oder eine Map starten==
Für diesen Zweck steht die Resource [[Resource:Mapmanager|mapmanager]] bereit, auf deren Dokumentation an dieser Stelle nur verwiesen sei. Wichtig ist natürlich, dass die Resource auch läuft.

[[en:Deathmatch Server Manual]]
[[it:Manuale del Server]]
[[nl:Deathmatch Server Manual]]
[[ru:Deathmatch Server Manual]]

CreateProjectile

2012-08-13T20:55:02Z

Justus H.: Added some internal links

__NOTOC__
{{Client function}}
This function creates a projectile of the specified type on the specified coordinates.

==Syntax==
<syntaxhighlight lang="lua">
projectile createProjectile ( element creator, int weaponType [, float posX, float posY, float posZ, float force = 1.0, element target = nil, float rotX, float rotY, float rotZ, float velX, float velY, float velZ, int model ] )
</syntaxhighlight>

==Required Arguments==
*'''creator:''' The [[element]] representing creator of the projectile. In case you want the projectile to be synced for everybody creator must be [[getLocalPlayer]]().
*'''weaponType:''' [[int]] representing the projectile weaponType (characteristics). Valid IDs are:
{{Projectiles}}

==Optional Arguments==
{{OptionalArg}}
*'''posX''','''posY''','''posZ''': [[float]] starting coordinates for the projectile. They are coordinates of creator by default.
*'''force''': [[float]] representing the starting force of the projectile.
*'''target''': [[element]] target used for heat seeking rockets.
*'''rotX''','''rotY''','''rotZ''': [[float]] starting rotation for the projectile.
*'''velX''','''velY''','''velZ''': [[float]] starting velocity for the projectile.
*'''model''': Integer representing the projectile's model, uses default model for weaponType if not specified.

==Returns==
Returns a ''[[projectile]]'' element if [[projectile]] creation was succesfull. Returns ''false'' if unable to create a [[projectile]] (wrong weapon ID or projectiles limit was reached).

==Example==
This example makes a rocket minigun (minigun shooting with rockets).
<syntaxhighlight lang="lua">
-- This function gets triggered everytime player shoots.
function onClientPlayerWeaponFireFunc(weapon,ammo,ammoInClip,hitX,hitY,hitZ,hitElement)
if weapon == 38 then -- if source is a local player and he uses minigun...
x,y,z = getElementPosition(getLocalPlayer())
if not createProjectile(getLocalPlayer(),19,x,y,z,200) then -- then we either create a projectile...
outputChatBox ( "Rocket minigun overheated! Give it a rest pal!", source ) -- or if projectile limit is reached we output player a chat message
end
end
end

-- Don't forget to add the onClientPlayerWeaponFireFunc function as a handler for onClientPlayerWeaponFire.
addEventHandler("onClientPlayerWeaponFire", getLocalPlayer(), onClientPlayerWeaponFireFunc)
</syntaxhighlight>

==See also==
{{Client projectile functions}}

[[it:createProjectile]]

DE/Server Anleitung

2012-06-24T07:20:09Z

Justus H.: brought page up to date

==Vorwort==
Einen MTA Server einzurichten ist einfacher, als es aussieht. Wenn Du dieser Anleitung folgst, brauchst Du nur wenige Minuten, um Deinen eigenen MTA Server zu konfigurieren.

==Installation==
===Windows (1.3)===
Der Windows-Server ist in der Installation des Clients bereits integriert
* Aktuellen Client von [http://mirror.mtasa.com/mtasa/main/mtasa-1.3.exe www.multitheftauto.com] herunterladen
* Während der Installation wird der Server standardmäßig installiert
* Zusätzlich kann man noch die [http://code.google.com/p/mtasa-resources/downloads/list aktuellen Resourcen von der Google-Code-Seite] herunterladen. Diese werden dann in ''server/mods/deathmatch/resources'' entpackt.

===Linux (1.3)===
* Aktuellen Server von [http://linux.mtasa.com/dl/130/multitheftauto_linux-1.3.0.tar.gz linux.mtasa.com] herunterladen und entpacken
* Die Konfigurationsdateien herunterladen und in den Ordner ''mods/deathmatch/'' entpacken
* Zusätzlich kann man noch die [http://code.google.com/p/mtasa-resources/downloads/list aktuellen Resourcen von der Google-Code-Seite] herunterladen. Diese werden dann in ''server/mods/deathmatch/resources'' entpackt.

==Den Server konfigurieren==
Der Server kann sowohl über die Konsole (das Fenster, das sich öffnet, wenn man die MTA Server.exe aufmacht) als auch im Spiel oder über das Webinterface verwaltet werden. Für die letzten beiden Optionen ist es nötig, mindestens einen Administrator hinzuzufügen.

===Allgemein===
Die hauptsächlichen Konfigurationsoptionen eures Server befinden sich in '''<server>/mods/deathmatch/mtaserver.conf'''.
Gespeicherte Accounts sind in '''<server>/mods/deathmatch/accounts.xml''' und Zugangsberechtigungen in '''<server>/mods/deathmatch/accounts.xml''' zu finden.

===Port-Konfiguration===
Hier wird erklärt welche Ports ihr öffnen müsst, damit auch andere Spieler auf eurem Server spielen können.

Als erstes öffnet ihr die Datei '''<server>/mods/deathmatch/mtaserver.conf'''' und sucht nach diesen Zeilen:
<syntaxhighlight lang="xml">
<serverport>22004</serverport>
<httpport>22005</httpport>
</syntaxhighlight>
Diese geben den Port für den Gameserver (in diesem Fall 22004) und für den eingebauten Webserver (22005) an.

Um den Server überhaupt von Außen erreichbar zu machen, müssen die entsprechenden Ports freigegeben werden. Auf der Seite [http://portforward.com/ portforward.com] wird für viele Router erklärt, wie dies funktioniert. Auch in eurer Firewall müssen (falls vorhanden) die Ports konfiguriert werden. Der MTA-Server an sich benötigt '''UDP''' für <serverport>, und sofern ihr keinen externen Webserver (später dazu mehr) nutzen wollt, noch eine TCP-Freigabe für <httpport>.

Um festzulegen, ob euer Server für Jeden in der Serverliste angezeigt werden soll, ist folgende Option vorhanden:
<syntaxhighlight lang="xml">
<ase>1</ase> 
<object name="user.BennyLava" />
</group>
...
</acl>
</syntaxhighlight>
Resourcen und Accounts kann man in Gruppen einordnen, und jeder Gruppe ist mindestens eine [[Access Control List]] zugeordnet. Diese gibt an, welche Rechte die Resource oder der Benutzer haben, welche Befehle jemand ausführen oder nicht ausführen darf und welche der Scripting-Funktionen nur bestimmten Resourcen zur Verfügung stehen. Alle registrierten und unregistrierten Benutzer fallen standardmäßig in die Gruppe ''Everyone'', die einigen Beschränkungen unterliegt, so fehlt beispielsweise das Recht zum Kicken und Bannen.

''Weitere Informationen zur ACL finden sich auf einer [[Access Control List|Extraseite]].''

===Das Webinterface===
===externen Webserver einrichten===
==Den Server verwalten==
Sobald man auf dem Server ist, kann man sich nun mit '''/login <passwort>''', oder falls der Benutzername unterschiedlich zum Accountname (in der ACL) ist, '''/login <accontname> <passwort>'''.

War dies erfolgreich, ist man Admin und kann einige Befehle, die speziell für Administratoren gedacht sind, nutzen.

Abgesehen von den in der '''mtaserver.conf''' eingestellten Resourcen für den Server-Start kann man jederzeit weitere starten oder bereits laufende anhalten, dazu gibt es die die Befehle
* '''start <Name der Resource>''', die die Resource mit dem Namen startet,
* '''stop <Name der Resource>''', um die Resource wieder zu stoppen, und
* '''restart <Name der Resource>''', welcher die Resource erst anhält und wieder startet.

Eine Übersicht über alle Befehle kann man mittels '''help''' in der Server- oder Ingame-Konsole (standardmäßig mit F8 bzw. ` erreichbar) anzeigen lassen.

Resourcen können weitere Funktionen und Befehle bereitstellen. Als Beispiel sei hier nur das Admin-Panel genannt, welches sich beim Einloggen mit der Meldung ''Press 'p' to open your admin panel'' zu Wort meldet. Durch Drücken dieser Taste erhält man Zugriff auf eine grafische Oberfläche, die viele zusätzliche Funktionen bereitstellt, unter anderem Kicken, Bannen und Teleportieren.

==Resourcen hinzufügen/aktualisieren==
Die Resourcen können entweder als ZIP-Archive gepackt sein oder einfache Ordner, in denen sich die zugehörigen Dateien befinden - beides wird von MTA unterstützt.
# Die Resource (ZIP oder Ordner) nach ''<server>/mods/deathmatch/resources'' kopieren
# Als Admin in der Konsole '''refresh''' eingeben. Dies durchsucht den kompletten resources-Ordner nach geänderten Resourcen, neue Resourcen werden der internen Liste hinzugefügt und nicht mehr existierende angehalten und gelöscht.

==Resourcen entfernen==
Sofern Resourcen nicht mehr benötigt werden, kann man diese ähnlich einfach entfernen:
# Den Ordner oder das ZIP-Archiv aus ''<server>/mods/deathmatch/resources'' löschen
# Als Admin in der Konsole '''refresh''' eingeben.

==Einen Gamemode oder eine Map starten==
Für diesen Zweck steht die Resource [[Resource:Mapmanager|mapmanager]] bereit, auf deren Dokumentation an dieser Stelle nur verwiesen sei. Wichtig ist natürlich, dass die Resource auch läuft.

[[en:Deathmatch Server Manual]]
[[it:Manuale del Server]]
[[nl:Deathmatch Server Manual]]
[[ru:Deathmatch Server Manual]]

DE/Server Anleitung

2012-06-24T07:10:29Z

Justus H.: Removed deprecated part

==Vorwort==
Einen MTA Server einzurichten ist einfacher, als es aussieht. Wenn Du dieser Anleitung folgst, brauchst Du nur wenige Minuten, um Deinen eigenen MTA Server zu konfigurieren.

==Installation==
===Windows (DP2)===
* Windows-Server von der [http://mtasa.com/deathmatch.html Downloadseite] herunterladen.
* Die Datei öffnen und auswählen, wohin der Server entpackt werden soll.
* Zum Schluss auf "Extract" klicken

===Windows (1.0)===
Der Windows-Server für die Nightlies ist bereits im Installer integriert.
* Aktuelle Nightly von [http://nightly.mtasa.com/mtasadm-1.0-r1294.exe nightly.mtasa.com] herunterladen
* Während der Installation wird der Server standardmäßig installiert
* Zusätzlich kann man noch die [http://code.google.com/p/multitheftauto-resources/downloads/list aktuellen Resourcen von der Google-Code-Seite] herunterladen. Diese werden dann in <server>/mods/deathmatch/resources entpackt.

==Den Server konfigurieren==
Der Server kann sowohl über die Konsole (das Fenster, das sich öffnet, wenn man die MTA Server.exe aufmacht) als auch im Spiel oder über das Webinterface verwaltet werden. Für die letzten beiden Optionen ist es nötig, mindestens einen Administrator hinzuzufügen.

===Allgemein===
Die hauptsächlichen Konfigurationsoptionen eures Server befinden sich in '''<server>/mods/deathmatch/mtaserver.conf'''.
Gespeicherte Accounts sind in '''<server>/mods/deathmatch/accounts.xml''' und Zugangsberechtigungen in '''<server>/mods/deathmatch/accounts.xml''' zu finden.

===Port-Konfiguration===
Hier wird erklärt welche Ports ihr öffnen müsst, damit auch andere Spieler auf eurem Server spielen können.

Als erstes öffnet ihr die Datei '''<server>/mods/deathmatch/mtaserver.conf'''' und sucht nach diesen Zeilen:
<syntaxhighlight lang="xml">
<serverport>22004</serverport>
<httpport>22005</httpport>
</syntaxhighlight>
Diese geben den Port für den Gameserver (in diesem Fall 22004) und für den eingebauten Webserver (22005) an.

Um den Server überhaupt von Außen erreichbar zu machen, müssen die entsprechenden Ports freigegeben werden. Auf der Seite [http://portforward.com/ portforward.com] wird für viele Router erklärt, wie dies funktioniert. Auch in eurer Firewall müssen (falls vorhanden) die Ports konfiguriert werden. Der MTA-Server an sich benötigt '''UDP''' für <serverport>, und sofern ihr keinen externen Webserver (später dazu mehr) nutzen wollt, noch eine TCP-Freigabe für <httpport>.

Um festzulegen, ob euer Server für Jeden in der Serverliste angezeigt werden soll, ist folgende Option vorhanden:
<syntaxhighlight lang="xml">
<ase>1</ase> 
<object name="user.BennyLava" />
</group>
...
</acl>
</syntaxhighlight>
Resourcen und Accounts kann man in Gruppen einordnen, und jeder Gruppe ist mindestens eine [[Access Control List]] zugeordnet. Diese gibt an, welche Rechte die Resource oder der Benutzer haben, welche Befehle jemand ausführen oder nicht ausführen darf und welche der Scripting-Funktionen nur bestimmten Resourcen zur Verfügung stehen. Alle registrierten und unregistrierten Benutzer fallen standardmäßig in die Gruppe ''Everyone'', die einigen Beschränkungen unterliegt, so fehlt beispielsweise das Recht zum Kicken und Bannen.

''Weitere Informationen zur ACL finden sich auf einer [[Access Control List|Extraseite]].''

===Das Webinterface===
===externen Webserver einrichten===
==Den Server verwalten==
Sobald man auf dem Server ist, kann man sich nun mit '''/login <passwort>''', oder falls der Benutzername unterschiedlich zum Accountname (in der ACL) ist, '''/login <accontname> <passwort>'''.

War dies erfolgreich, ist man Admin und kann einige Befehle, die speziell für Administratoren gedacht sind, nutzen.

Abgesehen von den in der '''mtaserver.conf''' eingestellten Resourcen für den Server-Start kann man jederzeit weitere starten oder bereits laufende anhalten, dazu gibt es die die Befehle
* '''start <Name der Resource>''', die die Resource mit dem Namen startet,
* '''stop <Name der Resource>''', um die Resource wieder zu stoppen, und
* '''restart <Name der Resource>''', welcher die Resource erst anhält und wieder startet.

Eine Übersicht über alle Befehle kann man mittels '''help''' in der Server- oder Ingame-Konsole (standardmäßig mit F8 bzw. ` erreichbar) anzeigen lassen.

Resourcen können weitere Funktionen und Befehle bereitstellen. Als Beispiel sei hier nur das Admin-Panel genannt, welches sich beim Einloggen mit der Meldung ''Press 'p' to open your admin panel'' zu Wort meldet. Durch Drücken dieser Taste erhält man Zugriff auf eine grafische Oberfläche, die viele zusätzliche Funktionen bereitstellt, unter anderem Kicken, Bannen und Teleportieren.

==Resourcen hinzufügen/aktualisieren==
Die Resourcen können entweder als ZIP-Archive gepackt sein oder einfache Ordner, in denen sich die zugehörigen Dateien befinden - beides wird von MTA unterstützt.
# Die Resource (ZIP oder Ordner) nach ''<server>/mods/deathmatch/resources'' kopieren
# Als Admin in der Konsole '''refresh''' eingeben. Dies durchsucht den kompletten resources-Ordner nach geänderten Resourcen, neue Resourcen werden der internen Liste hinzugefügt und nicht mehr existierende angehalten und gelöscht.

==Resourcen entfernen==
Sofern Resourcen nicht mehr benötigt werden, kann man diese ähnlich einfach entfernen:
# Den Ordner oder das ZIP-Archiv aus ''<server>/mods/deathmatch/resources'' löschen
# Als Admin in der Konsole '''refresh''' eingeben.

==Einen Gamemode oder eine Map starten==
Für diesen Zweck steht die Resource [[Resource:Mapmanager|mapmanager]] bereit, auf deren Dokumentation an dieser Stelle nur verwiesen sei. Wichtig ist natürlich, dass die Resource auch läuft.

[[en:Deathmatch Server Manual]]
[[it:Manuale del Server]]
[[nl:Deathmatch Server Manual]]
[[ru:Deathmatch Server Manual]]

DE/playSound3D

2012-05-22T09:32:56Z

Justus H.:

__NOTOC__
{{DE/Client function}}
Erstellt ein [[sound]] Element und spielt es für den lokalen Spieler ab. [[DE/setElementPosition]] kann benutzt werden, um das [[sound]] Element zu bewegen.<br />
<br />
'''Beachte:''' Unterstützte Audio Formate sind MP3, WAV, OGG, RIFF, MOD, XM, IT und S3M.

==Syntax==
<syntaxhighlight lang="lua">element playSound3D ( string soundPfad, float x, float y, float z, [ bool wiederholend = false ] )</syntaxhighlight>

===Benötigte Argumente===
*'''soundPfad:''' Der [[Dateipfad]] wo sich der Sound befindet.
*'''x:''' Eine Fließkommadarstellungen, welche die X Koordinate in der Karte darstellt.
*'''y:''' Eine Fließkommadarstellungen, welche die Y Koordinate in der Karte darstellt.
*'''z:''' Eine Fließkommadarstellungen, welche die Z Koordinate in der Karte darstellt

===Optimale Argumente===
*'''wiederholend:''' Ein [[boolean]], welcher angibt, ob sich der Sound wiederholen soll. ''true''.

===Returns===
Gibt ein [[sound]]-Element zurück, wenn der Sound erfolgreich erstellt wurde. ''false'' anderseits.

==Beispiel==
Dieses Beispiel erstellt ein Sound, der sich wiederholt, am Pier 69 in San Fierro.
<section name="Example" class="client" show="true">
<syntaxhighlight lang="lua">
function onResourceStart()
local sound = playSound3D("sounds/song.mp3", 373.14, -125.21, 1001, true)
end
addEventHandler("onClientResourceStart", getResourceRootElement(getThisResource()), onResourceStart)
</syntaxhighlight>
</section>

==Andere Funktionen==
{{DE/Client_audio_functions}}

DE/getRadioChannel

2012-05-22T09:30:21Z

Justus H.:

__NOTOC__
{{DE/Client function}}
Diese Funktion gibt die ID des derzeitigen Radiosenders zurück.

==Syntax==
<syntaxhighlight lang="lua">
int getRadioChannel ( )
</syntaxhighlight>

===Rückgaben===
Gibt die aktuelle Radiochannel-ID wieder.
{{SoundID}}

==Beispiel==
Dieses Beispiel gibt den Name deines zurzeitigen Radio-Channels in der Chatbox aus.
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
addCommandHandler ( "getradio",
function ()
outputChatBox ( "Du hoerst zurzeit: " .. getRadioChannelName ( getRadioChannel() ) .. "!" )
end
)
</syntaxhighlight>
</section>

==Andere Funktionen==

{{DE/Client_audio_functions}}

DE/getRadioChannelName

2012-05-22T09:29:57Z

Justus H.:

__NOTOC__
{{DE/Client function}}
Diese Funktion gibt den Name des übergebenen Radiosenders zurück

==Syntax==
<syntaxhighlight lang="lua">
string getRadioChannelName ( int id )
</syntaxhighlight>

===Benötigte Argumente===
*'''id:''' Die ID eines Radiosenders, von denen du den Namen haben möchtest. Es muss eine Nummer von 0 bis 12 sein.
{{SoundID}}

===Rückgaben===
Gibt einen String mit dem Namen des Radiosenders zurück, 'false' wenn nicht.

==Beispiel==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
addCommandHandler("getradio",
function()
outputChatBox("Du hoerst zurzeit: "..getRadioChannelName(getRadioChannel()).."!")
end
)
</syntaxhighlight>
</section>

==Andere Funktionen==

{{DE/Client_audio_functions}}

DE/getRadioChannel

2012-05-22T09:29:09Z

Justus H.:

__NOTOC__
{{DE/Client function}}
Diese Funktion gibt die ID des derzeitigen Radio-Kanals zurück.

==Syntax==
<syntaxhighlight lang="lua">
int getRadioChannel ( )
</syntaxhighlight>

===Rückgaben===
Gibt die aktuelle Radiochannel-ID wieder.
{{SoundID}}

==Beispiel==
Dieses Beispiel gibt den Name deines zurzeitigen Radio-Channels in der Chatbox aus.
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
addCommandHandler ( "getradio",
function ()
outputChatBox ( "Du hoerst zurzeit: " .. getRadioChannelName ( getRadioChannel() ) .. "!" )
end
)
</syntaxhighlight>
</section>

==Andere Funktionen==

{{DE/Client_audio_functions}}

DE/getRadioChannel

2012-05-22T09:28:55Z

Justus H.:

__NOTOC__
{{DE/Client function}}
Diese Funktion gibt die ID des derzeitigen Radio-Kanals zurück.

==Syntax==
<syntaxhighlight lang="lua">
int getRadioChannel ( )
</syntaxhighlight>

===Rückfaben===
Gibt die aktuelle Radiochannel-ID wieder.
{{SoundID}}

==Beispiel==
Dieses Beispiel gibt den Name deines zurzeitigen Radio-Channels in der Chatbox aus.
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
addCommandHandler ( "getradio",
function ()
outputChatBox ( "Du hoerst zurzeit: " .. getRadioChannelName ( getRadioChannel() ) .. "!" )
end
)
</syntaxhighlight>
</section>

==Andere Funktionen==

{{DE/Client_audio_functions}}

DE/playSoundFrontEnd

2012-05-22T09:27:49Z

Justus H.:

{{DE/Server client function}}
__NOTOC__
Diese Funktion spielt einen gewissen Sound für einen Spieler ab.

==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool playSoundFrontEnd ( spieler thePlayer, int sound )
</syntaxhighlight>

===Benötigte Argumente===
*'''thePlayer:''' Der [[spieler]] der den Sound hören soll
*'''sound:''' Ein [[int]] der für den Sound steht. Richtige ID's sind:
{{Sounds}}
</section>
<section name="Client" class="client" show="false">
<syntaxhighlight lang="lua">
bool playSoundFrontEnd ( int sound )
</syntaxhighlight>

===Benötigte Argumente===
*'''sound:''' Ein [[int]] der für den Sound steht. Richtige ID's sind:
{{Sounds}}
</section>

===Rückgaben===
Gibt ''true'' wieder, wenn der Sound erfolgreich abgespielt wurden ist. 'false', wenn nicht.

==Beispiel==
<section name="server" class="server" show="true">
In diesem Beispiel wird ein Sound abgespielt, wenn ein Spieler spawnt.
<syntaxhighlight lang="lua">
function onPlayerSpawn ( theSpawnpoint, theTeam )
playSoundFrontEnd ( source, 16 )
end
addEventHandler ( "onPlayerSpawn", getRootElement(), onPlayerSpawn )
</syntaxhighlight>
</section>
<section name="client" class="client" show="true">
In diesem Beispiel wird ein Sound abgespielt, wenn der Client den Command /sound eingibt.
<syntaxhighlight lang="lua">
function onSoundEvent ( )
playSoundFrontEnd ( 16 )
end
addCommandHandler("sound", onSoundEvent)
</syntaxhighlight>
</section>

==Andere Funktionen==
{{DE/Client_audio_functions}}

DE/isObjectBreakable

2012-05-05T19:42:28Z

Justus H.:

==Syntax==
<syntaxhighlight lang="lua">bool isObjectBreakable ( object theObject )</syntaxhighlight>

===Erforderliche Argumente===
*'''theObject''' Das Objekt, welches du überprüfen willst.
===Rückgabe===
Gibt ''true'', wenn das Objekt zerbrechlich ist, andernfalls ''false''.

==Beispiel==
<section name="Client" class="client" show="true">
Dieses Beispiel erstellt ein Objekt, wenn die Resource startet und überprüft, ob es zerbrechlich ist. (GETESTET!)
<syntaxhighlight lang="lua">addEventHandler("onClientResourceStart",resourceRoot,function()
local object = createObject ( 1337, 5540.6654, 1020.55122, 1240.545 )
if isObjectBreakable(object) then
outputChatBox("Ja, das Objekt ist zerbrechlich.")
else
outputChatBox("Nein, das Objekt ist nicht zerbrechlich.")
end
end)
</syntaxhighlight>
</section>

==Siehe auch==
{{Object functions}}

OnResourcePreStart

2012-01-09T19:26:04Z

Justus H.:

{{Server event}}
__NOTOC__
{{Needs_Checking|first parameter isn't the same resource/memory adress like getThisResource(). In addition this event is always attached to the root element}}
This event is triggered before a resource is loaded.

'''Important:''' If you attach this event to the root element it will called when ''any'' resource starts, not just the resource your script is running inside. As such, most of the time you will want to check that the resource passed to this event matches your resource (compare with the value returned by [[getThisResource]]) before doing anything. Alternatively you can attach the event to [[getResourceRootElement]]([[getThisResource]]()).

==Parameters==
<syntaxhighlight lang="lua">
resource startingResource
</syntaxhighlight>

*'''startingResource''': The resource that is starting

==Source==
The [[event system#Event source|source]] of this event is the root [[element]].

==Cancel effect==

==Example==
This code will output the name of any resource that is starting.
<syntaxhighlight lang="lua">
function displayStartingRes ( res )
outputChatBox ( "Resource " .. getResourceName(res) .. " is starting", getRootElement(), 255, 255, 255 )
end
addEventHandler ( "onResourcePreStart", getRootElement(), displayStartingRes )
</syntaxhighlight>

{{See also/Server event|Resource events}}

OnResourcePreStart

2012-01-09T19:24:08Z

Justus H.:

{{Server event}}
__NOTOC__
{{Needs_Checking|first parameter isn't the same resource/memory adress like getThisResource()}}
This event is triggered before a resource is loaded.

'''Important:''' If you attach this event to the root element it will called when ''any'' resource starts, not just the resource your script is running inside. As such, most of the time you will want to check that the resource passed to this event matches your resource (compare with the value returned by [[getThisResource]]) before doing anything. Alternatively you can attach the event to [[getResourceRootElement]]([[getThisResource]]()).

==Parameters==
<syntaxhighlight lang="lua">
resource startingResource
</syntaxhighlight>

*'''startingResource''': The resource that is starting

==Source==
The [[event system#Event source|source]] of this event is the root [[element]].

==Cancel effect==

==Example==
This code will output the name of any resource that is starting.
<syntaxhighlight lang="lua">
function displayStartingRes ( res )
outputChatBox ( "Resource " .. getResourceName(res) .. " is starting", getRootElement(), 255, 255, 255 )
end
addEventHandler ( "onResourcePreStart", getRootElement(), displayStartingRes )
</syntaxhighlight>

{{See also/Server event|Resource events}}

IsTrainDerailed

2011-10-12T13:49:30Z

Justus H.: /* Example */

__NOTOC__
[[Category:Needs_Example]]
{{Server client function}}
This function will check if a train or tram is derailed.

==Syntax==
<syntaxhighlight lang="lua">
bool isTrainDerailed ( vehicle vehicleToCheck )
</syntaxhighlight>

===Required Arguments===
*'''vehicleToCheck:''' The vehicle that you wish to check is derailed.

===Returns===
Returns ''true'' if the train is derailed, ''false'' if the train is still on the rails

==Example==
<section name="Example" class="server" show="true">
<syntaxhighlight lang="lua">
function checkDerailed(player)
if isPedInVehicle(player) and getVehicleType(getPedOccupiedVehicle(player) then --is the player in a vehicle and is it a train?
if isTrainDerailed(getPedOccupiedVehicle(player)) then --is the train derailed?
outputChatBox("Your train is derailed", player) --outputs a message
end
end
end
addCommandHandler("checkTrain", checkDerailed) --adds the command handler
</syntaxhighlight>
</section>

==See Also==
{{Vehicle_functions}}

IsTrainDerailed

2011-10-12T13:48:51Z

Justus H.: isTrainDerailed

__NOTOC__
[[Category:Needs_Example]]
{{Server client function}}
This function will check if a train or tram is derailed.

==Syntax==
<syntaxhighlight lang="lua">
bool isTrainDerailed ( vehicle vehicleToCheck )
</syntaxhighlight>

===Required Arguments===
*'''vehicleToCheck:''' The vehicle that you wish to check is derailed.

===Returns===
Returns ''true'' if the train is derailed, ''false'' if the train is still on the rails

==Example==
<section name="Example" class="server" show="true">
<syntaxhighlight lang="lua">
function checkDerailed(player)
if isPedInVehicle(player) and getVehicleType(getPedOccupiedVehicle(player) then --is the player in a vehicle and is it a train?
if isTrainDerailed(getPedOccupiedVehicle(player)) then --is the train derailed?
outputChatBox("Your train is derailed", player) --outputs a message
end
end
end
</syntaxhighlight>
</section>

==See Also==
{{Vehicle_functions}}