SetVehicleGunsEnabled: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(replaced notes about 'function not working' with 'function is removed since xxx, use yyy instead')
m (fixed a typo)
Line 1: Line 1:
{{Server client function}}
{{Server client function}}
{{Important Note|This function is depreciated and doesn't work since 1.0. Use [[ToggleControl]] instead.}}
{{Important Note|This function is deprecated and doesn't work since 1.0. Use [[ToggleControl]] instead.}}


__NOTOC__
__NOTOC__

Revision as of 09:18, 7 February 2012

[[{{{image}}}|link=|]] Important Note: This function is deprecated and doesn't work since 1.0. 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