SetModelHandling

2017-02-08T20:13:17Z

Renoaro13: /* Handling Properties */

{{Server function}}
__NOTOC__
This function is used to change the handling data of all vehicles of a specified model.

==Syntax==
<syntaxhighlight lang="lua">
bool setModelHandling ( int modelId, string property, var value )
</syntaxhighlight>

===Required Arguments===
*'''modelId:''' The [[Vehicle_IDs|vehicle model]] you wish to set the handling of.
*'''property:''' The property you wish to set the handling of the vehicle to, or ''nil'' if you want to reset the all the handling properties.
*'''value:''' The value of the models's handling property you wish to set, or ''nil'' if you want to reset the handling property to its default value.

===Returns===
Returns ''true'' if the handling was set successfully, ''false'' otherwise.

==Handling Properties==
See below a list of valid properties and their required values:
{{Handling Properties}}

==Example==
<section name="Server" class="server" show="true">
This example script changes the handling of all Bullet.
<syntaxhighlight lang="lua">
function handlingChange()
local modelId = 541
setModelHandling(modelId, "mass", 1890)
setModelHandling(modelId, "turnMass", 3780)
setModelHandling(modelId, "dragCoeff", 0.7)
setModelHandling(modelId, "centerOfMass", {0.0, 0.1, -0.2} )
setModelHandling(modelId, "percentSubmerged", 75)
setModelHandling(modelId, "tractionMultiplier", 0.70)
setModelHandling(modelId, "tractionLoss", 0.90)
setModelHandling(modelId, "tractionBias", 0.50)
setModelHandling(modelId, "numberOfGears", 5)
setModelHandling(modelId, "maxVelocity", 407)
setModelHandling(modelId, "engineAcceleration", 50)
setModelHandling(modelId, "engineInertia", 10)
setModelHandling(modelId, "driveType", "awd")
setModelHandling(modelId, "engineType", "petrol")
setModelHandling(modelId, "brakeDeceleration", 11)
setModelHandling(modelId, "brakeBias", 0.45)
setModelHandling(modelId, "ABS", false)
setModelHandling(modelId, "steeringLock", 30)
setModelHandling(modelId, "suspensionForceLevel", 0.80)
setModelHandling(modelId, "suspensionDamping", 0.20)
setModelHandling(modelId, "suspensionHighSpeedDamping", 0.0)
setModelHandling(modelId, "suspensionUpperLimit", 0.10)
setModelHandling(modelId, "suspensionLowerLimit", -0.09)
setModelHandling(modelId, "suspensionFrontRearBias", 0.5)
setModelHandling(modelId, "suspensionAntiDiveMultiplier", 0.6)
setModelHandling(modelId, "seatOffsetDistance", 0.3)
setModelHandling(modelId, "collisionDamageMultiplier", 0.50)
setModelHandling(modelId, "monetary", 1460000)
setModelHandling(modelId, "modelFlags", 0xC0222004)
setModelHandling(modelId, "handlingFlags", 0x1400000)
setModelHandling(modelId, "headLight", 1)
setModelHandling(modelId, "tailLight", 1)
setModelHandling(modelId, "animGroup", 0)
end
addEventHandler("onResourceStart", resourceRoot, handlingChange)
</syntaxhighlight>

This function will reset the handling of Bullet vehicles to its default state.
<syntaxhighlight lang="lua">
function resetHandling()
local modelId = 541
for k,_ in pairs(getModelHandling(modelId)) do
setModelHandling(modelId, k, nil)
end
end
addEventHandler("onResourceStop", resourceRoot, resetHandling)
</syntaxhighlight>
</section>

== Issues ==
{{Issues|
{{Issue|7454|setModelHandling doesn't work with already created vehicles}}
}}

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

SetVehicleHandling

2017-02-08T20:08:32Z

Renoaro13:

{{Server function}}
__NOTOC__
This function is used to change the handling data of a vehicle.

==Syntax==
<syntaxhighlight lang="lua">
bool setVehicleHandling ( element theVehicle, string property, var value )
</syntaxhighlight>

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

===Required Arguments===
*'''theVehicle:''' The vehicle you wish to set the handling of.
*'''property:''' The property you wish to set the handling of the vehicle to.
{{Handling Properties}}
*'''value:''' The value of the property you wish to set the handling of the vehicle to.

===Returns===
Returns ''true'' if the handling was set successfully, ''true'' otherwise. See below a list of valid propertys and their required values:

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

==Example==
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.
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function vhandling ( )
for _,v in pairs(getElementsByType("vehicle")) do
if getElementModel(v) == 415 then -------------- vehicle Id cheetah
setVehicleHandling (v, "mass", 900.0)
setVehicleHandling(v, "turnMass", 500)
setVehicleHandling(v, "dragCoeff", 4.0 )
setVehicleHandling(v, "centerOfMass", { 0.0,0.08,-0.09 } )
setVehicleHandling(v, "percentSubmerged", 103)
setVehicleHandling(v, "tractionMultiplier", 1.8)
setVehicleHandling(v, "tractionLoss", 1.0)
setVehicleHandling(v, "tractionBias", 0.48)
setVehicleHandling(v, "numberOfGears", 5)
setVehicleHandling(v, "maxVelocity", 300.0)
setVehicleHandling(v, "engineAcceleration", 90.0 )
setVehicleHandling(v, "engineInertia", 5.0)
setVehicleHandling(v, "driveType", "rwd")
setVehicleHandling(v, "engineType", "disel")
setVehicleHandling(v, "brakeDeceleration", 20.0)
setVehicleHandling(v, "brakeBias", 9.99)
-----abs----
setVehicleHandling(v, "steeringLock", 99.9 )
setVehicleHandling(v, "suspensionForceLevel", 2.99)
setVehicleHandling(v, "suspensionDamping", 6.50 )
setVehicleHandling(v, "suspensionHighSpeedDamping", 9.9)
setVehicleHandling(v, "suspensionUpperLimit", 9.99 )
setVehicleHandling(v, "suspensionLowerLimit", -0.16)
setVehicleHandling(v, "suspensionFrontRearBias", 0.5 )
setVehicleHandling(v, "suspensionAntiDiveMultiplier", 0.0)
setVehicleHandling(v, "seatOffsetDistance", 0.0)
setVehicleHandling(v, "collisionDamageMultiplier", 0.00)
setVehicleHandling(v, "monetary", 10000)
setVehicleHandling(v, "modelFlags", 1002000)
setVehicleHandling(v, "handlingFlags", 1000002)
setVehicleHandling(v, "headLight", 3)
setVehicleHandling(v, "tailLight", 2)
setVehicleHandling(v, "animGroup", 4)
end
end
end
addEventHandler ( "onPlayerVehicleEnter", getRootElement(), vhandling )
</syntaxhighlight></section>

This example will add a command for players with which they can change the mass of the vehicle.
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function massChange ( me, command, mass )
mass = tonumber ( mass ) -- Convert mass to a number
local veh = getPedOccupiedVehicle ( me ) -- Get the player's vehicle

if mass and veh then -- If valid mass and in a vehicle
local success = setVehicleHandling ( veh, "mass", mass ) -- Set the vehicle's mass, and check if successful

if success then -- If successful
outputChatBox ( "Your vehicle's mass has been changed to: "..mass.." kg", me, 0, 255, 0 ) -- Notify the player of success
else -- Too bad failure is still an option
outputChatBox ( "Setting mass failed. It's probably above or below allowed limits", me, 255, 0, 0 ) -- Notify the player of failure, and give a possible reason
end
elseif not veh then -- If not in a vehicle
outputChatBox ( "You're not in a vehicle", me, 255, 0, 0 ) -- Tell the player; He / she obviously doesn't know
elseif not mass then -- If not a valid mass
outputChatBox ( "Syntax: /changemass [mass]", me, 255, 0, 0 ) -- Tell the player the proper syntax
end
end
addCommandHandler ( "changemass", massChange )
</syntaxhighlight></section>

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

Multi Theft Auto: Wiki - User contributions [en]

SetModelHandling

SetVehicleHandling