View source for DE/createVehicle

__NOTOC__
{{DE/Server client function}}
{{note_box|Fahrzeuge und andere Elemente, die clientseitig erstellt werden, können nur von dem Client gesehen werden, der sie erstellt hat. Andere Spieler sehen sie nicht, und können nicht mit ihnen interagieren.}}
Diese Funktion erstellt ein Fahrzeug an den übergebenden Koordinaten.

==Syntax==
<syntaxhighlight lang="lua">
vehicle createVehicle ( int model, float x, float y, float z [, float rx, float ry, float rz, string nummernschild, bool bDirection, int variant1, int variant2 ] )
</syntaxhighlight>

===Benötigte Argumente===
* '''model''': Die Modell-ID, mit der das Auto erstellt werden soll
* '''x:''' Eine Fließkommazahl, welche die X Koordinate in der Karte darstellt.
* '''y:''' Eine Fließkommazahl, welche die Y Koordinate in der Karte darstellt.
* '''z:''' Eine Fließkommazahl, welche die Z Koordinate in der Karte darstellt.

===Optionale Argumente===
{{OptionalArg}}
*'''rx:''' Eine Fließkommazahl, welche die Rotation an der X Axe darstellt.
*'''ry:''' Eine Fließkommazahl, welche die Rotation an der Y Axe darstellt.
*'''rz:''' Eine Fließkommazahl, welche die Rotation an der Z Axe darstellt.
* '''nummernschild''': Ein [[DE/String|String]], der das Nummernschild angibt (maximal 8 Zeichen). Die Funktion kann nur für Autos verwendet werden.
* '''direction''': Ein [[DE/Bool|Boolean]], das auf ''false'' gesetzt werden sollte. *NUR SERVER*
* '''variant1''': Ein [[DE/Int|Integer]] für die 1. Variante des Fahrzeugs. [[Vehicle variants]]
* '''variant2''': Ein [[DE/Int|Integer]] für die 2. Variante des Fahrzeugs. [[Vehicle variants]]

===Returns===
Gibt das erstellte [[DE/vehicle|Fahrzeug]] Element zurück. ''false'', wenn die Argumente falsch sind oder das Fahrzeuglimit von 65535 Fahrzeugen erreicht wurde.

==Benutzung von Zügen==
Züge werden mit der Funktion createVehicle erstellt. Sie werden auf der am nächsten liegenden GTA:SA-Zugstrecke platziert.

==Beispiel==
<section name="Example 1: Server" class="server" show="true">
Dieses Script spawnt einen Rhino auf einem zufälligen Spieler. 
<syntaxhighlight lang="lua">
function scriptCreateTank ( player, command )
      local luckyBugger = getRandomPlayer() -- Zufaelliger Spieler
      local x, y, z = getElementPosition ( luckyBugger ) -- Die Position des Spielers
      createVehicle ( 432, x, y, z + 10 ) -- Erstellt den Panzer, 10 Einheiten ueber den Spieler
      outputChatBox ( "Du wurdest gepanzert!", luckyBugger )
end
--Erstellt ein Command fuer die Funktion
addCommandHandler ( "tank", scriptCreateTank )
</syntaxhighlight>
</section>

==Siehe auch==
{{DE/Vehicle_functions}}

[[en:createVehicle]]