org.bukkit.event.block
Class BlockPlaceEvent

java.lang.Object
  extended by org.bukkit.event.Event
      extended by org.bukkit.event.block.BlockEvent
          extended by org.bukkit.event.block.BlockPlaceEvent
All Implemented Interfaces:
Cancellable

public class BlockPlaceEvent
extends BlockEvent
implements Cancellable

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
protected  boolean canBuild
           
protected  boolean cancel
           
protected  ItemStack itemInHand
           
protected  Block placedAgainst
           
protected  Player player
           
protected  BlockState replacedBlockState
           
 
Fields inherited from class org.bukkit.event.block.BlockEvent
block
 
Constructor Summary
BlockPlaceEvent(Block placedBlock, BlockState replacedBlockState, Block placedAgainst, ItemStack itemInHand, Player thePlayer, boolean canBuild)
           
 
Method Summary
 boolean canBuild()
          Gets the value whether the player would be allowed to build here.
 Block getBlockAgainst()
          Gets the block that this block was placed against
 Block getBlockPlaced()
          Clarity method for getting the placed block.
 BlockState getBlockReplacedState()
          Gets the BlockState for the block which was replaced.
static HandlerList getHandlerList()
           
 HandlerList getHandlers()
           
 ItemStack getItemInHand()
          Gets the item in the player's hand when they placed the block.
 Player getPlayer()
          Gets the player who placed the block involved in this event.
 boolean isCancelled()
          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
getEventName, isAsynchronous
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

cancel

protected boolean cancel

canBuild

protected boolean canBuild

placedAgainst

protected Block placedAgainst

replacedBlockState

protected BlockState replacedBlockState

itemInHand

protected ItemStack itemInHand

player

protected Player player
Constructor Detail

BlockPlaceEvent

public BlockPlaceEvent(Block placedBlock,
                       BlockState replacedBlockState,
                       Block placedAgainst,
                       ItemStack itemInHand,
                       Player thePlayer,
                       boolean canBuild)
Method Detail

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 interface Cancellable
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 interface Cancellable
Parameters:
cancel - true if you wish to cancel this event

getPlayer

public Player getPlayer()
Gets the player who placed the block involved in this event.

Returns:
The Player who placed the block involved in this event

getBlockPlaced

public Block getBlockPlaced()
Clarity method for getting the placed block. Not really needed except for reasons of clarity.

Returns:
The Block that was placed

getBlockReplacedState

public BlockState getBlockReplacedState()
Gets the BlockState for the block which was replaced. Material type air mostly.

Returns:
The BlockState for the block which was replaced.

getBlockAgainst

public Block getBlockAgainst()
Gets the block that this block was placed against

Returns:
Block the block that the new block was placed against

getItemInHand

public ItemStack 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

canBuild

public boolean canBuild()
Gets the value whether the player would be allowed to build here. Defaults to spawn 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

public HandlerList getHandlers()
Specified by:
getHandlers in class Event

getHandlerList

public static HandlerList getHandlerList()


Copyright © 2013. All Rights Reserved.