SetVehicleGunsEnabled

From Multi Theft Auto: Wiki
Revision as of 00:15, 10 September 2016 by Walid (talk | contribs) (Deprecated function)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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 ToggleControl instead.


This function enables or disables the weapons on a vehicle

Syntax

bool setVehicleGunsEnabled ( vehicle theVehicle, bool gunsEnabled )

Required Arguments

  • theVehicle: The element representing the vehicle whose guns you want to toggle.
  • gunsEnabled: A bool representing whether guns are enabled or disabled. false will disable them, true will enable them.

Returns

Returns true if the guns were toggled succesfully, false if arguments passed were invalid.

Example

Click to collapse [-]
Example 1

This function will disables the ability to fire rockets on a hydra.

function disableFireForHydra ( theVehicle, seat, jacked )
    if ( getElementModel ( theVehicle ) == 520 ) then -- if they entered a hydra
        setVehicleGunsEnabled ( theVehicle, false ) -- disable their guns
    else -- if they entered another vehicle
        setVehicleGunsEnabled ( theVehicle, true ) -- enable their guns
    end
end
addEventHandler ( "onPlayerVehicleEnter", getRootElement(), disableFireForHydra )
Click to expand [+]
Example 2

See Also