selectWeapon: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\{\{( *)Important( *)\|" to "{{$1Feature$2|$2important$2|")
(formatting)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| ofp
|game1= ofp


|1.27
|version1= 1.27
 
|game2= ofpe
 
|version2= 1.00
 
|game3= arma1
 
|version3= 1.00
 
|game4= arma2
 
|version4= 1.00
 
|game5= arma2oa
 
|version5= 1.51
 
|game6= tkoh
 
|version6= 1.00
 
|game7= arma3
 
|version7= 0.50


|arg= local
|arg= local
Line 11: Line 35:
|gr1= Weapons
|gr1= Weapons


|mp= The unit must be [[local]] to the PC on which command is executed.
|descr= Selects the given weapon.


| Selects the given weapon.
|s1= unitName '''selectWeapon''' muzzleName


{{Feature|important|For weapons that have more than one muzzle, you have to input the <u>muzzlename</u> and '''not''' the weaponName.}}
|p1= unitName: [[Object]]
 
* The only weapons that have muzzleNames seem to be rifles with grenade launchers, handgrenades, smokeshells and satchels. In all other cases the weaponName must be used.
Fortunately, in OFP, in most cases, both names are the same. But check.
* In ArmA the weaponNames and muzzleNames are different.
* For muzzle names see [[:Category:Weapons|CfgWeapons]].
 
| unitName '''selectWeapon''' muzzleName


|p1= unitName: [[Object]]
|p2= muzzleName: [[String]] - Name of the weapon or muzzle
|p2= muzzleName: [[String]]
{{Feature|important|For weapons that have '''more than one muzzle''', you have to input the '''muzzleName''' and not the '''weaponName'''.
* In {{ofp}}, in most cases, both names are the same. But check.
* In {{arma1}} the weaponNames and muzzleNames are different.
* For muzzle names see [[:Category:Weapons|CfgWeapons]].}}


| [[Nothing]]
|r1= [[Nothing]]
   
   
|x1= <code>_soldier1 [[selectWeapon]] "LAWLauncher";</code>
|x1= <code>_soldier1 [[selectWeapon]] "LAWLauncher";</code>
|x2= <code>[[player]] [[selectWeapon]] "M203Muzzle";</code>
|x2= <code>[[player]] [[selectWeapon]] "M203Muzzle";</code>


| [[fire]], [[forceWeaponFire]], [[primaryWeapon]], [[handgunWeapon]], [[secondaryWeapon]], [[weapons]], [[ArmA:_Actions#SWITCHWEAPON|action SwitchWeapon]], [[ArmA:_Actions#SWITCHMAGAZINE|action SwitchMagazine]]
|seealso= [[fire]], [[forceWeaponFire]], [[primaryWeapon]], [[handgunWeapon]], [[secondaryWeapon]], [[weapons]], [[ArmA:_Actions#SWITCHWEAPON|action SwitchWeapon]], [[ArmA:_Actions#SWITCHMAGAZINE|action SwitchMagazine]]
}}
}}



Revision as of 14:31, 21 March 2021

Hover & click on the images for description

Description

Description:
Selects the given weapon.
Groups:
Weapons

Syntax

Syntax:
unitName selectWeapon muzzleName
Parameters:
unitName: Object
muzzleName: String - Name of the weapon or muzzle
For weapons that have more than one muzzle, you have to input the muzzleName and not the weaponName.
  • In Operation Flashpoint, in most cases, both names are the same. But check.
  • In Armed Assault the weaponNames and muzzleNames are different.
  • For muzzle names see CfgWeapons.
Return Value:
Nothing

Examples

Example 1:
_soldier1 selectWeapon "LAWLauncher";
Example 2:
player selectWeapon "M203Muzzle";

Additional Information

See also:
fireforceWeaponFireprimaryWeaponhandgunWeaponsecondaryWeaponweaponsaction SwitchWeaponaction SwitchMagazine

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
Posted on 5 Aug, 2008
Dr_Eyeball
Rather than simply using selectWeapon to select your default weapon after adding them to your player, it is recommended you use a script instead similar to the following, which caters for multiple muzzles:
SelectWeapon.sqf
 // Desc: select default weapon & handle multiple muzzles
 if (count weapons player > 0) then
 {
   private['_type', '_muzzles'];
 
   _type = ((weapons player) select 0);
   // check for multiple muzzles (eg: GL)
   _muzzles = getArray(configFile >> "cfgWeapons" >> _type >> "muzzles");
 
   if (count _muzzles > 1) then
   {
     player selectWeapon (_muzzles select 0);
   }
   else
   {
     player selectWeapon _type;
   };
 };
Posted on 22 Mar, 2010
MaestrO.fr
Can be used with primaryWeapon to select the primary weapon. An example with muzzle care (see Dr_EyeBall note) :
 if ( (primaryWeapon player) != "") then
 {
   private['_type', '_muzzles'];
 
   _type = primaryWeapon player;
   // check for multiple muzzles (eg: GL)
   _muzzles = getArray(configFile >> "cfgWeapons" >> _type >> "muzzles");
 
   if (count _muzzles > 1) then
   {
     player selectWeapon (_muzzles select 0);
   }
   else
   {
     player selectWeapon _type;
   };
 };