3 files changed, 24 insertions, 0 deletions
diff --git a/src/main/java/org/bukkit/block/Block.java b/src/main/java/org/bukkit/block/Block.java
index ffc20d81..933b90fe 100644
--- a/src/main/java/org/bukkit/block/Block.java
+++ b/src/main/java/org/bukkit/block/Block.java
@@ -138,6 +138,14 @@ public interface Block extends Metadatable {
     Location getLocation();
 
     /**
+     * Stores the location of the block in the provided Location object.<br />
+     * If the provided Location is null this method does nothing and returns null.
+     *
+     * @return The Location object provided or null
+     */
+    Location getLocation(Location loc);
+
+    /**
      * Gets the chunk which contains this block
      *
      * @return Containing Chunk
diff --git a/src/main/java/org/bukkit/block/BlockState.java b/src/main/java/org/bukkit/block/BlockState.java
index c727d0e0..08b10e6f 100644
--- a/src/main/java/org/bukkit/block/BlockState.java
+++ b/src/main/java/org/bukkit/block/BlockState.java
@@ -88,6 +88,14 @@ public interface BlockState extends Metadatable {
     Location getLocation();
 
     /**
+     * Stores the location of this block in the provided Location object.<br />
+     * If the provided Location is null this method does nothing and returns null.
+     *
+     * @return The Location object provided or null
+     */
+    Location getLocation(Location loc);
+
+    /**
      * Gets the chunk which contains this block
      *
      * @return Containing Chunk
diff --git a/src/main/java/org/bukkit/entity/Entity.java b/src/main/java/org/bukkit/entity/Entity.java
index 9058429b..a9df5c5c 100644
--- a/src/main/java/org/bukkit/entity/Entity.java
+++ b/src/main/java/org/bukkit/entity/Entity.java
@@ -25,6 +25,14 @@ public interface Entity extends Metadatable {
     public Location getLocation();
 
     /**
+     * Stores the entity's current position in the provided Location object.<br />
+     * If the provided Location is null this method does nothing and returns null.
+     *
+     * @return The Location object provided or null
+     */
+    public Location getLocation(Location loc);
+
+    /**
      * Sets this entity's velocity
      *
      * @param velocity New velocity to travel with