GetObituary

From ZDoom Wiki
Jump to navigation Jump to search


Actor

virtual string GetObituary (Actor victim, Actor inflictor, Name mod, bool playerattack)

Usage

Used to retrieve the obituary message to display upon the player's death. The function is not called if the player kills themselves, as the engine uses the self-killed obituary message (OB_KILLEDSELF) in this case.

Parameters

  • Actor victim
A pointer to the killed actor.
  • Actor inflictor
A pointer to the actor that inflicted the damage.
  • Name mod
The means of death. This is the damage type of the attack which killed victim.
  • bool playerattack
If this is true, the attack came from a player, and it is either a hitscan or rail attack.

Return value

The return value is a string that is used as the obituary message. If the string is empty, the engine falls back to a default message.

Predefined functionality

If not overridden, the function returns the telefrag-killed message (OB_MONTELEFRAG) if mod is 'Telefrag'. If mod is 'Melee', and the calling actor's HitObituary is not an empty string, it returns that. If that fails, the calling actor's Obituary is returned.

Examples

One of three obituary messages are chosen if this archvile kills the player.

class Test_Archvile : Archvile
{
    override string GetObituary (Actor victim, Actor inflictor, Name mod, bool playerattack)
    {
        static const string messages[] =
        {
            "%o got blown up by an archvile.",
            "%o was burned to death by an archvile.",
            "An archvile made %o disappear."
        };

        return messages[Random(0, messages.Size() - 1)];
    }
}

See also