[B+C] Add Location.getNearbyEntities. Adds BUKKIT-3868

src/main/java/org/bukkit/Location.java

@@ -1,6 +1,9 @@
 package org.bukkit;
 
+import java.util.Collection;
+
 import org.bukkit.block.Block;
+import org.bukkit.entity.Entity;
 import org.bukkit.util.NumberConversions;
 import org.bukkit.util.Vector;
 
@@ -82,6 +85,19 @@ public Block getBlock() {
         return world.getBlockAt(this);
     }
 
+    /**
+     * Returns a collection of entities within a bounding box centered
+     * around this location
+     *
+     * @param x 1/2 the size of the box along x axis
+     * @param y 1/2 the size of the box along y axis
+     * @param z 1/2 the size of the box along z axis
+     * @return List<Entity> List of entities nearby
+     */
+    public Collection<Entity> getNearbyEntities(double x, double y, double z) {
+        return world.getEntities(this, x, y, z);
+    }
+
     /**
      * Sets the x-coordinate of this location
      *

src/main/java/org/bukkit/World.java

@@ -429,6 +429,46 @@ public interface World extends PluginMessageRecipient, Metadatable {
      */
     public Collection<Entity> getEntitiesByClasses(Class<?>... classes);
 
+    /**
+     * Returns a collection of entities within a bounding box centered around the
+     * specified location
+     *
+     * @param center the center of the bounding box
+     * @param x 1/2 the size of the box along x axis
+     * @param y 1/2 the size of the box along y axis
+     * @param z 1/2 the size of the box along z axis
+     * @return A Collection of entities nearby
+     */
+    public Collection<Entity> getEntities(Location center, double x, double y, double z);
+
+    /**
+     * Get a collection of all entities in this World matching the given
+     * class/interface within a specific area
+     *
+     * @param center the center of the bounding box
+     * @param x 1/2 the size of the box along x axis
+     * @param y 1/2 the size of the box along y axis
+     * @param z 1/2 the size of the box along z axis
+     * @param clazz The class representing the type of entity to match
+     * @return A Collection of all Entities currently residing in this world that
+     *     match the given class/interface within the given area
+     */
+    public <T extends Entity> Collection<T> getEntitiesByClass(Location center, double x, double y, double z, Class<T> clazz);
+
+    /**
+     * Get a collection of all entities in this World matching any of the
+     * given classes/interfaces within a specific area
+     *
+     * @param center the center of the bounding box
+     * @param x 1/2 the size of the box along x axis
+     * @param y 1/2 the size of the box along y axis
+     * @param z 1/2 the size of the box along z axis
+     * @param classes The classes representing the types of entity to match
+     * @return A Collection of all Entities currently residing in this world that
+     *     match one or more of the given classes/interfaces in the area
+     */
+    public Collection<Entity> getEntitiesByClasses(Location center, double x, double y, double z, Class<?>... classes);
+
     /**
      * Get a list of all players in this World
      *