org.bukkit.entity.ThrownPotion Maven / Gradle / Ivy

Go to download
package org.bukkit.entity;

import org.bukkit.inventory.ItemStack;
import org.bukkit.potion.PotionEffect;

import java.util.Collection;

/**
 * Represents a thrown potion bottle
 */
public interface ThrownPotion extends Projectile {

  /**
   * Returns the effects that are applied by this potion.
   *
   * @return The potion effects
   */
  Collection getEffects();

  /**
   * Returns a copy of the ItemStack for this thrown potion.
   * 
   * Altering this copy will not alter the thrown potion directly. If you
   * want to alter the thrown potion, you must use the {@link
   * #setItem(ItemStack) setItemStack} method.
   *
   * @return A copy of the ItemStack for this thrown potion.
   */
  ItemStack getItem();

  /**
   * Set the ItemStack for this thrown potion.
   * 
   * The ItemStack must be a potion, otherwise an exception is thrown.
   *
   * @param item New ItemStack
   */
  void setItem(ItemStack item);
}