Editing SetWeapon

{{ACSFunction|description=Changes activator's current weapon.
|usage=''boolean'' '''SetWeapon'''(''str weapon'')
|parameters=
*''weapon'': name of weapon to switch to. This name is one defined by an [[EDF]] [[weaponinfo]] block, which for the base games is stored in '''player.edf'''.
|return='''TRUE''' if the weapon was successfully selected or was already active, '''FALSE''' otherwise.
|examples=

<code>int result = SetWeapon("Crossbow");   // will return TRUE if player has and can use crossbow</code>

|notes=
This function only works if activator is a player.

This will not allow selecting a weapon missing from activator's [[playerclass]] '''weaponslot''' items (i.e. weapons not allowed for the given character class), even if the player holds it in the inventory.

If Heretic tome of power (from [[powereffect]] '''type''' '''PowerWeaponLevel2''') is active, it will always choose the powered type even if you specify the unpowered '''weaponinfo''' definition name.
|id=(ACS internal)}}