Multi Theft Auto: Wiki - User contributions [en]

DE/Meta.xml

2014-12-06T23:53:34Z

Soner Sayakci: /* Tags */

Die ''meta.xml'' gibt MTA Informationen über die Resource. Beispiele dafür sind Ressourcenname, eingebundene Scripts und Dateien wie Grafiken und ähnliches. Benutzt wird hier die Auszeichnungssprache [http://de.wikipedia.org/wiki/XML XML].

== Tags ==
Folgende XML-Tags können verwenden werden:
*'''<info />''' Information über die Ressource (können via [[getResourceInfo]] eingelesen werden):
**'''author:''' Der Autor der Ressource
**'''version:''' Version der Ressource
**'''name:''' Name der Ressource
**'''description:''' Kurze Beschreibung der Ressource
**'''type:''' Typ der Ressource. Möglichkeiten sind: "gamemode", "script", "map" oder "misc"
*'''<script />''' Skriptdateien für diese Ressource, mögliche Attribute sind:
**'''src:''' Pfad zum Skript
**'''type:''' Typ: "client" oder "server"
**'''cache:''' Funktioniert nur bei Clientseitigen Scripts. Standard Wert ist "true". Bei "false" wird die Datei nicht auf der Festplatte gespeichert
**'''validate:''' Wenn "false" wird das Script nicht auf Kompatibilität geprüft.
*'''<map />''' Map für den Gamemode. Möglich ist:
**'''src:''' Pfad zur .map Datei
**'''dimension:''' Dimension, in der die Map erstellt wird
*'''<file />''' Datei: Häufig Bilder, .txd, .col, .dff oder .xml Dateien. Sie werden gedownloadet, sobald ein Spieler den Server betritt.
**'''src:''' Pfad zur Datei
**'''download:''' wird in Version 1.4 eingeführt und gibt an, ob eine Datei beim Ressourcenstart heruntergeladen werden soll
*'''<include />''' Ressource einbringen, welche diese Ressource benutzen wird
**'''resource:''' Die Resource die Inkludiert werden soll
**'''minversion:''' Minimale Version
**'''maxversion:''' Maximale Version
*'''<config />''' Konfigurationsdatei (.xml), möglich sind:
**'''src:''' Dateiname der Konfigurationsdatei
**'''type:''' Typ der Konfigurationsdatei: "client" oder "server"
*'''<export />''' Export von Funktionen dieser Ressource. Andere Resourcen können dadurch Zugriff erlangen.
**'''function:''' Funktionsname
**'''http:''' Kann die Ressource via HTTP geöffnet werden? (true/false)
*'''<html />'''
**'''src:''' Dateiname für die HTML Datei (kann ein Pfad sein)
**'''default:''' Standard HTMl-Datei, welche durch den Besuch von /resourceName/ geöffnet wird. Nur eine Datei kann als ''default'' markiert werden (true/false)
**'''raw:''' Gibt an, ob eine Datei nicht vom Lua-Interpreter analysiert und als binäre Datei verwendet werden soll. Dieses Attribut wird vor allem für Bilder benutzt (true/false)
*'''<settings>''' <setting name="" value=""/> </settings>: Viele Spielmodi benutzen diese Option, um Einstellungen, die leicht geändert werden können, festzulegen
*'''<min_mta_version />''' Minimale MTA Version
**'''client:''' Minimale Client Version
**'''server:''' Minimale Server Version
*'''<aclrequest />''' Eine Liste mit [[Access_Control_List|ACL]] Rechten, die die Ressource braucht
{{New items|3.0139|1.3.1 r4141|
*'''<sync_map_element_data />''' Sollen [[Element_data|Element Datas]] wie "PosX" und "DoubleSided" mit dem Client synchronisiert werden? Diese Einstellung ist für die meisten Ressourcen nicht von Bedeutung. (Eine erwähnenswerte Ressource ist der Map Editor). Diese Einstellung bezieht sich auf alle Maps der Ressource.
**'''false:''' Deaktiviert die Übertragung der Element Datas. Dies kann die Downloadzeit erheblich verkürzen.
**'''true:''' Aktiviert die Übertragung der Element Datas (Standard)
}}

== Beispiel ==
{{#tag:code |
<meta>
<info author="Slothman" type="gamemode" name="Stealth" />
<config src="help.xml" type="client"/>
<min_mta_version client="{{Current Version|full}}" server="{{Current Version|full}}" />
<sync_map_element_data>false</sync_map_element_data>

<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"/>
<script src="riemann_z_demonstration.lua" type="client"/>

<file src="riot_shield.txd" />
<file src="riot_shield.dff" />
<file src="riot_shield.col" />
<file src="armor.png" download="true"/>
<file src="camera.png" download="false"/>
<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]" />
<setting name="isAllowedToShoot" value="true" />
</settings>

<aclrequest>
<right name="function.startResource" access="true" />
<right name="function.stopResource" access="true" />
<right name="function.setPlayerMuted" access="true" />
</aclrequest>

</meta>
|lang="xml"}}

[[Category:DE/Skripting Konzepte]]

[[cs:Meta.xml]]
[[en:Meta.xml]]
[[es:Sobre el archivo "meta.xml"]]
[[it:Meta.xml]]
[[pl:Meta.xml]]
[[ru:Meta.xml]]

DE/Meta.xml

2014-12-06T23:52:48Z

Soner Sayakci: /* Tags */

Die ''meta.xml'' gibt MTA Informationen über die Resource. Beispiele dafür sind Ressourcenname, eingebundene Scripts und Dateien wie Grafiken und ähnliches. Benutzt wird hier die Auszeichnungssprache [http://de.wikipedia.org/wiki/XML XML].

== Tags ==
Folgende XML-Tags können verwenden werden:
*'''<info />''' Information über die Ressource (können via [[getResourceInfo]] eingelesen werden):
**'''author:''' Der Autor der Ressource
**'''version:''' Version der Ressource
**'''name:''' Name der Ressource
**'''description:''' Kurze Beschreibung der Ressource
**'''type:''' Typ der Ressource. Möglichkeiten sind: "gamemode", "script", "map" oder "misc"
*'''<script />''' Skriptdateien für diese Ressource, mögliche Attribute sind:
**'''src:''' Pfad zum Skript
**'''type:''' Typ: "client" oder "server"
**'''cache:''' Funktioniert nur bei Clientseitigen Scripts. Standard Wert ist "true". Bei "false" wird die Datei nicht auf der Festplatte gespeichert
**'''validate:''' Wenn "false" wird das Script nicht auf Kompatibilität geprüft.
*'''<map />''' Map für den Gamemode. Möglich ist:
**'''src:''' Pfad zur .map Datei
**'''dimension:''' Dimension, in der die Map erstellt wird
*'''<file />''' Datei: Häufig Bilder, .txd, .col, .dff oder .xml Dateien. Sie werden gedownloadet, sobald ein Spieler den Server betritt.
**'''src:''' Pfad zur Datei
**'''download:''' wird in Version 1.4 eingeführt und gibt an, ob eine Datei beim Ressourcenstart heruntergeladen werden soll
*'''<include />''' Ressource einbringen, welche diese Ressource benutzen wird
**'''minversion:''' Minimale Version
**'''maxversion:''' Maximale Version
*'''<config />''' Konfigurationsdatei (.xml), möglich sind:
**'''src:''' Dateiname der Konfigurationsdatei
**'''type:''' Typ der Konfigurationsdatei: "client" oder "server"
*'''<export />''' Export von Funktionen dieser Ressource. Andere Resourcen können dadurch Zugriff erlangen.
**'''function:''' Funktionsname
**'''http:''' Kann die Ressource via HTTP geöffnet werden? (true/false)
*'''<html />'''
**'''src:''' Dateiname für die HTML Datei (kann ein Pfad sein)
**'''default:''' Standard HTMl-Datei, welche durch den Besuch von /resourceName/ geöffnet wird. Nur eine Datei kann als ''default'' markiert werden (true/false)
**'''raw:''' Gibt an, ob eine Datei nicht vom Lua-Interpreter analysiert und als binäre Datei verwendet werden soll. Dieses Attribut wird vor allem für Bilder benutzt (true/false)
*'''<settings>''' <setting name="" value=""/> </settings>: Viele Spielmodi benutzen diese Option, um Einstellungen, die leicht geändert werden können, festzulegen
*'''<min_mta_version />''' Minimale MTA Version
**'''client:''' Minimale Client Version
**'''server:''' Minimale Server Version
*'''<aclrequest />''' Eine Liste mit [[Access_Control_List|ACL]] Rechten, die die Ressource braucht
{{New items|3.0139|1.3.1 r4141|
*'''<sync_map_element_data />''' Sollen [[Element_data|Element Datas]] wie "PosX" und "DoubleSided" mit dem Client synchronisiert werden? Diese Einstellung ist für die meisten Ressourcen nicht von Bedeutung. (Eine erwähnenswerte Ressource ist der Map Editor). Diese Einstellung bezieht sich auf alle Maps der Ressource.
**'''false:''' Deaktiviert die Übertragung der Element Datas. Dies kann die Downloadzeit erheblich verkürzen.
**'''true:''' Aktiviert die Übertragung der Element Datas (Standard)
}}

== Beispiel ==
{{#tag:code |
<meta>
<info author="Slothman" type="gamemode" name="Stealth" />
<config src="help.xml" type="client"/>
<min_mta_version client="{{Current Version|full}}" server="{{Current Version|full}}" />
<sync_map_element_data>false</sync_map_element_data>

<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"/>
<script src="riemann_z_demonstration.lua" type="client"/>

<file src="riot_shield.txd" />
<file src="riot_shield.dff" />
<file src="riot_shield.col" />
<file src="armor.png" download="true"/>
<file src="camera.png" download="false"/>
<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]" />
<setting name="isAllowedToShoot" value="true" />
</settings>

<aclrequest>
<right name="function.startResource" access="true" />
<right name="function.stopResource" access="true" />
<right name="function.setPlayerMuted" access="true" />
</aclrequest>

</meta>
|lang="xml"}}

[[Category:DE/Skripting Konzepte]]

[[cs:Meta.xml]]
[[en:Meta.xml]]
[[es:Sobre el archivo "meta.xml"]]
[[it:Meta.xml]]
[[pl:Meta.xml]]
[[ru:Meta.xml]]

SetBanReason

2014-07-23T15:18:57Z

Soner Sayakci: /* Example */

__NOTOC__
{{Server function}}
{{New items|4.0132|1.4|
This function set a new reason in the [[ban]].
}}

==Syntax==
<syntaxhighlight lang="lua">
bool setBanReason( ban theBan, string theReason )
</syntaxhighlight>

===Required Arguments===
*'''theBan:''' The [[ban]] in which you wish to retrieve the username of.
*'''theReason:''' the new reason (max 60 characters)

===Returns===
Returns ''true'' when is changed, ''false'' otherwise.

==Example==
<syntaxhighlight lang="lua">
function setreason (player,cmd,name,...)
local reason = table.concat({...}," ")
if name and reason then
local bans = getBans()
for i,v in ipairs(bans)do
if getBanNick(v) == name then
setBanReason(v,reason)
outputChatBox("Successfully edited the new Ban Reason.",player,0,125,0)
end
end
end
end
addCommandHandler("setreason",setreason)
</syntaxhighlight>

==See Also==
{{Admin_functions}}

SetBanReason

2014-07-23T15:17:49Z

Soner Sayakci:

__NOTOC__
{{Server function}}
{{New items|4.0132|1.4|
This function set a new reason in the [[ban]].
}}

==Syntax==
<syntaxhighlight lang="lua">
bool setBanReason( ban theBan, string theReason )
</syntaxhighlight>

===Required Arguments===
*'''theBan:''' The [[ban]] in which you wish to retrieve the username of.
*'''theReason:''' the new reason (max 60 characters)

===Returns===
Returns ''true'' when is changed, ''false'' otherwise.

==Example==
<syntaxhighlight lang="lua">
function setreason (player,cmd,name,...)
local reason = table.concat({...}," ")
if name and reason then
local bans = getBans()
for i,v in ipairs(bans)do
if getBanNick(v) == name then
setBanReason(v,reason)
outputChatBox("Successfully edited the new Ban Reason.")
end
end
end
end
addCommandHandler("setreason",setreason)
</syntaxhighlight>

==See Also==
{{Admin_functions}}

SetUnbanTime

2014-07-23T15:07:43Z

Soner Sayakci: Created page with "__NOTOC__ {{Server function}} {{Needs_Example}} {{New items|4.0132|1.4| This function set a new unbantime to ban. }} ==Syntax== <syntaxhighlight lang="lua"> bool setUnbanTime( ban th..."

__NOTOC__
{{Server function}}
{{Needs_Example}}
{{New items|4.0132|1.4|
This function set a new unbantime to [[ban]].
}}

==Syntax==
<syntaxhighlight lang="lua">
bool setUnbanTime( ban theBan, int theTime )
</syntaxhighlight>

===Required Arguments===
*'''theBan:''' The [[ban]] in which you wish to retrieve the username of.
*'''theTime:''' the new unban time

===Returns===
Returns ''true'' when is changed, ''false'' otherwise.

==Example==
<syntaxhighlight lang="lua">
--TODO
</syntaxhighlight>

==See Also==
{{Admin_functions}}

SetBanReason

2014-07-23T14:59:50Z

Soner Sayakci: Created page with "__NOTOC__ {{Server function}} {{Needs_Example}} {{New items|4.0132|1.4| This function set a new reason in the ban. }} ==Syntax== <syntaxhighlight lang="lua"> bool setBanReason( ban t..."

__NOTOC__
{{Server function}}
{{Needs_Example}}
{{New items|4.0132|1.4|
This function set a new reason in the [[ban]].
}}

==Syntax==
<syntaxhighlight lang="lua">
bool setBanReason( ban theBan, string theReason )
</syntaxhighlight>

===Required Arguments===
*'''theBan:''' The [[ban]] in which you wish to retrieve the username of.
*'''theReason:''' the new reason (max 60 characters)

===Returns===
Returns ''true'' when is changed, ''false'' otherwise.

==Example==
<syntaxhighlight lang="lua">
--TODO
</syntaxhighlight>

==See Also==
{{Admin_functions}}

SetBanAdmin

2014-07-23T14:58:01Z

Soner Sayakci: /* Required Arguments */

__NOTOC__
{{Server function}}
{{Needs_Example}}
{{New items|4.0132|1.4|
This function set a new Admin in the [[ban]].
}}

==Syntax==
<syntaxhighlight lang="lua">
bool setBanAdmin ( ban theBan, string theAdmin )
</syntaxhighlight>

===Required Arguments===
*'''theBan:''' The [[ban]] in which you wish to retrieve the username of.
*'''theAdmin:''' the new admin name

===Returns===
Returns ''true'' when is changed, ''false'' otherwise.

==Example==
<syntaxhighlight lang="lua">
--TODO
</syntaxhighlight>

==See Also==
{{Admin_functions}}

SetBanAdmin

2014-07-23T14:54:33Z

Soner Sayakci: Created page with "__NOTOC__ {{Server function}} {{Needs_Example}} {{New items|4.0132|1.4| This function set a new Admin in the ban. }} ==Syntax== <syntaxhighlight lang="lua"> bool setBanAdmin ( ban th..."

__NOTOC__
{{Server function}}
{{Needs_Example}}
{{New items|4.0132|1.4|
This function set a new Admin in the [[ban]].
}}

==Syntax==
<syntaxhighlight lang="lua">
bool setBanAdmin ( ban theBan, string theAdmin )
</syntaxhighlight>

===Required Arguments===
*'''theBan:''' The [[ban]] in which you wish to retrieve the username of.
*'''theBan:''' the new Admin name

===Returns===
Returns ''true'' when is changed, ''false'' otherwise.

==Example==
<syntaxhighlight lang="lua">
--TODO
</syntaxhighlight>

==See Also==
{{Admin_functions}}

KickPlayer

2013-10-08T13:37:22Z

Soner Sayakci: Undo revision 37282 by Soner Sayakci (talk)

{{Server function}}
__NOTOC__
This function will kick the specified player from the server.

==Syntax==
<syntaxhighlight lang="lua">
bool kickPlayer ( player kickedPlayer, [ player responsiblePlayer, string reason = "" ] )
</syntaxhighlight>
''or''
<syntaxhighlight lang="lua">
bool kickPlayer ( player kickedPlayer, [ string reason = "" ] )
</syntaxhighlight>

===Required Arguments===
*'''kickedPlayer:''' The player that will be kicked from the server

===Optional Arguments===
*'''responsiblePlayer:''' The player that is responsible for the event. '''Note''': If left out as in the second syntax, responsible player for the kick will be "Console" (Maximum 30 characters if using a string).
*'''reason:''' The reason for the kick. (Maximum 64 characters)

===Returns===
Returns ''true'' if the player was kicked succesfully, ''false'' if invalid arguments are specified.

==Example==
This example lets a player kick anyone who has a lower level.
<syntaxhighlight lang="lua">
function kickPlayerHandler ( sourcePlayer, commandname, kickedname, reason )
-- Get player element from the name
local kicked = getPlayerFromName ( kickedname )
-- If the client who sent the command has a higher level
if ( hasObjectPermissionTo ( sourcePlayer, "function.kickPlayer" ) ) then
-- Kick the player
kickPlayer ( kicked, sourcePlayer, reason )
end
end
-- Add the "kick" command handler
addCommandHandler ( "kick", kickPlayerHandler )
</syntaxhighlight>

==See Also==
{{Admin_functions}}
[[es:kickPlayer]]
[[ru:kickPlayer]]

KickPlayer

2013-10-08T13:36:34Z

Soner Sayakci: Undo revision 36992 by Soner Sayakci (talk)

{{Server function}}
__NOTOC__
This function will kick the specified player from the server.

==Syntax==
<syntaxhighlight lang="lua">
bool kickPlayer ( player kickedPlayer, [ player responsiblePlayer, string reason = "" ] )
</syntaxhighlight>
''or''
<syntaxhighlight lang="lua">
bool kickPlayer ( player kickedPlayer, [ string reason = "" ] )
</syntaxhighlight>

===Required Arguments===
*'''kickedPlayer:''' The player that will be kicked from the server

===Optional Arguments===
*'''responsiblePlayer:''' The player that is responsible for the event. '''Note''': If left out as in the second syntax, responsible player for the kick will be "Console" (Maximum 30 characters if using a string).
*'''reason:''' The reason for the kick.

===Returns===
Returns ''true'' if the player was kicked succesfully, ''false'' if invalid arguments are specified.

==Example==
This example lets a player kick anyone who has a lower level.
<syntaxhighlight lang="lua">
function kickPlayerHandler ( sourcePlayer, commandname, kickedname, reason )
-- Get player element from the name
local kicked = getPlayerFromName ( kickedname )
-- If the client who sent the command has a higher level
if ( hasObjectPermissionTo ( sourcePlayer, "function.kickPlayer" ) ) then
-- Kick the player
kickPlayer ( kicked, sourcePlayer, reason )
end
end
-- Add the "kick" command handler
addCommandHandler ( "kick", kickPlayerHandler )
</syntaxhighlight>

==See Also==
{{Admin_functions}}
[[es:kickPlayer]]
[[ru:kickPlayer]]

KickPlayer

2013-08-27T14:42:27Z

Soner Sayakci: /* Optional Arguments */

OnPlayerWasted

2013-08-14T00:17:20Z

Soner Sayakci: /* Example */

__NOTOC__
{{Server event}}
This event is triggered when a player is killed or dies.

==Parameters==
{{New feature/item|3|1.0||<syntaxhighlight lang="lua">
element killer, int killerWeapon, int bodypart [, bool stealth ]
</syntaxhighlight>}}

{{Deprecated_feature|3|1.0|<syntaxhighlight lang="lua">
int totalAmmo, element killer, int killerWeapon, int bodypart
</syntaxhighlight>}}

*'''killer''': an [[element]] representing the player or vehicle who was the killer. If there was no killer this is ''false''.
*'''killerWeapon''': an integer representing the [[Weapons|killer weapon]] or the [[Death Reasons|death reason]].
*'''bodypart''': an integer representing the bodypart ID the victim was hit on when he died.
{{BodyParts}}
*{{New feature/item|3|1.0||'''stealth''': boolean value representing whether or not this was a stealth kill}}

==Source==
The [[event system#Event source|source]] of this event is the [[player]] that died or got killed.

==Example==
This example prints the killer and bodypart to the chat when a player dies.
<syntaxhighlight lang="lua">
-- register player_Wasted as a handler for onPlayerWasted
function player_Wasted ( attacker, weapon, bodypart )
-- if there was an attacker
if ( attacker ) then
-- we declare our variable outside the following checks
local tempString
-- if the element that killed him was a player,
if ( getElementType ( attacker ) == "player" ) then
-- put the attacker, victim and weapon info in the string
tempString = getPlayerName ( attacker ).." killed "..getPlayerName ( source ).." ("..getWeaponNameFromID ( weapon )..")"
-- else, if it was a vehicle,
elseif ( getElementType ( attacker ) == "vehicle" ) then
-- we'll get the name from the attacker vehicle's driver
local tempString = getPlayerName ( getVehicleController ( attacker ) ).." killed "..getPlayerName ( source ).." ("..getWeaponNameFromID ( weapon )..")"
end
-- if the victim was shot in the head, append a special message
if ( bodypart == 9 ) then
tempString = tempString.." (HEADSHOT!)"
-- else, just append the bodypart name
else
tempString = tempString.." ("..getBodyPartName ( bodypart )..")"
end
-- display the message
outputChatBox ( tempString )
-- if there was no attacker,
else
-- output a death message without attacker info
outputChatBox ( getPlayerName ( source ).." died. ("..getWeaponNameFromID ( weapon )..") ("..getBodyPartName ( bodypart )..")" )
end
end
addEventHandler ( "onPlayerWasted", getRootElement(), player_Wasted )
</syntaxhighlight>

And another example, this will spawn you in the middle of GTA SA world (x=0, y=0, z=3) after 2 seconds of your death
<syntaxhighlight lang="lua">
addEventHandler( "onPlayerWasted", getRootElement( ),
function()
setTimer( spawnPlayer, 2000, 1, source, 0, 0, 3 )
end
)
</syntaxhighlight>

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

OnPlayerWasted

2013-08-14T00:17:04Z

Soner Sayakci: /* Parameters */

__NOTOC__
{{Server event}}
This event is triggered when a player is killed or dies.

==Parameters==
{{New feature/item|3|1.0||<syntaxhighlight lang="lua">
element killer, int killerWeapon, int bodypart [, bool stealth ]
</syntaxhighlight>}}

{{Deprecated_feature|3|1.0|<syntaxhighlight lang="lua">
int totalAmmo, element killer, int killerWeapon, int bodypart
</syntaxhighlight>}}

*'''killer''': an [[element]] representing the player or vehicle who was the killer. If there was no killer this is ''false''.
*'''killerWeapon''': an integer representing the [[Weapons|killer weapon]] or the [[Death Reasons|death reason]].
*'''bodypart''': an integer representing the bodypart ID the victim was hit on when he died.
{{BodyParts}}
*{{New feature/item|3|1.0||'''stealth''': boolean value representing whether or not this was a stealth kill}}

==Source==
The [[event system#Event source|source]] of this event is the [[player]] that died or got killed.

==Example==
This example prints the killer and bodypart to the chat when a player dies.
<syntaxhighlight lang="lua">
-- register player_Wasted as a handler for onPlayerWasted
function player_Wasted ( ammo, attacker, weapon, bodypart )
-- if there was an attacker
if ( attacker ) then
-- we declare our variable outside the following checks
local tempString
-- if the element that killed him was a player,
if ( getElementType ( attacker ) == "player" ) then
-- put the attacker, victim and weapon info in the string
tempString = getPlayerName ( attacker ).." killed "..getPlayerName ( source ).." ("..getWeaponNameFromID ( weapon )..")"
-- else, if it was a vehicle,
elseif ( getElementType ( attacker ) == "vehicle" ) then
-- we'll get the name from the attacker vehicle's driver
local tempString = getPlayerName ( getVehicleController ( attacker ) ).." killed "..getPlayerName ( source ).." ("..getWeaponNameFromID ( weapon )..")"
end
-- if the victim was shot in the head, append a special message
if ( bodypart == 9 ) then
tempString = tempString.." (HEADSHOT!)"
-- else, just append the bodypart name
else
tempString = tempString.." ("..getBodyPartName ( bodypart )..")"
end
-- display the message
outputChatBox ( tempString )
-- if there was no attacker,
else
-- output a death message without attacker info
outputChatBox ( getPlayerName ( source ).." died. ("..getWeaponNameFromID ( weapon )..") ("..getBodyPartName ( bodypart )..")" )
end
end
addEventHandler ( "onPlayerWasted", getRootElement(), player_Wasted )
</syntaxhighlight>

And another example, this will spawn you in the middle of GTA SA world (x=0, y=0, z=3) after 2 seconds of your death
<syntaxhighlight lang="lua">
addEventHandler( "onPlayerWasted", getRootElement( ),
function()
setTimer( spawnPlayer, 2000, 1, source, 0, 0, 3 )
end
)
</syntaxhighlight>

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

DE/playSound

2013-08-07T13:58:30Z

Soner Sayakci: /* Beispiel: */

__NOTOC__
{{DE/Client function}}
Spielt einen gewünschten Sound beim Clienten ab. Funktioniert auch beim Streamen.
'''Erlaubte Formate''': MP3, WAV, OGG, RIFF, MOD, XM, IT and S3M.

== Syntax ==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
bool playSound( float file, bool delay )
</syntaxhighlight>

===Benötigte Argumente:===
*'''file:''': Pfad zur wiedergebenden Datei
*'''delay:''' ''true'' wenn der Sound wiederholt werden soll, ''false'' wenn nicht

</section>
===Rückgaben===
Gibt ''true'' zurück, wenn der Sound erfolgreich abgespielt wurde. ''false'', wenn nicht.

== Beispiel: ==

<section name="Client" class="client" show="true">
Sobald der Spieler joint wird ein Stream gestartet zu Technobase
<syntaxhighlight lang="lua">
addEventHandler("onClientPlayerJoin", getRootElement(), function()
if source == getLocalPlayer() then
local sound = playSound("http://technobase.com/wave.mp3", false)
end
end)
</syntaxhighlight>
</section>

EngineRestoreModel

2013-01-15T13:42:40Z

Soner Sayakci:

__NOTOC__
{{Client function}}

This function restores the visual DFF and TXD model of the given model ID. This restores the result of [[engineReplaceModel]].

==Syntax==

<syntaxhighlight lang="lua">
bool engineRestoreModel ( int modelID )
</syntaxhighlight>

===Required Arguments===

*'''modelID:''' The model ID to restore the visuals of

===Returns===

Returns ''true'' if the model was successfully restored, ''false'' or ''nil'' if it failed for some reason.

==Example==


<section name="Client" class="client" show="true">
Client-Side example for restoring model / vehicle.
<syntaxhighlight lang="lua">
function ResetModel ( )
engineRestoreModel ( 587 ) -- Object / Vehicle to restore to default GTA one.
end

addEvent ( "restoreClientModel", true )
addEventHandler ( "restoreClientModel", getRootElement(), ResetModel )
</syntaxhighlight>
</section>

<section name="Server" class="server" show="true">
Server-Side example for triggering model / vehicle restore function with "restore" command.
<syntaxhighlight lang="lua">
function RestoreModel ( )
triggerClientEvent ( "restoreClientModel", getRootElement(), restoreClientModel )
end
addCommandHandler( "restore", RestoreModel )
</syntaxhighlight>
</section>

==See Also==

{{Engine_functions}}