Files
DeltaZern/paper-api/src/main/java/org/bukkit/entity/Arrow.java
T
2018-12-26 08:00:00 +11:00

111 lines
2.7 KiB
Java

package org.bukkit.entity;
import org.bukkit.block.Block;
/**
* Represents an arrow.
*/
public interface Arrow extends Projectile {
/**
* Gets the knockback strength for an arrow, which is the
* {@link org.bukkit.enchantments.Enchantment#KNOCKBACK KnockBack} level
* of the bow that shot it.
*
* @return the knockback strength value
*/
public int getKnockbackStrength();
/**
* Sets the knockback strength for an arrow.
*
* @param knockbackStrength the knockback strength value
*/
public void setKnockbackStrength(int knockbackStrength);
/**
* Gets the base amount of damage this arrow will do.
*
* Defaults to 2.0 for a normal arrow with
* <code>0.5 * (1 + power level)</code> added for arrows fired from
* enchanted bows.
*
* @return base damage amount
*/
public double getDamage();
/**
* Sets the base amount of damage this arrow will do.
*
* @param damage new damage amount
*/
public void setDamage(double damage);
/**
* Gets whether this arrow is critical.
* <p>
* Critical arrows have increased damage and cause particle effects.
* <p>
* Critical arrows generally occur when a player fully draws a bow before
* firing.
*
* @return true if it is critical
*/
public boolean isCritical();
/**
* Sets whether or not this arrow should be critical.
*
* @param critical whether or not it should be critical
*/
public void setCritical(boolean critical);
/**
* Gets whether this arrow is in a block or not.
* <p>
* Arrows in a block are motionless and may be picked up by players.
*
* @return true if in a block
*/
public boolean isInBlock();
/**
* Gets the block to which this arrow is attached.
*
* @return the attached block or null if not attached
*/
public Block getAttachedBlock();
/**
* Gets the current pickup status of this arrow.
*
* @return the pickup status of this arrow.
*/
public PickupStatus getPickupStatus();
/**
* Sets the current pickup status of this arrow.
*
* @param status new pickup status of this arrow.
*/
public void setPickupStatus(PickupStatus status);
/**
* Represents the pickup status of this arrow.
*/
public enum PickupStatus {
/**
* The arrow cannot be picked up.
*/
DISALLOWED,
/**
* The arrow can be picked up.
*/
ALLOWED,
/**
* The arrow can only be picked up by players in creative mode.
*/
CREATIVE_ONLY
}
}