diff --git a/src/main/java/org/bukkit/entity/TNTPrimed.java b/src/main/java/org/bukkit/entity/TNTPrimed.java index bf4ea515..948859e2 100644 --- a/src/main/java/org/bukkit/entity/TNTPrimed.java +++ b/src/main/java/org/bukkit/entity/TNTPrimed.java @@ -12,9 +12,27 @@ public interface TNTPrimed extends Explosive { public void setFuseTicks(int fuseTicks); /** - * Retrieve the number of ticks until the explosion of this TNTPrimed entity + * Retrieve the number of ticks until the explosion of this TNTPrimed + * entity * * @return the number of ticks until this TNTPrimed explodes */ public int getFuseTicks(); + + /** + * Gets the source of this primed TNT. The source is the entity + * responsible for the creation of this primed TNT. + * (I.E. player ignites TNT with flint and steel.) Take note + * that this can be null if there is no suitable source. + * (created by the {@link org.bukkit.World#spawn(Location, Class)} + * method, for example.) + * + * The source will become null if the chunk this primed TNT is in + * is unloaded then reloaded. If the source Entity becomes invalidated + * for any reason, such being removed from the world, the returned value + * will be null. + * + * @return the source of this primed TNT + */ + public Entity getSource(); }