EVENT CHANGEWEAPON: Difference between revisions
Doom64hunter (talk | contribs) More misinformation, this event does not allow the modder to control which weapon the player is switching weapons to. |
Doom64hunter (talk | contribs) mNo edit summary |
||
| Line 2: | Line 2: | ||
'''EVENT_CHANGEWEAPON''' is a [[EDuke32_event_list|Game Event]]. | '''EVENT_CHANGEWEAPON''' is a [[EDuke32_event_list|Game Event]]. | ||
This [[event]] is run 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. | ||
[[RETURN]] holds the number of the weapon the game is about to switch to, see [[WEAPON]]. | [[RETURN]] holds the number of the weapon the game is about to switch to, see [[WEAPON]]. | ||
| Line 9: | Line 9: | ||
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 -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.