diff options
Diffstat (limited to 'src/main')
158 files changed, 1158 insertions, 477 deletions
diff --git a/src/main/java/org/bukkit/BanEntry.java b/src/main/java/org/bukkit/BanEntry.java index 986120e5..b2437c6d 100644 --- a/src/main/java/org/bukkit/BanEntry.java +++ b/src/main/java/org/bukkit/BanEntry.java @@ -8,6 +8,7 @@ import java.util.Date; * <p> * Ban entries include the following properties: * <table border=1> + * <caption>Property information</caption> * <tr> * <th>Property</th> * <th>Description</th> diff --git a/src/main/java/org/bukkit/Bukkit.java b/src/main/java/org/bukkit/Bukkit.java index 1eaf92d7..2c43d9e3 100644 --- a/src/main/java/org/bukkit/Bukkit.java +++ b/src/main/java/org/bukkit/Bukkit.java @@ -2,7 +2,9 @@ package org.bukkit; import java.awt.image.BufferedImage; import java.io.File; +import java.io.Serializable; import java.util.Collection; +import java.util.Collections; import java.util.Iterator; import java.util.List; import java.util.Map; @@ -15,15 +17,17 @@ import org.bukkit.command.CommandException; import org.bukkit.command.CommandSender; import org.bukkit.command.ConsoleCommandSender; import org.bukkit.command.PluginCommand; +import org.bukkit.entity.Entity; import org.bukkit.entity.Player; import org.bukkit.event.inventory.InventoryType; +import org.bukkit.event.server.ServerListPingEvent; import org.bukkit.help.HelpMap; -import org.bukkit.inventory.ItemStack; import org.bukkit.inventory.Inventory; import org.bukkit.inventory.InventoryHolder; -import org.bukkit.inventory.ItemFactory; +import org.bukkit.inventory.ItemStack; import org.bukkit.inventory.Recipe; import org.bukkit.map.MapView; +import org.bukkit.permissions.Permissible; import org.bukkit.plugin.PluginManager; import org.bukkit.plugin.ServicesManager; import org.bukkit.plugin.messaging.Messenger; @@ -32,6 +36,10 @@ import org.bukkit.scoreboard.ScoreboardManager; import org.bukkit.util.CachedServerIcon; import com.avaje.ebean.config.ServerConfig; +import com.google.common.collect.ImmutableList; + +import org.bukkit.inventory.ItemFactory; +import org.bukkit.inventory.meta.ItemMeta; /** * Represents the Bukkit core, for version and Server singleton handling @@ -70,33 +78,41 @@ public final class Bukkit { } /** - * @see Server#getName() + * Gets the name of this server implementation. + * + * @return name of this server implementation */ public static String getName() { return server.getName(); } /** - * @see Server#getVersion() + * Gets the version string of this server implementation. + * + * @return version of this server implementation */ public static String getVersion() { return server.getVersion(); } /** - * @see Server#getBukkitVersion() + * Gets the Bukkit version that this server is running. + * + * @return version of Bukkit */ public static String getBukkitVersion() { return server.getBukkitVersion(); } /** + * Gets an array copy of all currently logged in players. + * <p> * This method exists for legacy reasons to provide backwards * compatibility. It will not exist at runtime and should not be used * under any circumstances. * - * @Deprecated - * @see Server#_INVALID_getOnlinePlayers() + * @deprecated superseded by {@link #getOnlinePlayers()} + * @return an array of Players that are currently online */ @Deprecated public static Player[] _INVALID_getOnlinePlayers() { @@ -104,98 +120,262 @@ public final class Bukkit { } /** - * @see Server#getOnlinePlayers() + * Gets a view of all currently logged in players. This {@linkplain + * Collections#unmodifiableCollection(Collection) view} is a reused + * object, making some operations like {@link Collection#size()} + * zero-allocation. + * <p> + * The collection is a view backed by the internal representation, such + * that, changes to the internal state of the server will be reflected + * immediately. However, the reuse of the returned collection (identity) + * is not strictly guaranteed for future or all implementations. Casting + * the collection, or relying on interface implementations (like {@link + * Serializable} or {@link List}), is deprecated. + * <p> + * Iteration behavior is undefined outside of self-contained main-thread + * uses. Normal and immediate iterator use without consequences that + * affect the collection are fully supported. The effects following + * (non-exhaustive) {@link Entity#teleport(Location) teleportation}, + * {@link Player#setHealth(double) death}, and {@link Player#kickPlayer( + * String) kicking} are undefined. Any use of this collection from + * asynchronous threads is unsafe. + * <p> + * For safe consequential iteration or mimicking the old array behavior, + * using {@link Collection#toArray(Object[])} is recommended. For making + * snapshots, {@link ImmutableList#copyOf(Collection)} is recommended. + * + * @return a view of currently online players. */ public static Collection<? extends Player> getOnlinePlayers() { return server.getOnlinePlayers(); } /** - * @see Server#getMaxPlayers() + * Get the maximum amount of players which can login to this server. + * + * @return the amount of players this server allows */ public static int getMaxPlayers() { return server.getMaxPlayers(); } /** - * @see Server#getPort() + * Get the game port that the server runs on. + * + * @return the port number of this server */ public static int getPort() { return server.getPort(); } /** - * @see Server#getViewDistance() + * Get the view distance from this server. + * + * @return the view distance from this server. */ public static int getViewDistance() { return server.getViewDistance(); } /** - * @see Server#getIp() + * Get the IP that this server is bound to, or empty string if not + * specified. + * + * @return the IP string that this server is bound to, otherwise empty + * string */ public static String getIp() { return server.getIp(); } /** - * @see Server#getServerName() + * Get the name of this server. + * + * @return the name of this server */ public static String getServerName() { return server.getServerName(); } /** - * @see Server#getServerId() + * Get an ID of this server. The ID is a simple generally alphanumeric ID + * that can be used for uniquely identifying this server. + * + * @return the ID of this server */ public static String getServerId() { return server.getServerId(); } - + /** - * @see Server#getWorldType() + * Get world type (level-type setting) for default world. + * + * @return the value of level-type (e.g. DEFAULT, FLAT, DEFAULT_1_1) */ public static String getWorldType() { return server.getWorldType(); } /** - * @see Server#getGenerateStructures() + * Get generate-structures setting. + * + * @return true if structure generation is enabled, false otherwise */ public static boolean getGenerateStructures() { return server.getGenerateStructures(); } /** - * @see Server#getAllowNether() + * Gets whether this server allows the End or not. + * + * @return whether this server allows the End or not + */ + public static boolean getAllowEnd() { + return server.getAllowEnd(); + } + + /** + * Gets whether this server allows the Nether or not. + * + * @return whether this server allows the Nether or not */ public static boolean getAllowNether() { return server.getAllowNether(); } /** - * @see Server#hasWhitelist() + * Gets whether this server has a whitelist or not. + * + * @return whether this server has a whitelist or not */ public static boolean hasWhitelist() { return server.hasWhitelist(); } /** - * @see Server#broadcastMessage(String message) + * Sets if the server is whitelisted. + * + * @param value true for whitelist on, false for off + */ + public static void setWhitelist(boolean value) { + server.setWhitelist(value); + } + + /** + * Gets a list of whitelisted players. + * + * @return a set containing all whitelisted players + */ + public static Set<OfflinePlayer> getWhitelistedPlayers() { + return server.getWhitelistedPlayers(); + } + + /** + * Reloads the whitelist from disk. + */ + public static void reloadWhitelist() { + server.reloadWhitelist(); + } + + /** + * Broadcast a message to all players. + * <p> + * This is the same as calling {@link #broadcast(java.lang.String, + * java.lang.String)} to {@link Server#BROADCAST_CHANNEL_USERS} + * + * @param message the message + * @return the number of players */ public static int broadcastMessage(String message) { return server.broadcastMessage(message); } /** - * @see Server#getUpdateFolder() + * Gets the name of the update folder. The update folder is used to safely + * update plugins at the right moment on a plugin load. + * <p> + * The update folder name is relative to the plugins folder. + * + * @return the name of the update folder */ public static String getUpdateFolder() { return server.getUpdateFolder(); } /** - * @see Server#getPlayer(String name) + * Gets the update folder. The update folder is used to safely update + * plugins at the right moment on a plugin load. + * + * @return the update folder + */ + public static File getUpdateFolderFile() { + return server.getUpdateFolderFile(); + } + + /** + * Gets the value of the connection throttle setting. + * + * @return the value of the connection throttle setting + */ + public static long getConnectionThrottle() { + return server.getConnectionThrottle(); + } + + /** + * Gets default ticks per animal spawns value. + * <p> + * <b>Example Usage:</b> + * <ul> + * <li>A value of 1 will mean the server will attempt to spawn monsters + * every tick. + * <li>A value of 400 will mean the server will attempt to spawn monsters + * every 400th tick. + * <li>A value below 0 will be reset back to Minecraft's default. + * </ul> + * <p> + * <b>Note:</b> If set to 0, animal spawning will be disabled. We + * recommend using spawn-animals to control this instead. + * <p> + * Minecraft default: 400. + * + * @return the default ticks per animal spawns value + */ + public static int getTicksPerAnimalSpawns() { + return server.getTicksPerAnimalSpawns(); + } + + /** + * Gets the default ticks per monster spawns value. + * <p> + * <b>Example Usage:</b> + * <ul> + * <li>A value of 1 will mean the server will attempt to spawn monsters + * every tick. + * <li>A value of 400 will mean the server will attempt to spawn monsters + * every 400th tick. + * <li>A value below 0 will be reset back to Minecraft's default. + * </ul> + * <p> + * <b>Note:</b> If set to 0, monsters spawning will be disabled. We + * recommend using spawn-monsters to control this instead. + * <p> + * Minecraft default: 1. + * + * @return the default ticks per monsters spawn value + */ + public static int getTicksPerMonsterSpawns() { + return server.getTicksPerMonsterSpawns(); + } + + /** + * Gets a player object by the given username. + * <p> + * This method may not return objects for offline players. + * + * @deprecated Use {@link #getPlayer(UUID)} as player names are no longer + * guaranteed to be unique + * @param name the name to look up + * @return a player if one was found, null otherwise */ @Deprecated public static Player getPlayer(String name) { @@ -203,7 +383,29 @@ public final class Bukkit { } /** - * @see Server#matchPlayer(String name) + * Gets the player with the exact given name, case insensitive. + * + * @deprecated Use {@link #getPlayer(UUID)} as player names are no longer + * guaranteed to be unique + * @param name Exact name of the player to retrieve + * @return a player object if one was found, null otherwise + */ + @Deprecated + public static Player getPlayerExact(String name) { + return server.getPlayerExact(name); + } + + /** + * Attempts to match any players with the given name, and returns a list + * of all possibly matches. + * <p> + * This list is not sorted in any particular order. If an exact match is + * found, the returned list will only contain a single result. + * + * @deprecated Use {@link #getPlayer(UUID)} as player names are no longer + * guaranteed to be unique + * @param name the (partial) name to match + * @return list of all possible players */ @Deprecated public static List<Player> matchPlayer(String name) { @@ -211,77 +413,112 @@ public final class Bukkit { } /** - * @see Server#getPlayer(java.util.UUID) + * Gets the player with the given UUID. + * + * @param id UUID of the player to retrieve + * @return a player object if one was found, null otherwise */ public static Player getPlayer(UUID id) { return server.getPlayer(id); } /** - * @see Server#getPluginManager() + * Gets the plugin manager for interfacing with plugins. + * + * @return a plugin manager for this Server instance */ public static PluginManager getPluginManager() { return server.getPluginManager(); } /** - * @see Server#getScheduler() + * Gets the scheduler for managing scheduled events. + * + * @return a scheduling service for this server */ public static BukkitScheduler getScheduler() { return server.getScheduler(); } /** - * @see Server#getServicesManager() + * Gets a services manager. + * + * @return s services manager */ public static ServicesManager getServicesManager() { return server.getServicesManager(); } /** - * @see Server#getWorlds() + * Gets a list of all worlds on this server. + * + * @return a list of worlds */ public static List<World> getWorlds() { return server.getWorlds(); } /** - * @see Server#createWorld(WorldCreator options) + * Creates or loads a world with the given name using the specified + * options. + * <p> + * If the world is already loaded, it will just return the equivalent of + * getWorld(creator.name()). + * + * @param creator the options to use when creating the world + * @return newly created or loaded world */ - public static World createWorld(WorldCreator options) { - return server.createWorld(options); + public static World createWorld(WorldCreator creator) { + return server.createWorld(creator); } /** - * @see Server#unloadWorld(String name, boolean save) + * Unloads a world with the given name. + * + * @param name Name of the world to unload + * @param save whether to save the chunks before unloading + * @return true if successful, false otherwise */ public static boolean unloadWorld(String name, boolean save) { return server.unloadWorld(name, save); } /** - * @see Server#unloadWorld(World world, boolean save) + * Unloads the given world. + * + * @param world the world to unload + * @param save whether to save the chunks before unloading + * @return true if successful, false otherwise */ public static boolean unloadWorld(World world, boolean save) { return server.unloadWorld(world, save); } /** - * @see Server#getWorld(String name) + * Gets the world with the given name. + * + * @param name the name of the world to retrieve + * @return a world with the given name, or null if none exists */ public static World getWorld(String name) { return server.getWorld(name); } /** - * @see Server#getWorld(UUID uid) + * Gets the world from the given Unique ID. + * + * @param uid a unique-id of the world to retrieve + * @return a world with the given Unique ID, or null if none exists */ public static World getWorld(UUID uid) { return server.getWorld(uid); } /** - * @see Server#getMap(short id) + * Gets the map from the given item ID. + * + * @param id the id of the map to get + * @return a map view if it exists, or null otherwise * @deprecated Magic value */ @Deprecated @@ -290,147 +527,222 @@ public final class Bukkit { } /** - * @see Server#createMap(World world) + * Create a new map with an automatically assigned ID. + * + * @param world the world the map will belong to + * @return a newly created map view */ public static MapView createMap(World world) { return server.createMap(world); } /** - * @see Server#reload() + * Reloads the server, refreshing settings and plugin information. */ public static void reload() { server.reload(); } /** - * @see Server#getLogger() + * Returns the primary logger associated with this server instance. + * + * @return Logger associated with this server */ public static Logger getLogger() { return server.getLogger(); } /** - * @see Server#getPluginCommand(String name) + * Gets a {@link PluginCommand} with the given name or alias. + * + * @param name the name of the command to retrieve + * @return a plugin command if found, null otherwise */ public static PluginCommand getPluginCommand(String name) { return server.getPluginCommand(name); } /** - * @see Server#savePlayers() + * Writes loaded players to disk. */ public static void savePlayers() { server.savePlayers(); } - + /** - * @see Server#dispatchCommand(CommandSender sender, String commandLine) + * Dispatches a command on this server, and executes it if found. + * + * @param sender the apparent sender of the command + * @param commandLine the command + arguments. Example: <code>test abc + * 123</code> + * @return returns false if no target is found + * @throws CommandException thrown when the executor for the given command + * fails with an unhandled exception */ public static boolean dispatchCommand(CommandSender sender, String commandLine) throws CommandException { return server.dispatchCommand(sender, commandLine); } /** - * @see Server#configureDbConfig(ServerConfig config) + * Populates a given {@link ServerConfig} with values attributes to this + * server. + * + * @param config the server config to populate */ public static void configureDbConfig(ServerConfig config) { server.configureDbConfig(config); } /** - * @see Server#addRecipe(Recipe recipe) + * Adds a recipe to the crafting manager. + * + * @param recipe the recipe to add + * @return true if the recipe was added, false if it wasn't for some + * reason */ public static boolean addRecipe(Recipe recipe) { return server.addRecipe(recipe); } /** - * @see Server#getRecipesFor(ItemStack result) + * Get a list of all recipes for a given item. The stack size is ignored + * in comparisons. If the durability is -1, it will match any data value. + * + * @param result the item to match against recipe results + * @return a list of recipes with the given result */ public static List<Recipe> getRecipesFor(ItemStack result) { return server.getRecipesFor(result); } /** - * @see Server#recipeIterator() + * Get an iterator through the list of crafting recipes. + * + * @return an iterator */ public static Iterator<Recipe> recipeIterator() { return server.recipeIterator(); } /** - * @see Server#clearRecipes() + * Clears the list of crafting recipes. */ public static void clearRecipes() { server.clearRecipes(); } /** - * @see Server#resetRecipes() + * Resets the list of crafting recipes to the default. */ public static void resetRecipes() { server.resetRecipes(); } - + /** - * @see Server#getCommandAliases() + * Gets a list of command aliases defined in the server properties. + * + * @return a map of aliases to command names */ public static Map<String, String[]> getCommandAliases() { return server.getCommandAliases(); } /** - * @see Server#getSpawnRadius() + * Gets the radius, in blocks, around each worlds spawn point to protect. + * + * @return spawn radius, or 0 if none */ public static int getSpawnRadius() { return server.getSpawnRadius(); } /** - * @see Server#setSpawnRadius(int value) + * Sets the radius, in blocks, around each worlds spawn point to protect. + * + * @param value new spawn radius, or 0 if none */ public static void setSpawnRadius(int value) { server.setSpawnRadius(value); } /** - * @see Server#getOnlineMode() + * Gets whether the Server is in online mode or not. + * + * @return true if the server authenticates clients, false otherwise */ public static boolean getOnlineMode() { return server.getOnlineMode(); } /** - * @see Server#getAllowFlight() + * Gets whether this server allows flying or not. + * + * @return true if the server allows flight, false otherwise */ public static boolean getAllowFlight() { return server.getAllowFlight(); } /** - * @see Server#isHardcore() + * Gets whether the server is in hardcore mode or not. + * + * @return true if the server mode is hardcore, false otherwise */ public static boolean isHardcore() { return server.isHardcore(); } /** - * @see Server#shutdown() + * Gets whether to use vanilla (false) or exact behaviour (true). + * + * <ul> + * <li>Vanilla behaviour: check for collisions and move the player if + * needed. + * <li>Exact behaviour: spawn players exactly where they should be. + * </ul> + * + * @return true if exact location locations are used for spawning, false + * for vanilla collision detection or otherwise + */ + public static boolean useExactLoginLocation() { + return server.useExactLoginLocation(); + } + + /** + * Shutdowns the server, stopping everything. */ public static void shutdown() { server.shutdown(); } /** - * @see Server#broadcast(String message, String permission) + * Broadcasts the specified message to every user with the given + * permission name. + * + * @param message message to broadcast + * @param permission the required permission {@link Permissible + * permissibles} must have to receive the broadcast + * @return number of message recipients */ public static int broadcast(String message, String permission) { return server.broadcast(message, permission); } /** - * @see Server#getOfflinePlayer(String name) + * Gets the player by the given name, regardless if they are offline or + * online. + * <p> + * This method may involve a blocking web request to get the UUID for the + * given name. + * <p> + * This will return an object even if the player does not exist. To this + * method, all players will exist. + * + * @deprecated Persistent storage of users should be by UUID as names are no longer + * unique past a single session. + * @param name the name the player to retrieve + * @return an offline player + * @see #getOfflinePlayer(java.util.UUID) */ @Deprecated public static OfflinePlayer getOfflinePlayer(String name) { @@ -438,310 +750,372 @@ public final class Bukkit { } /** - * @see Server#getOfflinePlayer(java.util.UUID) + * Gets the player by the given UUID, regardless if they are offline or + * online. + * <p> + * This will return an object even if the player does not exist. To this + * method, all players will exist. + * + * @param id the UUID of the player to retrieve + * @return an offline player */ public static OfflinePlayer getOfflinePlayer(UUID id) { return server.getOfflinePlayer(id); } /** - * @see Server#getPlayerExact(String name) - */ - @Deprecated - public static Player getPlayerExact(String name) { - return server.getPlayerExact(name); - } - - /** - * @see Server#getIPBans() + * Gets a set containing all current IPs that are banned. + * + * @return a set containing banned IP addresses */ public static Set<String> getIPBans() { return server.getIPBans(); } /** - * @see Server#banIP(String address) + * Bans the specified address from the server. + * + * @param address the IP address to ban */ public static void banIP(String address) { server.banIP(address); } /** - * @see Server#unbanIP(String address) + * Unbans the specified address from the server. + * + * @param address the IP address to unban */ public static void unbanIP(String address) { server.unbanIP(address); } /** - * @see Server#getBannedPlayers() + * Gets a set containing all banned players. + * + * @return a set containing banned players */ public static Set<OfflinePlayer> getBannedPlayers() { return server.getBannedPlayers(); } /** - * @see Server#getBanList(BanList.Type) + * Gets a ban list for the supplied type. + * <p> + * Bans by name are no longer supported and this method will return + * null when trying to request them. The replacement is bans by UUID. + * + * @param type the type of list to fetch, cannot be null + * @return a ban list of the specified type */ public static BanList getBanList(BanList.Type type){ return server.getBanList(type); } /** - * @see Server#setWhitelist(boolean value) + * Gets a set containing all player operators. + * + * @return a set containing player operators */ - public static void setWhitelist(boolean value) { - server.setWhitelist(value); + public static Set<OfflinePlayer> getOperators() { + return server.getOperators(); } /** - * @see Server#getWhitelistedPlayers() + * Gets the default {@link GameMode} for new players. + * + * @return the default game mode */ - public static Set<OfflinePlayer> getWhitelistedPlayers() { - return server.getWhitelistedPlayers(); + public static GameMode getDefaultGameMode() { + return server.getDefaultGameMode(); } /** - * @see Server#reloadWhitelist() + * Sets the default {@link GameMode} for new players. + * + * @param mode the new game mode */ - public static void reloadWhitelist() { - server.reloadWhitelist(); + public static void setDefaultGameMode(GameMode mode) { + server.setDefaultGameMode(mode); } /** - * @see Server#getConsoleSender() + * Gets a {@link ConsoleCommandSender} that may be used as an input source + * for this server. + * + * @return a console command sender */ public static ConsoleCommandSender getConsoleSender() { return server.getConsoleSender(); } /** - * @see Server#getOperators() - */ - public static Set<OfflinePlayer> getOperators() { - return server.getOperators(); - } - - /** - * @see Server#getWorldContainer() + * Gets the folder that contains all of the various {@link World}s. + * + * @return folder that contains all worlds */ public static File getWorldContainer() { return server.getWorldContainer(); } /** - * @see Server#getMessenger() - */ - public static Messenger getMessenger() { - return server.getMessenger(); - } - - /** - * @see Server#getAllowEnd() - */ - public static boolean getAllowEnd() { - return server.getAllowEnd(); - } - - /** - * @see Server#getUpdateFolderFile() - */ - public static File getUpdateFolderFile() { - return server.getUpdateFolderFile(); - } - - /** - * @see Server#getConnectionThrottle() - */ - public static long getConnectionThrottle() { - return server.getConnectionThrottle(); - } - - /** - * @see Server#getTicksPerAnimalSpawns() - */ - public static int getTicksPerAnimalSpawns() { - return server.getTicksPerAnimalSpawns(); - } - - /** - * @see Server#getTicksPerMonsterSpawns() - */ - public static int getTicksPerMonsterSpawns() { - return server.getTicksPerMonsterSpawns(); - } - - /** - * @see Server#useExactLoginLocation() - */ - public static boolean useExactLoginLocation() { - return server.useExactLoginLocation(); - } - - /** - * @see Server#getDefaultGameMode() + * Gets every player that has ever played on this server. + * + * @return an array containing all previous players */ - public static GameMode getDefaultGameMode() { - return server.getDefaultGameMode(); + public static OfflinePlayer[] getOfflinePlayers() { + return server.getOfflinePlayers(); } /** - * @see Server#setDefaultGameMode(GameMode mode) + * Gets the {@link Messenger} responsible for this server. + * + * @return messenger responsible for this server */ - public static void setDefaultGameMode(GameMode mode) { - server.setDefaultGameMode(mode); + public static Messenger getMessenger() { + return server.getMessenger(); } /** - * @see Server#getOfflinePlayers() + * Gets the {@link HelpMap} providing help topics for this server. + * + * @return a help map for this server */ - public static OfflinePlayer[] getOfflinePlayers() { - return server.getOfflinePlayers(); + public static HelpMap getHelpMap() { + return server.getHelpMap(); } /** - * @see Server#createInventory(InventoryHolder owner, InventoryType type) + * Creates an empty inventory of the specified type. If the type is {@link + * InventoryType#CHEST}, the new inventory has a size of 27; otherwise the + * new inventory has the normal size for its type. + * + * @param owner the holder of the inventory, or null to indicate no holder + * @param type the type of inventory to create + * @return a new inventory */ public static Inventory createInventory(InventoryHolder owner, InventoryType type) { return server.createInventory(owner, type); } /** - * @see Server#createInventory(InventoryHolder owner, InventoryType type, String title) + * Creates an empty inventory with the specified type and title. If the type + * is {@link InventoryType#CHEST}, the new inventory has a size of 27; + * otherwise the new inventory has the normal size for its type.<br> + * It should be noted that some inventory types do not support titles and + * may not render with said titles on the Minecraft client. + * + * @param owner The holder of the inventory; can be null if there's no holder. + * @param type The type of inventory to create. + * @param title The title of the inventory, to be displayed when it is viewed. + * @return The new inventory. */ public static Inventory createInventory(InventoryHolder owner, InventoryType type, String title) { return server.createInventory(owner, type, title); } /** - * @see Server#createInventory(InventoryHolder owner, int size) + * Creates an empty inventory of type {@link InventoryType#CHEST} with the + * specified size. + * + * @param owner the holder of the inventory, or null to indicate no holder + * @param size a multiple of 9 as the size of inventory to create + * @return a new inventory + * @throws IllegalArgumentException if the size is not a multiple of 9 */ public static Inventory createInventory(InventoryHolder owner, int size) throws IllegalArgumentException { return server.createInventory(owner, size); } /** - * @see Server#createInventory(InventoryHolder owner, int size, String - * title) + * Creates an empty inventory of type {@link InventoryType#CHEST} with the + * specified size and title. + * + * @param owner the holder of the inventory, or null to indicate no holder + * @param size a multiple of 9 as the size of inventory to create + * @param title the title of the inventory, displayed when inventory is + * viewed + * @return a new inventory + * @throws IllegalArgumentException if the size is not a multiple of 9 */ public static Inventory createInventory(InventoryHolder owner, int size, String title) throws IllegalArgumentException { return server.createInventory(owner, size, title); } /** - * @see Server#getHelpMap() - */ - public static HelpMap getHelpMap() { - return server.getHelpMap(); - } - - /** - * @see Server#getMonsterSpawnLimit() + * Gets user-specified limit for number of monsters that can spawn in a + * chunk. + * + * @return the monster spawn limit */ public static int getMonsterSpawnLimit() { return server.getMonsterSpawnLimit(); } /** - * @see Server#getAnimalSpawnLimit() + * Gets user-specified limit for number of animals that can spawn in a + * chunk. + * + * @return the animal spawn limit */ public static int getAnimalSpawnLimit() { return server.getAnimalSpawnLimit(); } /** - * @see Server#getWaterAnimalSpawnLimit() + * Gets user-specified limit for number of water animals that can spawn in + * a chunk. + * + * @return the water animal spawn limit */ public static int getWaterAnimalSpawnLimit() { return server.getWaterAnimalSpawnLimit(); } - + /** - * @see Server#getAmbientSpawnLimit() + * Gets user-specified limit for number of ambient mobs that can spawn in + * a chunk. + * + * @return the ambient spawn limit */ public static int getAmbientSpawnLimit() { return server.getAmbientSpawnLimit(); } /** - * @see Server#isPrimaryThread() + * Checks the current thread against the expected primary thread for the + * server. + * <p> + * <b>Note:</b> this method should not be used to indicate the current + * synchronized state of the runtime. A current thread matching the main + * thread indicates that it is synchronized, but a mismatch <b>does not + * preclude</b> the same assumption. + * + * @return true if the current thread matches the expected primary thread, + * false otherwise */ public static boolean isPrimaryThread() { return server.isPrimaryThread(); } /** - * @see Server#getMotd() + * Gets the message that is displayed on the server list. + * + * @return the servers MOTD */ public static String getMotd() { return server.getMotd(); } /** - * @see Server#getShutdownMessage() + * Gets the default message that is displayed when the server is stopped. + * + * @return the shutdown message */ public static String getShutdownMessage() { return server.getShutdownMessage(); } /** - * @see Server#getWarningState() + * Gets the current warning state for the server. + * + * @return the configured warning state */ public static WarningState getWarningState() { return server.getWarningState(); } /** - * @see Server#getItemFactory() + * Gets the instance of the item factory (for {@link ItemMeta}). + * + * @return the item factory + * @see ItemFactory */ public static ItemFactory getItemFactory() { return server.getItemFactory(); } /** - * @see Server#getScoreboardManager() + * Gets the instance of the scoreboard manager. + * <p> + * This will only exist after the first world has loaded. + * + * @return the scoreboard manager or null if no worlds are loaded. */ public static ScoreboardManager getScoreboardManager() { return server.getScoreboardManager(); } /** - * @see Server#getServerIcon() + * Gets an instance of the server's default server-icon. + * + * @return the default server-icon; null values may be used by the + * implementation to indicate no defined icon, but this behavior is + * not guaranteed */ public static CachedServerIcon getServerIcon() { return server.getServerIcon(); } /** - * @see Server#loadServerIcon(File) + * Loads an image from a file, and returns a cached image for the specific + * server-icon. + * <p> + * Size and type are implementation defined. An incompatible file is + * guaranteed to throw an implementation-defined {@link Exception}. + * + * @param file the file to load the from + * @throws IllegalArgumentException if image is null + * @throws Exception if the image does not meet current server server-icon + * specifications + * @return a cached server-icon that can be used for a {@link + * ServerListPingEvent#setServerIcon(CachedServerIcon)} */ public static CachedServerIcon loadServerIcon(File file) throws IllegalArgumentException, Exception { return server.loadServerIcon(file); } /** - * @see Server#loadServerIcon(BufferedImage) + * Creates a cached server-icon for the specific image. + * <p> + * Size and type are implementation defined. An incompatible file is + * guaranteed to throw an implementation-defined {@link Exception}. + * + * @param image the image to use + * @throws IllegalArgumentException if image is null + * @throws Exception if the image does not meet current server + * server-icon specifications + * @return a cached server-icon that can be used for a {@link + * ServerListPingEvent#setServerIcon(CachedServerIcon)} */ public static CachedServerIcon loadServerIcon(BufferedImage image) throws IllegalArgumentException, Exception { return server.loadServerIcon(image); } /** - * @see Server#setIdleTimeout(int) + * Set the idle kick timeout. Any players idle for the specified amount of + * time will be automatically kicked. + * <p> + * A value of 0 will disable the idle kick timeout. + * + * @param threshold the idle timeout in minutes */ public static void setIdleTimeout(int threshold) { server.setIdleTimeout(threshold); } /** - * @see Server#getIdleTimeout() + * Gets the idle kick timeout. + * + * @return the idle timeout in minutes */ public static int getIdleTimeout() { return server.getIdleTimeout(); } /** - * @see Server#getUnsafe() + * @see UnsafeValues + * @return the unsafe values instance */ @Deprecated public static UnsafeValues getUnsafe() { diff --git a/src/main/java/org/bukkit/ChatColor.java b/src/main/java/org/bukkit/ChatColor.java index 0bbc9fac..b8872b41 100644 --- a/src/main/java/org/bukkit/ChatColor.java +++ b/src/main/java/org/bukkit/ChatColor.java @@ -141,6 +141,8 @@ public enum ChatColor { /** * Checks if this code is a format code as opposed to a color code. + * + * @return whether this ChatColor is a format code */ public boolean isFormat() { return isFormat; @@ -148,6 +150,8 @@ public enum ChatColor { /** * Checks if this code is a color code as opposed to a format code. + * + * @return whether this ChatColor is a color code */ public boolean isColor() { return !isFormat && this != RESET; @@ -198,7 +202,7 @@ public enum ChatColor { * character. The alternate color code character will only be replaced if * it is immediately followed by 0-9, A-F, a-f, K-O, k-o, R or r. * - * @param altColorChar The alternate color code character to replace. Ex: & + * @param altColorChar The alternate color code character to replace. Ex: {@literal &} * @param textToTranslate Text containing the alternate color code character. * @return Text containing the ChatColor.COLOR_CODE color code character. */ diff --git a/src/main/java/org/bukkit/Color.java b/src/main/java/org/bukkit/Color.java index 76ff651f..83927dde 100644 --- a/src/main/java/org/bukkit/Color.java +++ b/src/main/java/org/bukkit/Color.java @@ -113,7 +113,7 @@ public final class Color implements ConfigurationSerializable { * @param green integer from 0-255 * @param blue integer from 0-255 * @return a new Color object for the red, green, blue - * @throws IllegalArgumentException if any value is strictly >255 or <0 + * @throws IllegalArgumentException if any value is strictly {@literal >255 or <0} */ public static Color fromRGB(int red, int green, int blue) throws IllegalArgumentException { return new Color(red, green, blue); @@ -126,7 +126,7 @@ public final class Color implements ConfigurationSerializable { * @param green integer from 0-255 * @param red integer from 0-255 * @return a new Color object for the red, green, blue - * @throws IllegalArgumentException if any value is strictly >255 or <0 + * @throws IllegalArgumentException if any value is strictly {@literal >255 or <0} */ public static Color fromBGR(int blue, int green, int red) throws IllegalArgumentException { return new Color(red, green, blue); diff --git a/src/main/java/org/bukkit/EntityEffect.java b/src/main/java/org/bukkit/EntityEffect.java index ec7d1e39..c816edfd 100644 --- a/src/main/java/org/bukkit/EntityEffect.java +++ b/src/main/java/org/bukkit/EntityEffect.java @@ -17,7 +17,7 @@ public enum EntityEffect { /** * When a mob dies. * <p> - * <b>This will cause client-glitches! + * <b>This will cause client-glitches!</b> */ DEATH(3), diff --git a/src/main/java/org/bukkit/FireworkEffect.java b/src/main/java/org/bukkit/FireworkEffect.java index 6f2d0968..4b0687fe 100644 --- a/src/main/java/org/bukkit/FireworkEffect.java +++ b/src/main/java/org/bukkit/FireworkEffect.java @@ -351,6 +351,8 @@ public final class FireworkEffect implements ConfigurationSerializable { /** * @see ConfigurationSerializable + * @param map the map to deserialize + * @return the resulting serializable */ public static ConfigurationSerializable deserialize(Map<String, Object> map) { Type type = Type.valueOf((String) map.get(TYPE)); @@ -367,6 +369,7 @@ public final class FireworkEffect implements ConfigurationSerializable { .build(); } + @Override public Map<String, Object> serialize() { return ImmutableMap.<String, Object>of( FLICKER, flicker, diff --git a/src/main/java/org/bukkit/Location.java b/src/main/java/org/bukkit/Location.java index 5c18507b..37fecc10 100644 --- a/src/main/java/org/bukkit/Location.java +++ b/src/main/java/org/bukkit/Location.java @@ -209,7 +209,7 @@ public class Location implements Cloneable { * <li>A pitch of 90 represents downward facing, or negative y * direction. * <li>A pitch of -90 represents upward facing, or positive y direction. - * <ul> + * </ul> * Increasing pitch values the equivalent of looking down. * * @param pitch new incline's pitch @@ -225,7 +225,7 @@ public class Location implements Cloneable { * <li>A pitch of 90 represents downward facing, or negative y * direction. * <li>A pitch of -90 represents upward facing, or positive y direction. - * <ul> + * </ul> * Increasing pitch values the equivalent of looking down. * * @return the incline's pitch @@ -260,6 +260,9 @@ public class Location implements Cloneable { /** * Sets the {@link #getYaw() yaw} and {@link #getPitch() pitch} to point * in the direction of the vector. + * + * @param vector the direction vector + * @return the same location */ public Location setDirection(Vector vector) { /* diff --git a/src/main/java/org/bukkit/Rotation.java b/src/main/java/org/bukkit/Rotation.java index dfdb0e5a..5d059eae 100644 --- a/src/main/java/org/bukkit/Rotation.java +++ b/src/main/java/org/bukkit/Rotation.java @@ -12,17 +12,33 @@ public enum Rotation { */ NONE, /** + * Rotated clockwise by 45 degrees + */ + CLOCKWISE_45, + /** * Rotated clockwise by 90 degrees */ CLOCKWISE, /** + * Rotated clockwise by 135 degrees + */ + CLOCKWISE_135, + /** * Flipped upside-down, a 180 degree rotation */ FLIPPED, /** + * Flipped upside-down + 45 degree rotation + */ + FLIPPED_45, + /** * Rotated counter-clockwise by 90 degrees */ COUNTER_CLOCKWISE, + /** + * Rotated counter-clockwise by 45 degrees + */ + COUNTER_CLOCKWISE_45 ; private static final Rotation [] rotations = values(); @@ -33,7 +49,7 @@ public enum Rotation { * @return the relative rotation */ public Rotation rotateClockwise() { - return rotations[(this.ordinal() + 1) & 0x3]; + return rotations[(this.ordinal() + 1) & 0x7]; } /** @@ -42,6 +58,6 @@ public enum Rotation { * @return the relative rotation */ public Rotation rotateCounterClockwise() { - return rotations[(this.ordinal() - 1) & 0x3]; + return rotations[(this.ordinal() - 1) & 0x7]; } } diff --git a/src/main/java/org/bukkit/Server.java b/src/main/java/org/bukkit/Server.java index e14e9f1d..ab6d047d 100644 --- a/src/main/java/org/bukkit/Server.java +++ b/src/main/java/org/bukkit/Server.java @@ -91,7 +91,7 @@ public interface Server extends PluginMessageRecipient { * compatibility. It will not exist at runtime and should not be used * under any circumstances. * - * @Deprecated superseded by {@link #getOnlinePlayers()} + * @deprecated superseded by {@link #getOnlinePlayers()} * @return an array of Players that are currently online */ @Deprecated @@ -735,7 +735,7 @@ public interface Server extends PluginMessageRecipient { /** * Creates an empty inventory with the specified type and title. If the type * is {@link InventoryType#CHEST}, the new inventory has a size of 27; - * otherwise the new inventory has the normal size for its type.<br /> + * otherwise the new inventory has the normal size for its type.<br> * It should be noted that some inventory types do not support titles and * may not render with said titles on the Minecraft client. * @@ -913,6 +913,7 @@ public interface Server extends PluginMessageRecipient { /** * @see UnsafeValues + * @return the unsafe values instance */ @Deprecated UnsafeValues getUnsafe(); diff --git a/src/main/java/org/bukkit/UnsafeValues.java b/src/main/java/org/bukkit/UnsafeValues.java index fc8a179c..568c83e3 100644 --- a/src/main/java/org/bukkit/UnsafeValues.java +++ b/src/main/java/org/bukkit/UnsafeValues.java @@ -14,7 +14,7 @@ import org.bukkit.inventory.ItemStack; * <p> * This interface is unsupported and only for internal use. * - * @deprecated Unsupported & internal use only + * @deprecated Unsupported {@literal &} internal use only */ @Deprecated public interface UnsafeValues { diff --git a/src/main/java/org/bukkit/World.java b/src/main/java/org/bukkit/World.java index 9bf2c41b..d306201c 100644 --- a/src/main/java/org/bukkit/World.java +++ b/src/main/java/org/bukkit/World.java @@ -402,6 +402,7 @@ public interface World extends PluginMessageRecipient, Metadatable { * Get a collection of all entities in this World matching the given * class/interface * + * @param <T> an entity subclass * @param classes The classes representing the types of entity to match * @return A List of all Entities currently residing in this world that * match the given class/interface @@ -412,7 +413,8 @@ public interface World extends PluginMessageRecipient, Metadatable { /** * Get a collection of all entities in this World matching the given * class/interface - * + * + * @param <T> an entity subclass * @param cls The class representing the type of entity to match * @return A List of all Entities currently residing in this world that * match the given class/interface @@ -746,6 +748,7 @@ public interface World extends PluginMessageRecipient, Metadatable { * Plays an effect to all players within a default radius around a given * location. * + * @param <T> data dependant on the type of effect * @param location the {@link Location} around which players must be to * hear the sound * @param effect the {@link Effect} @@ -756,6 +759,7 @@ public interface World extends PluginMessageRecipient, Metadatable { /** * Plays an effect to all players within a given radius around a location. * + * @param <T> data dependant on the type of effect * @param location the {@link Location} around which players must be to * hear the effect * @param effect the {@link Effect} @@ -1050,6 +1054,8 @@ public interface World extends PluginMessageRecipient, Metadatable { * <p> * <b>Note:</b> If set to a negative number the world will use the * server-wide spawn limit instead. + * + * @param limit the new mob limit */ void setMonsterSpawnLimit(int limit); @@ -1067,6 +1073,8 @@ public interface World extends PluginMessageRecipient, Metadatable { * <p> * <b>Note:</b> If set to a negative number the world will use the * server-wide spawn limit instead. + * + * @param limit the new mob limit */ void setAnimalSpawnLimit(int limit); @@ -1084,6 +1092,8 @@ public interface World extends PluginMessageRecipient, Metadatable { * <p> * <b>Note:</b> If set to a negative number the world will use the * server-wide spawn limit instead. + * + * @param limit the new mob limit */ void setWaterAnimalSpawnLimit(int limit); @@ -1101,6 +1111,8 @@ public interface World extends PluginMessageRecipient, Metadatable { * <p> * <b>Note:</b> If set to a negative number the world will use the * server-wide spawn limit instead. + * + * @param limit the new mob limit */ void setAmbientSpawnLimit(int limit); diff --git a/src/main/java/org/bukkit/block/Block.java b/src/main/java/org/bukkit/block/Block.java index 4a53109a..38e84415 100644 --- a/src/main/java/org/bukkit/block/Block.java +++ b/src/main/java/org/bukkit/block/Block.java @@ -148,6 +148,7 @@ public interface Block extends Metadatable { * If the provided Location is null this method does nothing and returns * null. * + * @param loc the location to copy into * @return The Location object provided or null */ Location getLocation(Location loc); @@ -219,16 +220,16 @@ public interface Block extends Metadatable { boolean setTypeIdAndData(int type, byte data, boolean applyPhysics); /** - * Gets the face relation of this block compared to the given block + * Gets the face relation of this block compared to the given block. * <p> - * For example: - * <pre> + * For example: + * <pre>{@code * Block current = world.getBlockAt(100, 100, 100); * Block target = world.getBlockAt(100, 101, 100); * * current.getFace(target) == BlockFace.Up; - * </pre> - * <br /> + * }</pre> + * <br> * If the given block is not connected to this block, null may be returned * * @param block Block to compare against this block diff --git a/src/main/java/org/bukkit/block/BlockState.java b/src/main/java/org/bukkit/block/BlockState.java index ca571739..96bf1d0d 100644 --- a/src/main/java/org/bukkit/block/BlockState.java +++ b/src/main/java/org/bukkit/block/BlockState.java @@ -96,6 +96,7 @@ public interface BlockState extends Metadatable { * If the provided Location is null this method does nothing and returns * null. * + * @param loc the location to copy into * @return The Location object provided or null */ Location getLocation(Location loc); diff --git a/src/main/java/org/bukkit/command/Command.java b/src/main/java/org/bukkit/command/Command.java index 87c33d9c..e5fb0f8f 100644 --- a/src/main/java/org/bukkit/command/Command.java +++ b/src/main/java/org/bukkit/command/Command.java @@ -57,7 +57,14 @@ public abstract class Command { public abstract boolean execute(CommandSender sender, String commandLabel, String[] args); /** + * Executed on tab completion for this command, returning a list of + * options the player can tab through. + * * @deprecated This method is not supported and returns null + * @param sender Source object which is executing this command + * @param args All arguments passed to the command, split via ' ' + * @return a list of tab-completions for the specified arguments. This + * will never be null. List may be immutable. */ @Deprecated public List<String> tabComplete(CommandSender sender, String[] args) { diff --git a/src/main/java/org/bukkit/command/defaults/HelpCommand.java b/src/main/java/org/bukkit/command/defaults/HelpCommand.java index ff73b26f..aa359e4a 100644 --- a/src/main/java/org/bukkit/command/defaults/HelpCommand.java +++ b/src/main/java/org/bukkit/command/defaults/HelpCommand.java @@ -165,7 +165,7 @@ public class HelpCommand extends VanillaCommand { /** * Computes the Dameraur-Levenshtein Distance between two strings. Adapted - * from the algorithm at <a href="http://en.wikipedia.org/wiki/Damerau–Levenshtein_distance">Wikipedia: Damerau–Levenshtein distance</a> + * from the algorithm at <a href="http://en.wikipedia.org/wiki/Damerau%E2%80%93Levenshtein_distance">Wikipedia: Damerau–Levenshtein distance</a> * * @param s1 The first string being compared. * @param s2 The second string being compared. diff --git a/src/main/java/org/bukkit/configuration/Configuration.java b/src/main/java/org/bukkit/configuration/Configuration.java index 9289c218..52e3ac42 100644 --- a/src/main/java/org/bukkit/configuration/Configuration.java +++ b/src/main/java/org/bukkit/configuration/Configuration.java @@ -29,7 +29,7 @@ public interface Configuration extends ConfigurationSection { * collection, then a new {@link MemoryConfiguration} will be created to * hold the new default values. * - * @param defaults A map of Path->Values to add to defaults. + * @param defaults A map of Path{@literal ->}Values to add to defaults. * @throws IllegalArgumentException Thrown if defaults is null. */ public void addDefaults(Map<String, Object> defaults); diff --git a/src/main/java/org/bukkit/configuration/file/FileConfiguration.java b/src/main/java/org/bukkit/configuration/file/FileConfiguration.java index 9d6d1c61..9cbe0cad 100644 --- a/src/main/java/org/bukkit/configuration/file/FileConfiguration.java +++ b/src/main/java/org/bukkit/configuration/file/FileConfiguration.java @@ -271,7 +271,7 @@ public abstract class FileConfiguration extends MemoryConfiguration { * Compiles the header for this {@link FileConfiguration} and returns the * result. * <p> - * This will use the header from {@link #options()} -> {@link + * This will use the header from {@link #options()} -> {@link * FileConfigurationOptions#header()}, respecting the rules of {@link * FileConfigurationOptions#copyHeader()} if set. * diff --git a/src/main/java/org/bukkit/configuration/serialization/ConfigurationSerializable.java b/src/main/java/org/bukkit/configuration/serialization/ConfigurationSerializable.java index ba3c8c47..74b73f9d 100644 --- a/src/main/java/org/bukkit/configuration/serialization/ConfigurationSerializable.java +++ b/src/main/java/org/bukkit/configuration/serialization/ConfigurationSerializable.java @@ -9,11 +9,11 @@ import java.util.Map; * methods as defined by this interface: * <ul> * <li>A static method "deserialize" that accepts a single {@link Map}< - * {@link String}, {@link Object}> and returns the class.</li> + * {@link String}, {@link Object}> and returns the class.</li> * <li>A static method "valueOf" that accepts a single {@link Map}<{@link - * String}, {@link Object}> and returns the class.</li> + * String}, {@link Object}> and returns the class.</li> * <li>A constructor that accepts a single {@link Map}<{@link String}, - * {@link Object}>.</li> + * {@link Object}>.</li> * </ul> * In addition to implementing this interface, you must register the class * with {@link ConfigurationSerialization#registerClass(Class)}. diff --git a/src/main/java/org/bukkit/entity/CreatureType.java b/src/main/java/org/bukkit/entity/CreatureType.java index 48ff687a..127d4756 100644 --- a/src/main/java/org/bukkit/entity/CreatureType.java +++ b/src/main/java/org/bukkit/entity/CreatureType.java @@ -71,6 +71,7 @@ public enum CreatureType { /** * + * @return the raw type id * @deprecated Magic value */ @Deprecated @@ -84,6 +85,8 @@ public enum CreatureType { /** * + * @param id the raw type id + * @return the matching CreatureType or null * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/entity/Damageable.java b/src/main/java/org/bukkit/entity/Damageable.java index 53877a84..d0599cf0 100644 --- a/src/main/java/org/bukkit/entity/Damageable.java +++ b/src/main/java/org/bukkit/entity/Damageable.java @@ -15,6 +15,8 @@ public interface Damageable extends Entity { * This method exists for legacy reasons to provide backwards * compatibility. It will not exist at runtime and should not be used * under any circumstances. + * + * @param amount Amount of damage to deal */ @Deprecated void _INVALID_damage(int amount); @@ -32,6 +34,9 @@ public interface Damageable extends Entity { * This method exists for legacy reasons to provide backwards * compatibility. It will not exist at runtime and should not be used * under any circumstances. + * + * @param amount Amount of damage to deal + * @param source Entity which to attribute this damage from */ @Deprecated void _INVALID_damage(int amount, Entity source); @@ -47,6 +52,8 @@ public interface Damageable extends Entity { * This method exists for legacy reasons to provide backwards * compatibility. It will not exist at runtime and should not be used * under any circumstances. + * + * @return Health represented from 0 to max */ @Deprecated int _INVALID_getHealth(); @@ -56,7 +63,7 @@ public interface Damageable extends Entity { * dead. * * @param health New health represented from 0 to max - * @throws IllegalArgumentException Thrown if the health is < 0 or > + * @throws IllegalArgumentException Thrown if the health is {@literal < 0 or >} * {@link #getMaxHealth()} */ void setHealth(double health); @@ -65,6 +72,10 @@ public interface Damageable extends Entity { * This method exists for legacy reasons to provide backwards * compatibility. It will not exist at runtime and should not be used * under any circumstances. + * + * @param health New health represented from 0 to max + * @throws IllegalArgumentException Thrown if the health is {@literal < 0 or >} + * {@link #getMaxHealth()} */ @Deprecated void _INVALID_setHealth(int health); @@ -80,6 +91,8 @@ public interface Damageable extends Entity { * This method exists for legacy reasons to provide backwards * compatibility. It will not exist at runtime and should not be used * under any circumstances. + * + * @return Maximum health */ @Deprecated int _INVALID_getMaxHealth(); @@ -101,6 +114,8 @@ public interface Damageable extends Entity { * This method exists for legacy reasons to provide backwards * compatibility. It will not exist at runtime and should not be used * under any circumstances. + * + * @param health amount of health to set the maximum to */ @Deprecated void _INVALID_setMaxHealth(int health); diff --git a/src/main/java/org/bukkit/entity/Entity.java b/src/main/java/org/bukkit/entity/Entity.java index 39c35c05..9fa886f6 100644 --- a/src/main/java/org/bukkit/entity/Entity.java +++ b/src/main/java/org/bukkit/entity/Entity.java @@ -30,6 +30,7 @@ public interface Entity extends Metadatable { * If the provided Location is null this method does nothing and returns * null. * + * @param loc the location to copy into * @return The Location object provided or null */ public Location getLocation(Location loc); @@ -109,7 +110,7 @@ public interface Entity extends Metadatable { * @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 + * @return {@code List<Entity>} List of entities nearby */ public List<org.bukkit.entity.Entity> getNearbyEntities(double x, double y, double z); diff --git a/src/main/java/org/bukkit/entity/EntityType.java b/src/main/java/org/bukkit/entity/EntityType.java index 2a69367d..ccc024bf 100644 --- a/src/main/java/org/bukkit/entity/EntityType.java +++ b/src/main/java/org/bukkit/entity/EntityType.java @@ -209,6 +209,7 @@ public enum EntityType { /** * + * @return the entity type's name * @deprecated Magic value */ @Deprecated @@ -222,6 +223,7 @@ public enum EntityType { /** * + * @return the raw type id * @deprecated Magic value */ @Deprecated @@ -231,6 +233,8 @@ public enum EntityType { /** * + * @param name the entity type's name + * @return the matching entity type or null * @deprecated Magic value */ @Deprecated @@ -243,6 +247,8 @@ public enum EntityType { /** * + * @param id the raw type id + * @return the matching entity type or null * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/entity/LivingEntity.java b/src/main/java/org/bukkit/entity/LivingEntity.java index 5e2a41ae..a0fefd85 100644 --- a/src/main/java/org/bukkit/entity/LivingEntity.java +++ b/src/main/java/org/bukkit/entity/LivingEntity.java @@ -173,6 +173,8 @@ public interface LivingEntity extends Entity, Damageable, ProjectileSource { * This method exists for legacy reasons to provide backwards * compatibility. It will not exist at runtime and should not be used * under any circumstances. + * + * @return damage taken since the last no damage ticks time period */ @Deprecated public int _INVALID_getLastDamage(); @@ -188,6 +190,8 @@ public interface LivingEntity extends Entity, Damageable, ProjectileSource { * This method exists for legacy reasons to provide backwards * compatibility. It will not exist at runtime and should not be used * under any circumstances. + * + * @param damage amount of damage */ @Deprecated public void _INVALID_setLastDamage(int damage); diff --git a/src/main/java/org/bukkit/entity/Minecart.java b/src/main/java/org/bukkit/entity/Minecart.java index a7bb0944..0b3e7745 100644 --- a/src/main/java/org/bukkit/entity/Minecart.java +++ b/src/main/java/org/bukkit/entity/Minecart.java @@ -11,6 +11,8 @@ public interface Minecart extends Vehicle { * This method exists for legacy reasons to provide backwards * compatibility. It will not exist at runtime and should not be used * under any circumstances. + * + * @param damage over 40 to "kill" a minecart */ @Deprecated public void _INVALID_setDamage(int damage); @@ -26,6 +28,8 @@ public interface Minecart extends Vehicle { * This method exists for legacy reasons to provide backwards * compatibility. It will not exist at runtime and should not be used * under any circumstances. + * + * @return The damage */ @Deprecated public int _INVALID_getDamage(); diff --git a/src/main/java/org/bukkit/entity/Player.java b/src/main/java/org/bukkit/entity/Player.java index fe8a0bd7..229a71a0 100644 --- a/src/main/java/org/bukkit/entity/Player.java +++ b/src/main/java/org/bukkit/entity/Player.java @@ -255,6 +255,7 @@ public interface Player extends HumanEntity, Conversable, CommandSender, Offline /** * Plays an effect to just this player. * + * @param <T> the data based based on the type of the effect * @param loc the location to play the effect at * @param effect the {@link Effect} * @param data a data bit needed for some effects @@ -360,6 +361,7 @@ public interface Player extends HumanEntity, Conversable, CommandSender, Offline /** * Gets whether this player has the given achievement. * + * @param achievement the achievement to check * @return whether the player has the achievement * @throws IllegalArgumentException if achievement is null */ @@ -763,7 +765,7 @@ public interface Player extends HumanEntity, Conversable, CommandSender, Offline * Gets the players current saturation level. * <p> * Saturation is a buffer for food level. Your food level will not drop if - * you are saturated > 0. + * you are saturated {@literal >} 0. * * @return Saturation level */ diff --git a/src/main/java/org/bukkit/entity/Projectile.java b/src/main/java/org/bukkit/entity/Projectile.java index 90ce3b3f..a5599fa3 100644 --- a/src/main/java/org/bukkit/entity/Projectile.java +++ b/src/main/java/org/bukkit/entity/Projectile.java @@ -11,6 +11,8 @@ public interface Projectile extends Entity { * This method exists for legacy reasons to provide backwards * compatibility. It will not exist at runtime and should not be used * under any circumstances. + * + * @return the {@link LivingEntity} that shot this projectile */ @Deprecated public LivingEntity _INVALID_getShooter(); @@ -26,6 +28,8 @@ public interface Projectile extends Entity { * This method exists for legacy reasons to provide backwards * compatibility. It will not exist at runtime and should not be used * under any circumstances. + * + * @param shooter the {@link LivingEntity} that shot this projectile */ @Deprecated public void _INVALID_setShooter(LivingEntity shooter); diff --git a/src/main/java/org/bukkit/event/EventHandler.java b/src/main/java/org/bukkit/event/EventHandler.java index e42acc19..4c9fb3cd 100644 --- a/src/main/java/org/bukkit/event/EventHandler.java +++ b/src/main/java/org/bukkit/event/EventHandler.java @@ -24,6 +24,8 @@ public @interface EventHandler { * <li>HIGHEST * <li>MONITOR * </ol> + * + * @return the priority */ EventPriority priority() default EventPriority.NORMAL; @@ -32,6 +34,8 @@ public @interface EventHandler { * <p> * If ignoreCancelled is true and the event is cancelled, the method is * not called. Otherwise, the method is always called. + * + * @return whether cancelled events should be ignored */ boolean ignoreCancelled() default false; } diff --git a/src/main/java/org/bukkit/event/block/BlockCanBuildEvent.java b/src/main/java/org/bukkit/event/block/BlockCanBuildEvent.java index 3860f443..613feb91 100644 --- a/src/main/java/org/bukkit/event/block/BlockCanBuildEvent.java +++ b/src/main/java/org/bukkit/event/block/BlockCanBuildEvent.java @@ -29,6 +29,9 @@ public class BlockCanBuildEvent extends BlockEvent { /** * * @deprecated Magic value + * @param block the block involved in this event + * @param id the id of the block to place + * @param canBuild whether we can build */ @Deprecated public BlockCanBuildEvent(final Block block, final int id, final boolean canBuild) { diff --git a/src/main/java/org/bukkit/event/block/BlockIgniteEvent.java b/src/main/java/org/bukkit/event/block/BlockIgniteEvent.java index 733a15ec..5ea8b07f 100644 --- a/src/main/java/org/bukkit/event/block/BlockIgniteEvent.java +++ b/src/main/java/org/bukkit/event/block/BlockIgniteEvent.java @@ -19,10 +19,6 @@ public class BlockIgniteEvent extends BlockEvent implements Cancellable { private final Block ignitingBlock; private boolean cancel; - /** - * @deprecated use {@link BlockIgniteEvent#BlockIgniteEvent(Block, - * IgniteCause, Entity)} instead. - */ @Deprecated public BlockIgniteEvent(final Block theBlock, final IgniteCause cause, final Player thePlayer) { this(theBlock, cause, (Entity) thePlayer); diff --git a/src/main/java/org/bukkit/event/block/BlockPhysicsEvent.java b/src/main/java/org/bukkit/event/block/BlockPhysicsEvent.java index e05d1caa..01a545b4 100644 --- a/src/main/java/org/bukkit/event/block/BlockPhysicsEvent.java +++ b/src/main/java/org/bukkit/event/block/BlockPhysicsEvent.java @@ -16,6 +16,8 @@ public class BlockPhysicsEvent extends BlockEvent implements Cancellable { /** * * @deprecated Magic value + * @param block the block involved in this event + * @param changed the changed block's type id */ @Deprecated public BlockPhysicsEvent(final Block block, final int changed) { diff --git a/src/main/java/org/bukkit/event/block/SignChangeEvent.java b/src/main/java/org/bukkit/event/block/SignChangeEvent.java index d1b7908d..83188cf5 100644 --- a/src/main/java/org/bukkit/event/block/SignChangeEvent.java +++ b/src/main/java/org/bukkit/event/block/SignChangeEvent.java @@ -46,8 +46,8 @@ public class SignChangeEvent extends BlockEvent implements Cancellable { * @param index index of the line to get * @return the String containing the line of text associated with the * provided index - * @throws IndexOutOfBoundsException thrown when the provided index is > 3 - * or < 0 + * @throws IndexOutOfBoundsException thrown when the provided index is {@literal > 3 + * or < 0} */ public String getLine(int index) throws IndexOutOfBoundsException { return lines[index]; @@ -58,8 +58,8 @@ public class SignChangeEvent extends BlockEvent implements Cancellable { * * @param index index of the line to set * @param line text to set - * @throws IndexOutOfBoundsException thrown when the provided index is > 3 - * or < 0 + * @throws IndexOutOfBoundsException thrown when the provided index is {@literal > 3 + * or < 0} */ public void setLine(int index, String line) throws IndexOutOfBoundsException { lines[index] = line; diff --git a/src/main/java/org/bukkit/event/entity/EntityDamageEvent.java b/src/main/java/org/bukkit/event/entity/EntityDamageEvent.java index 2cc07996..9ef48c84 100644 --- a/src/main/java/org/bukkit/event/entity/EntityDamageEvent.java +++ b/src/main/java/org/bukkit/event/entity/EntityDamageEvent.java @@ -63,6 +63,7 @@ public class EntityDamageEvent extends EntityEvent implements Cancellable { * event's construction. * * @param type the modifier + * @return the original damage * @throws IllegalArgumentException if type is null */ public double getOriginalDamage(DamageModifier type) throws IllegalArgumentException { @@ -79,6 +80,7 @@ public class EntityDamageEvent extends EntityEvent implements Cancellable { /** * Sets the damage for the specified modifier. * + * @param type the damage modifier * @param damage the scalar value of the damage's modifier * @see #getFinalDamage() * @throws IllegalArgumentException if type is null @@ -96,6 +98,7 @@ public class EntityDamageEvent extends EntityEvent implements Cancellable { /** * Gets the damage change for some modifier * + * @param type the damage modifier * @return The raw amount of damage caused by the event * @throws IllegalArgumentException if type is null * @see DamageModifier#BASE @@ -150,6 +153,8 @@ public class EntityDamageEvent extends EntityEvent implements Cancellable { * This method exists for legacy reasons to provide backwards * compatibility. It will not exist at runtime and should not be used * under any circumstances. + * + * @return the (rounded) damage */ @Deprecated public int _INVALID_getDamage() { @@ -197,6 +202,8 @@ public class EntityDamageEvent extends EntityEvent implements Cancellable { * This method exists for legacy reasons to provide backwards * compatibility. It will not exist at runtime and should not be used * under any circumstances. + * + * @param damage the new damage value */ @Deprecated public void _INVALID_setDamage(int damage) { diff --git a/src/main/java/org/bukkit/event/entity/EntityPortalExitEvent.java b/src/main/java/org/bukkit/event/entity/EntityPortalExitEvent.java index 682fe590..41edef6b 100644 --- a/src/main/java/org/bukkit/event/entity/EntityPortalExitEvent.java +++ b/src/main/java/org/bukkit/event/entity/EntityPortalExitEvent.java @@ -26,7 +26,7 @@ public class EntityPortalExitEvent extends EntityTeleportEvent { * Gets a copy of the velocity that the entity has before entering the * portal. * - * @return velocity of entity before entering portal + * @return velocity of entity before entering the portal */ public Vector getBefore() { return this.before.clone(); @@ -36,7 +36,7 @@ public class EntityPortalExitEvent extends EntityTeleportEvent { * Gets a copy of the velocity that the entity will have after exiting the * portal. * - * @return velocity of entity after exiting portal + * @return velocity of entity after exiting the portal */ public Vector getAfter() { return this.after.clone(); @@ -44,6 +44,8 @@ public class EntityPortalExitEvent extends EntityTeleportEvent { /** * Sets the velocity that the entity will have after exiting the portal. + * + * @param after the velocity after exiting the portal */ public void setAfter(Vector after) { this.after = after.clone(); diff --git a/src/main/java/org/bukkit/event/entity/EntityRegainHealthEvent.java b/src/main/java/org/bukkit/event/entity/EntityRegainHealthEvent.java index b4291b07..a7b3517a 100644 --- a/src/main/java/org/bukkit/event/entity/EntityRegainHealthEvent.java +++ b/src/main/java/org/bukkit/event/entity/EntityRegainHealthEvent.java @@ -38,6 +38,8 @@ public class EntityRegainHealthEvent extends EntityEvent implements Cancellable * This method exists for legacy reasons to provide backwards * compatibility. It will not exist at runtime and should not be used * under any circumstances. + * + * @return the (rounded) amount regained */ @Deprecated public int _INVALID_getAmount() { @@ -57,16 +59,20 @@ public class EntityRegainHealthEvent extends EntityEvent implements Cancellable * This method exists for legacy reasons to provide backwards * compatibility. It will not exist at runtime and should not be used * under any circumstances. + * + * @param amount the amount that will be regained */ @Deprecated public void _INVALID_setAmount(int amount) { setAmount(amount); } + @Override public boolean isCancelled() { return cancelled; } + @Override public void setCancelled(boolean cancel) { cancelled = cancel; } diff --git a/src/main/java/org/bukkit/event/player/PlayerFishEvent.java b/src/main/java/org/bukkit/event/player/PlayerFishEvent.java index 7416a0ae..5f1ecfef 100644 --- a/src/main/java/org/bukkit/event/player/PlayerFishEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerFishEvent.java @@ -20,9 +20,9 @@ public class PlayerFishEvent extends PlayerEvent implements Cancellable { /** * @deprecated replaced by {@link #PlayerFishEvent(Player, Entity, Fish, * State)} to include the {@link Fish} hook entity. - * @param player - * @param entity - * @param state + * @param player the player fishing + * @param entity the caught entity + * @param state the state of fishing */ @Deprecated public PlayerFishEvent(final Player player, final Entity entity, final State state) { @@ -40,7 +40,7 @@ public class PlayerFishEvent extends PlayerEvent implements Cancellable { * Gets the entity caught by the player. * <p> * If player has fished successfully, the result may be cast to {@link - * Item}. + * org.bukkit.entity.Item}. * * @return Entity caught by the player, Entity if fishing, and null if * bobber has gotten stuck in the ground or nothing has been caught diff --git a/src/main/java/org/bukkit/event/player/PlayerInteractAtEntityEvent.java b/src/main/java/org/bukkit/event/player/PlayerInteractAtEntityEvent.java index db5678ee..3293b115 100644 --- a/src/main/java/org/bukkit/event/player/PlayerInteractAtEntityEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerInteractAtEntityEvent.java @@ -2,6 +2,7 @@ package org.bukkit.event.player; import org.bukkit.entity.Entity; import org.bukkit.entity.Player; +import org.bukkit.event.HandlerList; import org.bukkit.util.Vector; /** @@ -9,6 +10,7 @@ import org.bukkit.util.Vector; * with a location on the entity the was clicked. */ public class PlayerInteractAtEntityEvent extends PlayerInteractEntityEvent { + private static final HandlerList handlers = new HandlerList(); private final Vector position; public PlayerInteractAtEntityEvent(Player who, Entity clickedEntity, Vector position) { @@ -19,4 +21,13 @@ public class PlayerInteractAtEntityEvent extends PlayerInteractEntityEvent { public Vector getClickedPosition() { return position.clone(); } + + @Override + public HandlerList getHandlers() { + return handlers; + } + + public static HandlerList getHandlerList() { + return handlers; + } } diff --git a/src/main/java/org/bukkit/event/player/PlayerLoginEvent.java b/src/main/java/org/bukkit/event/player/PlayerLoginEvent.java index b74b7b89..68834ddd 100644 --- a/src/main/java/org/bukkit/event/player/PlayerLoginEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerLoginEvent.java @@ -17,6 +17,7 @@ public class PlayerLoginEvent extends PlayerEvent { /** * @deprecated Address should be provided in other constructor + * @param player The {@link Player} for this event */ @Deprecated public PlayerLoginEvent(final Player player) { @@ -25,6 +26,8 @@ public class PlayerLoginEvent extends PlayerEvent { /** * @deprecated Address should be provided in other constructor + * @param player The {@link Player} for this event + * @param hostname The hostname that was used to connect to the server */ @Deprecated public PlayerLoginEvent(final Player player, final String hostname) { @@ -49,6 +52,9 @@ public class PlayerLoginEvent extends PlayerEvent { /** * @deprecated Address and hostname should be provided in other * constructor + * @param player The {@link Player} for this event + * @param result The result status for this event + * @param message The message to be displayed if result denies login */ @Deprecated public PlayerLoginEvent(final Player player, final Result result, final String message) { diff --git a/src/main/java/org/bukkit/event/server/ServerListPingEvent.java b/src/main/java/org/bukkit/event/server/ServerListPingEvent.java index c61afdf7..343f238f 100644 --- a/src/main/java/org/bukkit/event/server/ServerListPingEvent.java +++ b/src/main/java/org/bukkit/event/server/ServerListPingEvent.java @@ -32,6 +32,10 @@ public class ServerListPingEvent extends ServerEvent implements Iterable<Player> * This constructor is intended for implementations that provide the * {@link #iterator()} method, thus provided the {@link #getNumPlayers()} * count. + * + * @param address the address of the pinger + * @param motd the message of the day + * @param maxPlayers the max number of players */ protected ServerListPingEvent(final InetAddress address, final String motd, final int maxPlayers) { this.numPlayers = MAGIC_PLAYER_COUNT; diff --git a/src/main/java/org/bukkit/event/vehicle/VehicleDamageEvent.java b/src/main/java/org/bukkit/event/vehicle/VehicleDamageEvent.java index 304ee2cb..c7b9c1a6 100644 --- a/src/main/java/org/bukkit/event/vehicle/VehicleDamageEvent.java +++ b/src/main/java/org/bukkit/event/vehicle/VehicleDamageEvent.java @@ -48,6 +48,8 @@ public class VehicleDamageEvent extends VehicleEvent implements Cancellable { * This method exists for legacy reasons to provide backwards * compatibility. It will not exist at runtime and should not be used * under any circumstances. + * + * @return the damage */ @Deprecated public int _INVALID_getDamage() { @@ -67,6 +69,8 @@ public class VehicleDamageEvent extends VehicleEvent implements Cancellable { * This method exists for legacy reasons to provide backwards * compatibility. It will not exist at runtime and should not be used * under any circumstances. + * + * @param damage the damage */ @Deprecated public void _INVALID_setDamage(int damage) { diff --git a/src/main/java/org/bukkit/event/world/StructureGrowEvent.java b/src/main/java/org/bukkit/event/world/StructureGrowEvent.java index d1c9822a..62d300d7 100644 --- a/src/main/java/org/bukkit/event/world/StructureGrowEvent.java +++ b/src/main/java/org/bukkit/event/world/StructureGrowEvent.java @@ -9,8 +9,8 @@ import org.bukkit.event.Cancellable; import org.bukkit.event.HandlerList; /** - * Event that is called when an organic structure attempts to grow (Sapling -> - * Tree), (Mushroom -> Huge Mushroom), naturally or using bonemeal. + * Event that is called when an organic structure attempts to grow (Sapling {@literal ->} + * Tree), (Mushroom {@literal ->} Huge Mushroom), naturally or using bonemeal. */ public class StructureGrowEvent extends WorldEvent implements Cancellable { private static final HandlerList handlers = new HandlerList(); diff --git a/src/main/java/org/bukkit/generator/ChunkGenerator.java b/src/main/java/org/bukkit/generator/ChunkGenerator.java index 8e08bdc9..e5db6497 100644 --- a/src/main/java/org/bukkit/generator/ChunkGenerator.java +++ b/src/main/java/org/bukkit/generator/ChunkGenerator.java @@ -89,7 +89,7 @@ public abstract class ChunkGenerator { * <pre> * short[][] result = new short[world-height / 16][]; * </pre> - * Each section (sectionID = (Y>>4)) that has blocks needs to be allocated + * Each section {@code (sectionID = (Y>>4))} that has blocks needs to be allocated * space for the 4096 blocks in that section: * <pre> * result[sectionID] = new short[4096]; @@ -100,20 +100,20 @@ public abstract class ChunkGenerator { * following mapping function: * <pre> * void setBlock(short[][] result, int x, int y, int z, short blkid) { - * if (result[y >> 4] == null) { - * result[y >> 4] = new short[4096]; + * {@code if (result[y >> 4] == null) {} + * {@code result[y >> 4] = new short[4096];} * } - * result[y >> 4][((y & 0xF) << 8) | (z << 4) | x] = blkid; + * {@code result[y >> 4][((y & 0xF) << 8) | (z << 4) | x] = blkid;} * } * </pre> * while reading a block ID can be done with the following mapping * function: * <pre> * short getBlock(short[][] result, int x, int y, int z) { - * if (result[y >> 4] == null) { + * {@code if (result[y >> 4] == null) {} * return (short)0; * } - * return result[y >> 4][((y & 0xF) << 8) | (z << 4) | x]; + * {@code return result[y >> 4][((y & 0xF) << 8) | (z << 4) | x];} * } * </pre> * while sections that are not populated can be left null. @@ -122,20 +122,20 @@ public abstract class ChunkGenerator { * following mapping function: * <pre> * void setBlock(short[][] result, int x, int y, int z, short blkid) { - * if (result[y >> 4) == null) { - * result[y >> 4] = new short[4096]; + * {@code if (result[y >> 4) == null) {} + * {@code result[y >> 4] = new short[4096];} * } - * result[y >> 4][((y & 0xF) << 8) | (z << 4) | x] = blkid; + * {@code result[y >> 4][((y & 0xF) << 8) | (z << 4) | x] = blkid;} * } * </pre> * while reading a block ID can be done with the following mapping * function: * <pre> * short getBlock(short[][] result, int x, int y, int z) { - * if (result[y >> 4) == null) { + * {@code if (result[y >> 4) == null) {} * return (short)0; * } - * return result[y >> 4][((y & 0xF) << 8) | (z << 4) | x]; + * {@code return result[y >> 4][((y & 0xF) << 8) | (z << 4) | x];} * } * </pre> * <p> @@ -173,7 +173,7 @@ public abstract class ChunkGenerator { * <pre> * byte[][] result = new byte[world-height / 16][]; * </pre> - * Each section (sectionID = (Y>>4)) that has blocks needs to be allocated + * Each section {@code (sectionID = (Y>>4))} that has blocks needs to be allocated * space for the 4096 blocks in that section: * <pre> * result[sectionID] = new byte[4096]; @@ -184,20 +184,20 @@ public abstract class ChunkGenerator { * following mapping function: * <pre> * void setBlock(byte[][] result, int x, int y, int z, byte blkid) { - * if (result[y >> 4) == null) { - * result[y >> 4] = new byte[4096]; + * {@code if (result[y >> 4) == null) {} + * {@code result[y >> 4] = new byte[4096];} * } - * result[y >> 4][((y & 0xF) << 8) | (z << 4) | x] = blkid; + * {@code result[y >> 4][((y & 0xF) << 8) | (z << 4) | x] = blkid;} * } * </pre> * while reading a block ID can be done with the following mapping * function: * <pre> * byte getBlock(byte[][] result, int x, int y, int z) { - * if (result[y >> 4) == null) { + * {@code if (result[y >> 4) == null) {} * return (byte)0; * } - * return result[y >> 4][((y & 0xF) << 8) | (z << 4) | x]; + * {@code return result[y >> 4][((y & 0xF) << 8) | (z << 4) | x];} * } * </pre> * diff --git a/src/main/java/org/bukkit/help/HelpMap.java b/src/main/java/org/bukkit/help/HelpMap.java index 9c1b51be..43017c84 100644 --- a/src/main/java/org/bukkit/help/HelpMap.java +++ b/src/main/java/org/bukkit/help/HelpMap.java @@ -7,7 +7,7 @@ import java.util.List; * The HelpMap tracks all help topics registered in a Bukkit server. When the * server starts up or is reloaded, help is processed and topics are added in * the following order: - * <p> + * * <ol> * <li>General topics are loaded from the help.yml * <li>Plugins load and optionally call {@code addTopic()} diff --git a/src/main/java/org/bukkit/inventory/EntityEquipment.java b/src/main/java/org/bukkit/inventory/EntityEquipment.java index 9e712359..24dfd201 100644 --- a/src/main/java/org/bukkit/inventory/EntityEquipment.java +++ b/src/main/java/org/bukkit/inventory/EntityEquipment.java @@ -98,8 +98,8 @@ public interface EntityEquipment { /** * Gets the chance of the currently held item being dropped upon this - * creature's death - * <p> + * creature's death. + * * <ul> * <li>A drop chance of 0F will never drop * <li>A drop chance of 1F will always drop @@ -111,8 +111,8 @@ public interface EntityEquipment { /** * Sets the chance of the item this creature is currently holding being - * dropped upon this creature's death - * <p> + * dropped upon this creature's death. + * * <ul> * <li>A drop chance of 0F will never drop * <li>A drop chance of 1F will always drop @@ -124,8 +124,8 @@ public interface EntityEquipment { void setItemInHandDropChance(float chance); /** - * Gets the chance of the helmet being dropped upon this creature's death - * <p> + * Gets the chance of the helmet being dropped upon this creature's death. + * * <ul> * <li>A drop chance of 0F will never drop * <li>A drop chance of 1F will always drop @@ -136,8 +136,8 @@ public interface EntityEquipment { float getHelmetDropChance(); /** - * Sets the chance of the helmet being dropped upon this creature's death - * <p> + * Sets the chance of the helmet being dropped upon this creature's death. + * * <ul> * <li>A drop chance of 0F will never drop * <li>A drop chance of 1F will always drop @@ -150,8 +150,8 @@ public interface EntityEquipment { /** * Gets the chance of the chest plate being dropped upon this creature's - * death - * <p> + * death. + * * <ul> * <li>A drop chance of 0F will never drop * <li>A drop chance of 1F will always drop @@ -163,8 +163,8 @@ public interface EntityEquipment { /** * Sets the chance of the chest plate being dropped upon this creature's - * death - * <p> + * death. + * * <ul> * <li>A drop chance of 0F will never drop * <li>A drop chance of 1F will always drop @@ -177,8 +177,8 @@ public interface EntityEquipment { /** * Gets the chance of the leggings being dropped upon this creature's - * death - * <p> + * death. + * * <ul> * <li>A drop chance of 0F will never drop * <li>A drop chance of 1F will always drop @@ -190,8 +190,8 @@ public interface EntityEquipment { /** * Sets the chance of the leggings being dropped upon this creature's - * death - * <p> + * death. + * * <ul> * <li>A drop chance of 0F will never drop * <li>A drop chance of 1F will always drop @@ -203,8 +203,8 @@ public interface EntityEquipment { void setLeggingsDropChance(float chance); /** - * Gets the chance of the boots being dropped upon this creature's death - * <p> + * Gets the chance of the boots being dropped upon this creature's death. + * * <ul> * <li>A drop chance of 0F will never drop * <li>A drop chance of 1F will always drop @@ -215,8 +215,8 @@ public interface EntityEquipment { float getBootsDropChance(); /** - * Sets the chance of the boots being dropped upon this creature's death - * <p> + * Sets the chance of the boots being dropped upon this creature's death. + * * <ul> * <li>A drop chance of 0F will never drop * <li>A drop chance of 1F will always drop diff --git a/src/main/java/org/bukkit/inventory/InventoryView.java b/src/main/java/org/bukkit/inventory/InventoryView.java index 7e98d528..46242f8a 100644 --- a/src/main/java/org/bukkit/inventory/InventoryView.java +++ b/src/main/java/org/bukkit/inventory/InventoryView.java @@ -62,6 +62,7 @@ public abstract class InventoryView { /** * + * @return the id of this view * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/inventory/ItemStack.java b/src/main/java/org/bukkit/inventory/ItemStack.java index 6137c994..8f105d91 100644 --- a/src/main/java/org/bukkit/inventory/ItemStack.java +++ b/src/main/java/org/bukkit/inventory/ItemStack.java @@ -95,6 +95,10 @@ public class ItemStack implements Cloneable, ConfigurationSerializable { } /** + * @param type the raw type id + * @param amount the amount in the stack + * @param damage the damage value of the item + * @param data the data value or null * @deprecated this method uses an ambiguous data byte object */ @Deprecated @@ -109,6 +113,10 @@ public class ItemStack implements Cloneable, ConfigurationSerializable { } /** + * @param type the type + * @param amount the amount in the stack + * @param damage the damage value of the item + * @param data the data value or null * @deprecated this method uses an ambiguous data byte object */ @Deprecated diff --git a/src/main/java/org/bukkit/inventory/meta/FireworkMeta.java b/src/main/java/org/bukkit/inventory/meta/FireworkMeta.java index 3e06ee04..1e3ee59b 100644 --- a/src/main/java/org/bukkit/inventory/meta/FireworkMeta.java +++ b/src/main/java/org/bukkit/inventory/meta/FireworkMeta.java @@ -57,7 +57,7 @@ public interface FireworkMeta extends ItemMeta { * Remove an effect from this firework. * * @param index The index of the effect to remove - * @throws IndexOutOfBoundsException If index < 0 or index > {@link + * @throws IndexOutOfBoundsException If index {@literal < 0 or index >} {@link * #getEffectsSize()} */ void removeEffect(int index) throws IndexOutOfBoundsException; @@ -86,7 +86,7 @@ public interface FireworkMeta extends ItemMeta { * a second of flight time. * * @param power the power of the firework, from 0-128 - * @throws IllegalArgumentException if height<0 or height>128 + * @throws IllegalArgumentException if {@literal height<0 or height>128} */ void setPower(int power) throws IllegalArgumentException; diff --git a/src/main/java/org/bukkit/inventory/meta/ItemMeta.java b/src/main/java/org/bukkit/inventory/meta/ItemMeta.java index 397ba115..00f71ce2 100644 --- a/src/main/java/org/bukkit/inventory/meta/ItemMeta.java +++ b/src/main/java/org/bukkit/inventory/meta/ItemMeta.java @@ -87,7 +87,7 @@ public interface ItemMeta extends Cloneable, ConfigurationSerializable { int getEnchantLevel(Enchantment ench); /** - * Returns a copy the enchantments in this ItemMeta.<br /> + * Returns a copy the enchantments in this ItemMeta. <br> * Returns an empty map if none. * * @return An immutable copy of the enchantments diff --git a/src/main/java/org/bukkit/map/MapCursor.java b/src/main/java/org/bukkit/map/MapCursor.java index d3698a6e..52317497 100644 --- a/src/main/java/org/bukkit/map/MapCursor.java +++ b/src/main/java/org/bukkit/map/MapCursor.java @@ -166,6 +166,7 @@ public final class MapCursor { /** * + * @return the value * @deprecated Magic value */ @Deprecated @@ -175,6 +176,8 @@ public final class MapCursor { /** * + * @param value the value + * @return the matching type * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/map/MapView.java b/src/main/java/org/bukkit/map/MapView.java index ff370f4a..65c41596 100644 --- a/src/main/java/org/bukkit/map/MapView.java +++ b/src/main/java/org/bukkit/map/MapView.java @@ -135,7 +135,7 @@ public interface MapView { /** * Get a list of MapRenderers currently in effect. * - * @return A List<MapRenderer> containing each map renderer. + * @return A {@code List<MapRenderer>} containing each map renderer. */ public List<MapRenderer> getRenderers(); diff --git a/src/main/java/org/bukkit/material/Banner.java b/src/main/java/org/bukkit/material/Banner.java index e5a9d1c8..80a76165 100644 --- a/src/main/java/org/bukkit/material/Banner.java +++ b/src/main/java/org/bukkit/material/Banner.java @@ -14,7 +14,7 @@ public class Banner extends MaterialData implements Attachable { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -24,6 +24,8 @@ public class Banner extends MaterialData implements Attachable { /** * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -31,8 +33,9 @@ public class Banner extends MaterialData implements Attachable { super(type, data); } - /** - * + /** * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Bed.java b/src/main/java/org/bukkit/material/Bed.java index a1c087a2..ce94dafb 100644 --- a/src/main/java/org/bukkit/material/Bed.java +++ b/src/main/java/org/bukkit/material/Bed.java @@ -27,6 +27,7 @@ public class Bed extends MaterialData implements Directional { /** * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -39,7 +40,8 @@ public class Bed extends MaterialData implements Directional { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -48,7 +50,8 @@ public class Bed extends MaterialData implements Directional { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Button.java b/src/main/java/org/bukkit/material/Button.java index 2eeeaa6b..01895918 100644 --- a/src/main/java/org/bukkit/material/Button.java +++ b/src/main/java/org/bukkit/material/Button.java @@ -12,7 +12,7 @@ public class Button extends SimpleAttachableMaterialData implements Redstone { } /** - * + * @param type the type * @deprecated Magic value */ @Deprecated @@ -25,7 +25,8 @@ public class Button extends SimpleAttachableMaterialData implements Redstone { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -34,7 +35,8 @@ public class Button extends SimpleAttachableMaterialData implements Redstone { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Cake.java b/src/main/java/org/bukkit/material/Cake.java index 360ae585..e72cb914 100644 --- a/src/main/java/org/bukkit/material/Cake.java +++ b/src/main/java/org/bukkit/material/Cake.java @@ -8,7 +8,7 @@ public class Cake extends MaterialData { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -21,7 +21,8 @@ public class Cake extends MaterialData { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -30,7 +31,8 @@ public class Cake extends MaterialData { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Cauldron.java b/src/main/java/org/bukkit/material/Cauldron.java index b464bbdb..0ead402b 100644 --- a/src/main/java/org/bukkit/material/Cauldron.java +++ b/src/main/java/org/bukkit/material/Cauldron.java @@ -15,6 +15,8 @@ public class Cauldron extends MaterialData { /** * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -24,6 +26,7 @@ public class Cauldron extends MaterialData { /** * + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Chest.java b/src/main/java/org/bukkit/material/Chest.java index b9f69880..0db8aa54 100644 --- a/src/main/java/org/bukkit/material/Chest.java +++ b/src/main/java/org/bukkit/material/Chest.java @@ -23,7 +23,7 @@ public class Chest extends DirectionalContainer { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -36,7 +36,8 @@ public class Chest extends DirectionalContainer { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -45,7 +46,8 @@ public class Chest extends DirectionalContainer { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Coal.java b/src/main/java/org/bukkit/material/Coal.java index 3a4f7c38..dd940b63 100644 --- a/src/main/java/org/bukkit/material/Coal.java +++ b/src/main/java/org/bukkit/material/Coal.java @@ -17,7 +17,7 @@ public class Coal extends MaterialData { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -30,7 +30,8 @@ public class Coal extends MaterialData { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -39,7 +40,8 @@ public class Coal extends MaterialData { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/CocoaPlant.java b/src/main/java/org/bukkit/material/CocoaPlant.java index b8280b5b..6dede93c 100644 --- a/src/main/java/org/bukkit/material/CocoaPlant.java +++ b/src/main/java/org/bukkit/material/CocoaPlant.java @@ -19,7 +19,7 @@ public class CocoaPlant extends MaterialData implements Directional, Attachable } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -28,7 +28,8 @@ public class CocoaPlant extends MaterialData implements Directional, Attachable } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Command.java b/src/main/java/org/bukkit/material/Command.java index 174e1ff8..b484229e 100644 --- a/src/main/java/org/bukkit/material/Command.java +++ b/src/main/java/org/bukkit/material/Command.java @@ -11,7 +11,7 @@ public class Command extends MaterialData implements Redstone { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -24,7 +24,8 @@ public class Command extends MaterialData implements Redstone { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -33,7 +34,8 @@ public class Command extends MaterialData implements Redstone { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Crops.java b/src/main/java/org/bukkit/material/Crops.java index 2791998d..0a4f8f17 100644 --- a/src/main/java/org/bukkit/material/Crops.java +++ b/src/main/java/org/bukkit/material/Crops.java @@ -17,7 +17,7 @@ public class Crops extends MaterialData { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -30,7 +30,8 @@ public class Crops extends MaterialData { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -39,7 +40,8 @@ public class Crops extends MaterialData { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/DetectorRail.java b/src/main/java/org/bukkit/material/DetectorRail.java index b1d3073c..652a4b5e 100644 --- a/src/main/java/org/bukkit/material/DetectorRail.java +++ b/src/main/java/org/bukkit/material/DetectorRail.java @@ -11,7 +11,7 @@ public class DetectorRail extends ExtendedRails implements PressureSensor { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -24,7 +24,8 @@ public class DetectorRail extends ExtendedRails implements PressureSensor { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -33,7 +34,8 @@ public class DetectorRail extends ExtendedRails implements PressureSensor { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Diode.java b/src/main/java/org/bukkit/material/Diode.java index 04210b7a..fbfacc06 100644 --- a/src/main/java/org/bukkit/material/Diode.java +++ b/src/main/java/org/bukkit/material/Diode.java @@ -9,7 +9,7 @@ public class Diode extends MaterialData implements Directional { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -22,7 +22,8 @@ public class Diode extends MaterialData implements Directional { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -31,7 +32,8 @@ public class Diode extends MaterialData implements Directional { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/DirectionalContainer.java b/src/main/java/org/bukkit/material/DirectionalContainer.java index 9b0a0475..b56f0988 100644 --- a/src/main/java/org/bukkit/material/DirectionalContainer.java +++ b/src/main/java/org/bukkit/material/DirectionalContainer.java @@ -8,7 +8,7 @@ import org.bukkit.block.BlockFace; */ public class DirectionalContainer extends MaterialData implements Directional { /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -21,7 +21,8 @@ public class DirectionalContainer extends MaterialData implements Directional { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -30,7 +31,8 @@ public class DirectionalContainer extends MaterialData implements Directional { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Dispenser.java b/src/main/java/org/bukkit/material/Dispenser.java index b62f8c91..988407cf 100644 --- a/src/main/java/org/bukkit/material/Dispenser.java +++ b/src/main/java/org/bukkit/material/Dispenser.java @@ -18,7 +18,7 @@ public class Dispenser extends FurnaceAndDispenser { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -31,7 +31,8 @@ public class Dispenser extends FurnaceAndDispenser { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -40,7 +41,8 @@ public class Dispenser extends FurnaceAndDispenser { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Door.java b/src/main/java/org/bukkit/material/Door.java index 65fa32ca..0c5b52f0 100644 --- a/src/main/java/org/bukkit/material/Door.java +++ b/src/main/java/org/bukkit/material/Door.java @@ -15,7 +15,7 @@ public class Door extends MaterialData implements Directional, Openable { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -28,7 +28,8 @@ public class Door extends MaterialData implements Directional, Openable { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -37,7 +38,8 @@ public class Door extends MaterialData implements Directional, Openable { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Dye.java b/src/main/java/org/bukkit/material/Dye.java index 4412c1f5..0857dd86 100644 --- a/src/main/java/org/bukkit/material/Dye.java +++ b/src/main/java/org/bukkit/material/Dye.java @@ -12,7 +12,7 @@ public class Dye extends MaterialData implements Colorable { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -25,7 +25,8 @@ public class Dye extends MaterialData implements Colorable { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -34,7 +35,8 @@ public class Dye extends MaterialData implements Colorable { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/EnderChest.java b/src/main/java/org/bukkit/material/EnderChest.java index 696dc65d..d3a60196 100644 --- a/src/main/java/org/bukkit/material/EnderChest.java +++ b/src/main/java/org/bukkit/material/EnderChest.java @@ -23,7 +23,7 @@ public class EnderChest extends DirectionalContainer { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -36,7 +36,8 @@ public class EnderChest extends DirectionalContainer { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -45,7 +46,8 @@ public class EnderChest extends DirectionalContainer { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/ExtendedRails.java b/src/main/java/org/bukkit/material/ExtendedRails.java index 0dbbf7c8..34fb55e1 100644 --- a/src/main/java/org/bukkit/material/ExtendedRails.java +++ b/src/main/java/org/bukkit/material/ExtendedRails.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; */ public class ExtendedRails extends Rails { /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -22,7 +22,8 @@ public class ExtendedRails extends Rails { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -31,7 +32,8 @@ public class ExtendedRails extends Rails { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/FlowerPot.java b/src/main/java/org/bukkit/material/FlowerPot.java index 787c58d2..7f3574eb 100644 --- a/src/main/java/org/bukkit/material/FlowerPot.java +++ b/src/main/java/org/bukkit/material/FlowerPot.java @@ -17,7 +17,7 @@ public class FlowerPot extends MaterialData { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -30,7 +30,8 @@ public class FlowerPot extends MaterialData { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -39,7 +40,8 @@ public class FlowerPot extends MaterialData { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Furnace.java b/src/main/java/org/bukkit/material/Furnace.java index 49645aa9..c607226f 100644 --- a/src/main/java/org/bukkit/material/Furnace.java +++ b/src/main/java/org/bukkit/material/Furnace.java @@ -23,7 +23,7 @@ public class Furnace extends FurnaceAndDispenser { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -36,7 +36,8 @@ public class Furnace extends FurnaceAndDispenser { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -45,7 +46,8 @@ public class Furnace extends FurnaceAndDispenser { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/FurnaceAndDispenser.java b/src/main/java/org/bukkit/material/FurnaceAndDispenser.java index 3665479f..184fda21 100644 --- a/src/main/java/org/bukkit/material/FurnaceAndDispenser.java +++ b/src/main/java/org/bukkit/material/FurnaceAndDispenser.java @@ -8,7 +8,7 @@ import org.bukkit.Material; public class FurnaceAndDispenser extends DirectionalContainer { /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -21,7 +21,8 @@ public class FurnaceAndDispenser extends DirectionalContainer { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -30,7 +31,8 @@ public class FurnaceAndDispenser extends DirectionalContainer { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Ladder.java b/src/main/java/org/bukkit/material/Ladder.java index 09862bf6..cd4d6911 100644 --- a/src/main/java/org/bukkit/material/Ladder.java +++ b/src/main/java/org/bukkit/material/Ladder.java @@ -12,7 +12,7 @@ public class Ladder extends SimpleAttachableMaterialData { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -25,7 +25,8 @@ public class Ladder extends SimpleAttachableMaterialData { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -34,7 +35,8 @@ public class Ladder extends SimpleAttachableMaterialData { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Leaves.java b/src/main/java/org/bukkit/material/Leaves.java index 97ba3820..9f40a23d 100644 --- a/src/main/java/org/bukkit/material/Leaves.java +++ b/src/main/java/org/bukkit/material/Leaves.java @@ -17,7 +17,7 @@ public class Leaves extends MaterialData { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -30,7 +30,8 @@ public class Leaves extends MaterialData { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -39,7 +40,8 @@ public class Leaves extends MaterialData { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Lever.java b/src/main/java/org/bukkit/material/Lever.java index b88c536f..c6d3882c 100644 --- a/src/main/java/org/bukkit/material/Lever.java +++ b/src/main/java/org/bukkit/material/Lever.java @@ -12,7 +12,7 @@ public class Lever extends SimpleAttachableMaterialData implements Redstone { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -25,7 +25,8 @@ public class Lever extends SimpleAttachableMaterialData implements Redstone { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -34,7 +35,8 @@ public class Lever extends SimpleAttachableMaterialData implements Redstone { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/LongGrass.java b/src/main/java/org/bukkit/material/LongGrass.java index e8d1f380..5cd8d200 100644 --- a/src/main/java/org/bukkit/material/LongGrass.java +++ b/src/main/java/org/bukkit/material/LongGrass.java @@ -17,7 +17,7 @@ public class LongGrass extends MaterialData { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -30,7 +30,8 @@ public class LongGrass extends MaterialData { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -39,7 +40,8 @@ public class LongGrass extends MaterialData { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/MaterialData.java b/src/main/java/org/bukkit/material/MaterialData.java index ad7675f2..9caf085e 100644 --- a/src/main/java/org/bukkit/material/MaterialData.java +++ b/src/main/java/org/bukkit/material/MaterialData.java @@ -11,7 +11,7 @@ public class MaterialData implements Cloneable { private byte data = 0; /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -24,7 +24,8 @@ public class MaterialData implements Cloneable { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -34,7 +35,8 @@ public class MaterialData implements Cloneable { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/MonsterEggs.java b/src/main/java/org/bukkit/material/MonsterEggs.java index d8b627b7..a6897b7e 100644 --- a/src/main/java/org/bukkit/material/MonsterEggs.java +++ b/src/main/java/org/bukkit/material/MonsterEggs.java @@ -22,7 +22,7 @@ public class MonsterEggs extends TexturedMaterial { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -38,7 +38,8 @@ public class MonsterEggs extends TexturedMaterial { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -47,7 +48,8 @@ public class MonsterEggs extends TexturedMaterial { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Mushroom.java b/src/main/java/org/bukkit/material/Mushroom.java index 716d3781..40077a6a 100644 --- a/src/main/java/org/bukkit/material/Mushroom.java +++ b/src/main/java/org/bukkit/material/Mushroom.java @@ -27,7 +27,8 @@ public class Mushroom extends MaterialData { } /** - * + * @param shroom the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -37,7 +38,8 @@ public class Mushroom extends MaterialData { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/NetherWarts.java b/src/main/java/org/bukkit/material/NetherWarts.java index 99ea3f0b..55eb864a 100644 --- a/src/main/java/org/bukkit/material/NetherWarts.java +++ b/src/main/java/org/bukkit/material/NetherWarts.java @@ -17,7 +17,7 @@ public class NetherWarts extends MaterialData { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -30,7 +30,8 @@ public class NetherWarts extends MaterialData { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -39,7 +40,8 @@ public class NetherWarts extends MaterialData { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/PistonBaseMaterial.java b/src/main/java/org/bukkit/material/PistonBaseMaterial.java index f3586dc0..bbf1565d 100644 --- a/src/main/java/org/bukkit/material/PistonBaseMaterial.java +++ b/src/main/java/org/bukkit/material/PistonBaseMaterial.java @@ -7,8 +7,11 @@ import org.bukkit.block.BlockFace; * Material data for the piston base block */ public class PistonBaseMaterial extends MaterialData implements Directional, Redstone { + /** - * + * Constructs a PistonBaseMaterial + * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -21,7 +24,10 @@ public class PistonBaseMaterial extends MaterialData implements Directional, Red } /** - * + * Constructs a PistonBaseMaterial. + * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -30,7 +36,10 @@ public class PistonBaseMaterial extends MaterialData implements Directional, Red } /** - * + * Constructs a PistonBaseMaterial. + * + * @param type the material type to use + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -38,6 +47,7 @@ public class PistonBaseMaterial extends MaterialData implements Directional, Red super(type, data); } + @Override public void setFacingDirection(BlockFace face) { byte data = (byte) (getData() & 0x8); @@ -61,6 +71,7 @@ public class PistonBaseMaterial extends MaterialData implements Directional, Red setData(data); } + @Override public BlockFace getFacing() { byte dir = (byte) (getData() & 7); @@ -82,6 +93,7 @@ public class PistonBaseMaterial extends MaterialData implements Directional, Red } } + @Override public boolean isPowered() { return (getData() & 0x8) == 0x8; } @@ -89,7 +101,7 @@ public class PistonBaseMaterial extends MaterialData implements Directional, Red /** * Sets the current state of this piston * - * @param powered true if the piston is extended & powered, or false + * @param powered true if the piston is extended {@literal &} powered, or false */ public void setPowered(boolean powered) { setData((byte) (powered ? (getData() | 0x8) : (getData() & ~0x8))); diff --git a/src/main/java/org/bukkit/material/PistonExtensionMaterial.java b/src/main/java/org/bukkit/material/PistonExtensionMaterial.java index 85dee840..8076ec97 100644 --- a/src/main/java/org/bukkit/material/PistonExtensionMaterial.java +++ b/src/main/java/org/bukkit/material/PistonExtensionMaterial.java @@ -8,7 +8,7 @@ import org.bukkit.block.BlockFace; */ public class PistonExtensionMaterial extends MaterialData implements Attachable { /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -21,7 +21,8 @@ public class PistonExtensionMaterial extends MaterialData implements Attachable } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -30,7 +31,8 @@ public class PistonExtensionMaterial extends MaterialData implements Attachable } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/PoweredRail.java b/src/main/java/org/bukkit/material/PoweredRail.java index 444e53b7..4a9d6a97 100644 --- a/src/main/java/org/bukkit/material/PoweredRail.java +++ b/src/main/java/org/bukkit/material/PoweredRail.java @@ -11,7 +11,7 @@ public class PoweredRail extends ExtendedRails implements Redstone { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -24,7 +24,8 @@ public class PoweredRail extends ExtendedRails implements Redstone { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -33,7 +34,8 @@ public class PoweredRail extends ExtendedRails implements Redstone { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/PressurePlate.java b/src/main/java/org/bukkit/material/PressurePlate.java index 8c3bc759..d7747b5c 100644 --- a/src/main/java/org/bukkit/material/PressurePlate.java +++ b/src/main/java/org/bukkit/material/PressurePlate.java @@ -11,7 +11,7 @@ public class PressurePlate extends MaterialData implements PressureSensor { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -24,7 +24,8 @@ public class PressurePlate extends MaterialData implements PressureSensor { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -33,7 +34,8 @@ public class PressurePlate extends MaterialData implements PressureSensor { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Pumpkin.java b/src/main/java/org/bukkit/material/Pumpkin.java index d6ca83c9..afd200a1 100644 --- a/src/main/java/org/bukkit/material/Pumpkin.java +++ b/src/main/java/org/bukkit/material/Pumpkin.java @@ -23,7 +23,7 @@ public class Pumpkin extends MaterialData implements Directional { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -36,7 +36,8 @@ public class Pumpkin extends MaterialData implements Directional { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -45,7 +46,8 @@ public class Pumpkin extends MaterialData implements Directional { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Rails.java b/src/main/java/org/bukkit/material/Rails.java index 74fd95a9..10044ee8 100644 --- a/src/main/java/org/bukkit/material/Rails.java +++ b/src/main/java/org/bukkit/material/Rails.java @@ -13,7 +13,7 @@ public class Rails extends MaterialData { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -26,7 +26,8 @@ public class Rails extends MaterialData { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -35,7 +36,8 @@ public class Rails extends MaterialData { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/RedstoneTorch.java b/src/main/java/org/bukkit/material/RedstoneTorch.java index 76a3ddd9..45c3e47f 100644 --- a/src/main/java/org/bukkit/material/RedstoneTorch.java +++ b/src/main/java/org/bukkit/material/RedstoneTorch.java @@ -11,7 +11,7 @@ public class RedstoneTorch extends Torch implements Redstone { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -24,7 +24,8 @@ public class RedstoneTorch extends Torch implements Redstone { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -33,7 +34,8 @@ public class RedstoneTorch extends Torch implements Redstone { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/RedstoneWire.java b/src/main/java/org/bukkit/material/RedstoneWire.java index b429af00..d13ae4bf 100644 --- a/src/main/java/org/bukkit/material/RedstoneWire.java +++ b/src/main/java/org/bukkit/material/RedstoneWire.java @@ -11,7 +11,7 @@ public class RedstoneWire extends MaterialData implements Redstone { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -24,7 +24,8 @@ public class RedstoneWire extends MaterialData implements Redstone { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -33,7 +34,8 @@ public class RedstoneWire extends MaterialData implements Redstone { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Sandstone.java b/src/main/java/org/bukkit/material/Sandstone.java index 26cbbb52..be88d43b 100644 --- a/src/main/java/org/bukkit/material/Sandstone.java +++ b/src/main/java/org/bukkit/material/Sandstone.java @@ -17,7 +17,7 @@ public class Sandstone extends MaterialData { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -30,7 +30,8 @@ public class Sandstone extends MaterialData { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -39,7 +40,8 @@ public class Sandstone extends MaterialData { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Sign.java b/src/main/java/org/bukkit/material/Sign.java index e8da7aa9..0accdbce 100644 --- a/src/main/java/org/bukkit/material/Sign.java +++ b/src/main/java/org/bukkit/material/Sign.java @@ -12,7 +12,7 @@ public class Sign extends MaterialData implements Attachable { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -25,7 +25,8 @@ public class Sign extends MaterialData implements Attachable { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -34,7 +35,8 @@ public class Sign extends MaterialData implements Attachable { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/SimpleAttachableMaterialData.java b/src/main/java/org/bukkit/material/SimpleAttachableMaterialData.java index b5703c6c..b1897b7b 100644 --- a/src/main/java/org/bukkit/material/SimpleAttachableMaterialData.java +++ b/src/main/java/org/bukkit/material/SimpleAttachableMaterialData.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; public abstract class SimpleAttachableMaterialData extends MaterialData implements Attachable { /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -32,7 +32,8 @@ public abstract class SimpleAttachableMaterialData extends MaterialData implemen } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -41,7 +42,8 @@ public abstract class SimpleAttachableMaterialData extends MaterialData implemen } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Skull.java b/src/main/java/org/bukkit/material/Skull.java index 6e0d71fa..659d9e95 100644 --- a/src/main/java/org/bukkit/material/Skull.java +++ b/src/main/java/org/bukkit/material/Skull.java @@ -22,7 +22,7 @@ public class Skull extends MaterialData implements Directional { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -35,7 +35,8 @@ public class Skull extends MaterialData implements Directional { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -44,7 +45,8 @@ public class Skull extends MaterialData implements Directional { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/SmoothBrick.java b/src/main/java/org/bukkit/material/SmoothBrick.java index b7ab6074..a6d8931e 100644 --- a/src/main/java/org/bukkit/material/SmoothBrick.java +++ b/src/main/java/org/bukkit/material/SmoothBrick.java @@ -23,7 +23,7 @@ public class SmoothBrick extends TexturedMaterial { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -39,7 +39,8 @@ public class SmoothBrick extends TexturedMaterial { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -48,7 +49,8 @@ public class SmoothBrick extends TexturedMaterial { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/SpawnEgg.java b/src/main/java/org/bukkit/material/SpawnEgg.java index ed973c52..42606271 100644 --- a/src/main/java/org/bukkit/material/SpawnEgg.java +++ b/src/main/java/org/bukkit/material/SpawnEgg.java @@ -13,7 +13,8 @@ public class SpawnEgg extends MaterialData { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -22,7 +23,7 @@ public class SpawnEgg extends MaterialData { } /** - * + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Stairs.java b/src/main/java/org/bukkit/material/Stairs.java index 1f73c77c..7dde0214 100644 --- a/src/main/java/org/bukkit/material/Stairs.java +++ b/src/main/java/org/bukkit/material/Stairs.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; public class Stairs extends MaterialData implements Directional { /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -22,7 +22,8 @@ public class Stairs extends MaterialData implements Directional { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -31,7 +32,8 @@ public class Stairs extends MaterialData implements Directional { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Step.java b/src/main/java/org/bukkit/material/Step.java index 605f817c..c2ccfce4 100644 --- a/src/main/java/org/bukkit/material/Step.java +++ b/src/main/java/org/bukkit/material/Step.java @@ -26,7 +26,7 @@ public class Step extends TexturedMaterial { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -42,7 +42,8 @@ public class Step extends TexturedMaterial { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -51,7 +52,8 @@ public class Step extends TexturedMaterial { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/TexturedMaterial.java b/src/main/java/org/bukkit/material/TexturedMaterial.java index cfd971bd..d1b85e2e 100644 --- a/src/main/java/org/bukkit/material/TexturedMaterial.java +++ b/src/main/java/org/bukkit/material/TexturedMaterial.java @@ -14,7 +14,7 @@ public abstract class TexturedMaterial extends MaterialData { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -23,7 +23,8 @@ public abstract class TexturedMaterial extends MaterialData { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -32,7 +33,8 @@ public abstract class TexturedMaterial extends MaterialData { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Torch.java b/src/main/java/org/bukkit/material/Torch.java index f03b3cf8..60be6bd1 100644 --- a/src/main/java/org/bukkit/material/Torch.java +++ b/src/main/java/org/bukkit/material/Torch.java @@ -12,7 +12,7 @@ public class Torch extends SimpleAttachableMaterialData { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -25,7 +25,8 @@ public class Torch extends SimpleAttachableMaterialData { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -34,7 +35,8 @@ public class Torch extends SimpleAttachableMaterialData { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/TrapDoor.java b/src/main/java/org/bukkit/material/TrapDoor.java index bd4bcc2b..2ae33621 100644 --- a/src/main/java/org/bukkit/material/TrapDoor.java +++ b/src/main/java/org/bukkit/material/TrapDoor.java @@ -12,7 +12,7 @@ public class TrapDoor extends SimpleAttachableMaterialData implements Openable { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -25,7 +25,8 @@ public class TrapDoor extends SimpleAttachableMaterialData implements Openable { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -34,7 +35,8 @@ public class TrapDoor extends SimpleAttachableMaterialData implements Openable { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Tree.java b/src/main/java/org/bukkit/material/Tree.java index fe568723..d90126c1 100644 --- a/src/main/java/org/bukkit/material/Tree.java +++ b/src/main/java/org/bukkit/material/Tree.java @@ -24,7 +24,7 @@ public class Tree extends MaterialData { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -37,7 +37,8 @@ public class Tree extends MaterialData { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -46,7 +47,8 @@ public class Tree extends MaterialData { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Tripwire.java b/src/main/java/org/bukkit/material/Tripwire.java index 583860bc..570635d2 100644 --- a/src/main/java/org/bukkit/material/Tripwire.java +++ b/src/main/java/org/bukkit/material/Tripwire.java @@ -12,7 +12,7 @@ public class Tripwire extends MaterialData { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -21,7 +21,8 @@ public class Tripwire extends MaterialData { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/TripwireHook.java b/src/main/java/org/bukkit/material/TripwireHook.java index 7ad2d2ad..8ff23e9f 100644 --- a/src/main/java/org/bukkit/material/TripwireHook.java +++ b/src/main/java/org/bukkit/material/TripwireHook.java @@ -13,7 +13,7 @@ public class TripwireHook extends SimpleAttachableMaterialData implements Redsto } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -22,7 +22,8 @@ public class TripwireHook extends SimpleAttachableMaterialData implements Redsto } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Vine.java b/src/main/java/org/bukkit/material/Vine.java index a4f7ad57..5a09667f 100644 --- a/src/main/java/org/bukkit/material/Vine.java +++ b/src/main/java/org/bukkit/material/Vine.java @@ -21,7 +21,8 @@ public class Vine extends MaterialData { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -30,7 +31,7 @@ public class Vine extends MaterialData { } /** - * + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/WoodenStep.java b/src/main/java/org/bukkit/material/WoodenStep.java index 9584e252..b07ee89b 100644 --- a/src/main/java/org/bukkit/material/WoodenStep.java +++ b/src/main/java/org/bukkit/material/WoodenStep.java @@ -13,7 +13,7 @@ public class WoodenStep extends MaterialData { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -33,7 +33,8 @@ public class WoodenStep extends MaterialData { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -42,7 +43,8 @@ public class WoodenStep extends MaterialData { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/material/Wool.java b/src/main/java/org/bukkit/material/Wool.java index 8115bdc3..c4e4bfa0 100644 --- a/src/main/java/org/bukkit/material/Wool.java +++ b/src/main/java/org/bukkit/material/Wool.java @@ -17,7 +17,7 @@ public class Wool extends MaterialData implements Colorable { } /** - * + * @param type the raw type id * @deprecated Magic value */ @Deprecated @@ -30,7 +30,8 @@ public class Wool extends MaterialData implements Colorable { } /** - * + * @param type the raw type id + * @param data the raw data value * @deprecated Magic value */ @Deprecated @@ -39,7 +40,8 @@ public class Wool extends MaterialData implements Colorable { } /** - * + * @param type the type + * @param data the raw data value * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/metadata/LazyMetadataValue.java b/src/main/java/org/bukkit/metadata/LazyMetadataValue.java index a9546e53..564d0fab 100644 --- a/src/main/java/org/bukkit/metadata/LazyMetadataValue.java +++ b/src/main/java/org/bukkit/metadata/LazyMetadataValue.java @@ -56,6 +56,8 @@ public class LazyMetadataValue extends MetadataValueAdapter implements MetadataV /** * Protected special constructor used by FixedMetadataValue to bypass * standard setup. + * + * @param owningPlugin the owning plugin */ protected LazyMetadataValue(Plugin owningPlugin) { super(owningPlugin); diff --git a/src/main/java/org/bukkit/permissions/Permission.java b/src/main/java/org/bukkit/permissions/Permission.java index 26f6f2bb..14ec7099 100644 --- a/src/main/java/org/bukkit/permissions/Permission.java +++ b/src/main/java/org/bukkit/permissions/Permission.java @@ -213,7 +213,7 @@ public class Permission { * following keys: * <ul> * <li>default: Boolean true or false. If not specified, false. - * <li>children: Map<String, Boolean> of child permissions. If not + * <li>children: {@code Map<String, Boolean>} of child permissions. If not * specified, empty list. * <li>description: Short string containing a very small description of * this description. If not specified, empty string. @@ -245,10 +245,11 @@ public class Permission { * The data may contain the following keys: * <ul> * <li>default: Boolean true or false. If not specified, false. - * <li>children: Map<String, Boolean> of child permissions. If not + * <li>children: {@code Map<String, Boolean>} of child permissions. If not * specified, empty list. * <li>description: Short string containing a very small description of * this description. If not specified, empty string. + * </ul> * * @param name Name of the permission * @param data Map of keys @@ -265,7 +266,7 @@ public class Permission { * The data may contain the following keys: * <ul> * <li>default: Boolean true or false. If not specified, false. - * <li>children: Map<String, Boolean> of child permissions. If not + * <li>children: {@code Map<String, Boolean>} of child permissions. If not * specified, empty list. * <li>description: Short string containing a very small description of * this description. If not specified, empty string. diff --git a/src/main/java/org/bukkit/plugin/PluginDescriptionFile.java b/src/main/java/org/bukkit/plugin/PluginDescriptionFile.java index 0fd966c6..c82928ef 100644 --- a/src/main/java/org/bukkit/plugin/PluginDescriptionFile.java +++ b/src/main/java/org/bukkit/plugin/PluginDescriptionFile.java @@ -11,7 +11,6 @@ import java.util.Set; import org.bukkit.command.CommandExecutor; import org.bukkit.command.PluginCommand; -import org.bukkit.plugin.Plugin; import org.bukkit.plugin.java.JavaPlugin; import org.bukkit.permissions.Permissible; import org.bukkit.permissions.Permission; @@ -51,6 +50,7 @@ import com.google.common.collect.ImmutableSet; * This is a list of the possible yaml keys, with specific details included in * the respective method documentations: * <table border=1> + * <caption>The description of the plugin.yml layout</caption> * <tr> * <th>Node</th> * <th>Method</th> @@ -400,7 +400,7 @@ public final class PluginDescriptionFile { *- feildmaster *- amaranth</pre></blockquote> * Is equivilant to this example: - * <blockquote><pre>authors: [Grum, feildmaster, aramanth]<pre></blockquote> + * <pre>authors: [Grum, feildmaster, aramanth]</pre> * * @return an immutable list of the plugin's authors */ @@ -560,6 +560,7 @@ public final class PluginDescriptionFile { * aliases</i>, can be defined at runtime using methods in {@link * PluginCommand} and are defined here only as a convenience. * <table border=1> + * <caption>The command section's description</caption> * <tr> * <th>Node</th> * <th>Method</th> @@ -683,6 +684,7 @@ public final class PluginDescriptionFile { * <p> * A list of optional properties for permissions: * <table border=1> + * <caption>The permission section's description</caption> * <tr> * <th>Node</th> * <th>Description</th> @@ -776,6 +778,8 @@ public final class PluginDescriptionFile { *</pre></blockquote> * Another example, with nested definitions, can be found <a * href="doc-files/permissions-example_plugin.yml">here</a>. + * + * @return the permissions this plugin will register */ public List<Permission> getPermissions() { if (permissions == null) { @@ -817,7 +821,7 @@ public final class PluginDescriptionFile { * not included in the API. Any unrecognized * awareness (one unsupported or in a future version) will cause a dummy * object to be created instead of failing. - * <p> + * * <ul> * <li>Currently only supports the enumerated values in {@link * PluginAwareness.Flags}. @@ -861,6 +865,7 @@ public final class PluginDescriptionFile { } /** + * @return unused * @deprecated unused */ @Deprecated @@ -1101,6 +1106,7 @@ public final class PluginDescriptionFile { } /** + * @return internal use * @deprecated Internal use */ @Deprecated diff --git a/src/main/java/org/bukkit/plugin/TimedRegisteredListener.java b/src/main/java/org/bukkit/plugin/TimedRegisteredListener.java index e09234c1..164be937 100644 --- a/src/main/java/org/bukkit/plugin/TimedRegisteredListener.java +++ b/src/main/java/org/bukkit/plugin/TimedRegisteredListener.java @@ -76,7 +76,7 @@ public class TimedRegisteredListener extends RegisteredListener { * returned, such that for any event this listener has handled, * <code>this.getEventClass().isAssignableFrom(event.getClass())</code> * and no class <code>this.getEventClass().isAssignableFrom(clazz) - * && this.getEventClass() != clazz && + * {@literal && this.getEventClass() != clazz &&} * event.getClass().isAssignableFrom(clazz)</code> for all handled events. * * @return the event class handled by this RegisteredListener diff --git a/src/main/java/org/bukkit/plugin/java/JavaPlugin.java b/src/main/java/org/bukkit/plugin/java/JavaPlugin.java index 19893f31..c961b18c 100644 --- a/src/main/java/org/bukkit/plugin/java/JavaPlugin.java +++ b/src/main/java/org/bukkit/plugin/java/JavaPlugin.java @@ -72,6 +72,11 @@ public abstract class JavaPlugin extends PluginBase { * PluginDescriptionFile, File, File) constructor} cannot be used. * <p> * Its existence may be temporary. + * @param loader the plugin loader + * @param server the server instance + * @param description the plugin's description + * @param dataFolder the plugin's data folder + * @param file the location of the plugin */ @Deprecated protected JavaPlugin(final PluginLoader loader, final Server server, final PluginDescriptionFile description, final File dataFolder, final File file) { @@ -321,6 +326,12 @@ public abstract class JavaPlugin extends PluginBase { } /** + * @param loader the plugin loader + * @param server the server instance + * @param description the plugin's description + * @param dataFolder the plugin's data folder + * @param file the location of the plugin + * @param classLoader the class loader * @deprecated This method is legacy and will be removed - it must be * replaced by the specially provided constructor(s). */ @@ -492,6 +503,7 @@ public abstract class JavaPlugin extends PluginBase { * does not extend the class, where the intended plugin would have * resided in a different jar / classloader. * + * @param <T> a class that extends JavaPlugin * @param clazz the class desired * @return the plugin that provides and implements said class * @throws IllegalArgumentException if clazz is null @@ -525,6 +537,8 @@ public abstract class JavaPlugin extends PluginBase { * This method provides fast access to the plugin that has provided the * given class. * + * @param clazz a class belonging to a plugin + * @return the plugin that provided the class * @throws IllegalArgumentException if the class is not provided by a * JavaPlugin * @throws IllegalArgumentException if class is null diff --git a/src/main/java/org/bukkit/plugin/java/JavaPluginLoader.java b/src/main/java/org/bukkit/plugin/java/JavaPluginLoader.java index fb0bfba5..687029fb 100644 --- a/src/main/java/org/bukkit/plugin/java/JavaPluginLoader.java +++ b/src/main/java/org/bukkit/plugin/java/JavaPluginLoader.java @@ -52,6 +52,8 @@ public final class JavaPluginLoader implements PluginLoader { /** * This class was not meant to be constructed explicitly + * + * @param instance the server instance */ @Deprecated public JavaPluginLoader(Server instance) { diff --git a/src/main/java/org/bukkit/potion/Potion.java b/src/main/java/org/bukkit/potion/Potion.java index a358c299..8966c906 100644 --- a/src/main/java/org/bukkit/potion/Potion.java +++ b/src/main/java/org/bukkit/potion/Potion.java @@ -39,9 +39,10 @@ public class Potion { } /** + * @param type the type of the potion + * @param tier the tier of the potion * @deprecated In favour of {@link #Potion(PotionType, int)} - */ - @SuppressWarnings("javadoc") + */ @Deprecated public Potion(PotionType type, Tier tier) { this(type, tier == Tier.TWO ? 2 : 1); @@ -49,19 +50,24 @@ public class Potion { } /** + * @param type the type of the potion + * @param tier the tier of the potion + * @param splash whether the potion is a splash potion * @deprecated In favour of {@link #Potion(PotionType, int, boolean)} */ - @SuppressWarnings("javadoc") @Deprecated public Potion(PotionType type, Tier tier, boolean splash) { this(type, tier == Tier.TWO ? 2 : 1, splash); } /** + * @param type the type of the potion + * @param tier the tier of the potion + * @param splash whether the potion is a splash potion + * @param extended whether the potion has an extended duration * @deprecated In favour of {@link #Potion(PotionType, int, boolean, * boolean)} */ - @SuppressWarnings("javadoc") @Deprecated public Potion(PotionType type, Tier tier, boolean splash, boolean extended) { this(type, tier, splash); @@ -381,6 +387,8 @@ public class Potion { /** * + * @param damage the damage value + * @return the produced potion * @deprecated Magic value */ @Deprecated @@ -433,6 +441,7 @@ public class Potion { /** * + * @return the name id * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/potion/PotionType.java b/src/main/java/org/bukkit/potion/PotionType.java index b9949d96..568356e3 100644 --- a/src/main/java/org/bukkit/potion/PotionType.java +++ b/src/main/java/org/bukkit/potion/PotionType.java @@ -32,6 +32,7 @@ public enum PotionType { /** * + * @return the damage value * @deprecated Magic value */ @Deprecated @@ -49,6 +50,8 @@ public enum PotionType { /** * + * @param damage the damage value + * @return the matching potion type or null * @deprecated Magic value */ @Deprecated diff --git a/src/main/java/org/bukkit/projectiles/ProjectileSource.java b/src/main/java/org/bukkit/projectiles/ProjectileSource.java index afad8d74..cf909461 100644 --- a/src/main/java/org/bukkit/projectiles/ProjectileSource.java +++ b/src/main/java/org/bukkit/projectiles/ProjectileSource.java @@ -11,6 +11,7 @@ public interface ProjectileSource { /** * Launches a {@link Projectile} from the ProjectileSource. * + * @param <T> a projectile subclass * @param projectile class of the projectile to launch * @return the launched projectile */ @@ -20,6 +21,7 @@ public interface ProjectileSource { * Launches a {@link Projectile} from the ProjectileSource with an * initial velocity. * + * @param <T> a projectile subclass * @param projectile class of the projectile to launch * @param velocity the velocity with which to launch * @return the launched projectile diff --git a/src/main/java/org/bukkit/scheduler/BukkitScheduler.java b/src/main/java/org/bukkit/scheduler/BukkitScheduler.java index dfecafa7..6e28205f 100644 --- a/src/main/java/org/bukkit/scheduler/BukkitScheduler.java +++ b/src/main/java/org/bukkit/scheduler/BukkitScheduler.java @@ -21,6 +21,10 @@ public interface BukkitScheduler { /** * @deprecated Use {@link BukkitRunnable#runTaskLater(Plugin, long)} + * @param plugin Plugin that owns the task + * @param task Task to be executed + * @param delay Delay in server ticks before executing task + * @return Task id number (-1 if scheduling failed) */ @Deprecated public int scheduleSyncDelayedTask(Plugin plugin, BukkitRunnable task, long delay); @@ -38,6 +42,9 @@ public interface BukkitScheduler { /** * @deprecated Use {@link BukkitRunnable#runTask(Plugin)} + * @param plugin Plugin that owns the task + * @param task Task to be executed + * @return Task id number (-1 if scheduling failed) */ @Deprecated public int scheduleSyncDelayedTask(Plugin plugin, BukkitRunnable task); @@ -56,7 +63,12 @@ public interface BukkitScheduler { public int scheduleSyncRepeatingTask(Plugin plugin, Runnable task, long delay, long period); /** - * @deprecated Use {@link BukkitRunnable#runTaskTimer(Plugin, long, long)} + * @deprecated Use {@link BukkitRunnable#runTaskTimer(Plugin, long, long)} * + * @param plugin Plugin that owns the task + * @param task Task to be executed + * @param delay Delay in server ticks before executing first repeat + * @param period Period in server ticks of the task + * @return Task id number (-1 if scheduling failed) */ @Deprecated public int scheduleSyncRepeatingTask(Plugin plugin, BukkitRunnable task, long delay, long period); @@ -208,6 +220,12 @@ public interface BukkitScheduler { /** * @deprecated Use {@link BukkitRunnable#runTask(Plugin)} + * + * @param plugin the reference to the plugin scheduling task + * @param task the task to be run + * @return a BukkitTask that contains the id number + * @throws IllegalArgumentException if plugin is null + * @throws IllegalArgumentException if task is null */ @Deprecated public BukkitTask runTask(Plugin plugin, BukkitRunnable task) throws IllegalArgumentException; @@ -228,6 +246,11 @@ public interface BukkitScheduler { /** * @deprecated Use {@link BukkitRunnable#runTaskAsynchronously(Plugin)} + * @param plugin the reference to the plugin scheduling task + * @param task the task to be run + * @return a BukkitTask that contains the id number + * @throws IllegalArgumentException if plugin is null + * @throws IllegalArgumentException if task is null */ @Deprecated public BukkitTask runTaskAsynchronously(Plugin plugin, BukkitRunnable task) throws IllegalArgumentException; @@ -247,6 +270,12 @@ public interface BukkitScheduler { /** * @deprecated Use {@link BukkitRunnable#runTaskLater(Plugin, long)} + * @param plugin the reference to the plugin scheduling task + * @param task the task to be run + * @param delay the ticks to wait before running the task + * @return a BukkitTask that contains the id number + * @throws IllegalArgumentException if plugin is null + * @throws IllegalArgumentException if task is null */ @Deprecated public BukkitTask runTaskLater(Plugin plugin, BukkitRunnable task, long delay) throws IllegalArgumentException; @@ -269,6 +298,12 @@ public interface BukkitScheduler { /** * @deprecated Use {@link BukkitRunnable#runTaskLaterAsynchronously(Plugin, long)} + * @param plugin the reference to the plugin scheduling task + * @param task the task to be run + * @param delay the ticks to wait before running the task + * @return a BukkitTask that contains the id number + * @throws IllegalArgumentException if plugin is null + * @throws IllegalArgumentException if task is null */ @Deprecated public BukkitTask runTaskLaterAsynchronously(Plugin plugin, BukkitRunnable task, long delay) throws IllegalArgumentException; @@ -289,6 +324,13 @@ public interface BukkitScheduler { /** * @deprecated Use {@link BukkitRunnable#runTaskTimer(Plugin, long, long)} + * @param plugin the reference to the plugin scheduling task + * @param task the task to be run + * @param delay the ticks to wait before running the task + * @param period the ticks to wait between runs + * @return a BukkitTask that contains the id number + * @throws IllegalArgumentException if plugin is null + * @throws IllegalArgumentException if task is null */ @Deprecated public BukkitTask runTaskTimer(Plugin plugin, BukkitRunnable task, long delay, long period) throws IllegalArgumentException; @@ -313,6 +355,14 @@ public interface BukkitScheduler { /** * @deprecated Use {@link BukkitRunnable#runTaskTimerAsynchronously(Plugin, long, long)} + * @param plugin the reference to the plugin scheduling task + * @param task the task to be run + * @param delay the ticks to wait before running the task for the first + * time + * @param period the ticks to wait between runs + * @return a BukkitTask that contains the id number + * @throws IllegalArgumentException if plugin is null + * @throws IllegalArgumentException if task is null */ @Deprecated public BukkitTask runTaskTimerAsynchronously(Plugin plugin, BukkitRunnable task, long delay, long period) throws IllegalArgumentException; diff --git a/src/main/java/org/bukkit/util/StringUtil.java b/src/main/java/org/bukkit/util/StringUtil.java index 4a8753fd..7e793930 100644 --- a/src/main/java/org/bukkit/util/StringUtil.java +++ b/src/main/java/org/bukkit/util/StringUtil.java @@ -9,6 +9,7 @@ public class StringUtil { * Copies all elements from the iterable collection of originals to the * collection provided. * + * @param <T> the collection of strings * @param token String to search for * @param originals An iterable collection of strings to filter. * @param collection The collection to add matches to diff --git a/src/main/java/org/bukkit/util/io/BukkitObjectInputStream.java b/src/main/java/org/bukkit/util/io/BukkitObjectInputStream.java index d4b28251..13725531 100644 --- a/src/main/java/org/bukkit/util/io/BukkitObjectInputStream.java +++ b/src/main/java/org/bukkit/util/io/BukkitObjectInputStream.java @@ -21,8 +21,7 @@ public class BukkitObjectInputStream extends ObjectInputStream { /** * Constructor provided to mirror super functionality. * - * @throws IOException - * @throws SecurityException + * @throws IOException if an I/O error occurs while reading stream heade * @see ObjectInputStream#ObjectInputStream() */ protected BukkitObjectInputStream() throws IOException, SecurityException { @@ -33,8 +32,8 @@ public class BukkitObjectInputStream extends ObjectInputStream { /** * Object input stream decoration constructor. * - * @param in - * @throws IOException + * @param in the input stream to wrap + * @throws IOException if an I/O error occurs while reading stream header * @see ObjectInputStream#ObjectInputStream(InputStream) */ public BukkitObjectInputStream(InputStream in) throws IOException { diff --git a/src/main/java/org/bukkit/util/io/BukkitObjectOutputStream.java b/src/main/java/org/bukkit/util/io/BukkitObjectOutputStream.java index c11e2029..84528502 100644 --- a/src/main/java/org/bukkit/util/io/BukkitObjectOutputStream.java +++ b/src/main/java/org/bukkit/util/io/BukkitObjectOutputStream.java @@ -21,8 +21,7 @@ public class BukkitObjectOutputStream extends ObjectOutputStream { /** * Constructor provided to mirror super functionality. * - * @throws IOException - * @throws SecurityException + * @throws IOException if an I/O error occurs while writing stream header * @see ObjectOutputStream#ObjectOutputStream() */ protected BukkitObjectOutputStream() throws IOException, SecurityException { @@ -33,8 +32,8 @@ public class BukkitObjectOutputStream extends ObjectOutputStream { /** * Object output stream decoration constructor. * - * @param out - * @throws IOException + * @param out the stream to wrap + * @throws IOException if an I/O error occurs while writing stream header * @see ObjectOutputStream#ObjectOutputStream(OutputStream) */ public BukkitObjectOutputStream(OutputStream out) throws IOException { diff --git a/src/main/javadoc/org/bukkit/block/package-info.java b/src/main/javadoc/org/bukkit/block/package-info.java index fb7719b7..dc0f36a8 100644 --- a/src/main/javadoc/org/bukkit/block/package-info.java +++ b/src/main/javadoc/org/bukkit/block/package-info.java @@ -1,7 +1,6 @@ /** * Classes used to manipulate the voxels in a {@link org.bukkit.World world}, * including special states. - * <p> */ package org.bukkit.block; diff --git a/src/main/javadoc/org/bukkit/command/defaults/package-info.java b/src/main/javadoc/org/bukkit/command/defaults/package-info.java index f2967308..b67dfba0 100644 --- a/src/main/javadoc/org/bukkit/command/defaults/package-info.java +++ b/src/main/javadoc/org/bukkit/command/defaults/package-info.java @@ -1,7 +1,6 @@ /** * Commands for emulating the Minecraft commands and other necessary ones for * use by a Bukkit implementation. - * <p> */ package org.bukkit.command.defaults; diff --git a/src/main/javadoc/org/bukkit/command/package-info.java b/src/main/javadoc/org/bukkit/command/package-info.java index f06407a5..6428f474 100644 --- a/src/main/javadoc/org/bukkit/command/package-info.java +++ b/src/main/javadoc/org/bukkit/command/package-info.java @@ -1,6 +1,5 @@ /** * Classes relating to handling specialized non-chat player input. - * <p> */ package org.bukkit.command; diff --git a/src/main/javadoc/org/bukkit/configuration/file/package-info.java b/src/main/javadoc/org/bukkit/configuration/file/package-info.java index 9b1161bd..4973ffc1 100644 --- a/src/main/javadoc/org/bukkit/configuration/file/package-info.java +++ b/src/main/javadoc/org/bukkit/configuration/file/package-info.java @@ -2,7 +2,6 @@ * Classes dedicated facilitating {@link * org.bukkit.configuration.Configuration configurations} to be read and * stored on the filesystem. - * <p> */ package org.bukkit.configuration.file; diff --git a/src/main/javadoc/org/bukkit/configuration/package-info.java b/src/main/javadoc/org/bukkit/configuration/package-info.java index fc439dbb..63a39650 100644 --- a/src/main/javadoc/org/bukkit/configuration/package-info.java +++ b/src/main/javadoc/org/bukkit/configuration/package-info.java @@ -1,6 +1,5 @@ /** * Classes dedicated to handling a plugin's runtime configuration. - * <p> */ package org.bukkit.configuration; diff --git a/src/main/javadoc/org/bukkit/configuration/serialization/package-info.java b/src/main/javadoc/org/bukkit/configuration/serialization/package-info.java index b33306f2..529de2e8 100644 --- a/src/main/javadoc/org/bukkit/configuration/serialization/package-info.java +++ b/src/main/javadoc/org/bukkit/configuration/serialization/package-info.java @@ -2,7 +2,6 @@ * Classes dedicated to being able to perform serialization specialized for * the Bukkit {@link org.bukkit.configuration.Configuration configuration} * implementation. - * <p> */ package org.bukkit.configuration.serialization; diff --git a/src/main/javadoc/org/bukkit/conversations/package-info.java b/src/main/javadoc/org/bukkit/conversations/package-info.java index 2259e925..d49dafaf 100644 --- a/src/main/javadoc/org/bukkit/conversations/package-info.java +++ b/src/main/javadoc/org/bukkit/conversations/package-info.java @@ -1,6 +1,5 @@ /** * Classes dedicated to facilitate direct player-to-plugin communication. - * <p> */ package org.bukkit.conversations; diff --git a/src/main/javadoc/org/bukkit/enchantments/package-info.java b/src/main/javadoc/org/bukkit/enchantments/package-info.java index a686c828..fb67cc7e 100644 --- a/src/main/javadoc/org/bukkit/enchantments/package-info.java +++ b/src/main/javadoc/org/bukkit/enchantments/package-info.java @@ -2,7 +2,6 @@ * Classes relating to the specialized enhancements to {@link * org.bukkit.inventory.ItemStack item stacks}, as part of the {@link * org.bukkit.inventory.meta.ItemMeta meta data}. - * <p> */ package org.bukkit.enchantments; diff --git a/src/main/javadoc/org/bukkit/entity/minecart/package-info.java b/src/main/javadoc/org/bukkit/entity/minecart/package-info.java index 9988caaf..342f10ba 100644 --- a/src/main/javadoc/org/bukkit/entity/minecart/package-info.java +++ b/src/main/javadoc/org/bukkit/entity/minecart/package-info.java @@ -1,6 +1,5 @@ /** * Interfaces for various {@link org.bukkit.entity.Minecart} types. - * <p> */ package org.bukkit.entity.minecart; diff --git a/src/main/javadoc/org/bukkit/entity/package-info.java b/src/main/javadoc/org/bukkit/entity/package-info.java index 581209ba..167a830d 100644 --- a/src/main/javadoc/org/bukkit/entity/package-info.java +++ b/src/main/javadoc/org/bukkit/entity/package-info.java @@ -1,7 +1,6 @@ /** * Interfaces for non-voxel objects that can exist in a {@link * org.bukkit.World world}, including all players, monsters, projectiles, etc. - * <p> */ package org.bukkit.entity; diff --git a/src/main/javadoc/org/bukkit/event/block/package-info.java b/src/main/javadoc/org/bukkit/event/block/package-info.java index dd53485b..30aec218 100644 --- a/src/main/javadoc/org/bukkit/event/block/package-info.java +++ b/src/main/javadoc/org/bukkit/event/block/package-info.java @@ -2,7 +2,6 @@ * {@link org.bukkit.event.Event Events} relating to when a {@link * org.bukkit.block.Block block} is changed or interacts with the {@link * org.bukkit.World world}. - * <p> */ package org.bukkit.event.block; diff --git a/src/main/javadoc/org/bukkit/event/enchantment/package-info.java b/src/main/javadoc/org/bukkit/event/enchantment/package-info.java index 7be6f83b..e609c634 100644 --- a/src/main/javadoc/org/bukkit/event/enchantment/package-info.java +++ b/src/main/javadoc/org/bukkit/event/enchantment/package-info.java @@ -1,7 +1,6 @@ /** * {@link org.bukkit.event.Event Events} triggered from an {@link * org.bukkit.inventory.EnchantingInventory enchantment table}. - * <p> */ package org.bukkit.event.enchantment; diff --git a/src/main/javadoc/org/bukkit/event/entity/package-info.java b/src/main/javadoc/org/bukkit/event/entity/package-info.java index 36a1a096..cddcd4e4 100644 --- a/src/main/javadoc/org/bukkit/event/entity/package-info.java +++ b/src/main/javadoc/org/bukkit/event/entity/package-info.java @@ -2,7 +2,6 @@ * {@link org.bukkit.event.Event Events} relating to {@link * org.bukkit.entity.Entity entities}, excluding some directly referencing * some more specific entity types. - * <p> */ package org.bukkit.event.entity; diff --git a/src/main/javadoc/org/bukkit/event/hanging/package-info.java b/src/main/javadoc/org/bukkit/event/hanging/package-info.java index 63e9e7e6..bf16382b 100644 --- a/src/main/javadoc/org/bukkit/event/hanging/package-info.java +++ b/src/main/javadoc/org/bukkit/event/hanging/package-info.java @@ -1,7 +1,6 @@ /** * {@link org.bukkit.event.Event Events} relating to {@link * org.bukkit.entity.Hanging entities that hang}. - * <p> */ package org.bukkit.event.hanging; diff --git a/src/main/javadoc/org/bukkit/event/inventory/package-info.java b/src/main/javadoc/org/bukkit/event/inventory/package-info.java index 7cb5a636..7dd5b699 100644 --- a/src/main/javadoc/org/bukkit/event/inventory/package-info.java +++ b/src/main/javadoc/org/bukkit/event/inventory/package-info.java @@ -1,7 +1,6 @@ /** * {@link org.bukkit.event.Event Events} relating to {@link * org.bukkit.inventory.Inventory inventory} manipulation. - * <p> */ package org.bukkit.event.inventory; diff --git a/src/main/javadoc/org/bukkit/event/package-info.java b/src/main/javadoc/org/bukkit/event/package-info.java index ab3011a2..dd8baa1d 100644 --- a/src/main/javadoc/org/bukkit/event/package-info.java +++ b/src/main/javadoc/org/bukkit/event/package-info.java @@ -1,6 +1,5 @@ /** * Classes dedicated to handling triggered code executions. - * <p> */ package org.bukkit.event; diff --git a/src/main/javadoc/org/bukkit/event/painting/package-info.java b/src/main/javadoc/org/bukkit/event/painting/package-info.java index 39a8bb7d..6c9a091b 100644 --- a/src/main/javadoc/org/bukkit/event/painting/package-info.java +++ b/src/main/javadoc/org/bukkit/event/painting/package-info.java @@ -2,7 +2,6 @@ * {@link org.bukkit.event.Event Events} relating to {@link * org.bukkit.entity.Painting paintings}, but deprecated for more general * {@link org.bukkit.event.hanging hanging} events. - * <p> */ package org.bukkit.event.painting; diff --git a/src/main/javadoc/org/bukkit/event/player/package-info.java b/src/main/javadoc/org/bukkit/event/player/package-info.java index c5a49541..fb645f32 100644 --- a/src/main/javadoc/org/bukkit/event/player/package-info.java +++ b/src/main/javadoc/org/bukkit/event/player/package-info.java @@ -1,7 +1,6 @@ /** * {@link org.bukkit.event.Event Events} relating to {@link * org.bukkit.entity.Player players}. - * <p> */ package org.bukkit.event.player; diff --git a/src/main/javadoc/org/bukkit/event/server/package-info.java b/src/main/javadoc/org/bukkit/event/server/package-info.java index a2e16998..b548270c 100644 --- a/src/main/javadoc/org/bukkit/event/server/package-info.java +++ b/src/main/javadoc/org/bukkit/event/server/package-info.java @@ -1,7 +1,6 @@ /** * {@link org.bukkit.event.Event Events} relating to programmatic state * changes on the server. - * <p> */ package org.bukkit.event.server; diff --git a/src/main/javadoc/org/bukkit/event/vehicle/package-info.java b/src/main/javadoc/org/bukkit/event/vehicle/package-info.java index 07c470a2..b88cbcd6 100644 --- a/src/main/javadoc/org/bukkit/event/vehicle/package-info.java +++ b/src/main/javadoc/org/bukkit/event/vehicle/package-info.java @@ -1,7 +1,6 @@ /** * {@link org.bukkit.event.Event Events} relating to {@link * org.bukkit.entity.Vehicle vehicular entities}. - * <p> */ package org.bukkit.event.vehicle; diff --git a/src/main/javadoc/org/bukkit/event/weather/package-info.java b/src/main/javadoc/org/bukkit/event/weather/package-info.java index f2e3f49e..edaaf9f1 100644 --- a/src/main/javadoc/org/bukkit/event/weather/package-info.java +++ b/src/main/javadoc/org/bukkit/event/weather/package-info.java @@ -1,6 +1,5 @@ /** * {@link org.bukkit.event.Event Events} relating to weather. - * <p> */ package org.bukkit.event.weather; diff --git a/src/main/javadoc/org/bukkit/event/world/package-info.java b/src/main/javadoc/org/bukkit/event/world/package-info.java index 3b075f6d..4cbb818a 100644 --- a/src/main/javadoc/org/bukkit/event/world/package-info.java +++ b/src/main/javadoc/org/bukkit/event/world/package-info.java @@ -1,7 +1,6 @@ /** * {@link org.bukkit.event.Event Events} triggered by various {@link * org.bukkit.World world} states or changes. - * <p> */ package org.bukkit.event.world; diff --git a/src/main/javadoc/org/bukkit/generator/package-info.java b/src/main/javadoc/org/bukkit/generator/package-info.java index 54d1c294..2532addf 100644 --- a/src/main/javadoc/org/bukkit/generator/package-info.java +++ b/src/main/javadoc/org/bukkit/generator/package-info.java @@ -1,7 +1,6 @@ /** * Classes to facilitate {@link org.bukkit.World world} generation * implementation. - * <p> */ package org.bukkit.generator; diff --git a/src/main/javadoc/org/bukkit/help/package-info.java b/src/main/javadoc/org/bukkit/help/package-info.java index 691dfcd3..66a4aacb 100644 --- a/src/main/javadoc/org/bukkit/help/package-info.java +++ b/src/main/javadoc/org/bukkit/help/package-info.java @@ -1,6 +1,5 @@ /** * Classes used to manipulate the default command and topic assistance system. - * <p> */ package org.bukkit.help; diff --git a/src/main/javadoc/org/bukkit/inventory/meta/package-info.java b/src/main/javadoc/org/bukkit/inventory/meta/package-info.java index f39d93a4..b80eb88b 100644 --- a/src/main/javadoc/org/bukkit/inventory/meta/package-info.java +++ b/src/main/javadoc/org/bukkit/inventory/meta/package-info.java @@ -1,7 +1,6 @@ /** * The interfaces used when manipulating extra data can can be stored inside * {@link org.bukkit.inventory.ItemStack item stacks}. - * <p> */ package org.bukkit.inventory.meta; diff --git a/src/main/javadoc/org/bukkit/inventory/package-info.java b/src/main/javadoc/org/bukkit/inventory/package-info.java index 79e26ca2..8881abcc 100644 --- a/src/main/javadoc/org/bukkit/inventory/package-info.java +++ b/src/main/javadoc/org/bukkit/inventory/package-info.java @@ -1,6 +1,5 @@ /** * Classes involved in manipulating player inventories and item interactions. - * <p> */ package org.bukkit.inventory; diff --git a/src/main/javadoc/org/bukkit/map/package-info.java b/src/main/javadoc/org/bukkit/map/package-info.java index 9e08d6e5..30de8b24 100644 --- a/src/main/javadoc/org/bukkit/map/package-info.java +++ b/src/main/javadoc/org/bukkit/map/package-info.java @@ -1,7 +1,6 @@ /** * Classes to facilitate plugin handling of {@link org.bukkit.Material#MAP * map} displays. - * <p> */ package org.bukkit.map; diff --git a/src/main/javadoc/org/bukkit/material/package-info.java b/src/main/javadoc/org/bukkit/material/package-info.java index d2fa49fa..f3be435e 100644 --- a/src/main/javadoc/org/bukkit/material/package-info.java +++ b/src/main/javadoc/org/bukkit/material/package-info.java @@ -1,6 +1,5 @@ /** * Classes that represents various voxel types and states. - * <p> */ package org.bukkit.material; diff --git a/src/main/javadoc/org/bukkit/metadata/package-info.java b/src/main/javadoc/org/bukkit/metadata/package-info.java index 44227e6a..f8e00397 100644 --- a/src/main/javadoc/org/bukkit/metadata/package-info.java +++ b/src/main/javadoc/org/bukkit/metadata/package-info.java @@ -1,7 +1,6 @@ /** * Classes dedicated to providing a layer of plugin specified data on various * Minecraft concepts. - * <p> */ package org.bukkit.metadata; diff --git a/src/main/javadoc/org/bukkit/package-info.java b/src/main/javadoc/org/bukkit/package-info.java index f85c88d1..da7d9f12 100644 --- a/src/main/javadoc/org/bukkit/package-info.java +++ b/src/main/javadoc/org/bukkit/package-info.java @@ -1,6 +1,5 @@ /** * More generalized classes in the API. - * <p> */ package org.bukkit; diff --git a/src/main/javadoc/org/bukkit/permissions/package-info.java b/src/main/javadoc/org/bukkit/permissions/package-info.java index 3a5befe2..860abc3f 100644 --- a/src/main/javadoc/org/bukkit/permissions/package-info.java +++ b/src/main/javadoc/org/bukkit/permissions/package-info.java @@ -1,6 +1,5 @@ /** * Classes dedicated to providing binary state properties to players. - * <p> */ package org.bukkit.permissions; diff --git a/src/main/javadoc/org/bukkit/plugin/java/package-info.java b/src/main/javadoc/org/bukkit/plugin/java/package-info.java index 8d6f2a5b..c74e7093 100644 --- a/src/main/javadoc/org/bukkit/plugin/java/package-info.java +++ b/src/main/javadoc/org/bukkit/plugin/java/package-info.java @@ -1,7 +1,6 @@ /** * Classes for handling {@link org.bukkit.plugin.Plugin plugins} written in * java. - * <p> */ package org.bukkit.plugin.java; diff --git a/src/main/javadoc/org/bukkit/plugin/messaging/package-info.java b/src/main/javadoc/org/bukkit/plugin/messaging/package-info.java index c94ac66c..04cb2b93 100644 --- a/src/main/javadoc/org/bukkit/plugin/messaging/package-info.java +++ b/src/main/javadoc/org/bukkit/plugin/messaging/package-info.java @@ -1,6 +1,5 @@ /** * Classes dedicated to specialized plugin to client protocols. - * <p> */ package org.bukkit.plugin.messaging; diff --git a/src/main/javadoc/org/bukkit/plugin/package-info.java b/src/main/javadoc/org/bukkit/plugin/package-info.java index 087a0a4a..76fbe6ba 100644 --- a/src/main/javadoc/org/bukkit/plugin/package-info.java +++ b/src/main/javadoc/org/bukkit/plugin/package-info.java @@ -1,6 +1,5 @@ /** * Classes specifically relating to loading software modules at runtime. - * <p> */ package org.bukkit.plugin; diff --git a/src/main/javadoc/org/bukkit/potion/package-info.java b/src/main/javadoc/org/bukkit/potion/package-info.java index 9b13a773..6dd34544 100644 --- a/src/main/javadoc/org/bukkit/potion/package-info.java +++ b/src/main/javadoc/org/bukkit/potion/package-info.java @@ -1,7 +1,6 @@ /** * Classes to represent various {@link org.bukkit.Material#POTION potion} * properties and manipulation. - * <p> */ package org.bukkit.potion; diff --git a/src/main/javadoc/org/bukkit/projectiles/package-info.java b/src/main/javadoc/org/bukkit/projectiles/package-info.java index 0e396627..5efe7364 100644 --- a/src/main/javadoc/org/bukkit/projectiles/package-info.java +++ b/src/main/javadoc/org/bukkit/projectiles/package-info.java @@ -1,6 +1,5 @@ /** * Classes to represent the source of a projectile - * <p> */ package org.bukkit.projectiles; diff --git a/src/main/javadoc/org/bukkit/scheduler/package-info.java b/src/main/javadoc/org/bukkit/scheduler/package-info.java index 87059ea1..c441df67 100644 --- a/src/main/javadoc/org/bukkit/scheduler/package-info.java +++ b/src/main/javadoc/org/bukkit/scheduler/package-info.java @@ -1,7 +1,6 @@ /** * Classes dedicated to letting {@link org.bukkit.plugin.Plugin plugins} run * code at specific time intervals, including thread safety. - * <p> */ package org.bukkit.scheduler; diff --git a/src/main/javadoc/org/bukkit/scoreboard/package-info.java b/src/main/javadoc/org/bukkit/scoreboard/package-info.java index aad5e310..4d0b7e20 100644 --- a/src/main/javadoc/org/bukkit/scoreboard/package-info.java +++ b/src/main/javadoc/org/bukkit/scoreboard/package-info.java @@ -1,6 +1,5 @@ /** * Interfaces used to manage the client side score display system. - * <p> */ package org.bukkit.scoreboard; diff --git a/src/main/javadoc/org/bukkit/util/io/package-info.java b/src/main/javadoc/org/bukkit/util/io/package-info.java index 8e46cca4..c4efffbd 100644 --- a/src/main/javadoc/org/bukkit/util/io/package-info.java +++ b/src/main/javadoc/org/bukkit/util/io/package-info.java @@ -1,6 +1,5 @@ /** * Classes used to facilitate stream processing for specific Bukkit concepts. - * <p> */ package org.bukkit.util.io; diff --git a/src/main/javadoc/org/bukkit/util/noise/package-info.java b/src/main/javadoc/org/bukkit/util/noise/package-info.java index f77e35d0..8dd1501c 100644 --- a/src/main/javadoc/org/bukkit/util/noise/package-info.java +++ b/src/main/javadoc/org/bukkit/util/noise/package-info.java @@ -1,6 +1,5 @@ /** * Classes dedicated to facilitating deterministic noise. - * <p> */ package org.bukkit.util.noise; diff --git a/src/main/javadoc/org/bukkit/util/package-info.java b/src/main/javadoc/org/bukkit/util/package-info.java index a9c4c9d8..58176d08 100644 --- a/src/main/javadoc/org/bukkit/util/package-info.java +++ b/src/main/javadoc/org/bukkit/util/package-info.java @@ -1,7 +1,6 @@ /** * Multi and single purpose classes to facilitate various programmatic * concepts. - * <p> */ package org.bukkit.util; diff --git a/src/main/javadoc/org/bukkit/util/permissions/package-info.java b/src/main/javadoc/org/bukkit/util/permissions/package-info.java index 9a40b299..07498118 100644 --- a/src/main/javadoc/org/bukkit/util/permissions/package-info.java +++ b/src/main/javadoc/org/bukkit/util/permissions/package-info.java @@ -1,7 +1,6 @@ /** * Static methods for miscellaneous {@link org.bukkit.permissions.Permission * permission} functionality. - * <p> */ package org.bukkit.util.permissions; |