SetVehicleHandling - Revision history

Dutchman101 at 19:55, 5 January 2022

2022-01-05T19:55:09Z

← Older revision		Revision as of 19:55, 5 January 2022
Line 23:		Line 23:

	{{Note\|For functionality reasons, suspension modification is disabled on monster trucks, trains, boats and trailers.		{{Note\|For functionality reasons, suspension modification is disabled on monster trucks, trains, boats and trailers.
	Additionally, helicopters are not affected by custom handling. The vehicle-on-wheels handling does not affect planes when they are on the ground either.}}		Additionally, helicopters are not affected by custom handling. The vehicle-on-wheels handling does not affect planes when they are on the ground either. For more information on this, see [https://github.com/multitheftauto/mtasa-blue/issues/2426 issue 2426]}}
	{{Warning\|To change handling values of aircraft like ''maxVelocity'', you must first set [[SetAircraftMaxVelocity\|setAircraftMaxVelocity]].}}		{{Warning\|To change handling values of aircraft like ''maxVelocity'', you must first set [[SetAircraftMaxVelocity\|setAircraftMaxVelocity]].}}

NOki: Added reference to helicopters and other aircraft as per #2426

2021-11-02T09:08:11Z

Added reference to helicopters and other aircraft as per #2426

← Older revision		Revision as of 09:08, 2 November 2021
Line 7:		Line 7:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool setVehicleHandling ( element theVehicle, string property, var value )		bool setVehicleHandling(element theVehicle, string property, var value)
	</syntaxhighlight>		</syntaxhighlight>

	Syntaxes for reset configurations:		Syntaxes for reset configurations:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool setVehicleHandling ( element theVehicle, string property, nil, false ) -- Reset one property to model handling value		bool setVehicleHandling(element theVehicle, string property, nil, false) -- Reset one property to model handling value
	bool setVehicleHandling ( element theVehicle, string property, nil, true ) -- Reset one property to GTA default value		bool setVehicleHandling(element theVehicle, string property, nil, true) -- Reset one property to GTA default value
	bool setVehicleHandling ( element theVehicle, false ) -- Reset all properties to model handling value		bool setVehicleHandling(element theVehicle, false) -- Reset all properties to model handling value
	bool setVehicleHandling ( element theVehicle, true ) -- Reset all properties to GTA default value		bool setVehicleHandling(element theVehicle, true) -- Reset all properties to GTA default value
	</syntaxhighlight>		</syntaxhighlight>

Line 22:		Line 22:
	*'''property:''' The property you wish to set the handling of the vehicle to.		*'''property:''' The property you wish to set the handling of the vehicle to.

	{{Note\|For functionality reasons suspension modification is disabled on monster trucks, trains, boats and trailers.}}		{{Note\|For functionality reasons, suspension modification is disabled on monster trucks, trains, boats and trailers.
			Additionally, helicopters are not affected by custom handling. The vehicle-on-wheels handling does not affect planes when they are on the ground either.}}
			{{Warning\|To change handling values of aircraft like ''maxVelocity'', you must first set [[SetAircraftMaxVelocity\|setAircraftMaxVelocity]].}}

	{{Handling Properties}}		{{Handling Properties}}
	*'''value:''' The value of the property you wish to set the handling of the vehicle to.		*'''value:''' The value of the property you wish to set the handling of the vehicle to.
Line 31:		Line 34:
	==Example==		==Example==
	This example will make Infernus handling very fast and also make it damage proof from collision (handling by Mr.unpredictable).		This example will make Infernus handling very fast and also make it damage proof from collision (handling by Mr.unpredictable).
	this example will help you in creating your own vehicle ~~Handling~~.		this example will help you in creating your own vehicle handling.
	<section name="Server" class="server" show="true">		<section name="Server" class="server" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">

X86dev: /* Example */

2020-06-17T05:59:22Z

Example

← Older revision		Revision as of 05:59, 17 June 2020
Line 34:		Line 34:
	<section name="Server" class="server" show="true">		<section name="Server" class="server" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function vhandling ( )		function vhandling ( theVehicle )
	~~for _,v in pairs(getElementsByType("vehicle")) do~~		if getElementModel(theVehicle) == 411 then -------------- vehicle Id
	if getElementModel(v) == 411 then -------------- vehicle Id		setVehicleHandling(theVehicle, "mass", 300.0)
	setVehicleHandling (v, "mass", 300.0)		setVehicleHandling(theVehicle, "turnMass", 200)
	setVehicleHandling(v, "turnMass", 200)		setVehicleHandling(theVehicle, "dragCoeff", 4.0 )
	setVehicleHandling(v, "dragCoeff", 4.0 )		setVehicleHandling(theVehicle, "centerOfMass", { 0.0,0.08,-0.09 } )
	setVehicleHandling(v, "centerOfMass", { 0.0,0.08,-0.09 } )		setVehicleHandling(theVehicle, "percentSubmerged", 103)
	setVehicleHandling(v, "percentSubmerged", 103)		setVehicleHandling(theVehicle, "tractionMultiplier", 1.8)
	setVehicleHandling(v, "tractionMultiplier", 1.8)		setVehicleHandling(theVehicle, "tractionLoss", 1.0)
	setVehicleHandling(v, "tractionLoss", 1.0)		setVehicleHandling(theVehicle, "tractionBias", 0.48)
	setVehicleHandling(v, "tractionBias", 0.48)		setVehicleHandling(theVehicle, "numberOfGears", 5)
	setVehicleHandling(v, "numberOfGears", 5)		setVehicleHandling(theVehicle, "maxVelocity", 300.0)
	setVehicleHandling(v, "maxVelocity", 300.0)		setVehicleHandling(theVehicle, "engineAcceleration", 90.0 )
	setVehicleHandling(v, "engineAcceleration", 90.0 )		setVehicleHandling(theVehicle, "engineInertia", 5.0)
	setVehicleHandling(v, "engineInertia", 5.0)		setVehicleHandling(theVehicle, "driveType", "rwd")
	setVehicleHandling(v, "driveType", "rwd")		setVehicleHandling(theVehicle, "engineType", "petrol")
	setVehicleHandling(v, "engineType", "petrol")		setVehicleHandling(theVehicle, "brakeDeceleration", 20.0)
	setVehicleHandling(v, "brakeDeceleration", 20.0)		setVehicleHandling(theVehicle, "brakeBias", 0.60)
	setVehicleHandling(v, "brakeBias", 0.60)
	-----abs----		-----abs----
	setVehicleHandling(v, "steeringLock", 35.0 )		setVehicleHandling(theVehicle, "steeringLock", 35.0 )
	setVehicleHandling(v, "suspensionForceLevel", 0.85)		setVehicleHandling(theVehicle, "suspensionForceLevel", 0.85)
	setVehicleHandling(v, "suspensionDamping", 0.15 )		setVehicleHandling(theVehicle, "suspensionDamping", 0.15 )
	setVehicleHandling(v, "suspensionHighSpeedDamping", 0.0)		setVehicleHandling(theVehicle, "suspensionHighSpeedDamping", 0.0)
	setVehicleHandling(v, "suspensionUpperLimit", 0.15 )		setVehicleHandling(theVehicle, "suspensionUpperLimit", 0.15 )
	setVehicleHandling(v, "suspensionLowerLimit", -0.16)		setVehicleHandling(theVehicle, "suspensionLowerLimit", -0.16)
	setVehicleHandling(v, "suspensionFrontRearBias", 0.5 )		setVehicleHandling(theVehicle, "suspensionFrontRearBias", 0.5 )
	setVehicleHandling(v, "suspensionAntiDiveMultiplier", 0.0)		setVehicleHandling(theVehicle, "suspensionAntiDiveMultiplier", 0.0)
	setVehicleHandling(v, "seatOffsetDistance", 0.0)		setVehicleHandling(theVehicle, "seatOffsetDistance", 0.0)
	setVehicleHandling(v, "collisionDamageMultiplier", 0.00)		setVehicleHandling(theVehicle, "collisionDamageMultiplier", 0.00)
	--setVehicleHandling(v, "monetary", 10000) This one is disabled for now		--setVehicleHandling(theVehicle, "monetary", 10000) This one is disabled for now
	setVehicleHandling(v, "modelFlags", 1002000)		setVehicleHandling(theVehicle, "modelFlags", 1002000)
	setVehicleHandling(v, "handlingFlags", 1000002)		setVehicleHandling(theVehicle, "handlingFlags", 1000002)
	--setVehicleHandling(v, "headLight", 3) This one is disabled for now		--setVehicleHandling(theVehicle, "headLight", 3) This one is disabled for now
	--setVehicleHandling(v, "tailLight", 2) This one is disabled for now		--setVehicleHandling(theVehicle, "tailLight", 2) This one is disabled for now
	--setVehicleHandling(v, "animGroup", 4) This one is disabled for now		--setVehicleHandling(theVehicle, "animGroup", 4) This one is disabled for now
	~~end~~		end
	end
	end		end
	addEventHandler ( "onPlayerVehicleEnter", getRootElement(), vhandling )		addEventHandler ( "onPlayerVehicleEnter", getRootElement(), vhandling )

Allerek: commented setVehicleHandling

2019-04-20T13:31:04Z

commented setVehicleHandling

← Older revision		Revision as of 13:31, 20 April 2019
Line 64:		Line 64:
	setVehicleHandling(v, "seatOffsetDistance", 0.0)		setVehicleHandling(v, "seatOffsetDistance", 0.0)
	setVehicleHandling(v, "collisionDamageMultiplier", 0.00)		setVehicleHandling(v, "collisionDamageMultiplier", 0.00)
	setVehicleHandling(v, "monetary", 10000)		--setVehicleHandling(v, "monetary", 10000) This one is disabled for now
	setVehicleHandling(v, "modelFlags", 1002000)		setVehicleHandling(v, "modelFlags", 1002000)
	setVehicleHandling(v, "handlingFlags", 1000002)		setVehicleHandling(v, "handlingFlags", 1000002)
	setVehicleHandling(v, "headLight", 3)		--setVehicleHandling(v, "headLight", 3) This one is disabled for now
	setVehicleHandling(v, "tailLight", 2)		--setVehicleHandling(v, "tailLight", 2) This one is disabled for now
	setVehicleHandling(v, "animGroup", 4)		--setVehicleHandling(v, "animGroup", 4) This one is disabled for now
	end		end
	end		end

Myonlake: /* Changelog */

2018-07-09T20:28:34Z

Changelog

← Older revision		Revision as of 20:28, 9 July 2018
Line 184:		Line 184:
	==Changelog==		==Changelog==
	{{ChangelogHeader}}		{{ChangelogHeader}}
	{{ChangelogItem\|1.5.5-3.12009\|Added ~~clientside~~}}		{{ChangelogItem\|1.5.5-3.12009\|Added for vehicles created on client-side.}}

	==See other vehicle functions==		==See other vehicle functions==
	{{Vehicle functions}}		{{Vehicle functions}}

Myonlake at 22:12, 5 July 2018

2018-07-05T22:12:54Z

← Older revision		Revision as of 22:12, 5 July 2018
Line 181:		Line 181:
	addEventHandler("onResourceStop", resourceRoot, resetHandling)		addEventHandler("onResourceStop", resourceRoot, resetHandling)
	</syntaxhighlight></section>		</syntaxhighlight></section>

			==Changelog==
			{{ChangelogHeader}}
			{{ChangelogItem\|1.5.5-3.12009\|Added clientside}}

	==See other vehicle functions==		==See other vehicle functions==
	{{Vehicle functions}}		{{Vehicle functions}}

Myonlake at 23:14, 1 July 2018

2018-07-01T23:14:43Z

← Older revision		Revision as of 23:14, 1 July 2018
Line 3:		Line 3:
	This function is used to change the handling data of a vehicle.		This function is used to change the handling data of a vehicle.

	{{New ~~items~~\|3.0156\|1.5.5\|Implemented also for client-sided vehicles.~~\|12009~~}}		{{New feature/item\|3.0156\|1.5.5\|12009\|Implemented also for client-sided vehicles.}}

	==Syntax==		==Syntax==

Myonlake at 23:10, 1 July 2018

2018-07-01T23:10:05Z

← Older revision		Revision as of 23:10, 1 July 2018
Line 1:		Line 1:
	{{Server function}}		{{Server client function}}
	__NOTOC__		__NOTOC__
	This function is used to change the handling data of a vehicle.		This function is used to change the handling data of a vehicle.

			{{New items\|3.0156\|1.5.5\|Implemented also for client-sided vehicles.\|12009}}

	==Syntax==		==Syntax==
Line 14:		Line 16:
	bool setVehicleHandling ( element theVehicle, false ) -- Reset all properties to model handling value		bool setVehicleHandling ( element theVehicle, false ) -- Reset all properties to model handling value
	bool setVehicleHandling ( element theVehicle, true ) -- Reset all properties to GTA default value		bool setVehicleHandling ( element theVehicle, true ) -- Reset all properties to GTA default value
	</syntaxhighlight>		</syntaxhighlight>

	===Required Arguments===		===Required Arguments===
	*'''theVehicle:''' The vehicle you wish to set the handling of.		*'''theVehicle:''' The vehicle you wish to set the handling of.
	*'''property:''' The property you wish to set the handling of the vehicle to.		*'''property:''' The property you wish to set the handling of the vehicle to.

			{{Note\|For functionality reasons suspension modification is disabled on monster trucks, trains, boats and trailers.}}
	{{Handling Properties}}		{{Handling Properties}}
	*'''value:''' The value of the property you wish to set the handling of the vehicle to.		*'''value:''' The value of the property you wish to set the handling of the vehicle to.
Line 24:		Line 28:
	===Returns===		===Returns===
	Returns ''true'' if the handling was set successfully, ''false'' otherwise. See below a list of valid properties and their required values:		Returns ''true'' if the handling was set successfully, ''false'' otherwise. See below a list of valid properties and their required values:

	~~==Notes==~~
	~~for functionality reasons suspension modification is disabled on monster trucks, trains, boats and trailers.~~

	==Example==		==Example==

Saml1er: Undo revision 55407 by Saml1er (talk)

2018-06-23T01:03:15Z

Undo revision 55407 by Saml1er (talk)

← Older revision		Revision as of 01:03, 23 June 2018
Line 1:		Line 1:
	{{Server ~~client~~ function}}		{{Server function}}
	__NOTOC__		__NOTOC__
	This function is used to change the handling data of a vehicle.		This function is used to change the handling data of a vehicle.

Saml1er: changed template from server function to Server client function

2018-06-19T10:17:54Z

changed template from server function to Server client function

← Older revision		Revision as of 10:17, 19 June 2018
Line 1:		Line 1:
	{{Server function}}		{{Server client function}}
	__NOTOC__		__NOTOC__
	This function is used to change the handling data of a vehicle.		This function is used to change the handling data of a vehicle.