SetVehicleNitroActivated: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
(Remove obsolete Requirements section)
 
(2 intermediate revisions by 2 users not shown)
Line 2: Line 2:
{{Client function}}
{{Client function}}
{{New feature/item|3.0131|1.3.1|4993|
{{New feature/item|3.0131|1.3.1|4993|
This function activates the nitro on the [[vehicle]].
This function activates or deactivates the nitro on the specified [[vehicle]], like if a player pressed the button for activating nitro.
}}
}}
{{Warning|Only works if the vehicle is steamed in}}
{{Warning|Only works if the vehicle is streamed in.}}
==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">bool setVehicleNitroActivated ( vehicle theVehicle, bool state )</syntaxhighlight>  
<syntaxhighlight lang="lua">bool setVehicleNitroActivated ( vehicle theVehicle, bool state )</syntaxhighlight>  


===Required Arguments===  
===Required Arguments===  
*'''theVehicle''' The [[vehicle]], which you want to check an activation.
*'''theVehicle''' The [[vehicle]] to activate or deactivate the nitro on.
*'''state''' ''true'' if you want to activate the nitro, ''false'' if you want to disable it.
*'''state''' ''true'' if you want to activate the nitro, ''false'' if you want to disable it.


===Returns===
===Returns===
Returns ''true'' if the nitro is activated successfully on the vehicle, ''false'' otherwise.
Returns ''true'' if the nitro activation state was modified successfully, ''false'' otherwise.


==Example==
==Example==
Line 24: Line 24:
addVehicleUpgrade(source, 1010) -- Install the nitrous
addVehicleUpgrade(source, 1010) -- Install the nitrous
end
end
setVehicleNitroActivated(source, true)
setVehicleNitroActivated(source, true) -- Activate the nitro
end
end
end
end
Line 30: Line 30:
</syntaxhighlight>
</syntaxhighlight>
</section>
</section>
==Requirements==
{{Requirements|n/a|1.3.1-9.04993|}}


==See Also==
==See Also==
{{Client_vehicle_functions}}
{{Client_vehicle_functions}}

Latest revision as of 17:10, 7 November 2024

This function activates or deactivates the nitro on the specified vehicle, like if a player pressed the button for activating nitro.

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

Syntax

bool setVehicleNitroActivated ( vehicle theVehicle, bool state )

Required Arguments

  • theVehicle The vehicle to activate or deactivate the nitro on.
  • state true if you want to activate the nitro, false if you want to disable it.

Returns

Returns true if the nitro activation state was modified successfully, false otherwise.

Example

Click to collapse [-]
Client

This example adds and activates nitro in the vehicle the player enters.

function activateNitro(pPlayer)
	if pPlayer == localPlayer then
		if not getVehicleUpgradeOnSlot(source, 8) then -- Check if the vehicle has nitro installed or not
			addVehicleUpgrade(source, 1010) -- Install the nitrous
		end
		setVehicleNitroActivated(source, true) -- Activate the nitro
	end
end
addEventHandler("onClientVehicleEnter", root, activateNitro) -- When the player enters a vehicle, it executes the function

See Also