diff options
-rw-r--r-- | src/main/java/org/bukkit/Bukkit.java | 41 | ||||
-rw-r--r-- | src/main/java/org/bukkit/Server.java | 37 |
2 files changed, 78 insertions, 0 deletions
diff --git a/src/main/java/org/bukkit/Bukkit.java b/src/main/java/org/bukkit/Bukkit.java index 5bea055b..5a4654fd 100644 --- a/src/main/java/org/bukkit/Bukkit.java +++ b/src/main/java/org/bukkit/Bukkit.java @@ -531,6 +531,47 @@ public final class Bukkit { } /** + * Create a new explorer map targeting the closest nearby structure of a + * given {@link StructureType}. + * <br> + * This method uses implementation default values for radius and + * findUnexplored (usually 100, true). + * + * @param world the world the map will belong to + * @param location the origin location to find the nearest structure + * @param structureType the type of structure to find + * @return a newly created item stack + * + * @see World#locateNearestStructure(org.bukkit.Location, + * org.bukkit.StructureType, int, boolean) + */ + public static ItemStack createExplorerMap(World world, Location location, StructureType structureType) { + return server.createExplorerMap(world, location, structureType); + } + + /** + * Create a new explorer map targeting the closest nearby structure of a + * given {@link StructureType}. + * <br> + * This method uses implementation default values for radius and + * findUnexplored (usually 100, true). + * + * @param world the world the map will belong to + * @param location the origin location to find the nearest structure + * @param structureType the type of structure to find + * @param radius radius to search, see World#locateNearestStructure for more + * information + * @param findUnexplored whether to find unexplored structures + * @return the newly created item stack + * + * @see World#locateNearestStructure(org.bukkit.Location, + * org.bukkit.StructureType, int, boolean) + */ + public static ItemStack createExplorerMap(World world, Location location, StructureType structureType, int radius, boolean findUnexplored) { + return server.createExplorerMap(world, location, structureType, radius, findUnexplored); + } + + /** * Reloads the server, refreshing settings and plugin information. */ public static void reload() { diff --git a/src/main/java/org/bukkit/Server.java b/src/main/java/org/bukkit/Server.java index c3535e90..21ed6aeb 100644 --- a/src/main/java/org/bukkit/Server.java +++ b/src/main/java/org/bukkit/Server.java @@ -439,6 +439,43 @@ public interface Server extends PluginMessageRecipient { public MapView createMap(World world); /** + * Create a new explorer map targeting the closest nearby structure of a + * given {@link StructureType}. + * <br> + * This method uses implementation default values for radius and + * findUnexplored (usually 100, true). + * + * @param world the world the map will belong to + * @param location the origin location to find the nearest structure + * @param structureType the type of structure to find + * @return a newly created item stack + * + * @see World#locateNearestStructure(org.bukkit.Location, + * org.bukkit.StructureType, int, boolean) + */ + public ItemStack createExplorerMap(World world, Location location, StructureType structureType); + + /** + * Create a new explorer map targeting the closest nearby structure of a + * given {@link StructureType}. + * <br> + * This method uses implementation default values for radius and + * findUnexplored (usually 100, true). + * + * @param world the world the map will belong to + * @param location the origin location to find the nearest structure + * @param structureType the type of structure to find + * @param radius radius to search, see World#locateNearestStructure for more + * information + * @param findUnexplored whether to find unexplored structures + * @return the newly created item stack + * + * @see World#locateNearestStructure(org.bukkit.Location, + * org.bukkit.StructureType, int, boolean) + */ + public ItemStack createExplorerMap(World world, Location location, StructureType structureType, int radius, boolean findUnexplored); + + /** * Reloads the server, refreshing settings and plugin information. */ public void reload(); |