Package net.neoforged.neoforge.event.entity.player

Class UseItemOnBlockEvent

java.lang.Object

net.neoforged.bus.api.Event

net.neoforged.neoforge.event.entity.EntityEvent

net.neoforged.neoforge.event.entity.living.LivingEvent

net.neoforged.neoforge.event.entity.player.PlayerEvent

net.neoforged.neoforge.event.entity.player.PlayerInteractEvent

net.neoforged.neoforge.event.entity.player.UseItemOnBlockEvent

All Implemented Interfaces:

net.neoforged.bus.api.ICancellableEvent

public class UseItemOnBlockEvent
extends PlayerInteractEvent
implements net.neoforged.bus.api.ICancellableEvent

Fires on both the client and server thread when a player interacts with a block.

The event fires in three phases, corresponding with the three interaction behaviors: IItemExtension.onItemUseFirst(net.minecraft.world.item.ItemStack, net.minecraft.world.item.context.UseOnContext), BlockBehaviour.use(net.minecraft.world.level.block.state.BlockState, net.minecraft.world.level.Level, net.minecraft.core.BlockPos, net.minecraft.world.entity.player.Player, net.minecraft.world.InteractionHand, net.minecraft.world.phys.BlockHitResult), and Item.useOn(net.minecraft.world.item.context.UseOnContext).

The event fires after the interaction logic decides to run the particular interaction behavior, as opposed to PlayerInteractEvent.RightClickBlock which fires once-per-right-click, before the behavior-choosing logic.

If the event is cancelled via cancelWithResult(net.minecraft.world.InteractionResult), then the normal interaction behavior for that phase will not run, and the specified InteractionResult will be returned instead.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	UseItemOnBlockEvent.UsePhase

Nested classes/interfaces inherited from class net.neoforged.neoforge.event.entity.player.PlayerInteractEvent

PlayerInteractEvent.EntityInteract, PlayerInteractEvent.EntityInteractSpecific, PlayerInteractEvent.LeftClickBlock, PlayerInteractEvent.LeftClickEmpty, PlayerInteractEvent.RightClickBlock, PlayerInteractEvent.RightClickEmpty, PlayerInteractEvent.RightClickItem

Nested classes/interfaces inherited from class net.neoforged.neoforge.event.entity.player.PlayerEvent

PlayerEvent.BreakSpeed, PlayerEvent.Clone, PlayerEvent.HarvestCheck, PlayerEvent.ItemCraftedEvent, PlayerEvent.ItemPickupEvent, PlayerEvent.ItemSmeltedEvent, PlayerEvent.LoadFromFile, PlayerEvent.NameFormat, PlayerEvent.PlayerChangedDimensionEvent, PlayerEvent.PlayerChangeGameModeEvent, PlayerEvent.PlayerLoggedInEvent, PlayerEvent.PlayerLoggedOutEvent, PlayerEvent.PlayerRespawnEvent, PlayerEvent.SaveToFile, PlayerEvent.StartTracking, PlayerEvent.StopTracking, PlayerEvent.TabListNameFormat

Nested classes/interfaces inherited from class net.neoforged.neoforge.event.entity.living.LivingEvent

LivingEvent.LivingJumpEvent, LivingEvent.LivingTickEvent, LivingEvent.LivingVisibilityEvent

Nested classes/interfaces inherited from class net.neoforged.neoforge.event.entity.EntityEvent

EntityEvent.EnteringSection, EntityEvent.EntityConstructing, EntityEvent.Size

Nested classes/interfaces inherited from class net.neoforged.bus.api.Event

net.neoforged.bus.api.Event.HasResult, net.neoforged.bus.api.Event.Result

Field Summary

Fields

Modifier and Type	Field	Description
private final UseOnContext	context
private final UseItemOnBlockEvent.UsePhase	usePhase

Constructor Summary

Constructors

Constructor	Description
UseItemOnBlockEvent(UseOnContext context, UseItemOnBlockEvent.UsePhase usePhase)

Method Summary

Modifier and Type	Method	Description
void	cancelWithResult(InteractionResult result)	Cancels the use interaction (preventing the block or item's use behavior from running) and provides the specified result to the interaction logic instead.
UseOnContext	getUseOnContext()
UseItemOnBlockEvent.UsePhase	getUsePhase()	Returns The Use Phase of the interaction.

Methods inherited from class net.neoforged.neoforge.event.entity.player.PlayerInteractEvent

getCancellationResult, getFace, getHand, getItemStack, getLevel, getPos, getSide, setCancellationResult

Methods inherited from class net.neoforged.neoforge.event.entity.player.PlayerEvent

getEntity

Methods inherited from class net.neoforged.bus.api.Event

getResult, hasResult, setResult

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface net.neoforged.bus.api.ICancellableEvent

isCanceled, setCanceled

Field Details

context

private final UseOnContext context

usePhase

private final UseItemOnBlockEvent.UsePhase usePhase

Constructor Details

UseItemOnBlockEvent

public UseItemOnBlockEvent(UseOnContext context,
 UseItemOnBlockEvent.UsePhase usePhase)

Method Details

getUseOnContext

public UseOnContext getUseOnContext()

Returns:

context

getUsePhase

public UseItemOnBlockEvent.UsePhase getUsePhase()

Returns The Use Phase of the interaction.

Returns:

The Use Phase of the interaction

See Also:

• for semantics

cancelWithResult

public void cancelWithResult(InteractionResult result)

Cancels the use interaction (preventing the block or item's use behavior from running) and provides the specified result to the interaction logic instead.

Invoke this if you intend to prevent the default interaction behavior and replace it with your own.

Parameters:

result - InteractionResult to return to the interaction logic

• SUCCESS, CONSUME, CONSUME_PARTIAL, and FAIL will prevent further types of interaction attempts when provided from the ITEM_BEFORE_BLOCK phase.
• SUCCESS, CONSUME, and CONSUME_PARTIAL will trigger advancements on the server (except in the ITEM_BEFORE_BLOCK phase), and will also prevent the ITEM_AFTER_BLOCK item interaction from occurring if provided during the BLOCK phase.
• SUCCESS will trigger the arm-swinging mechanic.
• PASS will always allow proceeding to the next phase.