SetVehicleNitroLevel: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "__NOTOC__ {{Client function}} {{New feature/item|4.0140|1.3.1|4993| This function set the nitro level to the vehicle. }} ==Syntax== <syntaxhighlight lang="lua">bool setVehicleNitroLevel ...")
 
(Fix typo.)
 
(14 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{Client function}}
{{Client function}}
{{New feature/item|4.0140|1.3.1|4993|
{{New feature/item|3.0131|1.3.1|4993|
This function set the nitro level to the [[vehicle]].
This function sets the nitro level of the [[vehicle]].
}}
}}
 
{{Warning|Only works if the vehicle is streamed in.}}
==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">bool setVehicleNitroLevel ( vehicle theVehicle, float level )</syntaxhighlight>  
<syntaxhighlight lang="lua">bool setVehicleNitroLevel ( vehicle theVehicle, float level )</syntaxhighlight>  


===Required Arguments===  
===Required Arguments===  
*'''theVehicle''' The [[vehicle]] which you want to set.
*'''theVehicle''' The [[vehicle]], which you want to set.
*'''level''' Nitro level you want to set [0.0-1.0].
*'''level''' Nitro level you want to set (ranges from 0.0001 to 1.0).


===Returns===
===Returns===
Line 16: Line 16:


==Example==
==Example==
<syntaxhighlight lang="lua">addEventHandler( 'onClientVehicleEnter', root,
<section name="Client" class="client" show="true">
function( pPlayer )
This function installs nitrous to the vehicle and sets the level of it to 0.1 when a player enters the vehicle.
if pPlayer == localPlayer then
<syntaxhighlight lang="lua">
addVehicleUpgrade( source, 1010 ) -- Install a nitro.
function changeNitroLevel(pPlayer)
setVehicleNitroCount( source, 101 ) -- Set up an infinite nitro.
if pPlayer == localPlayer then
if not getVehicleUpgradeOnSlot(source, 8) then -- Check if the vehicle has nitro in it or not
addVehicleUpgrade(source, 1010) -- Install nitrous
end
end
setVehicleNitroLevel(source, 0.1) -- Set a nitro level of 0.1 to the vehicle
end
end
)</syntaxhighlight>
end
addEventHandler("onClientVehicleEnter", root, changeNitroLevel)
</syntaxhighlight>
</section>


==Requirements==
==Requirements==
Line 29: Line 35:


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

Latest revision as of 19:08, 15 June 2021

This function sets the nitro level of the vehicle.

[[|link=|]] Warning: Only works if the vehicle is streamed in.

Syntax

bool setVehicleNitroLevel ( vehicle theVehicle, float level )

Required Arguments

  • theVehicle The vehicle, which you want to set.
  • level Nitro level you want to set (ranges from 0.0001 to 1.0).

Returns

Returns true if the nitro level was set successfully to the vehicle, false otherwise.

Example

Click to collapse [-]
Client

This function installs nitrous to the vehicle and sets the level of it to 0.1 when a player enters the vehicle. 

function changeNitroLevel(pPlayer)
	if pPlayer == localPlayer then
		if not getVehicleUpgradeOnSlot(source, 8) then -- Check if the vehicle has nitro in it or not
			addVehicleUpgrade(source, 1010) -- Install nitrous
		end
		setVehicleNitroLevel(source, 0.1) -- Set a nitro level of 0.1 to the vehicle
	end
end
addEventHandler("onClientVehicleEnter", root, changeNitroLevel)

Requirements

Minimum server version n/a
Minimum client version 1.3.1-9.04993

Note: Using this feature requires the resource to have the above minimum version declared in the meta.xml <min_mta_version> section. e.g. <min_mta_version client="1.3.1-9.04993" />

See Also


Retrieved from "https://wiki.multitheftauto.com/wiki/SetVehicleNitroLevel?oldid=71344"