Package org.bukkit.event.block
Class BlockPlaceEvent
java.lang.Object
org.bukkit.event.Event
org.bukkit.event.block.BlockEvent
org.bukkit.event.block.BlockPlaceEvent
- All Implemented Interfaces:
Cancellable
- Direct Known Subclasses:
BlockMultiPlaceEvent
Called when a block is placed by a player.
If a Block Place event is cancelled, the block will not be placed.
-
Nested Class Summary
Nested classes/interfaces inherited from class org.bukkit.event.Event
Event.Result
-
Field Summary
Modifier and TypeFieldDescriptionprotected boolean
protected boolean
protected EquipmentSlot
protected ItemStack
protected Block
protected Player
protected BlockState
Fields inherited from class org.bukkit.event.block.BlockEvent
block
-
Constructor Summary
ConstructorDescriptionBlockPlaceEvent
(@NotNull Block placedBlock, @NotNull BlockState replacedBlockState, @NotNull Block placedAgainst, @NotNull ItemStack itemInHand, @NotNull Player thePlayer, boolean canBuild) Deprecated.BlockPlaceEvent
(@NotNull Block placedBlock, @NotNull BlockState replacedBlockState, @NotNull Block placedAgainst, @NotNull ItemStack itemInHand, @NotNull Player thePlayer, boolean canBuild, @NotNull EquipmentSlot hand) -
Method Summary
Modifier and TypeMethodDescriptionboolean
canBuild()
Gets the value whether the player would be allowed to build here.Gets the block that this block was placed againstClarity method for getting the placed block.Gets the BlockState for the block which was replaced.getHand()
Gets the hand which placed the blockstatic @NotNull HandlerList
Gets the item in the player's hand when they placed the block.Gets the player who placed the block involved in this event.boolean
Gets the cancellation state of this event.void
setBuild
(boolean canBuild) Sets the canBuild state of this event.void
setCancelled
(boolean cancel) Sets the cancellation state of this event.Methods inherited from class org.bukkit.event.block.BlockEvent
getBlock
Methods inherited from class org.bukkit.event.Event
callEvent, getEventName, isAsynchronous
-
Field Details
-
cancel
protected boolean cancel -
canBuild
protected boolean canBuild -
placedAgainst
-
replacedBlockState
-
itemInHand
-
player
-
hand
-
-
Constructor Details
-
Method Details
-
isCancelled
public boolean isCancelled()Description copied from interface:Cancellable
Gets the cancellation state of this event. A cancelled event will not be executed in the server, but will still pass to other plugins- Specified by:
isCancelled
in interfaceCancellable
- Returns:
- true if this event is cancelled
-
setCancelled
public void setCancelled(boolean cancel) Description copied from interface:Cancellable
Sets the cancellation state of this event. A cancelled event will not be executed in the server, but will still pass to other plugins.- Specified by:
setCancelled
in interfaceCancellable
- Parameters:
cancel
- true if you wish to cancel this event
-
getPlayer
Gets the player who placed the block involved in this event.- Returns:
- The Player who placed the block involved in this event
-
getBlockPlaced
Clarity method for getting the placed block. Not really needed except for reasons of clarity.- Returns:
- The Block that was placed
-
getBlockReplacedState
Gets the BlockState for the block which was replaced. Material type air mostly.- Returns:
- The BlockState for the block which was replaced.
-
getBlockAgainst
Gets the block that this block was placed against- Returns:
- Block the block that the new block was placed against
-
getItemInHand
Gets the item in the player's hand when they placed the block.- Returns:
- The ItemStack for the item in the player's hand when they placed the block
-
getHand
Gets the hand which placed the block- Returns:
- Main or off-hand, depending on which hand was used to place the block
-
canBuild
public boolean canBuild()Gets the value whether the player would be allowed to build here. Defaults to false if the server was going to stop them (such as, the player is in Spawn). Note that this is an entirely different check than BLOCK_CANBUILD, as this refers to a player, not universe-physics rule like cactus on dirt.- Returns:
- boolean whether the server would allow a player to build here
-
setBuild
public void setBuild(boolean canBuild) Sets the canBuild state of this event. Set to true if you want the player to be able to build.- Parameters:
canBuild
- true if you want the player to be able to build
-
getHandlers
- Specified by:
getHandlers
in classEvent
-
getHandlerList
-