EVENT PREWEAPONSHOOT

From EDukeWiki
Jump to navigation Jump to search
Event ID player# THISACTOR RETURN
EVENT_PREWEAPONSHOOT player that executed the input player->i 2 values

EVENT_PREWEAPONSHOOT is a game event.

This event is called when the player fires a projectile in the defined weapon sequence (P_FireWeapon), just before the projectile is spawned.

Note that it does not trigger if shoot is run manually from the player actor.

See also EVENT_POSTWEAPONSHOOT.

Return Values

This event has two return values:

userdef.return 0 (RETURN)
Setting this to any non-zero value prevents spawning the projectile, but otherwise continues execution of P_FireWeapon as normal. Note that if this is nonzero, EVENT_POSTWEAPONSHOOT will not trigger.
userdef.return 1
Contains the index of the projectile if they are being fired in a burst, starting from 0. For single shots, this is always 0.