package icbm.api;

import icbm.api.explosion.IExplosiveContainer;
import universalelectricity.core.vector.Vector3;

/**
 * This is an interface applied by all missile entities. You may cast this into
 * an @Entity. The "set" version of the function will make the entity do the
 * action on the next tick.
 * 
 * @author Calclavia
 */
public interface IMissile extends IExplosiveContainer {
	/**
	 * Blows up this missile. It will detonate the missile with the appropriate
	 * explosion.
	 */
	public void explode();

	public void setExplode();

	/**
	 * Blows up this missile like a TNT explosion. Small explosion used for
	 * events such as a missile crashing or failure to explode will result in
	 * this function being called.
	 */
	public void normalExplode();

	public void setNormalExplode();

	/**
	 * Drops the specified missile as an item.
	 */
	public void dropMissileAsItem();

	/**
	 * The amount of ticks this missile has been flying for. Returns -1 if the
	 * missile is not flying.
	 */
	public int getTicksInAir();

	/**
	 * Gets the launcher this missile is launched from.
	 */
	public ILauncherContainer getLauncher();

	/**
	 * Launches the missile into a specific target.
	 * 
	 * @param target
	 */
	public void launch(Vector3 target);

	public void launch(Vector3 target, int height);
}