Represents a player attack intent before Bedriox commits combat damage. It exposes the authoritative attacker, target, interaction type, and bounded proposed damage.
PlayerAttackEvent
Runs before the related authoritative action and may be cancelled within the documented server boundary.
Cancellable pre-eventBedriox\Api\Event\Player
Bedriox dispatches this before the related action commits. Cancelling it prevents that action at this event boundary.
Event after this
If this event is not cancelled and the action succeeds, Bedriox dispatches PlayerAttackedEvent as the committed outcome. That event cannot cancel or undo the result.
Event data
Bedriox\Api\Player\Player $attackerRead-only event value supplied by Bedriox.
Bedriox\Api\Player\Player $targetRead-only event value supplied by Bedriox.
Bedriox\Api\Player\PlayerInteractionType $interactionRead-only event value supplied by Bedriox.
Available methods
damage(): floatTyped public method.
setDamage(float $damage): voidTyped public method.
Inherited methods
isCancelled(): bool from Bedriox\Api\Event\CancellableEventTyped public method.
cancel(): void from Bedriox\Api\Event\CancellableEventTyped public method.
setCancelled(bool $cancelled): void from Bedriox\Api\Event\CancellableEventTyped public method.
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\PlayerAttackEvent;
#[EventHandler]
public function onPlayerAttackEvent(PlayerAttackEvent $event): void
{
// Keep listener work bounded and use public capabilities only.
}