SetJetpackWeaponEnabled: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "__NOTOC__ {{Server function}} This function sets a weapon usable while using the Jetpack. ==Syntax== <syntaxhighlight lang="lua">bool setJetpackWeaponEnabled(weapon-Type, player thePlayer)</...")
 
(Remove obsolete Requirements section)
 
(16 intermediate revisions by 10 users not shown)
Line 2: Line 2:
{{Server function}}
{{Server function}}
This function sets a weapon usable while using the Jetpack.
This function sets a weapon usable while using the Jetpack.
 
{{Note|colt 45, sawed-off, tec-9 and uzi are always enabled for the Jetpack and are not affected by this function.}}
==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">bool setJetpackWeaponEnabled(weapon-Type, player thePlayer)</syntaxhighlight>  
<syntaxhighlight lang="lua">bool setJetpackWeaponEnabled ( int weaponID/string weaponName, bool enabled )</syntaxhighlight>  


===Required Arguments===  
===Required Arguments===  
*'''weapon''' The weapon that's being set usable on a Jetpack.
*'''weaponID/weaponName:''' The ID or weapon name that's being set usable on a Jetpack. Names can be: (Case is ignored)
*'''enabled''' A bool representing whether the weapon is enabled or disabled.
{{All Weapon Types}}
*'''enabled:''' A [[boolean]] representing whether the weapon is enabled or disabled.


===Returns===
===Returns===
Returns true, else false if invalid arguments are passed.  
Returns true if successful, or false if invalid arguments are passed.


==Example==  
==Example==
<syntaxhighlight lang="lua">addCommandHandler("setJPEnabled",function(ped,_,wep,enabled)
This example enables the M4 to be fired while using a jetpack and announces it in the chat.
if type(wep) == "number" then
<syntaxhighlight lang="lua">addEventHandler("onResourceStart",resourceRoot,function()
wep = getWeaponNameFromID(wep)
    if setJetpackWeaponEnabled("31",true) then
end
          outputChatBox(getWeaponNameFromID(31).." is now enabled for jetpacks!")
if enabled == "true" then
    end
setJetpackWeaponEnabled(wep,true)
outputChatBox("You just enabled the Jetpack Weapons.",ped)
elseif enabled == "false" then
setJetpackWeaponEnabled(wep,false)
outputChatBox("You just disabled the Jetpack Weapons.",ped)
else
outputChatBox("SYNTAX: '/setJPEnabled theWeapon enabled"
end
end)</syntaxhighlight>
end)</syntaxhighlight>
==Requirements==
 
{{Requirements|1.3.1|n/a|}}
This example enables the M4, sniper rifle and country rifle to be fired while using a jetpack and announces it in the chat.
<syntaxhighlight lang="lua">
local weapons = {
    31,
    34,
    33,
}
 
addEventHandler("onResourceStart",resourceRoot,function()
    for i,v in ipairs(weapons) do
        if setJetpackWeaponEnabled(v,true) then
            outputChatBox(getWeaponNameFromID(v).." is now enabled for jetpacks!")
        end
    end
end
)</syntaxhighlight>
 
==See Also==
==See Also==
{{World_functions}}
{{World_functions|server}}

Latest revision as of 17:05, 7 November 2024

This function sets a weapon usable while using the Jetpack.

[[{{{image}}}|link=|]] Note: colt 45, sawed-off, tec-9 and uzi are always enabled for the Jetpack and are not affected by this function.

Syntax

bool setJetpackWeaponEnabled ( int weaponID/string weaponName, bool enabled )

Required Arguments

  • weaponID/weaponName: The ID or weapon name that's being set usable on a Jetpack. Names can be: (Case is ignored)
  • brassknuckle
  • golfclub
  • nightstick
  • knife
  • bat
  • shovel
  • poolstick
  • katana
  • chainsaw
  • dildo
  • vibrator
  • flower
  • cane
  • grenade
  • teargas
  • molotov
  • colt 45
  • silenced
  • deagle
  • shotgun
  • sawed-off
  • combat shotgun
  • uzi
  • mp5
  • ak-47
  • m4
  • tec-9
  • rifle
  • sniper
  • rocket launcher
  • rocket launcher hs
  • flamethrower
  • minigun
  • satchel
  • bomb
  • spraycan
  • fire extinguisher
  • camera
  • nightvision
  • infrared
  • parachute
  • enabled: A boolean representing whether the weapon is enabled or disabled.

Returns

Returns true if successful, or false if invalid arguments are passed.

Example

This example enables the M4 to be fired while using a jetpack and announces it in the chat. 

addEventHandler("onResourceStart",resourceRoot,function()
     if setJetpackWeaponEnabled("31",true) then
          outputChatBox(getWeaponNameFromID(31).." is now enabled for jetpacks!")
     end
end)

This example enables the M4, sniper rifle and country rifle to be fired while using a jetpack and announces it in the chat. 

local weapons = {
    31,
    34,
    33,
}

addEventHandler("onResourceStart",resourceRoot,function()
    for i,v in ipairs(weapons) do
        if setJetpackWeaponEnabled(v,true) then
            outputChatBox(getWeaponNameFromID(v).." is now enabled for jetpacks!")
        end
    end
end
)

See Also


Retrieved from "https://wiki.multitheftauto.com/wiki/SetJetpackWeaponEnabled?oldid=81122"