Talk:CreateMarker

2008-01-19T07:06:17Z

Kheprafish:

Is there a way to set the rotation of a marker?--[[User:Kheprafish|Kheprafish]] 12:44, 18 January 2008 (CST)
:Markers don't have a rotation... You might be thinking of [[setMarkerTarget]]... [[User:EAi|eAi]] 13:13, 18 January 2008 (CST)
::Ah, thanks. It just seems a little strange to orient ring markers this way--[[User:Kheprafish|Kheprafish]] 01:06, 19 January 2008 (CST)

Talk:CreateMarker

2008-01-18T18:44:48Z

Kheprafish: New page: Is there a way to set the rotation of a marker?--~~~~

Is there a way to set the rotation of a marker?--[[User:Kheprafish|Kheprafish]] 12:44, 18 January 2008 (CST)

GetVehicleCompatibleUpgrades

2008-01-14T23:56:53Z

Kheprafish: fix eventHandler code

__NOTOC__
{{Needs Checking| Are all vehicle updates listed? I didn't see wheel updates in the list for instance.}}
{{Server client function}}
This function returns a table of all the compatible upgrades (or all for a specified slot, optionally) for a specifed vehicle.

==Syntax==
<syntaxhighlight lang="lua">
table getVehicleCompatibleUpgrades ( vehicle theVehicle, [int slot] )
</syntaxhighlight>

===Required Arguments===
*'''theVehicle:''' The [[vehicle]] you wish to retrieve the list of compatible upgrades of.

===Optional Arguments===
*'''slot:''' The upgrade slot number for which you're getting the list (from 0 to 16). Compatible upgrades for all slots are listed if this is not specified.

===Returns===
Returns a ''table'' with all the compatible upgrades, or ''false'' if invalid arguments are passed.

==Example==
This example displays a list of all the compatible upgrades for a vehicle when you enter it.
<syntaxhighlight lang="lua">
function scriptOnPlayerEnterVehicle ( invehicle, seat, jacked )
local upgrades = getVehicleCompatibleUpgrades ( invehicle )
for upgradeKey, upgradeValue in ipairs ( upgrades ) do
outputChatBox ( getVehicleUpgradeSlotName ( upgradeValue ) .. ": " .. upgradeValue )
end
end
addEventHandler ( "onPlayerVehicleEnter", getRootElement(), scriptOnPlayerEnterVehicle )
</syntaxhighlight>

==See Also==
{{Vehicle functions}}

CreateVehicle

2008-01-14T09:01:17Z

Kheprafish: /* Example */

__NOTOC__
{{Server client function}}
This function creates a vehicle at the specified location.

Its worth noting that the position of the vehicle is the center point of the vehicle, not its base. As such, you need to ensure that the z value (vertical axis) is some height above the ground. You can find the exact height using the client side function [[getElementDistanceFromCentreOfMassToBaseOfModel]], or you can estimate it yourself and just spawn the vehicle so it drops to the ground.

'''Important Note:''' Vehicles created client side are only seen by the client that creates, them, aren't synced and players cannot enter them. They are essentially for display only.

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

===Required Arguments===
* '''model''': The [[Vehicle IDs|vehicle ID]] of the vehicle being created.
* '''x''': A floating point number representing the X coordinate on the map.
* '''y''': A floating point number representing the Y coordinate on the map.
* '''z''': A floating point number representing the Z coordinate on the map.

===Optional Arguments===
{{OptionalArg}}
* '''rx''': A floating point number representing the rotation about the X axis in degrees.
* '''ry''': A floating point number representing the rotation about the Y axis in degrees.
* '''rz''': A floating point number representing the rotation about the Z axis in degrees.
* '''numberplate''': A string that will go on the number plate of the car (max 8 characters). This is only applicable to [[cars]].

===Returns===
Returns the [[vehicle]] element that was created. Returns ''false'' if the arguments are incorrect, or if the vehicle limit of 65535 is exceeded.

==Using trains==
Trains are created using the createVehicle function. They are placed at the nearest point of the GTASA train pathing (railroad tracks) from their spawning point.

==Example==
<section name="Example 1" class="server" show="true">
This script spawns a Rhino on top of one lucky individual.
<syntaxhighlight lang="lua">
function scriptCreateTank ( player, command )
local luckyBugger = getRandomPlayer() -- get a random player
local x, y, z = getElementPosition ( luckyBugger ) -- retrive the player's position
createVehicle ( 432, x, y, z + 10 ) -- create the tank 10 units above them
outputChatBox ( "You got Tank'd!", luckyBugger )
end
--Attach the 'scriptCreateTank' function to the "tank" command
addCommandHandler ( "tank", scriptCreateTank )
</syntaxhighlight>
</section>

<section name="Example 2" class="client" show="true">
This script spawns a Rhino on top of the local player.
<syntaxhighlight lang="lua">
function scriptCreateTank ( commandName )
local luckyBugger = getLocalPlayer() -- get the local player
local x, y, z = getElementPosition ( luckyBugger ) -- retrive the player's position
createVehicle ( 432, x, y, z + 10 ) -- create the tank 10 units above them
outputChatBox ( "You got Tank'd!", luckyBugger )
end
--Attach the 'scriptCreateTank' function to the "tank" command
addCommandHandler ( "tank", scriptCreateTank )
</syntaxhighlight>
</section>

<section name="Example 3" class="server" show="true">
This example creates a vehicle five units to the right of a player when they type ''createvehicle'' and its name in the console:
<syntaxhighlight lang="lua">
local distance = 5 --units

-- define our handler (we'll take a variable number of parameters where the name goes, because there are vehicle names with more than one word)
function consoleCreateVehicle ( sourcePlayer, commandName, ... )
-- if a player triggered it, not the admin,
if ( sourcePlayer ) then
-- calculate the position of the vehicle based on the player's position and rotation:
local x, y, z = getElementPosition ( sourcePlayer ) -- get the player's position
local rotZ = getPlayerRotation ( sourcePlayer ) -- get the player's rotation around the Z axis in degrees
x = x + ( ( math.cos ( math.rad ( rotZ ) ) ) * distance ) -- calculate the X position of the vehicle
y = y + ( ( math.sin ( math.rad ( rotZ ) ) ) * distance ) -- calculate the Y position of the vehicle

-- get the complete vehicle name by joining all passed parameters using Lua function table.concat
local vehicleName = table.concat({...}, " ")
-- get the vehicle's model ID from the name
local vehicleID = getVehicleIDFromName ( vehicleName )
-- if vehicle ID is valid,
if vehicleID then
-- create the vehicle using the information gathered above:
local newVehicle = createVehicle ( vehicleID, x, y, z, 0, 0, rotZ )
-- if vehicle creation failed, give the player a message
if ( newVehicle == false ) then
outputConsole ( "Failed to create vehicle.", sourcePlayer )
end
end
end
end

-- Attach the 'consoleCreateVehicle' function to the "createvehicle" command
addCommandHandler ( "createvehicle", consoleCreateVehicle )
</syntaxhighlight>
</section>

==See Also==
{{IDs}}

{{Vehicle functions}}

Multi Theft Auto: Wiki - User contributions [en]

Talk:CreateMarker

Talk:CreateMarker

GetVehicleCompatibleUpgrades

CreateVehicle