Printz: Created page with "{{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= `int result = SetWeapon("Crossbow"); // will return TRUE if player..."`


2026-04-04T11:25:14Z
Created page with "{{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..."
New page
{{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)}}

SetWeapon - Revision history