Represents scoreboard score change before Bedriox commits the related authoritative change. Plugins may inspect it and cancel or adjust only the values explicitly exposed below.
ScoreboardScoreChangeEvent
Cancellable, adjustable intent emitted before an objective score changes.
Cancellable pre-eventBedriox\Api\Event\Scoreboard
Bedriox dispatches this before the related action commits. Cancelling it prevents that action at this event boundary.
Event data
Bedriox\Api\Scoreboard\ScoreboardObjective $objectiveRead-only event value supplied by Bedriox.
Bedriox\Api\Player\Player|Bedriox\Api\Entity\Entity|string $holderRead-only event value supplied by Bedriox.
?int $previousScoreRead-only event value supplied by Bedriox.
Available methods
score(): ?intTyped public method.
setScore(?int $score): 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\Scoreboard\ScoreboardScoreChangeEvent;
#[EventHandler]
public function onScoreboardScoreChangeEvent(ScoreboardScoreChangeEvent $event): void
{
// Keep listener work bounded and use public capabilities only.
}