EVENT CHANGEWEAPON: Difference between revisions
mNo edit summary |
Doom64hunter (talk | contribs) mNo edit summary |
||
| (4 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 | 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]]. | |||
-1 | 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 08: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.