bz_ePlayerDeathFinalizedEvent

This event is fired after the bz_ePlayerDieEvent and it contains the finalized kill data after any plugins may have reassigned kills.

Data Object Type

2.4.10 bz_PlayerDieEventData_V2

Deprecated Types

These data object types have been deprecated in favor of more recent versions, which contain more or corrected information.

• 2.4.0 bz_PlayerDieEventData_V1

Parameters

These are the values accessible in the bz_EventData variable that's made available in the Event method.

Data Type	Name	Description
int	playerID	ID of the player who was killed.
bz_eTeamType	team	The team the killed player was on.
int	killerID	The owner of the shot that killed the player, or BZ_SERVER for server side kills
bz_eTeamType	killerTeam	The team the owner of the shot was on.
bz_ApiString	flagKilledWith	The flag name the owner of the shot had when the shot was fired.
int	flagHeldWhenKilled	The ID of the flag the victim was holding when they died. (available since V2 of the event)
int	shotID	The shot ID that killed the player, if the player was not killed by a shot, the id will be -1.
bz_PlayerUpdateState	state	The state record for the killed player at the time of the event
double	eventTime	Time of the event on the server.

Plug-in Usage

There are no plug-ins in the official distribution that make use of this event. Browse the Plug-in Releases forum for plug-ins which may make use of this event.

Plug-in Example

This block of code can be used to get started when implementing the Event() function of your plug-in.

bz_PlayerDieEventData_V2* dataObject = (bz_PlayerDieEventData_V2*)eventData;

// Data
// ---
// (int)          playerID - ID of the player who was killed.
// (bz_eTeamType) team - The team the killed player was on.
// (int)          killerID - The owner of the shot that killed the player, or BZ_SERVER for server side kills
// (bz_eTeamType) killerTeam - The team the owner of the shot was on.
// (bz_ApiString) flagKilledWith - The flag name the owner of the shot had when the shot was fired.
// (int)          flagHeldWhenKilled - The ID of the flag the victim was holding when they died.
// (int)          shotID - The shot ID that killed the player, if the player was not killed by a shot, the id will be -1.
// (bz_PlayerUpdateState) state - The state record for the killed player at the time of the event
// (double)       eventTime - Time of the event on the server.

Other Player Events

• bz_eAllowPlayer
• bz_eAutoPilotEvent
• bz_eGetAutoTeamEvent
• bz_eGetPlayerInfoEvent
• bz_eGetPlayerMotto
• bz_ePlayerAuthEvent
• bz_ePlayerDieEvent
• bz_ePlayerJoinEvent
• bz_ePlayerPartEvent
• bz_ePlayerPausedEvent
• bz_ePlayerUpdateEvent

Back to bzfs API Events