EVENT CHANGEWEAPON: Difference between revisions

From EDukeWiki
Jump to navigation Jump to search
One (talk | contribs)
No edit summary
mNo edit summary
 
(3 intermediate revisions by 3 users not shown)
Line 1: Line 1:
EVENT_CHANGEWEAPON is a [[EDuke32_event_list|Game Event]].
{{EventTable|1=EVENT_CHANGEWEAPON|2=player that executed the input|3=[[i|player->i]]|4=1 value}}
'''EVENT_CHANGEWEAPON''' is a [[EDuke32_event_list|Game Event]].


This event is initalized when the player is changing weapons.
This [[event]] is run when the player is changing weapons. Note that this event only occurs if the weapon switch succeeds -- if the player tries to select a weapon that is already equipped, this event will not trigger. If you need to know which weapon the player intended to select, use [[EVENT_SELECTWEAPON]] instead.


The new weapon is in '[[WEAPON]]' and '[[WORKSLIKE]]'
[[RETURN]] holds the number of the weapon the game is about to switch to, see [[WEAPON]].


-1 means 'no weapon'
Setting [[RETURN]] to -1 will prevent the weapon switch, even when running out of ammo for that weapon.
 
Setting [[RETURN]] to -2 will allow the weapon lowering animation to play, but the player will still not be allowed to actually swap out the weapon.
 
Setting [[RETURN]] to any other value has no effect. If you need to change which weapon the player switches to, use [[EVENT_SELECTWEAPON]] instead.


[[Category:Events]]
[[Category:Events]]

Latest revision as of 09:47, 5 February 2022

Event ID player# THISACTOR RETURN
EVENT_CHANGEWEAPON player that executed the input player->i 1 value

EVENT_CHANGEWEAPON is a Game Event.

This event is run when the player is changing weapons. Note that this event only occurs if the weapon switch succeeds -- if the player tries to select a weapon that is already equipped, this event will not trigger. If you need to know which weapon the player intended to select, use EVENT_SELECTWEAPON instead.

RETURN holds the number of the weapon the game is about to switch to, see WEAPON.

Setting RETURN to -1 will prevent the weapon switch, even when running out of ammo for that weapon.

Setting RETURN to -2 will allow the weapon lowering animation to play, but the player will still not be allowed to actually swap out the weapon.

Setting RETURN to any other value has no effect. If you need to change which weapon the player switches to, use EVENT_SELECTWEAPON instead.