0.21.0-alpha.5

nova/xyz.xenondevs.nova.world.block.behavior/BlockBehavior

BlockBehavior

interface BlockBehavior : BlockBehaviorHolder

For handling block logic.

Inheritors

TileEntityDrops

TileEntityInteractive

TileEntityLimited

Functions

open suspend fun canPlace(pos: BlockPos, state: NovaBlockState, ctx: Context<DefaultContextIntentions.BlockPlace>): Boolean

Checks whether a block of state can be placed at pos using the given ctx.

open fun getDrops(pos: BlockPos, state: NovaBlockState, ctx: Context<DefaultContextIntentions.BlockBreak>): List<ItemStack>

Retrieves the items that would be dropped when breaking a block of state at pos with the given ctx. Handlers should check DefaultContextParamTypes.BLOCK_DROPS and DefaultContextParamTypes.BLOCK_STORAGE_DROPS.

open fun getExp(pos: BlockPos, state: NovaBlockState, ctx: Context<DefaultContextIntentions.BlockBreak>): Int

Retrieves the amount of experience that would be dropped when breaking a block of state at pos with the given ctx. Handlers should check DefaultContextParamTypes.BLOCK_EXP_DROPS.

open fun handleAttack(pos: BlockPos, state: NovaBlockState, ctx: Context<DefaultContextIntentions.BlockBreak>)

Handles attack (left-click) on a block of state at pos with the given ctx.

open fun handleBreak(pos: BlockPos, state: NovaBlockState, ctx: Context<DefaultContextIntentions.BlockBreak>)

Handles the destruction of a block of state at pos with the given ctx.

handleEntityInside

open fun handleEntityInside(pos: BlockPos, state: NovaBlockState, entity: Entity)

Called when an entity is inside a block of state at pos.

open fun handleInteract(pos: BlockPos, state: NovaBlockState, ctx: Context<DefaultContextIntentions.BlockInteract>): Boolean

Handles interaction (right-click) with a block of state at pos with the given ctx.

handleNeighborChanged

open fun handleNeighborChanged(pos: BlockPos, state: NovaBlockState)

Called when a redstone update happened that may affect this state at pos.

open fun handlePlace(pos: BlockPos, state: NovaBlockState, ctx: Context<DefaultContextIntentions.BlockPlace>)

Handles the placement of a block of state at pos with the given ctx.

handleRandomTick

open fun handleRandomTick(pos: BlockPos, state: NovaBlockState)

Handles a random tick for a block of state at pos.

handleScheduledTick

open fun handleScheduledTick(pos: BlockPos, state: NovaBlockState)

Handles a scheduled tick for a block of state at pos.

pickBlockCreative

open fun pickBlockCreative(pos: BlockPos, state: NovaBlockState, ctx: Context<DefaultContextIntentions.BlockInteract>): ItemStack?

Chooses the ItemStack that should be given to the player when mid-clicking a block of state at pos with the given ctx in creative mode.

open fun ticksRandomly(state: NovaBlockState): Boolean

Whether this behavior implements random-tick logic for the given state. Note that the result of this method will be cached on startup.

open fun updateShape(pos: BlockPos, state: NovaBlockState, neighborPos: BlockPos): NovaBlockState

Called when a block at neighborPos changed to update the NovaBlockState of this state at pos.