EVENT DAMAGECEILING
| Event ID | player# | THISACTOR | RETURN | |
|---|---|---|---|---|
| EVENT_DAMAGECEILING | -1 | Damage Source | 2-6 values |
EVENT_DAMAGECEILING is a Game Event.
This event is triggered whenever a ceiling is hit by a weapon.
This event is only executed if the tilenum was set with damageeventtile and damageeventtilerange.
THISACTOR equals the ID of the projectile or source of damage.
RETURN or the userdef return 0 is the sectnum of the ceiling being damaged.
Setting RETURN to -1 aborts the ceiling damage code, preventing hardcoded textures such as ceiling lights from being destroyed. Setting this to -1 will also prevent EVENT_DAMAGEHPLANE from executing.
The userdef return 1 through 5 equals the hitradius parameters. If there's no radius damage, return 1 equals -1.
See also EVENT_DAMAGEFLOOR, EVENT_DAMAGEWALL, EVENT_DAMAGESPRITE and EVENT_POSTDAMAGESPRITE.
Return Values
The additional return values of this event are only set if the damage type is RADIUSDAMAGE, i.e. explosive damage. If the damage was not caused by an explosion, only `userdef.return 0` is set, and `userdef.return 1` will be set to -1.
- userdef.return 0 (alias RETURN)
- Is set to the sectnum of the ceiling being damaged. Set to -1 to skip hardcoded effects. Cannot be used to change the destination of the damage.
- userdef.return 1
- Contains the blast radius if the damage type was radius damage. This value is set to -1 if no radius damage occurred.
- userdef.return 2
- Contains the damage dealt in the outermost blast radius area. (usually defined to be the lowest)
- userdef.return 3
- Contains the damage dealt in the second to outermost blast radius area.
- userdef.return 4
- Contains the damage dealt in the second to innermost blast radius area.
- userdef.return 5
- Contains the damage dealt in the innermost blast radius area. (usually defined to be the highest)