Package org.bukkit.entity

Interface FallingBlock

All Superinterfaces:

CommandSender, Entity, Metadatable, Nameable, Permissible, PersistentDataHolder, ServerOperator

public interface FallingBlock
extends Entity

Represents a falling block

Nested Class Summary

Nested classes/interfaces inherited from interface org.bukkit.entity.Entity

Entity.Spigot

Method Summary

Modifier and Type	Method	Description
boolean	canHurtEntities()	Get the HurtEntities state of this block.
BlockData	getBlockData()	Get the data for the falling block
boolean	getCancelDrop()	Get if the falling block will not become a block upon landing and not drop an item.
float	getDamagePerBlock()	Get the amount of damage inflicted upon entities multiplied by the distance that the block had fallen when this falling block lands on them.
boolean	getDropItem()	Get if the falling block will break into an item if it cannot be placed.
Material	getMaterial()	Deprecated. use getBlockData()
int	getMaxDamage()	Get the maximum amount of damage that can be inflicted upon entities when this falling block lands on them.
void	setCancelDrop(boolean cancelDrop)	Get if the falling block will not become a block upon landing and not drop an item.
void	setDamagePerBlock(float damage)	Set the amount of damage inflicted upon entities multiplied by the distance that the block had fallen when this falling block lands on them.
void	setDropItem(boolean drop)	Set if the falling block will break into an item if it cannot be placed.
void	setHurtEntities(boolean hurtEntities)	Set the HurtEntities state of this block.
void	setMaxDamage(int damage)	Set the maximum amount of damage that can be inflicted upon entities when this falling block lands on them.

Methods inherited from interface org.bukkit.command.CommandSender

getName, sendMessage, sendMessage, sendMessage, sendMessage

Methods inherited from interface org.bukkit.entity.Entity

addPassenger, addScoreboardTag, copy, copy, createSnapshot, eject, getBoundingBox, getEntityId, getFacing, getFallDistance, getFireTicks, getFreezeTicks, getHeight, getLastDamageCause, getLocation, getLocation, getMaxFireTicks, getMaxFreezeTicks, getNearbyEntities, getPassenger, getPassengers, getPistonMoveReaction, getPortalCooldown, getPose, getScoreboardTags, getServer, getSpawnCategory, getSwimHighSpeedSplashSound, getSwimSound, getSwimSplashSound, getTicksLived, getTrackedBy, getType, getUniqueId, getVehicle, getVelocity, getWidth, getWorld, hasGravity, isCustomNameVisible, isDead, isEmpty, isFrozen, isGlowing, isInsideVehicle, isInvulnerable, isInWater, isInWorld, isOnGround, isPersistent, isSilent, isValid, isVisibleByDefault, isVisualFire, leaveVehicle, playEffect, remove, removePassenger, removeScoreboardTag, setCustomNameVisible, setFallDistance, setFireTicks, setFreezeTicks, setGlowing, setGravity, setInvulnerable, setLastDamageCause, setPassenger, setPersistent, setPortalCooldown, setRotation, setSilent, setTicksLived, setVelocity, setVisibleByDefault, setVisualFire, spigot, teleport, teleport, teleport, teleport

Methods inherited from interface org.bukkit.metadata.Metadatable

getMetadata, hasMetadata, removeMetadata, setMetadata

Methods inherited from interface org.bukkit.Nameable

getCustomName, setCustomName

Methods inherited from interface org.bukkit.permissions.Permissible

addAttachment, addAttachment, addAttachment, addAttachment, getEffectivePermissions, hasPermission, hasPermission, isPermissionSet, isPermissionSet, recalculatePermissions, removeAttachment

Methods inherited from interface org.bukkit.persistence.PersistentDataHolder

getPersistentDataContainer

Methods inherited from interface org.bukkit.permissions.ServerOperator

isOp, setOp

Method Details

getMaterial

@Deprecated
@NotNull
Material getMaterial()

Deprecated.

use getBlockData()

Get the Material of the falling block

Returns:

Material of the block

getBlockData

@NotNull
BlockData getBlockData()

Get the data for the falling block

Returns:

data of the block

getDropItem

boolean getDropItem()

Get if the falling block will break into an item if it cannot be placed.

Note that if getCancelDrop() is true, the falling block will not drop an item regardless of whether or not the returned value is true.

Returns:

true if the block will break into an item when obstructed

setDropItem

void setDropItem(boolean drop)

Set if the falling block will break into an item if it cannot be placed.

Note that if getCancelDrop() is true, the falling block will not drop an item regardless of whether or not the value is set to true.

Parameters:

drop - true to break into an item when obstructed

getCancelDrop

boolean getCancelDrop()

Get if the falling block will not become a block upon landing and not drop an item.

Unlike getDropItem(), this property will prevent the block from forming into a block when it lands, causing it to disappear. If this property is true and getDropItem() is true, an item will NOT be dropped.

Returns:

true if the block will disappear

setCancelDrop

void setCancelDrop(boolean cancelDrop)

Get if the falling block will not become a block upon landing and not drop an item.

Unlike setDropItem(boolean), this property will prevent the block from forming into a block when it lands, causing it to disappear. If this property is true and getDropItem() is true, an item will NOT be dropped.

Parameters:

cancelDrop - true to make the block disappear when landing

canHurtEntities

boolean canHurtEntities()

Get the HurtEntities state of this block.

Returns:

whether entities will be damaged by this block.

setHurtEntities

void setHurtEntities(boolean hurtEntities)

Set the HurtEntities state of this block.

Parameters:

hurtEntities - whether entities will be damaged by this block.

getDamagePerBlock

float getDamagePerBlock()

Get the amount of damage inflicted upon entities multiplied by the distance that the block had fallen when this falling block lands on them.

Returns:

the damage per block

setDamagePerBlock

void setDamagePerBlock(float damage)

Set the amount of damage inflicted upon entities multiplied by the distance that the block had fallen when this falling block lands on them.

If damage is non-zero, this method will automatically call setHurtEntities(true).

Parameters:

damage - the damage per block to set. Must be >= 0.0

getMaxDamage

int getMaxDamage()

Get the maximum amount of damage that can be inflicted upon entities when this falling block lands on them.

Returns:

the max damage

setMaxDamage

void setMaxDamage(int damage)

Set the maximum amount of damage that can be inflicted upon entities when this falling block lands on them.

If damage is non-zero, this method will automatically call setHurtEntities(true).

Parameters:

damage - the max damage to set. Must be >= 0