Skip to main content

BlockEvents

BlockEvents posts callbacks around block interactions. Each callback receives an event object with fields like event.pos, event.state, and event.player.

Break and place

MethodWhen
broken { event -> ... }A block is broken. Event exposes pos, state, player.
placed { event -> ... }A block is placed.
postBroken / postPlacedAfter the engine's own handling.

Click handling

MethodWhen
leftClicked / rightClickedA player clicks a block.
postLeftClicked / postRightClickedAfterwards.
neighborNotifyA neighbor block changes.
modificationThe block is modified in place.
farmlandTrampledAn entity tramples farmland.

Example

BlockEvents.broken { event ->
println "[Showcase] ${event.player.name} broke ${event.state.block} at ${event.pos}"
}