Reports lethal player damage and lets plugins control the bounded death presentation before Bedriox completes that presentation.
PlayerDeathEvent
Runs after lethal damage commits and before death messages are presented.
Typed eventBedriox\Api\Event\Player
Bedriox dispatches this at the typed lifecycle point represented by the event. Check the available values below before acting.
Event data
Bedriox\Api\Player\Player $playerRead-only event value supplied by Bedriox.
string $causeRead-only event value supplied by Bedriox.
float $damageRead-only event value supplied by Bedriox.
?Bedriox\Api\Player\Player $killerRead-only event value supplied by Bedriox.
Available methods
keepsInventory(): boolTyped public method.
setKeepInventory(bool $keepInventory): voidTyped public method.
deathMessage(): string|Bedriox\Api\TranslatableMessage|nullTyped public method.
setDeathMessage(string|Bedriox\Api\TranslatableMessage|null $message): voidTyped public method.
deathScreenMessage(): string|Bedriox\Api\TranslatableMessage|nullTyped public method.
setDeathScreenMessage(string|Bedriox\Api\TranslatableMessage|null $message): voidTyped public method.
Inherited methods
captureState(): mixed from Bedriox\Api\Event\EventTyped public method.
restoreState(mixed $state): void from Bedriox\Api\Event\EventTyped public method.
setReadOnly(bool $readOnly): void from Bedriox\Api\Event\EventTyped public method.
Listen for this event
Register the containing object with PluginContext::events()->registerSubscriber($this), then add a typed handler:
use Bedriox\Api\Event\EventHandler;
use Bedriox\Api\Event\Player\PlayerDeathEvent;
#[EventHandler]
public function onPlayerDeathEvent(PlayerDeathEvent $event): void
{
// Keep listener work bounded and use public capabilities only.
}