Interface BlockHandler

All Known Implementing Classes:

BlockHandler.Dummy

public interface BlockHandler

Interface used to provide block behavior. Set with Block.withHandler(BlockHandler).

Implementations are expected to be thread safe.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	BlockHandler.Destroy
static final class	BlockHandler.Dummy	Handler used for loaded blocks with unknown namespace in order to do not lose the information while saving, and for runtime debugging purpose.
static final class	BlockHandler.Interaction
static class	BlockHandler.Placement	Represents an object forwarded to onPlace(Placement).
static final class	BlockHandler.PlayerDestroy
static final class	BlockHandler.PlayerPlacement
static final class	BlockHandler.Tick
static final class	BlockHandler.Touch

Method Summary

Modifier and Type	Method	Description
default byte	getBlockEntityAction()
default Collection<Tag<?>>	getBlockEntityTags()	Specifies which block entity tags should be sent to the player.
Key	getKey()	Gets the id of this handler.
default boolean	isTickable()
default void	onDestroy(BlockHandler.Destroy destroy)	Called when a block has been destroyed or replaced.
default boolean	onInteract(BlockHandler.Interaction interaction)	Handles interactions with this block.
default void	onPlace(BlockHandler.Placement placement)	Called when a block has been placed.
default void	onTouch(BlockHandler.Touch touch)	Defines custom behaviour for entities touching this block.
default void	tick(BlockHandler.Tick tick)

Method Details

onPlace

default void onPlace(BlockHandler.Placement placement)

Called when a block has been placed.

Parameters:

placement - the placement details

onDestroy

default void onDestroy(BlockHandler.Destroy destroy)

Called when a block has been destroyed or replaced.

Parameters:

destroy - the destroy details

onInteract

default boolean onInteract(BlockHandler.Interaction interaction)

Handles interactions with this block. Can also block normal item use (containers should block when opening the menu, this prevents the player from placing a block when opening it for instance).

Parameters:

interaction - the interaction details

Returns:

true to let the block interaction happens, false to cancel

onTouch

default void onTouch(BlockHandler.Touch touch)

Defines custom behaviour for entities touching this block.

Parameters:

touch - the contact details

tick

default void tick(BlockHandler.Tick tick)

isTickable

default boolean isTickable()

getBlockEntityTags

default Collection<Tag<?>> getBlockEntityTags()

Specifies which block entity tags should be sent to the player.

Returns:

The list of tags from this block's block entity that should be sent to the player

See Also:

• Block entity on the Minecraft wiki

getBlockEntityAction

default byte getBlockEntityAction()

getKey

Key getKey()

Gets the id of this handler.

Used to write the block entity in the anvil world format.

Returns:

the key of this handler