Package org.bukkit.inventory

Interface EntityEquipment

public interface EntityEquipment

An interface to a creatures inventory

Method Summary

Modifier and Type	Method	Description
void	clear()	Clears the entity of all armor and held items
ItemStack[]	getArmorContents()	Gets all ItemStacks from the armor slots.
ItemStack	getBoots()	Gets a copy of the boots currently being worn by the entity
float	getBootsDropChance()	Gets the chance of the boots being dropped upon this creature's death.
ItemStack	getChestplate()	Gets a copy of the chest plate currently being worn by the entity
float	getChestplateDropChance()	Gets the chance of the chest plate being dropped upon this creature's death.
ItemStack	getHelmet()	Gets a copy of the helmet currently being worn by the entity
float	getHelmetDropChance()	Gets the chance of the helmet being dropped upon this creature's death.
Entity	getHolder()	Get the entity this EntityEquipment belongs to
ItemStack	getItem(EquipmentSlot slot)	Gets the ItemStack at the given equipment slot in the inventory.
ItemStack	getItemInHand()	Deprecated. entities can duel wield now use the methods for the specific hand instead
float	getItemInHandDropChance()	Deprecated. entities can duel wield now use the methods for the specific hand instead
ItemStack	getItemInMainHand()	Gets a copy of the item the entity is currently holding in their main hand.
float	getItemInMainHandDropChance()	Gets the chance of the main hand item being dropped upon this creature's death.
ItemStack	getItemInOffHand()	Gets a copy of the item the entity is currently holding in their off hand.
float	getItemInOffHandDropChance()	Gets the chance of the off hand item being dropped upon this creature's death.
ItemStack	getLeggings()	Gets a copy of the leggings currently being worn by the entity
float	getLeggingsDropChance()	Gets the chance of the leggings being dropped upon this creature's death.
void	setArmorContents(ItemStack[] items)	Sets the entities armor to the provided array of ItemStacks
void	setBoots(ItemStack boots)	Sets the boots worn by the entity
void	setBoots(ItemStack boots, boolean silent)	Sets the boots worn by the entity
void	setBootsDropChance(float chance)	Sets the chance of the boots being dropped upon this creature's death.
void	setChestplate(ItemStack chestplate)	Sets the chest plate worn by the entity
void	setChestplate(ItemStack chestplate, boolean silent)	Sets the chest plate worn by the entity
void	setChestplateDropChance(float chance)	Sets the chance of the chest plate being dropped upon this creature's death.
void	setHelmet(ItemStack helmet)	Sets the helmet worn by the entity
void	setHelmet(ItemStack helmet, boolean silent)	Sets the helmet worn by the entity
void	setHelmetDropChance(float chance)	Sets the chance of the helmet being dropped upon this creature's death.
void	setItem(EquipmentSlot slot, ItemStack item)	Stores the ItemStack at the given equipment slot in the inventory.
void	setItem(EquipmentSlot slot, ItemStack item, boolean silent)	Stores the ItemStack at the given equipment slot in the inventory.
void	setItemInHand(ItemStack stack)	Deprecated. entities can duel wield now use the methods for the specific hand instead
void	setItemInHandDropChance(float chance)	Deprecated. entities can duel wield now use the methods for the specific hand instead
void	setItemInMainHand(ItemStack item)	Sets the item the entity is holding in their main hand.
void	setItemInMainHand(ItemStack item, boolean silent)	Sets the item the entity is holding in their main hand.
void	setItemInMainHandDropChance(float chance)	Sets the chance of the item this creature is currently holding in their main hand being dropped upon this creature's death.
void	setItemInOffHand(ItemStack item)	Sets the item the entity is holding in their off hand.
void	setItemInOffHand(ItemStack item, boolean silent)	Sets the item the entity is holding in their off hand.
void	setItemInOffHandDropChance(float chance)	Sets the chance of the off hand item being dropped upon this creature's death.
void	setLeggings(ItemStack leggings)	Sets the leggings worn by the entity
void	setLeggings(ItemStack leggings, boolean silent)	Sets the leggings worn by the entity
void	setLeggingsDropChance(float chance)	Sets the chance of the leggings being dropped upon this creature's death.

Method Details

setItem

void setItem(@NotNull
 EquipmentSlot slot,
 @Nullable
 ItemStack item)

Stores the ItemStack at the given equipment slot in the inventory.

Parameters:

slot - the slot to put the ItemStack

item - the ItemStack to set

setItem

void setItem(@NotNull
 EquipmentSlot slot,
 @Nullable
 ItemStack item,
 boolean silent)

Stores the ItemStack at the given equipment slot in the inventory.

Parameters:

slot - the slot to put the ItemStack

item - the ItemStack to set

silent - whether or not the equip sound should be silenced

getItem

@NotNull
ItemStack getItem(@NotNull
 EquipmentSlot slot)

Gets the ItemStack at the given equipment slot in the inventory.

Parameters:

slot - the slot to get the ItemStack

Returns:

the ItemStack in the given slot

getItemInMainHand

@NotNull
ItemStack getItemInMainHand()

Gets a copy of the item the entity is currently holding in their main hand.

Returns:

the currently held item

setItemInMainHand

void setItemInMainHand(@Nullable
 ItemStack item)

Sets the item the entity is holding in their main hand.

Parameters:

item - The item to put into the entities hand

setItemInMainHand

void setItemInMainHand(@Nullable
 ItemStack item,
 boolean silent)

Sets the item the entity is holding in their main hand.

Parameters:

item - The item to put into the entities hand

silent - whether or not the equip sound should be silenced

getItemInOffHand

@NotNull
ItemStack getItemInOffHand()

Gets a copy of the item the entity is currently holding in their off hand.

Returns:

the currently held item

setItemInOffHand

void setItemInOffHand(@Nullable
 ItemStack item)

Sets the item the entity is holding in their off hand.

Parameters:

item - The item to put into the entities hand

setItemInOffHand

void setItemInOffHand(@Nullable
 ItemStack item,
 boolean silent)

Sets the item the entity is holding in their off hand.

Parameters:

item - The item to put into the entities hand

silent - whether or not the equip sound should be silenced

getItemInHand

@Deprecated
@NotNull
ItemStack getItemInHand()

Deprecated.

entities can duel wield now use the methods for the specific hand instead

Gets a copy of the item the entity is currently holding

Returns:

the currently held item

See Also:

• getItemInMainHand()
• getItemInOffHand()

setItemInHand

@Deprecated
void setItemInHand(@Nullable
 ItemStack stack)

Deprecated.

entities can duel wield now use the methods for the specific hand instead

Sets the item the entity is holding

Parameters:

stack - The item to put into the entities hand

See Also:

• setItemInMainHand(ItemStack)
• setItemInOffHand(ItemStack)

getHelmet

@Nullable
ItemStack getHelmet()

Gets a copy of the helmet currently being worn by the entity

Returns:

The helmet being worn

setHelmet

void setHelmet(@Nullable
 ItemStack helmet)

Sets the helmet worn by the entity

Parameters:

helmet - The helmet to put on the entity

setHelmet

void setHelmet(@Nullable
 ItemStack helmet,
 boolean silent)

Sets the helmet worn by the entity

Parameters:

helmet - The helmet to put on the entity

silent - whether or not the equip sound should be silenced

getChestplate

@Nullable
ItemStack getChestplate()

Gets a copy of the chest plate currently being worn by the entity

Returns:

The chest plate being worn

setChestplate

void setChestplate(@Nullable
 ItemStack chestplate)

Sets the chest plate worn by the entity

Parameters:

chestplate - The chest plate to put on the entity

setChestplate

void setChestplate(@Nullable
 ItemStack chestplate,
 boolean silent)

Sets the chest plate worn by the entity

Parameters:

chestplate - The chest plate to put on the entity

silent - whether or not the equip sound should be silenced

getLeggings

@Nullable
ItemStack getLeggings()

Gets a copy of the leggings currently being worn by the entity

Returns:

The leggings being worn

setLeggings

void setLeggings(@Nullable
 ItemStack leggings)

Sets the leggings worn by the entity

Parameters:

leggings - The leggings to put on the entity

setLeggings

void setLeggings(@Nullable
 ItemStack leggings,
 boolean silent)

Sets the leggings worn by the entity

Parameters:

leggings - The leggings to put on the entity

silent - whether or not the equip sound should be silenced

getBoots

@Nullable
ItemStack getBoots()

Gets a copy of the boots currently being worn by the entity

Returns:

The boots being worn

setBoots

void setBoots(@Nullable
 ItemStack boots)

Sets the boots worn by the entity

Parameters:

boots - The boots to put on the entity

setBoots

void setBoots(@Nullable
 ItemStack boots,
 boolean silent)

Sets the boots worn by the entity

Parameters:

boots - The boots to put on the entity

silent - whether or not the equip sound should be silenced

getArmorContents

@NotNull
ItemStack[] getArmorContents()

Gets all ItemStacks from the armor slots.

Returns:

all the ItemStacks from the armor slots. Individual items can be null and are returned in a fixed order starting from the boots and going up to the helmet

setArmorContents

void setArmorContents(@NotNull
 ItemStack[] items)

Sets the entities armor to the provided array of ItemStacks

Parameters:

items - The items to set the armor as. Individual items may be null.

clear

void clear()

Clears the entity of all armor and held items

getItemInHandDropChance

@Deprecated
float getItemInHandDropChance()

Deprecated.

entities can duel wield now use the methods for the specific hand instead

Returns:

drop chance

See Also:

• getItemInMainHandDropChance()
• getItemInOffHandDropChance()

setItemInHandDropChance

@Deprecated
void setItemInHandDropChance(float chance)

Deprecated.

entities can duel wield now use the methods for the specific hand instead

Parameters:

chance - drop chance

See Also:

• setItemInMainHandDropChance(float)
• setItemInOffHandDropChance(float)

getItemInMainHandDropChance

float getItemInMainHandDropChance()

Gets the chance of the main hand item being dropped upon this creature's death.

• A drop chance of 0.0F will never drop
• A drop chance of 1.0F will always drop

Returns:

chance of the currently held item being dropped (1 for non-Mob)

setItemInMainHandDropChance

void setItemInMainHandDropChance(float chance)

Sets the chance of the item this creature is currently holding in their main hand being dropped upon this creature's death.

• A drop chance of 0.0F will never drop
• A drop chance of 1.0F will always drop

Parameters:

chance - the chance of the main hand item being dropped

Throws:

UnsupportedOperationException - when called on non-Mob

getItemInOffHandDropChance

float getItemInOffHandDropChance()

Gets the chance of the off hand item being dropped upon this creature's death.

• A drop chance of 0.0F will never drop
• A drop chance of 1.0F will always drop

Returns:

chance of the off hand item being dropped (1 for non-Mob)

setItemInOffHandDropChance

void setItemInOffHandDropChance(float chance)

Sets the chance of the off hand item being dropped upon this creature's death.

• A drop chance of 0.0F will never drop
• A drop chance of 1.0F will always drop

Parameters:

chance - the chance of off hand item being dropped

Throws:

UnsupportedOperationException - when called on non-Mob

getHelmetDropChance

float getHelmetDropChance()

Gets the chance of the helmet being dropped upon this creature's death.

• A drop chance of 0.0F will never drop
• A drop chance of 1.0F will always drop

Returns:

the chance of the helmet being dropped (1 for non-Mob)

setHelmetDropChance

void setHelmetDropChance(float chance)

Sets the chance of the helmet being dropped upon this creature's death.

• A drop chance of 0.0F will never drop
• A drop chance of 1.0F will always drop

Parameters:

chance - of the helmet being dropped

Throws:

UnsupportedOperationException - when called on non-Mob

getChestplateDropChance

float getChestplateDropChance()

Gets the chance of the chest plate being dropped upon this creature's death.

• A drop chance of 0.0F will never drop
• A drop chance of 1.0F will always drop

Returns:

the chance of the chest plate being dropped (1 for non-Mob)

setChestplateDropChance

void setChestplateDropChance(float chance)

Sets the chance of the chest plate being dropped upon this creature's death.

• A drop chance of 0.0F will never drop
• A drop chance of 1.0F will always drop

Parameters:

chance - of the chest plate being dropped

Throws:

UnsupportedOperationException - when called on non-Mob

getLeggingsDropChance

float getLeggingsDropChance()

Gets the chance of the leggings being dropped upon this creature's death.

• A drop chance of 0.0F will never drop
• A drop chance of 1.0F will always drop

Returns:

the chance of the leggings being dropped (1 for non-Mob)

setLeggingsDropChance

void setLeggingsDropChance(float chance)

Sets the chance of the leggings being dropped upon this creature's death.

• A drop chance of 0.0F will never drop
• A drop chance of 1.0F will always drop

Parameters:

chance - chance of the leggings being dropped

Throws:

UnsupportedOperationException - when called on non-Mob

getBootsDropChance

float getBootsDropChance()

Gets the chance of the boots being dropped upon this creature's death.

• A drop chance of 0.0F will never drop
• A drop chance of 1.0F will always drop

Returns:

the chance of the boots being dropped (1 for non-Mob)

setBootsDropChance

void setBootsDropChance(float chance)

Sets the chance of the boots being dropped upon this creature's death.

• A drop chance of 0.0F will never drop
• A drop chance of 1.0F will always drop

Parameters:

chance - of the boots being dropped

Throws:

UnsupportedOperationException - when called on non-Mob

getHolder

@Nullable
Entity getHolder()

Get the entity this EntityEquipment belongs to

Returns:

the entity this EntityEquipment belongs to