From 9c1bc74618e5aa23224e6f814b4d4a8a5a026ddf Mon Sep 17 00:00:00 2001 From: AlphaBlend Date: Thu, 21 Mar 2013 12:48:53 -0600 Subject: Add method to get the source of a TNTPrimed. Adds BUKKIT-3815 --- src/main/java/org/bukkit/entity/TNTPrimed.java | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) 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(); } -- cgit v1.2.3