GetVehicleIDFromName: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (Disgrace. Removed quotes in command handler.)
m (Visual improvement)
 
(4 intermediate revisions by 4 users not shown)
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{server client function}}
{{server client function}}
{{Deprecated|getVehicleModelFromName}}
This function retrieves the ID of a vehicle as an integer value from its name.
This function retrieves the ID of a vehicle as an integer value from its name.


Line 13: Line 15:
===Returns===
===Returns===
Returns an [[int]] if the name exists, ''false'' otherwise.
Returns an [[int]] if the name exists, ''false'' otherwise.
If you use this function on vehicles with shared names, such as "police", it will return the earliest occurrence of that vehicle's ID.


==Example==  
==Example==  
This will allow the player to create a vehicle by name and it's ID will be displayed in the chatbox when the vehicle is spawned.
This will allow the player to create a vehicle by name and it's ID will be displayed in the chatbox when the vehicle is spawned.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function createvehiclecommand ( player, commandName, carname )
function createvehiclecommand ( sourcePlayer, commandName, carname )
--This function is triggered by the text "spawnvehicle" in the console.
-- This function is triggered by the text "spawnvehicle" in the console.
--The player must also specify the added varible carname to specify
-- The player must specify the added parameter 'carname' to specify
--what car they wish to spawn.
-- what car they wish to spawn.
carid = getVehicleIDFromName ( carname )
local carid = getVehicleIDFromName ( carname )
--Get the ID of the car the player asked for and store it to the
-- Get the ID of the car the player asked for and store it to the
--varible 'carid'
-- variable 'carid'
local x, y, z = getElementPosition ( player )
local x, y, z = getElementPosition ( sourcePlayer )
--Get the position of the player to spawn the car near this location
-- Get the position of the player to spawn the car near this location
if carid == false then
if carid == false then
outputChatBox ( "That is not a valid car name" )
outputChatBox ( "That is not a valid car name" )
else
else
createVehicle ( carid, x + 5, y, z )
createVehicle ( carid, x + 5, y, z )
--Spawn the car using it's ID. Spawn it at x + 5 from the player so it doesn't crush him
-- Spawn the car using its ID. Spawn it at x + 5 from the player so it doesn't crush him
outputChatBox ( "A vehicle with an ID of "..carid.." was created!" )
outputChatBox ( "A vehicle with an ID of " .. carid .. " was created!" )
end
end
--If the entered car name returns no car ID, the string will be empty and false will be returned.
-- If the entered car name returns no car ID, the string will be empty and false will be returned.
--If the string does have any value, we create the car and announce the car ID in the chatbox,
-- If the string does have any value, we create the car and announce the car ID in the chatbox,
--because a car did exist under the given car name.
-- because a car did exist under the given car name.
end
end
addCommandHandler ( "spawnvehicle", createvehiclecommand )
addCommandHandler ( "spawnvehicle", createvehiclecommand )

Latest revision as of 11:29, 26 June 2014

Emblem-important.png This function is deprecated. This means that its use is discouraged and that it might not exist in future versions.

Please use getVehicleModelFromName instead.


This function retrieves the ID of a vehicle as an integer value from its name.

Syntax

int getVehicleIDFromName ( string name )             

Required Arguments

  • name: A string containing the name of the vehicle.

Returns

Returns an int if the name exists, false otherwise. If you use this function on vehicles with shared names, such as "police", it will return the earliest occurrence of that vehicle's ID.

Example

This will allow the player to create a vehicle by name and it's ID will be displayed in the chatbox when the vehicle is spawned.

function createvehiclecommand ( sourcePlayer, commandName, carname )
	-- This function is triggered by the text "spawnvehicle" in the console.
	-- The player must specify the added parameter 'carname' to specify
	-- what car they wish to spawn.
	local carid = getVehicleIDFromName ( carname )
	-- Get the ID of the car the player asked for and store it to the
	-- variable 'carid'
	local x, y, z = getElementPosition ( sourcePlayer )
	-- Get the position of the player to spawn the car near this location
	if carid == false then
		outputChatBox ( "That is not a valid car name" )
	else
		createVehicle ( carid, x + 5, y, z )
		-- Spawn the car using its ID. Spawn it at x + 5 from the player so it doesn't crush him
		outputChatBox ( "A vehicle with an ID of " .. carid .. " was created!" )
	end
	-- If the entered car name returns no car ID, the string will be empty and false will be returned.
	-- If the string does have any value, we create the car and announce the car ID in the chatbox,
	-- because a car did exist under the given car name.
end
addCommandHandler ( "spawnvehicle", createvehiclecommand )

See Also