org.bukkit.block

Interface Beacon

All Superinterfaces:

BlockState, InventoryHolder, Lockable, Metadatable, Nameable

public interface Beacon
extends BlockState, InventoryHolder, Lockable, Nameable

Represents a beacon.

Method Summary

Modifier and Type	Method and Description
java.util.Collection<LivingEntity>	getEntitiesInRange() Returns the list of players within the beacon's range of effect.
PotionEffect	getPrimaryEffect() Returns the primary effect set on the beacon
PotionEffect	getSecondaryEffect() Returns the secondary effect set on the beacon.
int	getTier() Returns the tier of the beacon pyramid (0-4).
void	setPrimaryEffect(PotionEffectType effect) Set the primary effect on this beacon, or null to clear.
void	setSecondaryEffect(PotionEffectType effect) Set the secondary effect on this beacon, or null to clear.

Methods inherited from interface org.bukkit.block.BlockState

getBlock, getChunk, getData, getLightLevel, getLocation, getLocation, getRawData, getType, getTypeId, getWorld, getX, getY, getZ, isPlaced, setData, setRawData, setType, setTypeId, update, update, update

Methods inherited from interface org.bukkit.metadata.Metadatable

getMetadata, hasMetadata, removeMetadata, setMetadata

Methods inherited from interface org.bukkit.inventory.InventoryHolder

getInventory

Methods inherited from interface org.bukkit.block.Lockable

getLock, isLocked, setLock

Methods inherited from interface org.bukkit.Nameable

getCustomName, setCustomName

Method Detail

getEntitiesInRange

java.util.Collection<LivingEntity> getEntitiesInRange()

Returns the list of players within the beacon's range of effect.

Returns:

the players in range

getTier

int getTier()

Returns the tier of the beacon pyramid (0-4). The tier refers to the beacon's power level, based on how many layers of blocks are in the pyramid. Tier 1 refers to a beacon with one layer of 9 blocks under it.

Returns:

the beacon tier

getPrimaryEffect

PotionEffect getPrimaryEffect()

Returns the primary effect set on the beacon

Returns:

the primary effect or null if not set

setPrimaryEffect

void setPrimaryEffect(PotionEffectType effect)

Set the primary effect on this beacon, or null to clear.

Parameters:

effect - new primary effect

getSecondaryEffect

PotionEffect getSecondaryEffect()

Returns the secondary effect set on the beacon.

Returns:

the secondary effect or null if no secondary effect

setSecondaryEffect

void setSecondaryEffect(PotionEffectType effect)

Set the secondary effect on this beacon, or null to clear. Note that tier must be >= 4 for this effect to be active.

Parameters:

effect - desired secondary effect