Package org.bukkit.event.block

Class BlockDispenseLootEvent

java.lang.Object

org.bukkit.event.Event

org.bukkit.event.block.BlockEvent

org.bukkit.event.block.BlockDispenseLootEvent

All Implemented Interfaces:

Cancellable

public class BlockDispenseLootEvent
extends BlockEvent
implements Cancellable

Called when a block dispenses loot from its designated LootTable.

This is not to be confused with events like BlockDispenseEvent which fires when a singular item is dispensed from its inventory container.
Example: A player unlocks a trial chamber vault and the vault block dispenses its loot.

Nested Class Summary

Nested classes/interfaces inherited from class org.bukkit.event.Event

Event.Result

Field Summary

Fields inherited from class org.bukkit.event.block.BlockEvent

block

Constructor Summary

Constructors

Constructor	Description
BlockDispenseLootEvent(@Nullable Player player, @NotNull Block block, @NotNull List<ItemStack> dispensedLoot, @NotNull LootTable lootTable)

Method Summary

Modifier and Type	Method	Description
@NotNull List<ItemStack>	getDispensedLoot()	Gets the loot that will be dispensed.
static @NotNull HandlerList	getHandlerList()
@NotNull HandlerList	getHandlers()
@NotNull LootTable	getLootTable()	Gets the loot table used to generate the initial loot to dispense.
@Nullable Player	getPlayer()	Gets the player associated with this event.
boolean	isCancelled()	Gets the cancellation state of this event.
void	setCancelled(boolean cancel)	Sets the cancellation state of this event.
void	setDispensedLoot(@Nullable List<ItemStack> dispensedLoot)	Sets the loot that will be dispensed.

Methods inherited from class org.bukkit.event.block.BlockEvent

getBlock

Methods inherited from class org.bukkit.event.Event

callEvent, getEventName, isAsynchronous

Methods inherited from class java.lang.Object

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

Constructor Details

BlockDispenseLootEvent

@Internal
public BlockDispenseLootEvent(@Nullable
 @Nullable Player player,
 @NotNull
 @NotNull Block block,
 @NotNull
 @NotNull List<ItemStack> dispensedLoot,
 @NotNull
 @NotNull LootTable lootTable)

Method Details

getDispensedLoot

@NotNull
public @NotNull List<ItemStack> getDispensedLoot()

Gets the loot that will be dispensed.

Returns:

the loot that will be dispensed

setDispensedLoot

public void setDispensedLoot(@Nullable
 @Nullable List<ItemStack> dispensedLoot)

Sets the loot that will be dispensed.

Parameters:

dispensedLoot - new loot to dispense

getLootTable

@NotNull
public @NotNull LootTable getLootTable()

Gets the loot table used to generate the initial loot to dispense.

Returns:

the loot table used to generate the initial loot to dispense

getPlayer

@Nullable
public @Nullable Player getPlayer()

Gets the player associated with this event.
Warning: Some event instances like a TrialSpawner dispensing its reward loot may not have a player associated with them and will return null.

Returns:

the player who unlocked the vault

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

getHandlers

@NotNull
public @NotNull HandlerList getHandlers()

Specified by:

getHandlers in class Event

getHandlerList

@NotNull
public static @NotNull HandlerList getHandlerList()