diff options
| author | Erik Broes <erikbroes@grum.nl> | 2011-12-25 16:02:30 +0100 |
|---|---|---|
| committer | Erik Broes <erikbroes@grum.nl> | 2011-12-25 16:02:30 +0100 |
| commit | b9fca3c04d3561ffa1430724e5fb5ab8e024dd2c (patch) | |
| tree | e6b17ff17e749afb0042357e4922757e66eedfe3 /src/main/java/org | |
| parent | a345613cfaf533817ade333946461a2c31c3d400 (diff) | |
| download | bukkit-b9fca3c04d3561ffa1430724e5fb5ab8e024dd2c.tar bukkit-b9fca3c04d3561ffa1430724e5fb5ab8e024dd2c.tar.gz bukkit-b9fca3c04d3561ffa1430724e5fb5ab8e024dd2c.tar.lz bukkit-b9fca3c04d3561ffa1430724e5fb5ab8e024dd2c.tar.xz bukkit-b9fca3c04d3561ffa1430724e5fb5ab8e024dd2c.zip | |
Generic cleanup of warnings, whitespace and style.
Diffstat (limited to 'src/main/java/org')
256 files changed, 1308 insertions, 1046 deletions
diff --git a/src/main/java/org/bukkit/Art.java b/src/main/java/org/bukkit/Art.java index fef562bb..10fad07b 100644 --- a/src/main/java/org/bukkit/Art.java +++ b/src/main/java/org/bukkit/Art.java @@ -6,34 +6,34 @@ import java.util.HashMap; * Represents the art on a painting */ public enum Art { - KEBAB(0,1,1), - AZTEC(1,1,1), - ALBAN(2,1,1), - AZTEC2(3,1,1), - BOMB(4,1,1), - PLANT(5,1,1), - WASTELAND(6,1,1), - POOL(7,2,1), - COURBET(8,2,1), - SEA(9,2,1), - SUNSET(10,2,1), - CREEBET(11,2,1), - WANDERER(12,1,2), - GRAHAM(13,1,2), - MATCH(14,4,2), - BUST(15,2,2), - STAGE(16,2,2), - VOID(17,2,2), - SKULL_AND_ROSES(18,2,2), - FIGHTERS(19,2,2), - POINTER(20,4,4), - PIGSCENE(21,4,4), - BURNINGSKULL(22,4,4), - SKELETON(23,4,3), - DONKEYKONG(24,4,3); + KEBAB(0, 1, 1), + AZTEC(1, 1, 1), + ALBAN(2, 1, 1), + AZTEC2(3, 1, 1), + BOMB(4, 1, 1), + PLANT(5, 1, 1), + WASTELAND(6, 1, 1), + POOL(7, 2, 1), + COURBET(8, 2, 1), + SEA(9, 2, 1), + SUNSET(10, 2, 1), + CREEBET(11, 2, 1), + WANDERER(12, 1, 2), + GRAHAM(13, 1, 2), + MATCH(14, 4, 2), + BUST(15, 2, 2), + STAGE(16, 2, 2), + VOID(17, 2, 2), + SKULL_AND_ROSES(18, 2, 2), + FIGHTERS(19, 2, 2), + POINTER(20, 4, 4), + PIGSCENE(21, 4, 4), + BURNINGSKULL(22, 4, 4), + SKELETON(23, 4, 3), + DONKEYKONG(24, 4, 3); private int id, width, height; - private static HashMap<String,Art> names = new HashMap<String,Art>(); - private static HashMap<Integer,Art> ids = new HashMap<Integer,Art>(); + private static HashMap<String, Art> names = new HashMap<String, Art>(); + private static HashMap<Integer, Art> ids = new HashMap<Integer, Art>(); static { for (Art art : Art.values()) { ids.put(art.id, art); diff --git a/src/main/java/org/bukkit/BlockChangeDelegate.java b/src/main/java/org/bukkit/BlockChangeDelegate.java index 64be8f09..78c7b7bc 100644 --- a/src/main/java/org/bukkit/BlockChangeDelegate.java +++ b/src/main/java/org/bukkit/BlockChangeDelegate.java @@ -32,6 +32,7 @@ public interface BlockChangeDelegate { /** * Get the block type at the location. + * * @param x X coordinate * @param y Y coordinate * @param z Z coordinate diff --git a/src/main/java/org/bukkit/Bukkit.java b/src/main/java/org/bukkit/Bukkit.java index c051209d..d7753329 100644 --- a/src/main/java/org/bukkit/Bukkit.java +++ b/src/main/java/org/bukkit/Bukkit.java @@ -258,7 +258,7 @@ public final class Bukkit { public static void unbanIP(String address) { server.unbanIP(address); } - + public static Set<OfflinePlayer> getBannedPlayers() { return server.getBannedPlayers(); } diff --git a/src/main/java/org/bukkit/Chunk.java b/src/main/java/org/bukkit/Chunk.java index c44bc5ce..77651392 100644 --- a/src/main/java/org/bukkit/Chunk.java +++ b/src/main/java/org/bukkit/Chunk.java @@ -42,12 +42,14 @@ public interface Chunk { /** * Capture thread-safe read-only snapshot of chunk data + * * @return ChunkSnapshot */ ChunkSnapshot getChunkSnapshot(); /** * Capture thread-safe read-only snapshot of chunk data + * * @param includeMaxblocky - if true, snapshot includes per-coordinate maximum Y values * @param includeBiome - if true, snapshot includes per-coordinate biome type * @param includeBiomeTempRain - if true, snapshot includes per-coordinate raw biome temperature and rainfall @@ -57,12 +59,14 @@ public interface Chunk { /** * Get a list of all entities in the chunk. + * * @return The entities. */ Entity[] getEntities(); /** * Get a list of all tile entities in the chunk. + * * @return The tile entities. */ BlockState[] getTileEntities(); diff --git a/src/main/java/org/bukkit/ChunkSnapshot.java b/src/main/java/org/bukkit/ChunkSnapshot.java index e54b5e6b..e1373c61 100644 --- a/src/main/java/org/bukkit/ChunkSnapshot.java +++ b/src/main/java/org/bukkit/ChunkSnapshot.java @@ -1,6 +1,7 @@ package org.bukkit; import org.bukkit.block.Biome; + /** * Represents a static, thread-safe snapshot of chunk of blocks * Purpose is to allow clean, efficient copy of a chunk data to be made, and then handed off for processing in another thread (e.g. map rendering) @@ -106,6 +107,7 @@ public interface ChunkSnapshot { /** * Get world full time when chunk snapshot was captured + * * @return time in ticks */ long getCaptureFullTime(); diff --git a/src/main/java/org/bukkit/Location.java b/src/main/java/org/bukkit/Location.java index 6ee1852e..f4b8c989 100644 --- a/src/main/java/org/bukkit/Location.java +++ b/src/main/java/org/bukkit/Location.java @@ -240,10 +240,10 @@ public class Location implements Cloneable { z += vec.z; return this; } - - /** + + /** * Adds the location by a vector. - * + * * @see Vector * @param vec Vector to use * @return the same location @@ -289,10 +289,10 @@ public class Location implements Cloneable { z -= vec.z; return this; } - - /** + + /** * Subtracts the location by a vector. - * + * * @see Vector * @param vec The vector to use * @return the same location @@ -348,7 +348,7 @@ public class Location implements Cloneable { } /** - * Get the distance between this location and another. The value + * Get the distance between this location and another. The value * of this method is not cached and uses a costly square-root function, so * do not repeatedly call this method to get the location's magnitude. NaN * will be returned if the inner result of the sqrt() function overflows, diff --git a/src/main/java/org/bukkit/OfflinePlayer.java b/src/main/java/org/bukkit/OfflinePlayer.java index 2f4ca39f..a59f8424 100644 --- a/src/main/java/org/bukkit/OfflinePlayer.java +++ b/src/main/java/org/bukkit/OfflinePlayer.java @@ -47,13 +47,13 @@ public interface OfflinePlayer extends ServerOperator, AnimalTamer, Configuratio * @param value true if whitelisted */ public void setWhitelisted(boolean value); - + /** * Gets a {@link Player} object that this represents, if there is one * <p> * If the player is online, this will return that player. Otherwise, * it will return null. - * + * * @return Online player */ public Player getPlayer(); diff --git a/src/main/java/org/bukkit/Server.java b/src/main/java/org/bukkit/Server.java index 80cd8127..54f301e3 100644 --- a/src/main/java/org/bukkit/Server.java +++ b/src/main/java/org/bukkit/Server.java @@ -53,10 +53,10 @@ public interface Server { * @return version of this server implementation */ public String getVersion(); - + /** * Gets the Bukkit version that this server is running. - * + * * @return Version of Bukkit */ public String getBukkitVersion(); @@ -110,7 +110,7 @@ public interface Server { * @return The ID of this server */ public String getServerId(); - + /** * Gets whether this server allows the End or not. * @@ -304,7 +304,7 @@ public interface Server { */ public World createWorld(WorldCreator creator); - /** + /** * Unloads a world with the given name. * * @param name Name of the world to unload @@ -398,6 +398,7 @@ public interface Server { /** * Adds a recipe to the crafting manager. + * * @param recipe The recipe to add. * @return True to indicate that the recipe was added. */ diff --git a/src/main/java/org/bukkit/TravelAgent.java b/src/main/java/org/bukkit/TravelAgent.java index 1fac1e73..5a545fc7 100644 --- a/src/main/java/org/bukkit/TravelAgent.java +++ b/src/main/java/org/bukkit/TravelAgent.java @@ -64,7 +64,7 @@ public interface TravelAgent { /** * Attempt to create a portal near the given location. - * + * * @param location The desired location of the portal. * @return True if a nether portal was successfully created. */ diff --git a/src/main/java/org/bukkit/World.java b/src/main/java/org/bukkit/World.java index 2ecb8a95..d6ae084d 100644 --- a/src/main/java/org/bukkit/World.java +++ b/src/main/java/org/bukkit/World.java @@ -552,12 +552,14 @@ public interface World { /** * Gets the current PVP setting for this world. + * * @return True if PVP is enabled */ public boolean getPVP(); /** * Sets the PVP setting for this world. + * * @param pvp True/False whether PVP should be Enabled. */ public void setPVP(boolean pvp); @@ -613,7 +615,8 @@ public interface World { /** * Get empty chunk snapshot (equivalent to all air blocks), optionally including valid biome - * data. Used for representing an ungenerated chunk, or for fetching only biome data without loading a chunk. + * data. Used for representing an ungenerated chunk, or for fetching only biome data without loading a chunk. + * * @param x - chunk x coordinate * @param z - chunk z coordinate * @param includeBiome - if true, snapshot includes per-coordinate biome type @@ -706,10 +709,10 @@ public interface World { public boolean getKeepSpawnInMemory(); /** - * Sets whether the world's spawn area should be kept loaded into memory or not. - * - * @param keepLoaded if true then the world's spawn area will be kept loaded into memory. - */ + * Sets whether the world's spawn area should be kept loaded into memory or not. + * + * @param keepLoaded if true then the world's spawn area will be kept loaded into memory. + */ public void setKeepSpawnInMemory(boolean keepLoaded); /** diff --git a/src/main/java/org/bukkit/WorldCreator.java b/src/main/java/org/bukkit/WorldCreator.java index 0d299ff8..fec84f0c 100644 --- a/src/main/java/org/bukkit/WorldCreator.java +++ b/src/main/java/org/bukkit/WorldCreator.java @@ -226,7 +226,7 @@ public class WorldCreator { if (output == null) { output = Bukkit.getConsoleSender(); } - + if (name != null) { String[] split = name.split(":", 2); String id = (split.length > 1) ? split[1] : null; diff --git a/src/main/java/org/bukkit/block/Block.java b/src/main/java/org/bukkit/block/Block.java index e4a9be93..58030574 100644 --- a/src/main/java/org/bukkit/block/Block.java +++ b/src/main/java/org/bukkit/block/Block.java @@ -23,12 +23,14 @@ public interface Block { /** * @deprecated use {@link #getRelative(BlockFace face)} */ - @Deprecated Block getFace(BlockFace face); + @Deprecated + Block getFace(BlockFace face); /** * @deprecated use {@link #getRelative(BlockFace face, int distance)} */ - @Deprecated Block getFace(BlockFace face, int distance); + @Deprecated + Block getFace(BlockFace face, int distance); /** * Gets the block at the given offsets @@ -56,8 +58,9 @@ public interface Block { * <br /> * For example, the following method places water at 100,102,100; two blocks * above 100,100,100. + * * <pre> - * Block block = world.getBlockAt(100,100,100); + * Block block = world.getBlockAt(100, 100, 100); * Block shower = block.getFace(BlockFace.UP, 2); * shower.setType(Material.WATER); * </pre> @@ -164,12 +167,14 @@ public interface Block { * Gets the face relation of this block compared to the given block<br /> * <br /> * For example: + * * <pre> * Block current = world.getBlockAt(100, 100, 100); * Block target = world.getBlockAt(100, 101, 100); * * current.getFace(target) == BlockFace.Up; * </pre> + * * <br /> * If the given block is not connected to this block, null may be returned * diff --git a/src/main/java/org/bukkit/block/BlockFace.java b/src/main/java/org/bukkit/block/BlockFace.java index 1c687ebb..43447648 100644 --- a/src/main/java/org/bukkit/block/BlockFace.java +++ b/src/main/java/org/bukkit/block/BlockFace.java @@ -42,6 +42,7 @@ public enum BlockFace { /** * Get the amount of X-coordinates to modify to get the represented block + * * @return Amount of X-coordinates to modify */ public int getModX() { @@ -50,6 +51,7 @@ public enum BlockFace { /** * Get the amount of Y-coordinates to modify to get the represented block + * * @return Amount of Y-coordinates to modify */ public int getModY() { @@ -58,6 +60,7 @@ public enum BlockFace { /** * Get the amount of Z-coordinates to modify to get the represented block + * * @return Amount of Z-coordinates to modify */ public int getModZ() { diff --git a/src/main/java/org/bukkit/block/Jukebox.java b/src/main/java/org/bukkit/block/Jukebox.java index 6d941168..7b45b833 100644 --- a/src/main/java/org/bukkit/block/Jukebox.java +++ b/src/main/java/org/bukkit/block/Jukebox.java @@ -8,24 +8,28 @@ import org.bukkit.Material; public interface Jukebox extends BlockState { /** * Get the record currently playing + * * @return The record Material, or AIR if none is playing */ public Material getPlaying(); - + /** * Set the record currently playing + * * @param record The record Material, or null/AIR to stop playing */ public void setPlaying(Material record); - + /** * Check if the jukebox is currently playing a record + * * @return True if there is a record playing */ public boolean isPlaying(); - + /** * Stop the jukebox playing and eject the current record + * * @return True if a record was ejected; false if there was none playing */ public boolean eject(); diff --git a/src/main/java/org/bukkit/block/NoteBlock.java b/src/main/java/org/bukkit/block/NoteBlock.java index e086fdc6..ffe5af65 100644 --- a/src/main/java/org/bukkit/block/NoteBlock.java +++ b/src/main/java/org/bukkit/block/NoteBlock.java @@ -47,7 +47,7 @@ public interface NoteBlock extends BlockState { /** * Plays an arbitrary note with an arbitrary instrument - * + * * @param instrument Instrument ID * @param note Note ID * @return true if successful, otherwise false @@ -56,7 +56,7 @@ public interface NoteBlock extends BlockState { /** * Plays an arbitrary note with an arbitrary instrument - * + * * @param instrument The instrument * @param note The note * @return true if successful, otherwise false diff --git a/src/main/java/org/bukkit/block/PistonMoveReaction.java b/src/main/java/org/bukkit/block/PistonMoveReaction.java index 83064122..42023b9a 100644 --- a/src/main/java/org/bukkit/block/PistonMoveReaction.java +++ b/src/main/java/org/bukkit/block/PistonMoveReaction.java @@ -11,7 +11,7 @@ public enum PistonMoveReaction { private int id; private static Map<Integer, PistonMoveReaction> byId = new HashMap<Integer, PistonMoveReaction>(); static { - for (PistonMoveReaction reaction: PistonMoveReaction.values()) { + for (PistonMoveReaction reaction : PistonMoveReaction.values()) { byId.put(reaction.id, reaction); } } diff --git a/src/main/java/org/bukkit/command/Command.java b/src/main/java/org/bukkit/command/Command.java index 65e3370a..c4305878 100644 --- a/src/main/java/org/bukkit/command/Command.java +++ b/src/main/java/org/bukkit/command/Command.java @@ -149,7 +149,6 @@ public abstract class Command { return false; } - private boolean allowChangesFrom(CommandMap commandMap) { return (null == this.commandMap || this.commandMap == commandMap); } @@ -237,7 +236,7 @@ public abstract class Command { for (Permissible user : users) { if (user instanceof CommandSender) { - CommandSender target = (CommandSender)user; + CommandSender target = (CommandSender) user; if (target instanceof ConsoleCommandSender) { target.sendMessage(result); diff --git a/src/main/java/org/bukkit/command/CommandException.java b/src/main/java/org/bukkit/command/CommandException.java index 2ea2c6f1..76c1a016 100644 --- a/src/main/java/org/bukkit/command/CommandException.java +++ b/src/main/java/org/bukkit/command/CommandException.java @@ -3,6 +3,7 @@ package org.bukkit.command; /** * Thrown when an unhandled exception occurs during the execution of a Command */ +@SuppressWarnings("serial") public class CommandException extends RuntimeException { /** @@ -12,6 +13,7 @@ public class CommandException extends RuntimeException { /** * Constructs an instance of <code>CommandException</code> with the specified detail message. + * * @param msg the detail message. */ public CommandException(String msg) { diff --git a/src/main/java/org/bukkit/command/ConsoleCommandSender.java b/src/main/java/org/bukkit/command/ConsoleCommandSender.java index a74df60a..baf80b6e 100644 --- a/src/main/java/org/bukkit/command/ConsoleCommandSender.java +++ b/src/main/java/org/bukkit/command/ConsoleCommandSender.java @@ -1,4 +1,4 @@ package org.bukkit.command; -public interface ConsoleCommandSender extends CommandSender{ +public interface ConsoleCommandSender extends CommandSender { } diff --git a/src/main/java/org/bukkit/command/MultipleCommandAlias.java b/src/main/java/org/bukkit/command/MultipleCommandAlias.java index e1474542..59ac4c20 100644 --- a/src/main/java/org/bukkit/command/MultipleCommandAlias.java +++ b/src/main/java/org/bukkit/command/MultipleCommandAlias.java @@ -1,4 +1,3 @@ - package org.bukkit.command; /** diff --git a/src/main/java/org/bukkit/command/PluginCommand.java b/src/main/java/org/bukkit/command/PluginCommand.java index 1b220b10..67597d32 100644 --- a/src/main/java/org/bukkit/command/PluginCommand.java +++ b/src/main/java/org/bukkit/command/PluginCommand.java @@ -43,7 +43,7 @@ public final class PluginCommand extends Command { } if (!success && usageMessage.length() > 0) { - for (String line: usageMessage.replace("<command>", commandLabel).split("\n")) { + for (String line : usageMessage.replace("<command>", commandLabel).split("\n")) { sender.sendMessage(line); } } diff --git a/src/main/java/org/bukkit/command/RemoteConsoleCommandSender.java b/src/main/java/org/bukkit/command/RemoteConsoleCommandSender.java index 5ba3c438..dc3bc1d1 100644 --- a/src/main/java/org/bukkit/command/RemoteConsoleCommandSender.java +++ b/src/main/java/org/bukkit/command/RemoteConsoleCommandSender.java @@ -1,4 +1,4 @@ package org.bukkit.command; -public interface RemoteConsoleCommandSender extends CommandSender{ +public interface RemoteConsoleCommandSender extends CommandSender { } diff --git a/src/main/java/org/bukkit/command/SimpleCommandMap.java b/src/main/java/org/bukkit/command/SimpleCommandMap.java index 3f03ebcf..5965e4d7 100644 --- a/src/main/java/org/bukkit/command/SimpleCommandMap.java +++ b/src/main/java/org/bukkit/command/SimpleCommandMap.java @@ -79,7 +79,7 @@ public class SimpleCommandMap implements CommandMap { public boolean register(String label, String fallbackPrefix, Command command) { boolean registeredPassedLabel = register(label, fallbackPrefix, command, false); - Iterator iterator = command.getAliases().iterator(); + Iterator<String> iterator = command.getAliases().iterator(); while (iterator.hasNext()) { if (!register((String) iterator.next(), fallbackPrefix, command, true)) { iterator.remove(); @@ -94,12 +94,13 @@ public class SimpleCommandMap implements CommandMap { /** * Registers a command with the given name is possible, otherwise uses fallbackPrefix to create a unique name if its not an alias + * * @param name the name of the command, without the '/'-prefix. * @param fallbackPrefix a prefix which is prepended to the command with a ':' one or more times to make the command unique * @param command the command to register * @return true if command was registered with the passed in label, false otherwise. - * If isAlias was true a return of false indicates no command was registerd - * If isAlias was false a return of false indicates the fallbackPrefix was used one or more times to create a unique name for the command + * If isAlias was true a return of false indicates no command was registerd + * If isAlias was false a return of false indicates the fallbackPrefix was used one or more times to create a unique name for the command */ private synchronized boolean register(String label, String fallbackPrefix, Command command, boolean isAlias) { String lowerLabel = label.trim().toLowerCase(); diff --git a/src/main/java/org/bukkit/command/defaults/DeopCommand.java b/src/main/java/org/bukkit/command/defaults/DeopCommand.java index a01327dc..ef7ab2f1 100644 --- a/src/main/java/org/bukkit/command/defaults/DeopCommand.java +++ b/src/main/java/org/bukkit/command/defaults/DeopCommand.java @@ -29,7 +29,7 @@ public class DeopCommand extends VanillaCommand { player.setOp(false); if (player instanceof Player) { - ((Player)player).sendMessage(ChatColor.YELLOW + "You are no longer op!"); + ((Player) player).sendMessage(ChatColor.YELLOW + "You are no longer op!"); } return true; diff --git a/src/main/java/org/bukkit/command/defaults/ExpCommand.java b/src/main/java/org/bukkit/command/defaults/ExpCommand.java index 71773fd2..721a7d7a 100644 --- a/src/main/java/org/bukkit/command/defaults/ExpCommand.java +++ b/src/main/java/org/bukkit/command/defaults/ExpCommand.java @@ -28,7 +28,7 @@ public class ExpCommand extends VanillaCommand { try { int exp = Integer.parseInt(args[1]); - Command.broadcastCommandMessage(sender, "Giving " + exp + " exp to " + player.getName()); + Command.broadcastCommandMessage(sender, "Giving " + exp + " exp to " + player.getName()); player.giveExp(exp); } catch (NumberFormatException ex) { diff --git a/src/main/java/org/bukkit/command/defaults/KillCommand.java b/src/main/java/org/bukkit/command/defaults/KillCommand.java index e6c2fa13..0fe80db4 100644 --- a/src/main/java/org/bukkit/command/defaults/KillCommand.java +++ b/src/main/java/org/bukkit/command/defaults/KillCommand.java @@ -18,7 +18,7 @@ public class KillCommand extends VanillaCommand { if (!testPermission(sender)) return true; if (sender instanceof Player) { - Player player = (Player)sender; + Player player = (Player) sender; EntityDamageEvent ede = new EntityDamageEvent(player, EntityDamageEvent.DamageCause.SUICIDE, 1000); Bukkit.getPluginManager().callEvent(ede); diff --git a/src/main/java/org/bukkit/command/defaults/MeCommand.java b/src/main/java/org/bukkit/command/defaults/MeCommand.java index 54184b09..f181b4fe 100644 --- a/src/main/java/org/bukkit/command/defaults/MeCommand.java +++ b/src/main/java/org/bukkit/command/defaults/MeCommand.java @@ -23,10 +23,10 @@ public class MeCommand extends VanillaCommand { StringBuilder message = new StringBuilder(); message.append(sender.getName()); if (args.length > 0) { - for (int i = 0; i < args.length; i++) { - message.append(" "); - message.append(args[i]); - } + for (String arg : args) { + message.append(" "); + message.append(arg); + } } Bukkit.broadcastMessage("* " + message.toString()); diff --git a/src/main/java/org/bukkit/command/defaults/OpCommand.java b/src/main/java/org/bukkit/command/defaults/OpCommand.java index b8329de7..2b41dfc9 100644 --- a/src/main/java/org/bukkit/command/defaults/OpCommand.java +++ b/src/main/java/org/bukkit/command/defaults/OpCommand.java @@ -29,7 +29,7 @@ public class OpCommand extends VanillaCommand { player.setOp(true); if (player instanceof Player) { - ((Player)player).sendMessage(ChatColor.YELLOW + "You are now op!"); + ((Player) player).sendMessage(ChatColor.YELLOW + "You are now op!"); } return true; diff --git a/src/main/java/org/bukkit/command/defaults/PluginsCommand.java b/src/main/java/org/bukkit/command/defaults/PluginsCommand.java index ec03cfb3..2efe30e8 100644 --- a/src/main/java/org/bukkit/command/defaults/PluginsCommand.java +++ b/src/main/java/org/bukkit/command/defaults/PluginsCommand.java @@ -19,7 +19,7 @@ public class PluginsCommand extends Command { @Override public boolean execute(CommandSender sender, String currentAlias, String[] args) { if (!testPermission(sender)) return true; - + sender.sendMessage("Plugins: " + getPluginList()); return true; } @@ -27,13 +27,13 @@ public class PluginsCommand extends Command { private String getPluginList() { StringBuilder pluginList = new StringBuilder(); Plugin[] plugins = Bukkit.getPluginManager().getPlugins(); - + for (Plugin plugin : plugins) { if (pluginList.length() > 0) { pluginList.append(ChatColor.WHITE); pluginList.append(", "); } - + pluginList.append(plugin.isEnabled() ? ChatColor.GREEN : ChatColor.RED); pluginList.append(plugin.getDescription().getName()); } diff --git a/src/main/java/org/bukkit/command/defaults/SayCommand.java b/src/main/java/org/bukkit/command/defaults/SayCommand.java index 37fdac76..41ce50ef 100644 --- a/src/main/java/org/bukkit/command/defaults/SayCommand.java +++ b/src/main/java/org/bukkit/command/defaults/SayCommand.java @@ -23,11 +23,11 @@ public class SayCommand extends VanillaCommand { StringBuilder message = new StringBuilder(); if (args.length > 0) { - message.append(args[0]); - for (int i = 1; i < args.length; i++) { - message.append(" "); - message.append(args[i]); - } + message.append(args[0]); + for (int i = 1; i < args.length; i++) { + message.append(" "); + message.append(args[i]); + } } if (!(sender instanceof ConsoleCommandSender)) { diff --git a/src/main/java/org/bukkit/command/defaults/TimeCommand.java b/src/main/java/org/bukkit/command/defaults/TimeCommand.java index a9e6a9fe..347c3489 100644 --- a/src/main/java/org/bukkit/command/defaults/TimeCommand.java +++ b/src/main/java/org/bukkit/command/defaults/TimeCommand.java @@ -15,7 +15,7 @@ public class TimeCommand extends VanillaCommand { @Override public boolean execute(CommandSender sender, String currentAlias, String[] args) { - if (args.length != 2) { + if (args.length != 2) { sender.sendMessage(ChatColor.RED + "Incorrect usage. Correct usage:\n" + usageMessage); return false; } diff --git a/src/main/java/org/bukkit/command/defaults/ToggleDownfallCommand.java b/src/main/java/org/bukkit/command/defaults/ToggleDownfallCommand.java index d03ccecb..f5f8c217 100644 --- a/src/main/java/org/bukkit/command/defaults/ToggleDownfallCommand.java +++ b/src/main/java/org/bukkit/command/defaults/ToggleDownfallCommand.java @@ -29,7 +29,7 @@ public class ToggleDownfallCommand extends VanillaCommand { return true; } } else if (sender instanceof Player) { - world = ((Player)sender).getWorld(); + world = ((Player) sender).getWorld(); } else { world = Bukkit.getWorlds().get(0); } diff --git a/src/main/java/org/bukkit/command/defaults/VersionCommand.java b/src/main/java/org/bukkit/command/defaults/VersionCommand.java index 91231a06..3a582359 100644 --- a/src/main/java/org/bukkit/command/defaults/VersionCommand.java +++ b/src/main/java/org/bukkit/command/defaults/VersionCommand.java @@ -12,7 +12,7 @@ import org.bukkit.plugin.PluginDescriptionFile; public class VersionCommand extends Command { public VersionCommand(String name) { super(name); - + this.description = "Gets the version of this server including any plugins in use"; this.usageMessage = "/version [plugin name]"; this.setPermission("bukkit.command.version"); @@ -22,7 +22,7 @@ public class VersionCommand extends Command { @Override public boolean execute(CommandSender sender, String currentAlias, String[] args) { if (!testPermission(sender)) return true; - + if (args.length == 0) { sender.sendMessage("This server is running " + Bukkit.getName() + " version " + Bukkit.getVersion() + " (Implementing API version " + Bukkit.getBukkitVersion() + ")"); } else { @@ -32,7 +32,7 @@ public class VersionCommand extends Command { if (name.length() > 0) { name.append(' '); } - + name.append(arg); } @@ -83,7 +83,7 @@ public class VersionCommand extends Command { result.append(ChatColor.GREEN); result.append(authors.get(i)); } - + return result.toString(); } } diff --git a/src/main/java/org/bukkit/configuration/Configuration.java b/src/main/java/org/bukkit/configuration/Configuration.java index ed66d1b8..6fa80186 100644 --- a/src/main/java/org/bukkit/configuration/Configuration.java +++ b/src/main/java/org/bukkit/configuration/Configuration.java @@ -70,12 +70,12 @@ public interface Configuration extends ConfigurationSection { * @return Configuration source for default values, or null if none exist. */ public Configuration getDefaults(); - + /** * Gets the {@link ConfigurationOptions} for this {@link Configuration}. * <p> * All setters through this method are chainable. - * + * * @return Options for this configuration */ public ConfigurationOptions options(); diff --git a/src/main/java/org/bukkit/configuration/ConfigurationOptions.java b/src/main/java/org/bukkit/configuration/ConfigurationOptions.java index 5392700f..73ca421c 100644 --- a/src/main/java/org/bukkit/configuration/ConfigurationOptions.java +++ b/src/main/java/org/bukkit/configuration/ConfigurationOptions.java @@ -7,38 +7,38 @@ public class ConfigurationOptions { private char pathSeparator = '.'; private boolean copyDefaults = false; private final Configuration configuration; - + protected ConfigurationOptions(Configuration configuration) { this.configuration = configuration; } - + /** * Returns the {@link Configuration} that this object is responsible for. - * + * * @return Parent configuration */ public Configuration configuration() { return configuration; } - + /** * Gets the char that will be used to separate {@link ConfigurationSection}s * <p> * This value does not affect how the {@link Configuration} is stored, only in * how you access the data. The default value is '.'. - * + * * @return Path separator */ public char pathSeparator() { return pathSeparator; } - + /** * Sets the char that will be used to separate {@link ConfigurationSection}s * <p> * This value does not affect how the {@link Configuration} is stored, only in * how you access the data. The default value is '.'. - * + * * @param value Path separator * @return This object, for chaining */ @@ -46,7 +46,7 @@ public class ConfigurationOptions { this.pathSeparator = value; return this; } - + /** * Checks if the {@link Configuration} should copy values from its default {@link Configuration} directly. * <p> @@ -55,13 +55,13 @@ public class ConfigurationOptions { * are provided by default. As a result, {@link ConfigurationSection#contains(java.lang.String)} will always * return the same value as {@link ConfigurationSection#isSet(java.lang.String)}. * The default value is false. - * + * * @return Whether or not defaults are directly copied */ public boolean copyDefaults() { return copyDefaults; } - + /** * Sets if the {@link Configuration} should copy values from its default {@link Configuration} directly. * <p> @@ -70,7 +70,7 @@ public class ConfigurationOptions { * are provided by default. As a result, {@link ConfigurationSection#contains(java.lang.String)} will always * return the same value as {@link ConfigurationSection#isSet(java.lang.String)}. * The default value is false. - * + * * @param value Whether or not defaults are directly copied * @return This object, for chaining */ diff --git a/src/main/java/org/bukkit/configuration/ConfigurationSection.java b/src/main/java/org/bukkit/configuration/ConfigurationSection.java index 3bd6fe37..7083ccc2 100644 --- a/src/main/java/org/bukkit/configuration/ConfigurationSection.java +++ b/src/main/java/org/bukkit/configuration/ConfigurationSection.java @@ -79,13 +79,13 @@ public interface ConfigurationSection { * @return Path of this section relative to its root */ public String getCurrentPath(); - + /** * Gets the name of this individual {@link ConfigurationSection}, in the path. * <p> * This will always be the final part of {@link #getCurrentPath()}, unless the * section is orphaned. - * + * * @return Name of this section */ public String getName(); @@ -146,7 +146,7 @@ public interface ConfigurationSection { * <p> * Some implementations may have limitations on what you may store. See their * individual javadocs for details. No implementations should allow you to store - * {@link Configuration}s or {@link ConfigurationSection}s, please use + * {@link Configuration}s or {@link ConfigurationSection}s, please use * {@link #createSection(java.lang.String)} for that. * * @param path Path of the object to set. @@ -164,7 +164,7 @@ public interface ConfigurationSection { * @return Newly created section */ public ConfigurationSection createSection(String path); - + /** * Creates a {@link ConfigurationSection} at the specified path, with specified values. * <p> @@ -213,7 +213,6 @@ public interface ConfigurationSection { */ public boolean isString(String path); - /** * Gets the requested int by path. * <p> @@ -250,7 +249,6 @@ public interface ConfigurationSection { */ public boolean isInt(String path); - /** * Gets the requested boolean by path. * <p> @@ -287,7 +285,6 @@ public interface ConfigurationSection { */ public boolean isBoolean(String path); - /** * Gets the requested double by path. * <p> @@ -324,7 +321,6 @@ public interface ConfigurationSection { */ public boolean isDouble(String path); - /** * Gets the requested long by path. * <p> @@ -361,8 +357,6 @@ public interface ConfigurationSection { */ public boolean isLong(String path); - - // Java /** * Gets the requested List by path. @@ -374,6 +368,7 @@ public interface ConfigurationSection { * @param path Path of the List to get. * @return Requested List. */ + @SuppressWarnings("rawtypes") public List getList(String path); /** @@ -385,7 +380,8 @@ public interface ConfigurationSection { * @param path Path of the List to get. * @return Requested List. */ - public List getList(String path, List def); + @SuppressWarnings("rawtypes") + public List getList(String path, List<?> def); /** * Checks if the specified path is a List. @@ -400,7 +396,6 @@ public interface ConfigurationSection { */ public boolean isList(String path); - /** * Gets the requested List of String by path. * <p> @@ -551,7 +546,6 @@ public interface ConfigurationSection { */ public List<Map<String, Object>> getMapList(String path); - // Bukkit /** * Gets the requested Vector by path. @@ -589,7 +583,6 @@ public interface ConfigurationSection { */ public boolean isVector(String path); - /** * Gets the requested OfflinePlayer by path. * <p> @@ -626,7 +619,6 @@ public interface ConfigurationSection { */ public boolean isOfflinePlayer(String path); - /** * Gets the requested ItemStack by path. * <p> @@ -663,7 +655,6 @@ public interface ConfigurationSection { */ public boolean isItemStack(String path); - /** * Gets the requested ConfigurationSection by path. * <p> @@ -688,18 +679,18 @@ public interface ConfigurationSection { * @return Whether or not the specified path is a ConfigurationSection. */ public boolean isConfigurationSection(String path); - + /** * Gets the equivalent {@link ConfigurationSection} from the default {@link Configuration} defined in {@link #getRoot()}. * <p> * If the root contains no defaults, or the defaults doesn't contain a value * for this path, or the value at this path is not a {@link ConfigurationSection} then * this will return null. - * + * * @return Equivalent section in root configuration */ public ConfigurationSection getDefaultSection(); - + /** * Sets the default value in the root at the given path as provided. * <p> diff --git a/src/main/java/org/bukkit/configuration/InvalidConfigurationException.java b/src/main/java/org/bukkit/configuration/InvalidConfigurationException.java index 3057712f..c60ff56e 100644 --- a/src/main/java/org/bukkit/configuration/InvalidConfigurationException.java +++ b/src/main/java/org/bukkit/configuration/InvalidConfigurationException.java @@ -3,6 +3,7 @@ package org.bukkit.configuration; /** * Exception thrown when attempting to load an invalid {@link Configuration} */ +@SuppressWarnings("serial") public class InvalidConfigurationException extends Exception { /** * Creates a new instance of InvalidConfigurationException without a message or cause. diff --git a/src/main/java/org/bukkit/configuration/MemoryConfiguration.java b/src/main/java/org/bukkit/configuration/MemoryConfiguration.java index 5fffc593..d26a2984 100644 --- a/src/main/java/org/bukkit/configuration/MemoryConfiguration.java +++ b/src/main/java/org/bukkit/configuration/MemoryConfiguration.java @@ -32,7 +32,7 @@ public class MemoryConfiguration extends MemorySection implements Configuration if (path == null) { throw new IllegalArgumentException("Path may not be null"); } - + if (defaults == null) { defaults = new MemoryConfiguration(); } @@ -79,7 +79,7 @@ public class MemoryConfiguration extends MemorySection implements Configuration if (options == null) { options = new MemoryConfigurationOptions(this); } - + return options; } } diff --git a/src/main/java/org/bukkit/configuration/MemoryConfigurationOptions.java b/src/main/java/org/bukkit/configuration/MemoryConfigurationOptions.java index 93d3e50c..16b10514 100644 --- a/src/main/java/org/bukkit/configuration/MemoryConfigurationOptions.java +++ b/src/main/java/org/bukkit/configuration/MemoryConfigurationOptions.java @@ -10,7 +10,7 @@ public class MemoryConfigurationOptions extends ConfigurationOptions { @Override public MemoryConfiguration configuration() { - return (MemoryConfiguration)super.configuration(); + return (MemoryConfiguration) super.configuration(); } @Override diff --git a/src/main/java/org/bukkit/configuration/MemorySection.java b/src/main/java/org/bukkit/configuration/MemorySection.java index 3cae2295..eb84b4a6 100644 --- a/src/main/java/org/bukkit/configuration/MemorySection.java +++ b/src/main/java/org/bukkit/configuration/MemorySection.java @@ -40,7 +40,7 @@ public class MemorySection implements ConfigurationSection { this.path = ""; this.fullPath = ""; this.parent = null; - this.root = (Configuration)this; + this.root = (Configuration) this; } /** @@ -65,16 +65,16 @@ public class MemorySection implements ConfigurationSection { if (root == null) { throw new IllegalArgumentException("Path cannot be orphaned"); } - + this.fullPath = createPath(parent, path); } public Set<String> getKeys(boolean deep) { Set<String> result = new LinkedHashSet<String>(); - + if (getRoot().options().copyDefaults()) { ConfigurationSection defaults = getDefaultSection(); - + if (defaults != null) { result.addAll(defaults.getKeys(deep)); } @@ -87,10 +87,10 @@ public class MemorySection implements ConfigurationSection { public Map<String, Object> getValues(boolean deep) { Map<String, Object> result = new LinkedHashMap<String, Object>(); - + if (getRoot().options().copyDefaults()) { ConfigurationSection defaults = getDefaultSection(); - + if (defaults != null) { result.putAll(defaults.getValues(deep)); } @@ -124,7 +124,7 @@ public class MemorySection implements ConfigurationSection { public String getCurrentPath() { return fullPath; } - + public String getName() { return path; } @@ -136,32 +136,32 @@ public class MemorySection implements ConfigurationSection { public ConfigurationSection getParent() { return parent; } - + public void addDefault(String path, Object value) { if (path == null) { throw new IllegalArgumentException("Path cannot be null"); } - + if (root == null) { throw new IllegalStateException("Cannot set default on orphaned section"); } else { root.addDefault(createPath(this, path), value); } } - + public ConfigurationSection getDefaultSection() { if (getRoot() == null) { return null; } - + Configuration defaults = getRoot().getDefaults(); - + if (defaults != null) { if (defaults.isConfigurationSection(getCurrentPath())) { return defaults.getConfigurationSection(getCurrentPath()); } } - + return null; } @@ -169,9 +169,7 @@ public class MemorySection implements ConfigurationSection { String[] split = path.split(Pattern.quote(Character.toString(getRoot().options().pathSeparator()))); ConfigurationSection section = this; - if (path == null) { - throw new IllegalArgumentException("Path cannot be null"); - } else if (path.length() == 0) { + if (path.length() == 0) { throw new IllegalArgumentException("Cannot set to an empty path"); } @@ -219,7 +217,7 @@ public class MemorySection implements ConfigurationSection { for (int i = 0; i < split.length - 1; i++) { section = section.getConfigurationSection(split[i]); - + if (section == null) { return def; } @@ -230,11 +228,8 @@ public class MemorySection implements ConfigurationSection { if (section == this) { result = map.get(key); return (result == null) ? def : result; - } else if (section != null) { - return section.get(key, def); - } else { - return def; } + return section.get(key, def); } public ConfigurationSection createSection(String path) { @@ -267,13 +262,14 @@ public class MemorySection implements ConfigurationSection { return section.createSection(key); } } - + + @SuppressWarnings("unchecked") public ConfigurationSection createSection(String path, Map<String, Object> map) { ConfigurationSection section = createSection(path); - for(Map.Entry<String, Object> entry : map.entrySet()) { - if(entry.getValue() instanceof Map) { - section.createSection(entry.getKey(), (Map<String, Object>)entry.getValue()); + for (Map.Entry<String, Object> entry : map.entrySet()) { + if (entry.getValue() instanceof Map) { + section.createSection(entry.getKey(), (Map<String, Object>) entry.getValue()); } else { section.set(entry.getKey(), entry.getValue()); } @@ -343,7 +339,7 @@ public class MemorySection implements ConfigurationSection { } Object def = getDefault(path); - return getBoolean(path, (def instanceof Boolean) ? (Boolean)def : false); + return getBoolean(path, (def instanceof Boolean) ? (Boolean) def : false); } public boolean getBoolean(String path, boolean def) { @@ -352,7 +348,7 @@ public class MemorySection implements ConfigurationSection { } Object val = get(path, def); - return (val instanceof Boolean) ? (Boolean)val : def; + return (val instanceof Boolean) ? (Boolean) val : def; } public boolean isBoolean(String path) { @@ -418,23 +414,25 @@ public class MemorySection implements ConfigurationSection { return val instanceof Long; } -// Java - public List getList(String path) { + // Java + @SuppressWarnings("unchecked") + public List<Object> getList(String path) { if (path == null) { throw new IllegalArgumentException("Path cannot be null"); } Object def = getDefault(path); - return getList(path, (def instanceof List) ? (List)def : null); + return getList(path, (def instanceof List) ? (List<Object>) def : null); } - public List getList(String path, List def) { + @SuppressWarnings("unchecked") + public List<Object> getList(String path, List<?> def) { if (path == null) { throw new IllegalArgumentException("Path cannot be null"); } Object val = get(path, def); - return (val instanceof List) ? (List)val : def; + return (List<Object>) ((val instanceof List) ? val : def); } public boolean isList(String path) { @@ -452,19 +450,19 @@ public class MemorySection implements ConfigurationSection { } List<Object> list = getList(path); - + if (list == null) { return null; } - - List<String> result = new ArrayList(); - + + List<String> result = new ArrayList<String>(); + for (Object object : list) { if ((object instanceof String) || (isPrimitiveWrapper(object))) { result.add(String.valueOf(object)); } } - + return result; } @@ -474,37 +472,38 @@ public class MemorySection implements ConfigurationSection { } List<Object> list = getList(path); - + if (list == null) { return null; } - - List<Integer> result = new ArrayList(); - + + List<Integer> result = new ArrayList<Integer>(); + for (Object object : list) { if (object instanceof Integer) { - result.add((Integer)object); + result.add((Integer) object); } else if (object instanceof String) { try { - result.add(Integer.valueOf((String)object)); - } catch (Exception ex) {} + result.add(Integer.valueOf((String) object)); + } catch (Exception ex) { + } } else if (object instanceof Byte) { - result.add((Integer)(int)(byte)(Byte)object); + result.add((Integer) (int) (byte) (Byte) object); } else if (object instanceof Character) { - result.add((Integer)(int)(char)(Character)object); + result.add((Integer) (int) (char) (Character) object); } else if (object instanceof Short) { - result.add((Integer)(int)(short)(Short)object); + result.add((Integer) (int) (short) (Short) object); } else if (object instanceof Integer) { - result.add((Integer)(int)(int)(Integer)object); + result.add((Integer) (int) (int) (Integer) object); } else if (object instanceof Long) { - result.add((Integer)(int)(long)(Long)object); + result.add((Integer) (int) (long) (Long) object); } else if (object instanceof Float) { - result.add((Integer)(int)(float)(Float)object); + result.add((Integer) (int) (float) (Float) object); } else if (object instanceof Double) { - result.add((Integer)(int)(double)(Double)object); + result.add((Integer) (int) (double) (Double) object); } } - + return result; } @@ -514,16 +513,16 @@ public class MemorySection implements ConfigurationSection { } List<Object> list = getList(path); - + if (list == null) { return null; } - - List<Boolean> result = new ArrayList(); - + + List<Boolean> result = new ArrayList<Boolean>(); + for (Object object : list) { if (object instanceof Boolean) { - result.add((Boolean)object); + result.add((Boolean) object); } else if (object instanceof String) { if (Boolean.TRUE.toString().equals(object)) { result.add(true); @@ -532,7 +531,7 @@ public class MemorySection implements ConfigurationSection { } } } - + return result; } @@ -542,37 +541,38 @@ public class MemorySection implements ConfigurationSection { } List<Object> list = getList(path); - + if (list == null) { return null; } - - List<Double> result = new ArrayList(); - + + List<Double> result = new ArrayList<Double>(); + for (Object object : list) { if (object instanceof Double) { - result.add((Double)object); + result.add((Double) object); } else if (object instanceof String) { try { - result.add(Double.valueOf((String)object)); - } catch (Exception ex) {} + result.add(Double.valueOf((String) object)); + } catch (Exception ex) { + } } else if (object instanceof Byte) { - result.add((Double)(double)(byte)(Byte)object); + result.add((Double) (double) (byte) (Byte) object); } else if (object instanceof Character) { - result.add((Double)(double)(char)(Character)object); + result.add((Double) (double) (char) (Character) object); } else if (object instanceof Short) { - result.add((Double)(double)(short)(Short)object); + result.add((Double) (double) (short) (Short) object); } else if (object instanceof Integer) { - result.add((Double)(double)(int)(Integer)object); + result.add((Double) (double) (int) (Integer) object); } else if (object instanceof Long) { - result.add((Double)(double)(long)(Long)object); + result.add((Double) (double) (long) (Long) object); } else if (object instanceof Float) { - result.add((Double)(double)(float)(Float)object); + result.add((Double) (double) (float) (Float) object); } else if (object instanceof Double) { - result.add((Double)(double)(double)(Double)object); + result.add((Double) (double) (double) (Double) object); } } - + return result; } @@ -582,37 +582,38 @@ public class MemorySection implements ConfigurationSection { } List<Object> list = getList(path); - + if (list == null) { return null; } - - List<Float> result = new ArrayList(); - + + List<Float> result = new ArrayList<Float>(); + for (Object object : list) { if (object instanceof Float) { - result.add((Float)object); + result.add((Float) object); } else if (object instanceof String) { try { - result.add(Float.valueOf((String)object)); - } catch (Exception ex) {} + result.add(Float.valueOf((String) object)); + } catch (Exception ex) { + } } else if (object instanceof Byte) { - result.add((Float)(float)(byte)(Byte)object); + result.add((Float) (float) (byte) (Byte) object); } else if (object instanceof Character) { - result.add((Float)(float)(char)(Character)object); + result.add((Float) (float) (char) (Character) object); } else if (object instanceof Short) { - result.add((Float)(float)(short)(Short)object); + result.add((Float) (float) (short) (Short) object); } else if (object instanceof Integer) { - result.add((Float)(float)(int)(Integer)object); + result.add((Float) (float) (int) (Integer) object); } else if (object instanceof Long) { - result.add((Float)(float)(long)(Long)object); + result.add((Float) (float) (long) (Long) object); } else if (object instanceof Float) { - result.add((Float)(float)(float)(Float)object); + result.add((Float) (float) (float) (Float) object); } else if (object instanceof Double) { - result.add((Float)(float)(double)(Double)object); + result.add((Float) (float) (double) (Double) object); } } - + return result; } @@ -622,37 +623,38 @@ public class MemorySection implements ConfigurationSection { } List<Object> list = getList(path); - + if (list == null) { return null; } - - List<Long> result = new ArrayList(); - + + List<Long> result = new ArrayList<Long>(); + for (Object object : list) { if (object instanceof Long) { - result.add((Long)object); + result.add((Long) object); } else if (object instanceof String) { try { - result.add(Long.valueOf((String)object)); - } catch (Exception ex) {} + result.add(Long.valueOf((String) object)); + } catch (Exception ex) { + } } else if (object instanceof Byte) { - result.add((Long)(long)(byte)(Byte)object); + result.add((Long) (long) (byte) (Byte) object); } else if (object instanceof Character) { - result.add((Long)(long)(char)(Character)object); + result.add((Long) (long) (char) (Character) object); } else if (object instanceof Short) { - result.add((Long)(long)(short)(Short)object); + result.add((Long) (long) (short) (Short) object); } else if (object instanceof Integer) { - result.add((Long)(long)(int)(Integer)object); + result.add((Long) (long) (int) (Integer) object); } else if (object instanceof Long) { - result.add((Long)(long)(long)(Long)object); + result.add((Long) (long) (long) (Long) object); } else if (object instanceof Float) { - result.add((Long)(long)(float)(Float)object); + result.add((Long) (long) (float) (Float) object); } else if (object instanceof Double) { - result.add((Long)(long)(double)(Double)object); + result.add((Long) (long) (double) (Double) object); } } - + return result; } @@ -662,37 +664,38 @@ public class MemorySection implements ConfigurationSection { } List<Object> list = getList(path); - + if (list == null) { return null; } - - List<Byte> result = new ArrayList(); - + + List<Byte> result = new ArrayList<Byte>(); + for (Object object : list) { if (object instanceof Byte) { - result.add((Byte)object); + result.add((Byte) object); } else if (object instanceof String) { try { - result.add(Byte.valueOf((String)object)); - } catch (Exception ex) {} + result.add(Byte.valueOf((String) object)); + } catch (Exception ex) { + } } else if (object instanceof Byte) { - result.add((Byte)(byte)(byte)(Byte)object); + result.add((Byte) (byte) (byte) (Byte) object); } else if (object instanceof Character) { - result.add((Byte)(byte)(char)(Character)object); + result.add((Byte) (byte) (char) (Character) object); } else if (object instanceof Short) { - result.add((Byte)(byte)(short)(Short)object); + result.add((Byte) (byte) (short) (Short) object); } else if (object instanceof Integer) { - result.add((Byte)(byte)(int)(Integer)object); + result.add((Byte) (byte) (int) (Integer) object); } else if (object instanceof Long) { - result.add((Byte)(byte)(long)(Long)object); + result.add((Byte) (byte) (long) (Long) object); } else if (object instanceof Float) { - result.add((Byte)(byte)(float)(Float)object); + result.add((Byte) (byte) (float) (Float) object); } else if (object instanceof Double) { - result.add((Byte)(byte)(double)(Double)object); + result.add((Byte) (byte) (double) (Double) object); } } - + return result; } @@ -702,39 +705,39 @@ public class MemorySection implements ConfigurationSection { } List<Object> list = getList(path); - + if (list == null) { return null; } - - List<Character> result = new ArrayList(); - + + List<Character> result = new ArrayList<Character>(); + for (Object object : list) { if (object instanceof Character) { - result.add((Character)object); + result.add((Character) object); } else if (object instanceof String) { - String str = (String)object; - + String str = (String) object; + if (str.length() == 1) { result.add(str.charAt(0)); } } else if (object instanceof Byte) { - result.add((Character)(char)(byte)(Byte)object); + result.add((Character) (char) (byte) (Byte) object); } else if (object instanceof Character) { - result.add((Character)(char)(char)(Character)object); + result.add((Character) (char) (char) (Character) object); } else if (object instanceof Short) { - result.add((Character)(char)(short)(Short)object); + result.add((Character) (char) (short) (Short) object); } else if (object instanceof Integer) { - result.add((Character)(char)(int)(Integer)object); + result.add((Character) (char) (int) (Integer) object); } else if (object instanceof Long) { - result.add((Character)(char)(long)(Long)object); + result.add((Character) (char) (long) (Long) object); } else if (object instanceof Float) { - result.add((Character)(char)(float)(Float)object); + result.add((Character) (char) (float) (Float) object); } else if (object instanceof Double) { - result.add((Character)(char)(double)(Double)object); + result.add((Character) (char) (double) (Double) object); } } - + return result; } @@ -744,65 +747,67 @@ public class MemorySection implements ConfigurationSection { } List<Object> list = getList(path); - + if (list == null) { return null; } - - List<Short> result = new ArrayList(); - + + List<Short> result = new ArrayList<Short>(); + for (Object object : list) { if (object instanceof Short) { - result.add((Short)object); + result.add((Short) object); } else if (object instanceof String) { try { - result.add(Short.valueOf((String)object)); - } catch (Exception ex) {} + result.add(Short.valueOf((String) object)); + } catch (Exception ex) { + } } else if (object instanceof Byte) { - result.add((Short)(short)(byte)(Byte)object); + result.add((Short) (short) (byte) (Byte) object); } else if (object instanceof Character) { - result.add((Short)(short)(char)(Character)object); + result.add((Short) (short) (char) (Character) object); } else if (object instanceof Short) { - result.add((Short)(short)(short)(Short)object); + result.add((Short) (short) (short) (Short) object); } else if (object instanceof Integer) { - result.add((Short)(short)(int)(Integer)object); + result.add((Short) (short) (int) (Integer) object); } else if (object instanceof Long) { - result.add((Short)(short)(long)(Long)object); + result.add((Short) (short) (long) (Long) object); } else if (object instanceof Float) { - result.add((Short)(short)(float)(Float)object); + result.add((Short) (short) (float) (Float) object); } else if (object instanceof Double) { - result.add((Short)(short)(double)(Double)object); + result.add((Short) (short) (double) (Double) object); } } - + return result; } + @SuppressWarnings("unchecked") public List<Map<String, Object>> getMapList(String path) { if (path == null) { throw new IllegalArgumentException("Path cannot be null"); } List<Object> list = getList(path); - List<Map<String, Object>> result = new ArrayList(); - + List<Map<String, Object>> result = new ArrayList<Map<String, Object>>(); + for (Object object : list) { if (object instanceof Map) { - result.add((Map<String, Object>)object); + result.add((Map<String, Object>) object); } } - + return result; } -// Bukkit + // Bukkit public Vector getVector(String path) { if (path == null) { throw new IllegalArgumentException("Path cannot be null"); } Object def = getDefault(path); - return getVector(path, (def instanceof Vector) ? (Vector)def : null); + return getVector(path, (def instanceof Vector) ? (Vector) def : null); } public Vector getVector(String path, Vector def) { @@ -811,7 +816,7 @@ public class MemorySection implements ConfigurationSection { } Object val = get(path, def); - return (val instanceof Vector) ? (Vector)val : def; + return (val instanceof Vector) ? (Vector) val : def; } public boolean isVector(String path) { @@ -829,7 +834,7 @@ public class MemorySection implements ConfigurationSection { } Object def = getDefault(path); - return getOfflinePlayer(path, (def instanceof OfflinePlayer) ? (OfflinePlayer)def : null); + return getOfflinePlayer(path, (def instanceof OfflinePlayer) ? (OfflinePlayer) def : null); } public OfflinePlayer getOfflinePlayer(String path, OfflinePlayer def) { @@ -838,7 +843,7 @@ public class MemorySection implements ConfigurationSection { } Object val = get(path, def); - return (val instanceof OfflinePlayer) ? (OfflinePlayer)val : def; + return (val instanceof OfflinePlayer) ? (OfflinePlayer) val : def; } public boolean isOfflinePlayer(String path) { @@ -856,7 +861,7 @@ public class MemorySection implements ConfigurationSection { } Object def = getDefault(path); - return getItemStack(path, (def instanceof ItemStack) ? (ItemStack)def : null); + return getItemStack(path, (def instanceof ItemStack) ? (ItemStack) def : null); } public ItemStack getItemStack(String path, ItemStack def) { @@ -865,7 +870,7 @@ public class MemorySection implements ConfigurationSection { } Object val = get(path, def); - return (val instanceof ItemStack) ? (ItemStack)val : def; + return (val instanceof ItemStack) ? (ItemStack) val : def; } public boolean isItemStack(String path) { @@ -881,11 +886,12 @@ public class MemorySection implements ConfigurationSection { if (path == null) { throw new IllegalArgumentException("Path cannot be null"); } - + Object val = get(path, null); - if (val != null) - return (val instanceof ConfigurationSection) ? (ConfigurationSection)val : null; - + if (val != null) { + return (val instanceof ConfigurationSection) ? (ConfigurationSection) val : null; + } + val = get(path, getDefault(path)); return (val instanceof ConfigurationSection) ? createSection(path) : null; } @@ -903,7 +909,7 @@ public class MemorySection implements ConfigurationSection { if (input == null) { throw new IllegalArgumentException("Cannot store null"); } - + if (isPrimitiveWrapper(input) || isNaturallyStorable(input)) { return input; } else if (input instanceof ConfigurationSerializable) { @@ -912,14 +918,14 @@ public class MemorySection implements ConfigurationSection { throw new IllegalArgumentException("Cannot store " + input + " into " + this + ", unsupported class"); } - + protected boolean isPrimitiveWrapper(Object input) { return input instanceof Integer || input instanceof Boolean || input instanceof Character || input instanceof Byte || input instanceof Short || input instanceof Double || input instanceof Long || input instanceof Float; } - + protected boolean isNaturallyStorable(Object input) { return input instanceof List || input instanceof Iterable || input instanceof String || input instanceof File || @@ -937,13 +943,13 @@ public class MemorySection implements ConfigurationSection { protected void mapChildrenKeys(Set<String> output, ConfigurationSection section, boolean deep) { if (section instanceof MemorySection) { - MemorySection sec = (MemorySection)section; + MemorySection sec = (MemorySection) section; for (Map.Entry<String, Object> entry : sec.map.entrySet()) { output.add(createPath(section, entry.getKey(), this)); if ((deep) && (entry.getValue() instanceof ConfigurationSection)) { - ConfigurationSection subsection = (ConfigurationSection)entry.getValue(); + ConfigurationSection subsection = (ConfigurationSection) entry.getValue(); mapChildrenKeys(output, subsection, deep); } } @@ -958,14 +964,14 @@ public class MemorySection implements ConfigurationSection { protected void mapChildrenValues(Map<String, Object> output, ConfigurationSection section, boolean deep) { if (section instanceof MemorySection) { - MemorySection sec = (MemorySection)section; + MemorySection sec = (MemorySection) section; for (Map.Entry<String, Object> entry : sec.map.entrySet()) { output.put(createPath(section, entry.getKey(), this), entry.getValue()); - + if (entry.getValue() instanceof ConfigurationSection) { if (deep) { - mapChildrenValues(output, (ConfigurationSection)entry.getValue(), deep); + mapChildrenValues(output, (ConfigurationSection) entry.getValue(), deep); } } } @@ -982,7 +988,7 @@ public class MemorySection implements ConfigurationSection { * Creates a full path to the given {@link ConfigurationSection} from its root {@link Configuration}. * <p> * You may use this method for any given {@link ConfigurationSection}, not only {@link MemorySection}. - * + * * @param section Section to create a path for. * @param key Name of the specified section. * @return Full path of the section from its root. @@ -991,12 +997,11 @@ public class MemorySection implements ConfigurationSection { return createPath(section, key, (section == null) ? null : section.getRoot()); } - /** * Creates a relative path to the given {@link ConfigurationSection} from the given relative section. * <p> * You may use this method for any given {@link ConfigurationSection}, not only {@link MemorySection}. - * + * * @param section Section to create a path for. * @param key Name of the specified section. * @param relativeTo Section to create the path relative to. @@ -1022,21 +1027,21 @@ public class MemorySection implements ConfigurationSection { builder.append(key); } - + return builder.toString(); } @Override public String toString() { StringBuilder builder = new StringBuilder(); - + builder.append(getClass().getSimpleName()); builder.append("[path='"); builder.append(getCurrentPath()); builder.append("', root='"); builder.append(root.getClass().getSimpleName()); builder.append("']"); - + return builder.toString(); } } diff --git a/src/main/java/org/bukkit/configuration/file/FileConfiguration.java b/src/main/java/org/bukkit/configuration/file/FileConfiguration.java index 409e3921..4c192639 100644 --- a/src/main/java/org/bukkit/configuration/file/FileConfiguration.java +++ b/src/main/java/org/bukkit/configuration/file/FileConfiguration.java @@ -48,7 +48,7 @@ public abstract class FileConfiguration extends MemoryConfiguration { if (file == null) { throw new IllegalArgumentException("File cannot be null"); } - + Files.createParentDirs(file); String data = saveToString(); @@ -76,7 +76,7 @@ public abstract class FileConfiguration extends MemoryConfiguration { if (file == null) { throw new IllegalArgumentException("File cannot be null"); } - + save(new File(file)); } @@ -108,7 +108,7 @@ public abstract class FileConfiguration extends MemoryConfiguration { load(new FileInputStream(file)); } - + /** * Loads this {@link FileConfiguration} from the specified stream. * <p> @@ -124,7 +124,7 @@ public abstract class FileConfiguration extends MemoryConfiguration { if (stream == null) { throw new IllegalArgumentException("Stream cannot be null"); } - + InputStreamReader reader = new InputStreamReader(stream); StringBuilder builder = new StringBuilder(); BufferedReader input = new BufferedReader(reader); @@ -178,13 +178,13 @@ public abstract class FileConfiguration extends MemoryConfiguration { * @throws IllegalArgumentException Thrown if contents is null. */ public abstract void loadFromString(String contents) throws InvalidConfigurationException; - + /** * Compiles the header for this {@link FileConfiguration} and returns the result. * <p> * This will use the header from {@link #options()} -> {@link FileConfigurationOptions#header()}, * respecting the rules of {@link FileConfigurationOptions#copyHeader()} if set. - * + * * @return Compiled header */ protected abstract String buildHeader(); @@ -194,7 +194,7 @@ public abstract class FileConfiguration extends MemoryConfiguration { if (options == null) { options = new FileConfigurationOptions(this); } - - return (FileConfigurationOptions)options; + + return (FileConfigurationOptions) options; } }
\ No newline at end of file diff --git a/src/main/java/org/bukkit/configuration/file/FileConfigurationOptions.java b/src/main/java/org/bukkit/configuration/file/FileConfigurationOptions.java index 1da24047..e99c4cfa 100644 --- a/src/main/java/org/bukkit/configuration/file/FileConfigurationOptions.java +++ b/src/main/java/org/bukkit/configuration/file/FileConfigurationOptions.java @@ -8,14 +8,14 @@ import org.bukkit.configuration.*; public class FileConfigurationOptions extends MemoryConfigurationOptions { private String header = null; private boolean copyHeader = true; - + protected FileConfigurationOptions(MemoryConfiguration configuration) { super(configuration); } @Override public FileConfiguration configuration() { - return (FileConfiguration)super.configuration(); + return (FileConfiguration) super.configuration(); } @Override @@ -29,7 +29,7 @@ public class FileConfigurationOptions extends MemoryConfigurationOptions { super.pathSeparator(value); return this; } - + /** * Gets the header that will be applied to the top of the saved output. * <p> @@ -40,13 +40,13 @@ public class FileConfigurationOptions extends MemoryConfigurationOptions { * <p> * Null is a valid value which will indicate that no header is to be applied. * The default value is null. - * + * * @return Header */ public String header() { return header; } - + /** * Sets the header that will be applied to the top of the saved output. * <p> @@ -56,8 +56,8 @@ public class FileConfigurationOptions extends MemoryConfigurationOptions { * but you may include one if you wish for extra spacing. * <p> * Null is a valid value which will indicate that no header is to be applied. - * The default value is null. * + * * @param value New header * @return This object, for chaining */ @@ -65,7 +65,7 @@ public class FileConfigurationOptions extends MemoryConfigurationOptions { this.header = value; return this; } - + /** * Gets whether or not the header should be copied from a default source. * <p> @@ -78,13 +78,13 @@ public class FileConfigurationOptions extends MemoryConfigurationOptions { * specified in this configuration will be used. * <p> * Defaults to true. - * + * * @return Whether or not to copy the header */ public boolean copyHeader() { return copyHeader; } - + /** * Sets whether or not the header should be copied from a default source. * <p> @@ -97,13 +97,13 @@ public class FileConfigurationOptions extends MemoryConfigurationOptions { * specified in this configuration will be used. * <p> * Defaults to true. - * + * * @param value Whether or not to copy the header * @return This object, for chaining */ public FileConfigurationOptions copyHeader(boolean value) { copyHeader = value; - + return this; } } diff --git a/src/main/java/org/bukkit/configuration/file/YamlConfiguration.java b/src/main/java/org/bukkit/configuration/file/YamlConfiguration.java index aaf8ce7f..237018e3 100644 --- a/src/main/java/org/bukkit/configuration/file/YamlConfiguration.java +++ b/src/main/java/org/bukkit/configuration/file/YamlConfiguration.java @@ -4,14 +4,14 @@ import java.io.File; import java.io.FileNotFoundException; import java.io.IOException; import java.io.InputStream; -import java.util.HashMap; import java.util.LinkedHashMap; import java.util.Map; import java.util.logging.Level; + import org.bukkit.Bukkit; -import org.bukkit.configuration.InvalidConfigurationException; import org.bukkit.configuration.Configuration; import org.bukkit.configuration.ConfigurationSection; +import org.bukkit.configuration.InvalidConfigurationException; import org.bukkit.configuration.serialization.ConfigurationSerializable; import org.bukkit.configuration.serialization.ConfigurationSerialization; import org.yaml.snakeyaml.DumperOptions; @@ -33,20 +33,20 @@ public class YamlConfiguration extends FileConfiguration { @Override public String saveToString() { Map<String, Object> output = new LinkedHashMap<String, Object>(); - + yamlOptions.setIndent(options().indent()); yamlOptions.setDefaultFlowStyle(DumperOptions.FlowStyle.BLOCK); yamlRepresenter.setDefaultFlowStyle(DumperOptions.FlowStyle.BLOCK); - + serializeValues(output, getValues(false)); - + String header = buildHeader(); String dump = yaml.dump(output); - + if (dump.equals(BLANK_CONFIG)) { dump = ""; } - + return header + dump; } @@ -55,45 +55,47 @@ public class YamlConfiguration extends FileConfiguration { if (contents == null) { throw new IllegalArgumentException("Contents cannot be null"); } - - Map<Object, Object> input = (Map<Object, Object>)yaml.load(contents); + + @SuppressWarnings("unchecked") + Map<Object, Object> input = (Map<Object, Object>) yaml.load(contents); int size = (input == null) ? 0 : input.size(); Map<String, Object> result = new LinkedHashMap<String, Object>(size); - + if (size > 0) { for (Map.Entry<Object, Object> entry : input.entrySet()) { result.put(entry.getKey().toString(), entry.getValue()); } } - + String header = parseHeader(contents); - + if (header.length() > 0) { options().header(header); } - + deserializeValues(result, this); } - + protected void deserializeValues(Map<String, Object> input, ConfigurationSection section) throws InvalidConfigurationException { if (input == null) { return; } - + for (Map.Entry<String, Object> entry : input.entrySet()) { Object value = entry.getValue(); - + if (value instanceof Map) { - Map<Object, Object> subinput = (Map<Object, Object>)value; + @SuppressWarnings("unchecked") + Map<Object, Object> subinput = (Map<Object, Object>) value; int size = (subinput == null) ? 0 : subinput.size(); Map<String, Object> subvalues = new LinkedHashMap<String, Object>(size); - + if (size > 0) { for (Map.Entry<Object, Object> subentry : subinput.entrySet()) { subvalues.put(subentry.getKey().toString(), subentry.getValue()); } } - + if (subvalues.containsKey(ConfigurationSerialization.SERIALIZED_TYPE_KEY)) { try { ConfigurationSerializable serializable = ConfigurationSerialization.deserializeObject(subvalues); @@ -110,51 +112,51 @@ public class YamlConfiguration extends FileConfiguration { } } } - + protected void serializeValues(Map<String, Object> output, Map<String, Object> input) { if (input == null) { return; } - + for (Map.Entry<String, Object> entry : input.entrySet()) { Object value = entry.getValue(); - + if (value instanceof ConfigurationSection) { - ConfigurationSection subsection = (ConfigurationSection)entry.getValue(); + ConfigurationSection subsection = (ConfigurationSection) entry.getValue(); Map<String, Object> subvalues = new LinkedHashMap<String, Object>(); - + serializeValues(subvalues, subsection.getValues(false)); value = subvalues; } else if (value instanceof ConfigurationSerializable) { - ConfigurationSerializable serializable = (ConfigurationSerializable)value; + ConfigurationSerializable serializable = (ConfigurationSerializable) value; Map<String, Object> subvalues = new LinkedHashMap<String, Object>(); subvalues.put(ConfigurationSerialization.SERIALIZED_TYPE_KEY, ConfigurationSerialization.getAlias(serializable.getClass())); - + serializeValues(subvalues, serializable.serialize()); value = subvalues; } else if ((!isPrimitiveWrapper(value)) && (!isNaturallyStorable(value))) { throw new IllegalStateException("Configuration contains non-serializable values, cannot process"); } - + if (value != null) { output.put(entry.getKey(), value); } } } - + protected String parseHeader(String input) { String[] lines = input.split("\r?\n", -1); StringBuilder result = new StringBuilder(); boolean readingHeader = true; - + for (int i = 0; (i < lines.length) && (readingHeader); i++) { String line = lines[i]; - + if (line.startsWith(COMMENT_PREFIX)) { if (i > 0) { result.append("\n"); } - + if (line.length() > COMMENT_PREFIX.length()) { result.append(line.substring(COMMENT_PREFIX.length())); } @@ -164,44 +166,45 @@ public class YamlConfiguration extends FileConfiguration { readingHeader = false; } } - + return result.toString(); } - + + @Override protected String buildHeader() { String header = options().header(); - + if (options().copyHeader()) { Configuration def = getDefaults(); - + if ((def != null) && (def instanceof FileConfiguration)) { - FileConfiguration filedefaults = (FileConfiguration)def; + FileConfiguration filedefaults = (FileConfiguration) def; String defaultsHeader = filedefaults.buildHeader(); - + if ((defaultsHeader != null) && (defaultsHeader.length() > 0)) { return defaultsHeader; } } } - + if (header == null) { return ""; } - + StringBuilder builder = new StringBuilder(); String[] lines = header.split("\r?\n", -1); boolean startedHeader = false; - + for (int i = lines.length - 1; i >= 0; i--) { builder.insert(0, "\n"); - + if ((startedHeader) || (lines[i].length() != 0)) { builder.insert(0, lines[i]); builder.insert(0, COMMENT_PREFIX); startedHeader = true; } } - + return builder.toString(); } @@ -210,16 +213,16 @@ public class YamlConfiguration extends FileConfiguration { if (options == null) { options = new YamlConfigurationOptions(this); } - - return (YamlConfigurationOptions)options; + + return (YamlConfigurationOptions) options; } - + /** * Creates a new {@link YamlConfiguration}, loading from the given file. * <p> * Any errors loading the Configuration will be logged and then ignored. * If the specified input is not a valid config, a blank config will be returned. - * + * * @param file Input file * @return Resulting configuration * @throws IllegalArgumentException Thrown is file is null @@ -228,9 +231,9 @@ public class YamlConfiguration extends FileConfiguration { if (file == null) { throw new IllegalArgumentException("File cannot be null"); } - + YamlConfiguration config = new YamlConfiguration(); - + try { config.load(file); } catch (FileNotFoundException ex) { @@ -245,16 +248,16 @@ public class YamlConfiguration extends FileConfiguration { Bukkit.getLogger().log(Level.SEVERE, "Cannot load " + file + ": " + ex.getCause().getClass(), ex); } } - + return config; } - + /** * Creates a new {@link YamlConfiguration}, loading from the given stream. * <p> * Any errors loading the Configuration will be logged and then ignored. * If the specified input is not a valid config, a blank config will be returned. - * + * * @param stream Input stream * @return Resulting configuration * @throws IllegalArgumentException Thrown is stream is null @@ -263,9 +266,9 @@ public class YamlConfiguration extends FileConfiguration { if (stream == null) { throw new IllegalArgumentException("Stream cannot be null"); } - + YamlConfiguration config = new YamlConfiguration(); - + try { config.load(stream); } catch (IOException ex) { @@ -279,7 +282,7 @@ public class YamlConfiguration extends FileConfiguration { Bukkit.getLogger().log(Level.SEVERE, "Cannot load configuration: " + ex.getCause().getClass(), ex); } } - + return config; } } diff --git a/src/main/java/org/bukkit/configuration/file/YamlConfigurationOptions.java b/src/main/java/org/bukkit/configuration/file/YamlConfigurationOptions.java index 25fd6266..46e4d6f9 100644 --- a/src/main/java/org/bukkit/configuration/file/YamlConfigurationOptions.java +++ b/src/main/java/org/bukkit/configuration/file/YamlConfigurationOptions.java @@ -5,14 +5,14 @@ package org.bukkit.configuration.file; */ public class YamlConfigurationOptions extends FileConfigurationOptions { private int indent = 2; - + protected YamlConfigurationOptions(YamlConfiguration configuration) { super(configuration); } @Override public YamlConfiguration configuration() { - return (YamlConfiguration)super.configuration(); + return (YamlConfiguration) super.configuration(); } @Override @@ -38,23 +38,23 @@ public class YamlConfigurationOptions extends FileConfigurationOptions { super.copyHeader(value); return this; } - + /** * Gets how much spaces should be used to indent each line. * <p> * The minimum value this may be is 2, and the maximum is 9. - * + * * @return How much to indent by */ public int indent() { return indent; } - + /** * Sets how much spaces should be used to indent each line. * <p> * The minimum value this may be is 2, and the maximum is 9. - * + * * @param value New indent * @return This object, for chaining */ @@ -62,7 +62,7 @@ public class YamlConfigurationOptions extends FileConfigurationOptions { if ((indent < 2) || (value > 9)) { throw new IllegalArgumentException("Indent must be between 1 and 10 characters"); } - + this.indent = value; return this; } diff --git a/src/main/java/org/bukkit/configuration/serialization/ConfigurationSerializable.java b/src/main/java/org/bukkit/configuration/serialization/ConfigurationSerializable.java index 6e2af873..53b4fb2f 100644 --- a/src/main/java/org/bukkit/configuration/serialization/ConfigurationSerializable.java +++ b/src/main/java/org/bukkit/configuration/serialization/ConfigurationSerializable.java @@ -7,9 +7,11 @@ import java.util.Map; * <p> * These objects MUST implement one of the following, in addition to the methods * as defined by this interface: - * - A static method "deserialize" that accepts a single {@link Map<String, Object>} and returns the class. - * - A static method "valueOf" that accepts a single {@link Map<String, Object>} and returns the class. - * - A constructor that accepts a single {@link Map<String, Object>}. + * <ul> + * <li>A static method "deserialize" that accepts a single {@link Map<String, Object>} and returns the class.</li> + * <li>A static method "valueOf" that accepts a single {@link Map<String, Object>} and returns the class.</li> + * <li>A constructor that accepts a single {@link Map<String, Object>}.</li> + * </ul> */ public interface ConfigurationSerializable { /** @@ -17,7 +19,7 @@ public interface ConfigurationSerializable { * <p> * This class must provide a method to restore this class, as defined in the * {@link ConfigurationSerializable} interface javadocs. - * + * * @return Map containing the current state of this class */ public Map<String, Object> serialize(); diff --git a/src/main/java/org/bukkit/configuration/serialization/ConfigurationSerialization.java b/src/main/java/org/bukkit/configuration/serialization/ConfigurationSerialization.java index ce594136..8bf50b95 100644 --- a/src/main/java/org/bukkit/configuration/serialization/ConfigurationSerialization.java +++ b/src/main/java/org/bukkit/configuration/serialization/ConfigurationSerialization.java @@ -17,27 +17,27 @@ public class ConfigurationSerialization { public static final String SERIALIZED_TYPE_KEY = "=="; private final Class<? extends ConfigurationSerializable> clazz; private static Map<String, Class<? extends ConfigurationSerializable>> aliases = new HashMap<String, Class<? extends ConfigurationSerializable>>(); - + static { registerClass(Vector.class); registerClass(BlockVector.class); } - + protected ConfigurationSerialization(Class<? extends ConfigurationSerializable> clazz) { this.clazz = clazz; } - + protected Method getMethod(String name, boolean isStatic) { try { Method method = clazz.getDeclaredMethod(name, Map.class); - + if (!ConfigurationSerializable.class.isAssignableFrom(method.getReturnType())) { return null; } if (Modifier.isStatic(method.getModifiers()) != isStatic) { return null; } - + return method; } catch (NoSuchMethodException ex) { return null; @@ -45,7 +45,7 @@ public class ConfigurationSerialization { return null; } } - + protected Constructor<? extends ConfigurationSerializable> getConstructor() { try { return clazz.getConstructor(Map.class); @@ -55,11 +55,11 @@ public class ConfigurationSerialization { return null; } } - + protected ConfigurationSerializable deserializeViaMethod(Method method, Map<String, Object> args) { try { - ConfigurationSerializable result = (ConfigurationSerializable)method.invoke(null, args); - + ConfigurationSerializable result = (ConfigurationSerializable) method.invoke(null, args); + if (result == null) { Logger.getLogger(ConfigurationSerialization.class.getName()).log(Level.SEVERE, "Could not call method '" + method.toString() + "' of " + clazz + " for deserialization: method returned null"); } else { @@ -68,55 +68,55 @@ public class ConfigurationSerialization { } catch (Throwable ex) { Logger.getLogger(ConfigurationSerialization.class.getName()).log(Level.SEVERE, "Could not call method '" + method.toString() + "' of " + clazz + " for deserialization", ex); } - + return null; } - + protected ConfigurationSerializable deserializeViaCtor(Constructor<? extends ConfigurationSerializable> ctor, Map<String, Object> args) { try { return ctor.newInstance(args); } catch (Throwable ex) { Logger.getLogger(ConfigurationSerialization.class.getName()).log(Level.SEVERE, "Could not call constructor '" + ctor.toString() + "' of " + clazz + " for deserialization", ex); } - + return null; } - + public ConfigurationSerializable deserialize(Map<String, Object> args) { if (args == null) { throw new IllegalArgumentException("Args must not be null"); } - + ConfigurationSerializable result = null; Method method = null; - + if (result == null) { method = getMethod("deserialize", true); - + if (method != null) { result = deserializeViaMethod(method, args); } } - + if (result == null) { method = getMethod("valueOf", true); - + if (method != null) { result = deserializeViaMethod(method, args); } } - + if (result == null) { Constructor<? extends ConfigurationSerializable> constructor = getConstructor(); - + if (constructor != null) { result = deserializeViaCtor(constructor, args); } } - + return result; } - + /** * Attempts to deserialize the given arguments into a new instance of the given class. * <p> @@ -125,7 +125,7 @@ public class ConfigurationSerialization { * <p> * If a new instance could not be made, an example being the class not fully implementing * the interface, null will be returned. - * + * * @param args Arguments for deserialization * @param clazz Class to deserialize into * @return New instance of the specified class @@ -133,7 +133,7 @@ public class ConfigurationSerialization { public static ConfigurationSerializable deserializeObject(Map<String, Object> args, Class<? extends ConfigurationSerializable> clazz) { return new ConfigurationSerialization(clazz).deserialize(args); } - + /** * Attempts to deserialize the given arguments into a new instance of the given class. * <p> @@ -142,17 +142,17 @@ public class ConfigurationSerialization { * <p> * If a new instance could not be made, an example being the class not fully implementing * the interface, null will be returned. - * + * * @param args Arguments for deserialization * @return New instance of the specified class */ public static ConfigurationSerializable deserializeObject(Map<String, Object> args) { Class<? extends ConfigurationSerializable> clazz = null; - + if (args.containsKey(SERIALIZED_TYPE_KEY)) { try { - String alias = (String)args.get(SERIALIZED_TYPE_KEY); - + String alias = (String) args.get(SERIALIZED_TYPE_KEY); + if (alias == null) { throw new IllegalArgumentException("Specified class does not exist ('" + alias + ")'"); } else { @@ -165,71 +165,73 @@ public class ConfigurationSerialization { } else { throw new IllegalArgumentException("Args doesn't contain type key ('" + SERIALIZED_TYPE_KEY + "')"); } - + return new ConfigurationSerialization(clazz).deserialize(args); } - + /** * Registers the given {@link ConfigurationSerializable} class by its alias - * + * * @param clazz Class to register */ public static void registerClass(Class<? extends ConfigurationSerializable> clazz) { DelegateDeserialization delegate = clazz.getAnnotation(DelegateDeserialization.class); - - if (delegate == null ) { + + if (delegate == null) { registerClass(clazz, getAlias(clazz)); registerClass(clazz, clazz.getName()); } } - + /** * Registers the given alias to the specified {@link ConfigurationSerializable} class - * + * * @param clazz Class to register * @param alias Alias to register as */ public static void registerClass(Class<? extends ConfigurationSerializable> clazz, String alias) { aliases.put(alias, clazz); } - + /** * Unregisters the specified alias to a {@link ConfigurationSerializable} - * + * * @param alias Alias to unregister */ public static void unregisterClass(String alias) { aliases.remove(alias); } - + /** * Unregisters any aliases for the specified {@link ConfigurationSerializable} class - * + * * @param clazz Class to unregister */ public static void unregisterClass(Class<? extends ConfigurationSerializable> clazz) { - while (aliases.values().remove(clazz)); + while (aliases.values().remove(clazz)) { + ; + } } - + /** * Attempts to get a registered {@link ConfigurationSerializable} class by its alias - * + * * @param alias Alias of the serializable * @return Registered class, or null if not found */ public static Class<? extends ConfigurationSerializable> getClassByAlias(String alias) { return aliases.get(alias); } - + /** * Gets the correct alias for the given {@link ConfigurationSerializable} class - * + * * @param clazz Class to get alias for * @return Alias to use for the class */ public static String getAlias(Class<? extends ConfigurationSerializable> clazz) { DelegateDeserialization delegate = clazz.getAnnotation(DelegateDeserialization.class); - + if (delegate != null) { if ((delegate.value() == null) || (delegate.value() == clazz)) { delegate = null; @@ -237,7 +239,7 @@ public class ConfigurationSerialization { return getAlias(delegate.value()); } } - + if (delegate == null) { SerializableAs alias = clazz.getAnnotation(SerializableAs.class); @@ -245,7 +247,7 @@ public class ConfigurationSerialization { return alias.value(); } } - + return clazz.getName(); } }
\ No newline at end of file diff --git a/src/main/java/org/bukkit/configuration/serialization/DelegateDeserialization.java b/src/main/java/org/bukkit/configuration/serialization/DelegateDeserialization.java index 9e38f1a0..81a8852a 100644 --- a/src/main/java/org/bukkit/configuration/serialization/DelegateDeserialization.java +++ b/src/main/java/org/bukkit/configuration/serialization/DelegateDeserialization.java @@ -14,7 +14,7 @@ import java.lang.annotation.Target; public @interface DelegateDeserialization { /** * Which class should be used as a delegate for this classes deserialization - * + * * @return Delegate class */ public Class<? extends ConfigurationSerializable> value(); diff --git a/src/main/java/org/bukkit/configuration/serialization/SerializableAs.java b/src/main/java/org/bukkit/configuration/serialization/SerializableAs.java index adfc0aac..361c6092 100644 --- a/src/main/java/org/bukkit/configuration/serialization/SerializableAs.java +++ b/src/main/java/org/bukkit/configuration/serialization/SerializableAs.java @@ -21,7 +21,7 @@ public @interface SerializableAs { * <p> * This name MUST be unique. We recommend using names such as "MyPluginThing" instead of * "Thing". - * + * * @return Name to serialize the class as. */ public String value(); diff --git a/src/main/java/org/bukkit/entity/Animals.java b/src/main/java/org/bukkit/entity/Animals.java index f23db9bc..960c441f 100644 --- a/src/main/java/org/bukkit/entity/Animals.java +++ b/src/main/java/org/bukkit/entity/Animals.java @@ -7,7 +7,7 @@ package org.bukkit.entity; public interface Animals extends Creature { /** * Gets the age of this animal. - * + * * @return Age */ public int getAge(); diff --git a/src/main/java/org/bukkit/entity/Blaze.java b/src/main/java/org/bukkit/entity/Blaze.java index 0033acd0..7a5505b7 100644 --- a/src/main/java/org/bukkit/entity/Blaze.java +++ b/src/main/java/org/bukkit/entity/Blaze.java @@ -4,5 +4,5 @@ package org.bukkit.entity; * Represents a Blaze monster */ public interface Blaze extends Monster { - + } diff --git a/src/main/java/org/bukkit/entity/Boat.java b/src/main/java/org/bukkit/entity/Boat.java index bbd772fe..c4f98400 100644 --- a/src/main/java/org/bukkit/entity/Boat.java +++ b/src/main/java/org/bukkit/entity/Boat.java @@ -18,11 +18,11 @@ public interface Boat extends Vehicle { * @param speed The max speed. */ public void setMaxSpeed(double speed); - + /** * Gets the deceleration rate (newSpeed = curSpeed * rate) of occupied * boats. The default is 0.2. - * + * * @return */ public double getOccupiedDeceleration(); @@ -31,7 +31,7 @@ public interface Boat extends Vehicle { * Sets the deceleration rate (newSpeed = curSpeed * rate) of occupied * boats. Setting this to a higher value allows for quicker acceleration. * The default is 0.2. - * + * * @param speed deceleration rate */ public void setOccupiedDeceleration(double rate); @@ -40,7 +40,7 @@ public interface Boat extends Vehicle { * Gets the deceleration rate (newSpeed = curSpeed * rate) of unoccupied * boats. The default is -1. Values below 0 indicate that no additional * deceleration is imposed. - * + * * @return */ public double getUnoccupiedDeceleration(); @@ -50,21 +50,21 @@ public interface Boat extends Vehicle { * boats. Setting this to a higher value allows for quicker deceleration * of boats when a player disembarks. The default is -1. Values below 0 * indicate that no additional deceleration is imposed. - * + * * @param rate deceleration rate */ public void setUnoccupiedDeceleration(double rate); /** * Get whether boats can work on land. - * + * * @return whether boats can work on land */ public boolean getWorkOnLand(); /** * Set whether boats can work on land. - * + * * @param workOnLand whether boats can work on land */ public void setWorkOnLand(boolean workOnLand); diff --git a/src/main/java/org/bukkit/entity/ComplexEntityPart.java b/src/main/java/org/bukkit/entity/ComplexEntityPart.java index ced09c4b..5db43e0a 100644 --- a/src/main/java/org/bukkit/entity/ComplexEntityPart.java +++ b/src/main/java/org/bukkit/entity/ComplexEntityPart.java @@ -6,7 +6,7 @@ package org.bukkit.entity; public interface ComplexEntityPart extends Entity { /** * Gets the parent {@link ComplexLivingEntity} of this part. - * + * * @return Parent complex entity */ public ComplexLivingEntity getParent(); diff --git a/src/main/java/org/bukkit/entity/ComplexLivingEntity.java b/src/main/java/org/bukkit/entity/ComplexLivingEntity.java index 6de2c561..2670d17b 100644 --- a/src/main/java/org/bukkit/entity/ComplexLivingEntity.java +++ b/src/main/java/org/bukkit/entity/ComplexLivingEntity.java @@ -8,7 +8,7 @@ import java.util.Set; public interface ComplexLivingEntity extends LivingEntity { /** * Gets a list of parts that belong to this complex entity - * + * * @return List of parts */ public Set<ComplexEntityPart> getParts(); diff --git a/src/main/java/org/bukkit/entity/CreatureType.java b/src/main/java/org/bukkit/entity/CreatureType.java index 40c037da..2f1ab5a5 100644 --- a/src/main/java/org/bukkit/entity/CreatureType.java +++ b/src/main/java/org/bukkit/entity/CreatureType.java @@ -50,7 +50,7 @@ public enum CreatureType { public String getName() { return name; } - + public Class<? extends Entity> getEntityClass() { return clazz; } diff --git a/src/main/java/org/bukkit/entity/EnderDragon.java b/src/main/java/org/bukkit/entity/EnderDragon.java index 18e8bca6..609f3ba5 100644 --- a/src/main/java/org/bukkit/entity/EnderDragon.java +++ b/src/main/java/org/bukkit/entity/EnderDragon.java @@ -4,5 +4,5 @@ package org.bukkit.entity; * Represents an Ender Dragon */ public interface EnderDragon extends ComplexLivingEntity { - + } diff --git a/src/main/java/org/bukkit/entity/EnderPearl.java b/src/main/java/org/bukkit/entity/EnderPearl.java index 77c81ec1..51e4f907 100644 --- a/src/main/java/org/bukkit/entity/EnderPearl.java +++ b/src/main/java/org/bukkit/entity/EnderPearl.java @@ -4,5 +4,5 @@ package org.bukkit.entity; * Represents an Ender Pearl entity */ public interface EnderPearl extends Projectile { - + } diff --git a/src/main/java/org/bukkit/entity/EnderSignal.java b/src/main/java/org/bukkit/entity/EnderSignal.java index 94a2f947..49a21ad3 100644 --- a/src/main/java/org/bukkit/entity/EnderSignal.java +++ b/src/main/java/org/bukkit/entity/EnderSignal.java @@ -4,5 +4,5 @@ package org.bukkit.entity; * Represents an Ender Signal, which is often created upon throwing an ender eye */ public interface EnderSignal extends Entity { - + } diff --git a/src/main/java/org/bukkit/entity/Entity.java b/src/main/java/org/bukkit/entity/Entity.java index eca0a8a2..b47a7ddb 100644 --- a/src/main/java/org/bukkit/entity/Entity.java +++ b/src/main/java/org/bukkit/entity/Entity.java @@ -122,6 +122,7 @@ public interface Entity { /** * Returns true if this entity has been marked for removal. + * * @return True if it is dead. */ public boolean isDead(); @@ -165,49 +166,53 @@ public interface Entity { /** * Returns the distance this entity has fallen + * * @return The distance. */ public float getFallDistance(); /** * Sets the fall distance for this entity + * * @param distance The new distance. */ public void setFallDistance(float distance); /** * Record the last {@link EntityDamageEvent} inflicted on this entity + * * @param event a {@link EntityDamageEvent} */ public void setLastDamageCause(EntityDamageEvent event); /** * Retrieve the last {@link EntityDamageEvent} inflicted on this entity. This event may have been cancelled. + * * @return the last known {@link EntityDamageEvent} or null if hitherto unharmed */ public EntityDamageEvent getLastDamageCause(); /** * Returns a unique and persistent id for this entity + * * @return unique id */ public UUID getUniqueId(); - + /** * Gets the amount of ticks this entity has lived for. * <p> * This is the equivalent to "age" in entities. - * + * * @return Age of entity */ public int getTicksLived(); - + /** * Sets the amount of ticks this entity has lived for. * <p> - * This is the equivalent to "age" in entities. May not be - * less than one tick. - * + * This is the equivalent to "age" in entities. May not be less than one tick. + * * @param value Age of entity */ public void setTicksLived(int value); diff --git a/src/main/java/org/bukkit/entity/ExperienceOrb.java b/src/main/java/org/bukkit/entity/ExperienceOrb.java index 4093e998..40783b89 100644 --- a/src/main/java/org/bukkit/entity/ExperienceOrb.java +++ b/src/main/java/org/bukkit/entity/ExperienceOrb.java @@ -10,10 +10,10 @@ public interface ExperienceOrb extends Entity { * @return Amount of experience */ public int getExperience(); - + /** * Sets how much experience is contained within this orb - * + * * @param value Amount of experience */ public void setExperience(int value); diff --git a/src/main/java/org/bukkit/entity/Explosive.java b/src/main/java/org/bukkit/entity/Explosive.java index 0a737855..bc68190c 100644 --- a/src/main/java/org/bukkit/entity/Explosive.java +++ b/src/main/java/org/bukkit/entity/Explosive.java @@ -6,24 +6,28 @@ package org.bukkit.entity; public interface Explosive extends Entity { /** * Set the radius affected by this explosive's explosion + * * @param yield The explosive yield */ public void setYield(float yield); /** * Return the radius or yield of this explosive's explosion + * * @return the radius of blocks affected */ public float getYield(); /** * Set whether or not this explosive's explosion causes fire + * * @param isIncendiary Whether it should cause fire */ public void setIsIncendiary(boolean isIncendiary); /** * Return whether or not this explosive creates a fire when exploding + * * @return true if the explosive creates fire, false otherwise */ public boolean isIncendiary(); diff --git a/src/main/java/org/bukkit/entity/HumanEntity.java b/src/main/java/org/bukkit/entity/HumanEntity.java index 09bcf8ff..654a7475 100644 --- a/src/main/java/org/bukkit/entity/HumanEntity.java +++ b/src/main/java/org/bukkit/entity/HumanEntity.java @@ -40,14 +40,6 @@ public interface HumanEntity extends LivingEntity, AnimalTamer, Permissible { public void setItemInHand(ItemStack item); /** - * Changes the item in hand to another of your 'action slots'. - * - * @param index The new index to use, only valid ones are 0-8. - * - public void selectItemInHand(int index); - */ - - /** * Returns whether this player is slumbering. * * @return slumber state diff --git a/src/main/java/org/bukkit/entity/LivingEntity.java b/src/main/java/org/bukkit/entity/LivingEntity.java index 94504bcf..c57b84d1 100644 --- a/src/main/java/org/bukkit/entity/LivingEntity.java +++ b/src/main/java/org/bukkit/entity/LivingEntity.java @@ -25,10 +25,10 @@ public interface LivingEntity extends Entity { * @throws IllegalArgumentException Thrown if the health is < 0 or > max */ public void setHealth(int health); - + /** * Gets the maximum health this entity may have - * + * * @return Maximum health */ public int getMaxHealth(); @@ -86,12 +86,14 @@ public interface LivingEntity extends Entity { /** * Throws an egg from the entity. + * * @return The egg thrown. */ public Egg throwEgg(); /** * Throws a snowball from the entity. + * * @return The snowball thrown. */ public Snowball throwSnowball(); diff --git a/src/main/java/org/bukkit/entity/Minecart.java b/src/main/java/org/bukkit/entity/Minecart.java index 4a748a92..554c3fdb 100644 --- a/src/main/java/org/bukkit/entity/Minecart.java +++ b/src/main/java/org/bukkit/entity/Minecart.java @@ -23,7 +23,7 @@ public interface Minecart extends Vehicle { /** * Gets the maximum speed of a minecart. The speed is unrelated to the velocity. - * + * * @return The max speed */ public double getMaxSpeed(); @@ -69,6 +69,7 @@ public interface Minecart extends Vehicle { * Gets the derailed velocity modifier. Used for minecarts that are on the ground, but not on rails. * * A derailed minecart's velocity is multiplied by this factor each tick. + * * @return derailed visible speed */ public Vector getDerailedVelocityMod(); diff --git a/src/main/java/org/bukkit/entity/MushroomCow.java b/src/main/java/org/bukkit/entity/MushroomCow.java index 56439497..84154de1 100644 --- a/src/main/java/org/bukkit/entity/MushroomCow.java +++ b/src/main/java/org/bukkit/entity/MushroomCow.java @@ -4,5 +4,5 @@ package org.bukkit.entity; * Represents a mushroom {@link Cow} */ public interface MushroomCow extends Cow { - + } diff --git a/src/main/java/org/bukkit/entity/NPC.java b/src/main/java/org/bukkit/entity/NPC.java index 2c651a5b..0c6b175b 100644 --- a/src/main/java/org/bukkit/entity/NPC.java +++ b/src/main/java/org/bukkit/entity/NPC.java @@ -4,5 +4,5 @@ package org.bukkit.entity; * Represents a non-player character */ public interface NPC extends Creature { - + } diff --git a/src/main/java/org/bukkit/entity/Painting.java b/src/main/java/org/bukkit/entity/Painting.java index 94e0e36e..a6473ea6 100644 --- a/src/main/java/org/bukkit/entity/Painting.java +++ b/src/main/java/org/bukkit/entity/Painting.java @@ -10,12 +10,14 @@ import org.bukkit.material.Attachable; public interface Painting extends Entity, Attachable { /** * Get the art on this painting + * * @return The art */ public Art getArt(); /** * Set the art on this painting + * * @param art The new art * @return False if the new art won't fit at the painting's current location */ @@ -23,10 +25,11 @@ public interface Painting extends Entity, Attachable { /** * Set the art on this painting + * * @param art The new art * @param force If true, force the new art regardless of whether it fits at the current location - * Note that forcing it where it can't fit normally causes it to drop as an item unless you override - * this by catching the PAINTING_BREAK event. + * Note that forcing it where it can't fit normally causes it to drop as an item unless you override + * this by catching the PAINTING_BREAK event. * @return False if force was false and the new art won't fit at the painting's current location */ public boolean setArt(Art art, boolean force); @@ -34,6 +37,7 @@ public interface Painting extends Entity, Attachable { /** * Sets the direction of the painting, potentially overriding rules of placement. Note that if the result * is not valid the painting would normally drop as an item. + * * @param face The new direction. * @param force Whether to force it. * @return False if force was false and there was no block for it to attach to in order to face the given direction. diff --git a/src/main/java/org/bukkit/entity/Pig.java b/src/main/java/org/bukkit/entity/Pig.java index fe1b0f4c..28f59f2c 100644 --- a/src/main/java/org/bukkit/entity/Pig.java +++ b/src/main/java/org/bukkit/entity/Pig.java @@ -6,7 +6,7 @@ package org.bukkit.entity; public interface Pig extends Animals, Vehicle { /** - * Check if the pig has a saddle. + * Check if the pig has a saddle. * * @return if the pig has been saddled. */ diff --git a/src/main/java/org/bukkit/entity/Player.java b/src/main/java/org/bukkit/entity/Player.java index 71a6e980..8fbb9509 100644 --- a/src/main/java/org/bukkit/entity/Player.java +++ b/src/main/java/org/bukkit/entity/Player.java @@ -37,7 +37,7 @@ public interface Player extends HumanEntity, CommandSender, OfflinePlayer { * @param name The new display name. */ public void setDisplayName(String name); - + /** * Gets the name that is shown on the player list. * @@ -82,6 +82,7 @@ public interface Player extends HumanEntity, CommandSender, OfflinePlayer { /** * Gets the socket address of this player + * * @return the player's address */ public InetSocketAddress getAddress(); @@ -117,12 +118,14 @@ public interface Player extends HumanEntity, CommandSender, OfflinePlayer { /** * Returns if the player is in sneak mode + * * @return true if player is in sneak mode */ public boolean isSneaking(); /** * Sets the sneak mode the player + * * @param sneak true if player should appear sneaking */ public void setSneaking(boolean sneak); @@ -214,7 +217,7 @@ public interface Player extends HumanEntity, CommandSender, OfflinePlayer { /** * Send a chunk change. This fakes a chunk change packet for a user at * a certain location. The updated cuboid must be entirely within a single - * chunk. This will not actually change the world in any way. + * chunk. This will not actually change the world in any way. * * At least one of the dimensions of the cuboid must be even. The size of the * data buffer must be 2.5*sx*sy*sz and formatted in accordance with the Packet51 diff --git a/src/main/java/org/bukkit/entity/SmallFireball.java b/src/main/java/org/bukkit/entity/SmallFireball.java index 870b8a26..33f54d3e 100644 --- a/src/main/java/org/bukkit/entity/SmallFireball.java +++ b/src/main/java/org/bukkit/entity/SmallFireball.java @@ -4,5 +4,5 @@ package org.bukkit.entity; * Represents a small {@link Fireball} */ public interface SmallFireball extends Fireball { - + } diff --git a/src/main/java/org/bukkit/entity/Snowman.java b/src/main/java/org/bukkit/entity/Snowman.java index 84c31e9e..49005ed2 100644 --- a/src/main/java/org/bukkit/entity/Snowman.java +++ b/src/main/java/org/bukkit/entity/Snowman.java @@ -4,5 +4,5 @@ package org.bukkit.entity; * Represents a snowman entity */ public interface Snowman extends Creature { - + } diff --git a/src/main/java/org/bukkit/entity/TNTPrimed.java b/src/main/java/org/bukkit/entity/TNTPrimed.java index e463e453..bf4ea515 100644 --- a/src/main/java/org/bukkit/entity/TNTPrimed.java +++ b/src/main/java/org/bukkit/entity/TNTPrimed.java @@ -6,12 +6,14 @@ package org.bukkit.entity; public interface TNTPrimed extends Explosive { /** * Set the number of ticks until the TNT blows up after being primed. + * * @param fuseTicks The fuse ticks */ public void setFuseTicks(int fuseTicks); /** * Retrieve the number of ticks until the explosion of this TNTPrimed entity + * * @return the number of ticks until this TNTPrimed explodes */ public int getFuseTicks(); diff --git a/src/main/java/org/bukkit/entity/ThrownPotion.java b/src/main/java/org/bukkit/entity/ThrownPotion.java index 1daffced..789ade54 100644 --- a/src/main/java/org/bukkit/entity/ThrownPotion.java +++ b/src/main/java/org/bukkit/entity/ThrownPotion.java @@ -4,5 +4,5 @@ package org.bukkit.entity; * Represents a thrown potion bottle */ public interface ThrownPotion extends Projectile { - + } diff --git a/src/main/java/org/bukkit/entity/Villager.java b/src/main/java/org/bukkit/entity/Villager.java index 6d8dc763..1fa8392f 100644 --- a/src/main/java/org/bukkit/entity/Villager.java +++ b/src/main/java/org/bukkit/entity/Villager.java @@ -4,5 +4,5 @@ package org.bukkit.entity; * Represents a villager NPC */ public interface Villager extends NPC { - + } diff --git a/src/main/java/org/bukkit/event/Event.java b/src/main/java/org/bukkit/event/Event.java index 7f4c51c8..095c19c6 100644 --- a/src/main/java/org/bukkit/event/Event.java +++ b/src/main/java/org/bukkit/event/Event.java @@ -7,6 +7,7 @@ import org.bukkit.entity.Projectile; /** * Represents an event */ +@SuppressWarnings("serial") public abstract class Event implements Serializable { private final Type type; private final String name; @@ -146,128 +147,128 @@ public abstract class Event implements Serializable { * * @see org.bukkit.event.player.PlayerJoinEvent */ - PLAYER_JOIN (Category.PLAYER), + PLAYER_JOIN(Category.PLAYER), /** * Called when a player is attempting to connect to the server * * @see org.bukkit.event.player.PlayerLoginEvent */ - PLAYER_LOGIN (Category.PLAYER), + PLAYER_LOGIN(Category.PLAYER), /** * Called when a player has just been authenticated * * @see org.bukkit.event.player.PlayerPreLoginEvent */ - PLAYER_PRELOGIN (Category.PLAYER), + PLAYER_PRELOGIN(Category.PLAYER), /** * Called when a player respawns * * @see org.bukkit.event.player.PlayerRespawnEvent */ - PLAYER_RESPAWN (Category.PLAYER), + PLAYER_RESPAWN(Category.PLAYER), /** * Called when a player gets kicked from the server * * @see org.bukkit.event.player.PlayerKickEvent */ - PLAYER_KICK (Category.PLAYER), + PLAYER_KICK(Category.PLAYER), /** * Called when a player sends a chat message * * @see org.bukkit.event.player.PlayerChatEvent */ - PLAYER_CHAT (Category.PLAYER), + PLAYER_CHAT(Category.PLAYER), /** * Called when a player uses a command (early in the command handling process) * * @see org.bukkit.event.player.PlayerCommandPreprocessEvent */ - PLAYER_COMMAND_PREPROCESS (Category.PLAYER), + PLAYER_COMMAND_PREPROCESS(Category.PLAYER), /** * Called when a player leaves the server * * @see org.bukkit.event.player.PlayerQuitEvent */ - PLAYER_QUIT (Category.PLAYER), + PLAYER_QUIT(Category.PLAYER), /** * Called when a player moves position in the world * * @see org.bukkit.event.player.PlayerMoveEvent */ - PLAYER_MOVE (Category.PLAYER), + PLAYER_MOVE(Category.PLAYER), /** * Called before a player gets a velocity vector sent, which will instruct him to * get "pushed" into a specific direction, e.g. after an explosion * * @see org.bukkit.event.player.PlayerVelocityEvent */ - PLAYER_VELOCITY (Category.PLAYER), + PLAYER_VELOCITY(Category.PLAYER), /** * Called when a player undergoes an animation (Arm Swing is the only animation currently supported) * * @see org.bukkit.event.player.PlayerAnimationEvent */ - PLAYER_ANIMATION (Category.PLAYER), + PLAYER_ANIMATION(Category.PLAYER), /** * Called when a player toggles sneak mode * * @see org.bukkit.event.player.PlayerToggleSneakEvent */ - PLAYER_TOGGLE_SNEAK (Category.PLAYER), + PLAYER_TOGGLE_SNEAK(Category.PLAYER), /** * Called when a player toggles sprint mode * * @see org.bukkit.event.player.PlayerToggleSprintEvent */ - PLAYER_TOGGLE_SPRINT (Category.PLAYER), + PLAYER_TOGGLE_SPRINT(Category.PLAYER), /** * Called when a player interacts with an object or air * * @see org.bukkit.event.player.PlayerInteractEvent */ - PLAYER_INTERACT (Category.PLAYER), + PLAYER_INTERACT(Category.PLAYER), /** * Called when a player right clicks an entity * * @see org.bukkit.event.player.PlayerInteractEntityEvent */ - PLAYER_INTERACT_ENTITY (Category.PLAYER), + PLAYER_INTERACT_ENTITY(Category.PLAYER), /** * Called when a player throws an egg * * @see org.bukkit.event.player.PlayerEggThrowEvent */ - PLAYER_EGG_THROW (Category.PLAYER), + PLAYER_EGG_THROW(Category.PLAYER), /** * Called when a player teleports from one position to another * * @see org.bukkit.event.player.PlayerTeleportEvent */ - PLAYER_TELEPORT (Category.PLAYER), + PLAYER_TELEPORT(Category.PLAYER), /** * Called when a player completes the portaling process by standing in a portal * * @see org.bukkit.event.player.PlayerPortalEvent */ - PLAYER_PORTAL (Category.PLAYER), + PLAYER_PORTAL(Category.PLAYER), /** * Called when a player changes their held item * * @see org.bukkit.event.player.PlayerItemHeldEvent */ - PLAYER_ITEM_HELD (Category.PLAYER), + PLAYER_ITEM_HELD(Category.PLAYER), /** * Called when a player drops an item * * @see org.bukkit.event.player.PlayerDropItemEvent */ - PLAYER_DROP_ITEM (Category.PLAYER), + PLAYER_DROP_ITEM(Category.PLAYER), /** * Called when a player picks an item up off the ground * * @see org.bukkit.event.player.PlayerPickupItemEvent */ - PLAYER_PICKUP_ITEM (Category.PLAYER), + PLAYER_PICKUP_ITEM(Category.PLAYER), /** * Called when a player empties a bucket * @@ -328,7 +329,7 @@ public abstract class Event implements Serializable { * * @see org.bukkit.event.block.BlockDamageEvent */ - BLOCK_DAMAGE (Category.BLOCK), + BLOCK_DAMAGE(Category.BLOCK), /** * Called when a block is undergoing a universe physics * check on whether it can be built @@ -337,21 +338,21 @@ public abstract class Event implements Serializable { * * @see org.bukkit.event.block.BlockCanBuildEvent */ - BLOCK_CANBUILD (Category.BLOCK), + BLOCK_CANBUILD(Category.BLOCK), /** * Called when a block of water or lava attempts to flow into another * block * * @see org.bukkit.event.block.BlockFromToEvent */ - BLOCK_FROMTO (Category.BLOCK), + BLOCK_FROMTO(Category.BLOCK), /** * Called when a block is being set on fire from another block, such as * an adjacent block of fire attempting to set fire to wood * * @see org.bukkit.event.block.BlockIgniteEvent */ - BLOCK_IGNITE (Category.BLOCK), + BLOCK_IGNITE(Category.BLOCK), /** * Called when a block undergoes a physics check * @@ -360,37 +361,37 @@ public abstract class Event implements Serializable { * * @see org.bukkit.event.block.BlockPhysicsEvent */ - BLOCK_PHYSICS (Category.BLOCK), + BLOCK_PHYSICS(Category.BLOCK), /** * Called when a player is attempting to place a block * * @see org.bukkit.event.block.BlockPlaceEvent */ - BLOCK_PLACE (Category.BLOCK), + BLOCK_PLACE(Category.BLOCK), /** * Called when a block dispenses something * * @see org.bukkit.event.block.BlockDispenseEvent */ - BLOCK_DISPENSE (Category.BLOCK), + BLOCK_DISPENSE(Category.BLOCK), /** * Called when a block is destroyed from being burnt by fire * * @see org.bukkit.event.block.BlockBurnEvent */ - BLOCK_BURN (Category.BLOCK), + BLOCK_BURN(Category.BLOCK), /** * Called when leaves are decaying naturally * * @see org.bukkit.event.block.LeavesDecayEvent */ - LEAVES_DECAY (Category.BLOCK), + LEAVES_DECAY(Category.BLOCK), /** * Called when a sign is changed * * @see org.bukkit.event.block.SignChangeEvent */ - SIGN_CHANGE (Category.BLOCK), + SIGN_CHANGE(Category.BLOCK), /** * Called when a block changes redstone current. Only triggered on blocks * that are actually capable of transmitting or carrying a redstone @@ -398,43 +399,43 @@ public abstract class Event implements Serializable { * * @see org.bukkit.event.block.BlockRedstoneEvent */ - REDSTONE_CHANGE (Category.BLOCK), + REDSTONE_CHANGE(Category.BLOCK), /** * Called when a block is broken by a player * * @see org.bukkit.event.block.BlockBreakEvent */ - BLOCK_BREAK (Category.BLOCK), + BLOCK_BREAK(Category.BLOCK), /** * Called when a block is formed based on world conditions * * @see org.bukkit.event.block.BlockFormEvent */ - BLOCK_FORM (Category.BLOCK), + BLOCK_FORM(Category.BLOCK), /** * Called when a block spreads based on world conditions * * @see org.bukkit.event.block.BlockSpreadEvent */ - BLOCK_SPREAD (Category.BLOCK), + BLOCK_SPREAD(Category.BLOCK), /** * Called when a block fades, melts or disappears based on world conditions * * @see org.bukkit.event.block.BlockFadeEvent */ - BLOCK_FADE (Category.BLOCK), + BLOCK_FADE(Category.BLOCK), /** * Called when a piston extends * * @see org.bukkit.event.block.BlockPistonExtendEvent */ - BLOCK_PISTON_EXTEND (Category.BLOCK), + BLOCK_PISTON_EXTEND(Category.BLOCK), /** * Called when a piston retracts * * @see org.bukkit.event.block.BlockPistonRetractEvent */ - BLOCK_PISTON_RETRACT (Category.BLOCK), + BLOCK_PISTON_RETRACT(Category.BLOCK), /** * INVENTORY EVENTS @@ -445,43 +446,43 @@ public abstract class Event implements Serializable { * * @todo: add javadoc see comment */ - INVENTORY_OPEN (Category.INVENTORY), + INVENTORY_OPEN(Category.INVENTORY), /** * Called when a player closes an inventory * * @todo: add javadoc see comment */ - INVENTORY_CLOSE (Category.INVENTORY), + INVENTORY_CLOSE(Category.INVENTORY), /** * Called when a player clicks on an inventory slot * * @todo: add javadoc see comment */ - INVENTORY_CLICK (Category.INVENTORY), + INVENTORY_CLICK(Category.INVENTORY), /** * Called when an inventory slot changes values or type * * @todo: add javadoc see comment */ - INVENTORY_CHANGE (Category.INVENTORY), + INVENTORY_CHANGE(Category.INVENTORY), /** * Called when a player is attempting to perform an inventory transaction * * @todo: add javadoc see comment */ - INVENTORY_TRANSACTION (Category.INVENTORY), + INVENTORY_TRANSACTION(Category.INVENTORY), /** * Called when an ItemStack is successfully smelted in a furnace. * * @see org.bukkit.event.inventory.FurnaceSmeltEvent */ - FURNACE_SMELT (Category.INVENTORY), + FURNACE_SMELT(Category.INVENTORY), /** * Called when an ItemStack is successfully burned as fuel in a furnace. * * @see org.bukkit.event.inventory.FurnaceBurnEvent */ - FURNACE_BURN (Category.INVENTORY), + FURNACE_BURN(Category.INVENTORY), /** * SERVER EVENTS @@ -492,19 +493,19 @@ public abstract class Event implements Serializable { * * @see org.bukkit.event.server.PluginEnableEvent */ - PLUGIN_ENABLE (Category.SERVER), + PLUGIN_ENABLE(Category.SERVER), /** * Called when a plugin is disabled * * @see org.bukkit.event.server.PluginDisableEvent */ - PLUGIN_DISABLE (Category.SERVER), + PLUGIN_DISABLE(Category.SERVER), /** * Called when a server command is called * * @see org.bukkit.event.server.ServerCommandEvent */ - SERVER_COMMAND (Category.SERVER), + SERVER_COMMAND(Category.SERVER), /** * Called when a remote server command is called * @@ -516,13 +517,13 @@ public abstract class Event implements Serializable { * * @see org.bukkit.event.server.MapInitializeEvent */ - MAP_INITIALIZE (Category.SERVER), + MAP_INITIALIZE(Category.SERVER), /** * Called when a client pings a server. * * @see org.bukkit.event.server.ServerListPingEvent */ - SERVER_LIST_PING (Category.SERVER), + SERVER_LIST_PING(Category.SERVER), /** * WORLD EVENTS @@ -536,13 +537,13 @@ public abstract class Event implements Serializable { * * @see org.bukkit.event.world.ChunkLoadEvent */ - CHUNK_LOAD (Category.WORLD), + CHUNK_LOAD(Category.WORLD), /** * Called when a chunk is unloaded * * @see org.bukkit.event.world.ChunkUnloadEvent */ - CHUNK_UNLOAD (Category.WORLD), + CHUNK_UNLOAD(Category.WORLD), /** * Called when a newly created chunk has been populated. * @@ -550,55 +551,55 @@ public abstract class Event implements Serializable { * * @see org.bukkit.event.world.ChunkPopulateEvent */ - CHUNK_POPULATED (Category.WORLD), + CHUNK_POPULATED(Category.WORLD), /** * Called when an ItemEntity spawns in the world * * @see org.bukkit.event.entity.ItemSpawnEvent */ - ITEM_SPAWN (Category.WORLD), + ITEM_SPAWN(Category.WORLD), /** * Called when a World's spawn is changed * * @see org.bukkit.event.world.SpawnChangeEvent */ - SPAWN_CHANGE (Category.WORLD), + SPAWN_CHANGE(Category.WORLD), /** * Called when a world is saved * * @see org.bukkit.event.world.WorldSaveEvent */ - WORLD_SAVE (Category.WORLD), + WORLD_SAVE(Category.WORLD), /** * Called when a World is initializing * * @see org.bukkit.event.world.WorldInitEvent */ - WORLD_INIT (Category.WORLD), + WORLD_INIT(Category.WORLD), /** * Called when a World is loaded * * @see org.bukkit.event.world.WorldLoadEvent */ - WORLD_LOAD (Category.WORLD), + WORLD_LOAD(Category.WORLD), /** * Called when a World is unloaded * * @see org.bukkit.event.world.WorldUnloadEvent */ - WORLD_UNLOAD (Category.WORLD), + WORLD_UNLOAD(Category.WORLD), /** * Called when world attempts to create a matching end to a portal * * @see org.bukkit.event.world.PortalCreateEvent */ - PORTAL_CREATE (Category.WORLD), + PORTAL_CREATE(Category.WORLD), /** * Called when an organic structure attempts to grow (Sapling -> Tree), (Mushroom -> Huge Mushroom), naturally or using bonemeal. * -+ * @see org.bukkit.event.world.TreeGrowEvent + * @see org.bukkit.event.world.TreeGrowEvent */ - STRUCTURE_GROW (Category.WORLD), + STRUCTURE_GROW(Category.WORLD), /** * ENTITY EVENTS @@ -609,19 +610,19 @@ public abstract class Event implements Serializable { * * @see org.bukkit.event.painting.PaintingPlaceEvent */ - PAINTING_PLACE (Category.ENTITY), + PAINTING_PLACE(Category.ENTITY), /** * Called when a painting is removed * * @see org.bukkit.event.painting.PaintingBreakEvent */ - PAINTING_BREAK (Category.ENTITY), + PAINTING_BREAK(Category.ENTITY), /** * Called when an entity touches a portal block * * @see org.bukkit.event.entity.EntityPortalEnterEvent */ - ENTITY_PORTAL_ENTER (Category.ENTITY), + ENTITY_PORTAL_ENTER(Category.ENTITY), /** * LIVING_ENTITY EVENTS @@ -633,31 +634,31 @@ public abstract class Event implements Serializable { * * @see org.bukkit.event.entity.CreatureSpawnEvent */ - CREATURE_SPAWN (Category.LIVING_ENTITY), + CREATURE_SPAWN(Category.LIVING_ENTITY), /** * Called when a LivingEntity is damaged with no source. * * @see org.bukkit.event.entity.EntityDamageEvent */ - ENTITY_DAMAGE (Category.LIVING_ENTITY), + ENTITY_DAMAGE(Category.LIVING_ENTITY), /** * Called when a LivingEntity dies * * @see org.bukkit.event.entity.EntityDeathEvent */ - ENTITY_DEATH (Category.LIVING_ENTITY), + ENTITY_DEATH(Category.LIVING_ENTITY), /** * Called when a Skeleton or Zombie catch fire due to the sun * * @see org.bukkit.event.entity.EntityCombustEvent */ - ENTITY_COMBUST (Category.LIVING_ENTITY), + ENTITY_COMBUST(Category.LIVING_ENTITY), /** * Called when an entity explodes, either TNT, Creeper, or Ghast Fireball * * @see org.bukkit.event.entity.EntityExplodeEvent */ - ENTITY_EXPLODE (Category.LIVING_ENTITY), + ENTITY_EXPLODE(Category.LIVING_ENTITY), /** * Called when an entity has made a decision to explode. * @@ -670,74 +671,74 @@ public abstract class Event implements Serializable { * * @see org.bukkit.event.entity.ExplosionPrimeEvent */ - EXPLOSION_PRIME (Category.LIVING_ENTITY), + EXPLOSION_PRIME(Category.LIVING_ENTITY), /** * Called when an entity targets another entity * * @see org.bukkit.event.entity.EntityTargetEvent */ - ENTITY_TARGET (Category.LIVING_ENTITY), + ENTITY_TARGET(Category.LIVING_ENTITY), /** * Called when an entity interacts with a block * This event specifically excludes player entities * * @see org.bukkit.event.entity.EntityInteractEvent */ - ENTITY_INTERACT (Category.LIVING_ENTITY), + ENTITY_INTERACT(Category.LIVING_ENTITY), /** * Called when a creeper gains or loses a power shell * * @see org.bukkit.event.entity.CreeperPowerEvent */ - CREEPER_POWER (Category.LIVING_ENTITY), + CREEPER_POWER(Category.LIVING_ENTITY), /** * Called when a pig is zapped, zombifying it * * @see org.bukkit.event.entity.PigZapEvent */ - PIG_ZAP (Category.LIVING_ENTITY), + PIG_ZAP(Category.LIVING_ENTITY), /** * Called when a LivingEntity is tamed * * @see org.bukkit.event.entity.EntityTameEvent */ - ENTITY_TAME (Category.LIVING_ENTITY), + ENTITY_TAME(Category.LIVING_ENTITY), /** * Called when a {@link Projectile} hits something * * @see org.bukkit.event.entity.ProjectileHitEvent */ - PROJECTILE_HIT (Category.ENTITY), + PROJECTILE_HIT(Category.ENTITY), /** * Called when a Slime splits into smaller Slimes upon death * * @see org.bukkit.event.entity.SlimeSplitEvent */ - SLIME_SPLIT (Category.LIVING_ENTITY), + SLIME_SPLIT(Category.LIVING_ENTITY), /** * Called when a LivingEntity is regains health * * @see org.bukkit.event.entity.EntityRegainHealthEvent */ - ENTITY_REGAIN_HEALTH (Category.LIVING_ENTITY), + ENTITY_REGAIN_HEALTH(Category.LIVING_ENTITY), /** * Called when an Enderman picks a block up * * @see org.bukkit.event.entity.EndermanPickupEvent */ - ENDERMAN_PICKUP (Category.LIVING_ENTITY), + ENDERMAN_PICKUP(Category.LIVING_ENTITY), /** * Called when an Enderman places a block * * @see org.bukkit.event.entity.EndermanPlaceEvent */ - ENDERMAN_PLACE (Category.LIVING_ENTITY), + ENDERMAN_PLACE(Category.LIVING_ENTITY), /** * Called when a human entity's food level changes * * @see org.bukkit.event.entity.FoodLevelChangeEvent */ - FOOD_LEVEL_CHANGE (Category.LIVING_ENTITY), + FOOD_LEVEL_CHANGE(Category.LIVING_ENTITY), /** * WEATHER EVENTS @@ -748,19 +749,19 @@ public abstract class Event implements Serializable { * * @see org.bukkit.event.weather.LightningStrikeEvent */ - LIGHTNING_STRIKE (Category.WEATHER), + LIGHTNING_STRIKE(Category.WEATHER), /** * Called when the weather in a world changes * * @see org.bukkit.event.weather.WeatherChangeEvent */ - WEATHER_CHANGE (Category.WEATHER), + WEATHER_CHANGE(Category.WEATHER), /** * Called when the thunder state in a world changes * * @see org.bukkit.event.weather.ThunderChangeEvent */ - THUNDER_CHANGE (Category.WEATHER), + THUNDER_CHANGE(Category.WEATHER), /** * VEHICLE EVENTS @@ -771,55 +772,55 @@ public abstract class Event implements Serializable { * * @see org.bukkit.event.vehicle.VehicleCreateEvent */ - VEHICLE_CREATE (Category.VEHICLE), + VEHICLE_CREATE(Category.VEHICLE), /** * Called when a vehicle is destroyed * * @see org.bukkit.event.vehicle.VehicleDestroyEvent */ - VEHICLE_DESTROY (Category.VEHICLE), + VEHICLE_DESTROY(Category.VEHICLE), /** * Called when a vehicle is damaged by a LivingEntity * * @see org.bukkit.event.vehicle.VehicleDamageEvent */ - VEHICLE_DAMAGE (Category.VEHICLE), + VEHICLE_DAMAGE(Category.VEHICLE), /** * Called when a vehicle collides with an Entity * * @see org.bukkit.event.vehicle.VehicleCollisionEvent */ - VEHICLE_COLLISION_ENTITY (Category.VEHICLE), + VEHICLE_COLLISION_ENTITY(Category.VEHICLE), /** * Called when a vehicle collides with a Block * * @see org.bukkit.event.vehicle.VehicleBlockCollisionEvent */ - VEHICLE_COLLISION_BLOCK (Category.VEHICLE), + VEHICLE_COLLISION_BLOCK(Category.VEHICLE), /** * Called when a vehicle is entered by a LivingEntity * * @see org.bukkit.event.vehicle.VehicleEnterEvent */ - VEHICLE_ENTER (Category.VEHICLE), + VEHICLE_ENTER(Category.VEHICLE), /** * Called when a vehicle is exited by a LivingEntity * * @see org.bukkit.event.vehicle.VehicleExitEvent */ - VEHICLE_EXIT (Category.VEHICLE), + VEHICLE_EXIT(Category.VEHICLE), /** * Called when a vehicle moves position in the world * * @see org.bukkit.event.vehicle.VehicleMoveEvent */ - VEHICLE_MOVE (Category.VEHICLE), + VEHICLE_MOVE(Category.VEHICLE), /** * Called when a vehicle is going through an update cycle, rechecking itself * * @see org.bukkit.event.vehicle.VehicleUpdateEvent */ - VEHICLE_UPDATE (Category.VEHICLE), + VEHICLE_UPDATE(Category.VEHICLE), /** * MISCELLANEOUS EVENTS */ @@ -827,7 +828,7 @@ public abstract class Event implements Serializable { /** * Represents a custom event, isn't actually used */ - CUSTOM_EVENT (Category.MISCELLANEOUS); + CUSTOM_EVENT(Category.MISCELLANEOUS); private final Category category; diff --git a/src/main/java/org/bukkit/event/EventException.java b/src/main/java/org/bukkit/event/EventException.java index f9991c88..84638e85 100644 --- a/src/main/java/org/bukkit/event/EventException.java +++ b/src/main/java/org/bukkit/event/EventException.java @@ -22,6 +22,7 @@ public class EventException extends Exception { /** * Constructs a new EventException with the given message + * * @param cause The exception that caused this * @param message The message */ @@ -32,6 +33,7 @@ public class EventException extends Exception { /** * Constructs a new EventException with the given message + * * @param message The message */ public EventException(String message) { diff --git a/src/main/java/org/bukkit/event/block/BlockBreakEvent.java b/src/main/java/org/bukkit/event/block/BlockBreakEvent.java index 5563f403..972b8b63 100644 --- a/src/main/java/org/bukkit/event/block/BlockBreakEvent.java +++ b/src/main/java/org/bukkit/event/block/BlockBreakEvent.java @@ -6,13 +6,14 @@ import org.bukkit.event.Cancellable; /** * Called when a block is broken by a player. - *<p /> + * <p /> * Note: * Plugins wanting to simulate a traditional block drop should set the block to air and utilise their own methods for determining * what the default drop for the block being broken is and what to do about it, if anything. - *<p /> + * <p /> * If a Block Break event is cancelled, the block will not break. */ +@SuppressWarnings("serial") public class BlockBreakEvent extends BlockEvent implements Cancellable { private Player player; diff --git a/src/main/java/org/bukkit/event/block/BlockBurnEvent.java b/src/main/java/org/bukkit/event/block/BlockBurnEvent.java index f0567e11..fc53334c 100644 --- a/src/main/java/org/bukkit/event/block/BlockBurnEvent.java +++ b/src/main/java/org/bukkit/event/block/BlockBurnEvent.java @@ -5,9 +5,10 @@ import org.bukkit.event.Cancellable; /** * Called when a block is destroyed as a result of being burnt by fire. - *<p /> + * <p /> * If a Block Burn event is cancelled, the block will not be destroyed as a result of being burnt by fire. */ +@SuppressWarnings("serial") public class BlockBurnEvent extends BlockEvent implements Cancellable { private boolean cancelled; diff --git a/src/main/java/org/bukkit/event/block/BlockCanBuildEvent.java b/src/main/java/org/bukkit/event/block/BlockCanBuildEvent.java index f1c7eeb8..191bf9f8 100644 --- a/src/main/java/org/bukkit/event/block/BlockCanBuildEvent.java +++ b/src/main/java/org/bukkit/event/block/BlockCanBuildEvent.java @@ -5,13 +5,14 @@ import org.bukkit.Material; /** * Called when we try to place a block, to see if we can build it here or not. - *<p /> + * <p /> * Note: * <ul> - * <li>The Block returned by getBlock() is the block we are trying to place on, not the block we are trying to place.</li> - * <li>If you want to figure out what is being placed, use {@link #getMaterial()} or {@link #getMaterialId()} instead.</li> + * <li>The Block returned by getBlock() is the block we are trying to place on, not the block we are trying to place.</li> + * <li>If you want to figure out what is being placed, use {@link #getMaterial()} or {@link #getMaterialId()} instead.</li> * </ul> */ +@SuppressWarnings("serial") public class BlockCanBuildEvent extends BlockEvent { protected boolean buildable; protected int material; diff --git a/src/main/java/org/bukkit/event/block/BlockDamageEvent.java b/src/main/java/org/bukkit/event/block/BlockDamageEvent.java index e2d8cd80..6100d9ad 100644 --- a/src/main/java/org/bukkit/event/block/BlockDamageEvent.java +++ b/src/main/java/org/bukkit/event/block/BlockDamageEvent.java @@ -10,6 +10,7 @@ import org.bukkit.inventory.ItemStack; * <p /> * If a Block Damage event is cancelled, the block will not be damaged. */ +@SuppressWarnings("serial") public class BlockDamageEvent extends BlockEvent implements Cancellable { private Player player; private boolean instaBreak; diff --git a/src/main/java/org/bukkit/event/block/BlockDispenseEvent.java b/src/main/java/org/bukkit/event/block/BlockDispenseEvent.java index 84ffc7db..b4279efa 100644 --- a/src/main/java/org/bukkit/event/block/BlockDispenseEvent.java +++ b/src/main/java/org/bukkit/event/block/BlockDispenseEvent.java @@ -7,9 +7,10 @@ import org.bukkit.util.Vector; /** * Called when an item is dispensed from a block. - *<p /> + * <p /> * If a Block Dispense event is cancelled, the block will not dispense the item. */ +@SuppressWarnings("serial") public class BlockDispenseEvent extends BlockEvent implements Cancellable { private boolean cancelled = false; @@ -43,7 +44,7 @@ public class BlockDispenseEvent extends BlockEvent implements Cancellable { /** * Gets the velocity. - *<p /> + * <p /> * Note: Modifying the returned Vector will not change the velocity, you must use {@link #setVelocity(org.bukkit.util.Vector)} instead. * * @return A Vector for the dispensed item's velocity diff --git a/src/main/java/org/bukkit/event/block/BlockEvent.java b/src/main/java/org/bukkit/event/block/BlockEvent.java index ab7de90f..2ebb6a28 100644 --- a/src/main/java/org/bukkit/event/block/BlockEvent.java +++ b/src/main/java/org/bukkit/event/block/BlockEvent.java @@ -6,6 +6,7 @@ import org.bukkit.event.Event; /** * Represents a block related event. */ +@SuppressWarnings("serial") public class BlockEvent extends Event { protected Block block; diff --git a/src/main/java/org/bukkit/event/block/BlockFadeEvent.java b/src/main/java/org/bukkit/event/block/BlockFadeEvent.java index 21d97ba0..cfd26e95 100644 --- a/src/main/java/org/bukkit/event/block/BlockFadeEvent.java +++ b/src/main/java/org/bukkit/event/block/BlockFadeEvent.java @@ -3,17 +3,19 @@ package org.bukkit.event.block; import org.bukkit.block.Block; import org.bukkit.block.BlockState; import org.bukkit.event.Cancellable; + /** * Called when a block fades, melts or disappears based on world conditions * <p /> * Examples: * <ul> - * <li>Snow melting due to being near a light source.</li> - * <li>Ice melting due to being near a light source.</li> + * <li>Snow melting due to being near a light source.</li> + * <li>Ice melting due to being near a light source.</li> * </ul> * <p /> * If a Block Fade event is cancelled, the block will not fade, melt or disappear. */ +@SuppressWarnings("serial") public class BlockFadeEvent extends BlockEvent implements Cancellable { private boolean cancelled; private BlockState newState; diff --git a/src/main/java/org/bukkit/event/block/BlockFormEvent.java b/src/main/java/org/bukkit/event/block/BlockFormEvent.java index f2403670..209a5659 100644 --- a/src/main/java/org/bukkit/event/block/BlockFormEvent.java +++ b/src/main/java/org/bukkit/event/block/BlockFormEvent.java @@ -7,16 +7,18 @@ import org.bukkit.event.Cancellable; /** * Called when a block is formed or spreads based on world conditions. * Use {@link BlockSpreadEvent} to catch blocks that actually spread and don't just "randomly" form. - *<p /> + * <p /> * Examples: - *<ul> - * <li>Snow forming due to a snow storm.</li> - * <li>Ice forming in a snowy Biome like Taiga or Tundra.</li> + * <ul> + * <li>Snow forming due to a snow storm.</li> + * <li>Ice forming in a snowy Biome like Taiga or Tundra.</li> * </ul> - *<p /> + * <p /> * If a Block Form event is cancelled, the block will not be formed. + * * @see BlockSpreadEvent */ +@SuppressWarnings("serial") public class BlockFormEvent extends BlockEvent implements Cancellable { private boolean cancelled; private BlockState newState; diff --git a/src/main/java/org/bukkit/event/block/BlockFromToEvent.java b/src/main/java/org/bukkit/event/block/BlockFromToEvent.java index 36710834..0f43c931 100644 --- a/src/main/java/org/bukkit/event/block/BlockFromToEvent.java +++ b/src/main/java/org/bukkit/event/block/BlockFromToEvent.java @@ -6,9 +6,10 @@ import org.bukkit.event.Cancellable; /** * Represents events with a source block and a destination block, currently only applies to liquid (lava and water). - *<p /> + * <p /> * If a Block From To event is cancelled, the block will not move (the liquid will not flow). */ +@SuppressWarnings("serial") public class BlockFromToEvent extends BlockEvent implements Cancellable { protected Block to; protected BlockFace face; diff --git a/src/main/java/org/bukkit/event/block/BlockIgniteEvent.java b/src/main/java/org/bukkit/event/block/BlockIgniteEvent.java index 6bcf2e8a..a98b15f8 100644 --- a/src/main/java/org/bukkit/event/block/BlockIgniteEvent.java +++ b/src/main/java/org/bukkit/event/block/BlockIgniteEvent.java @@ -7,9 +7,10 @@ import org.bukkit.event.Event; /** * Called when a block is ignited. If you want to catch when a Player places fire, you need to use {@link BlockPlaceEvent}. - *<p /> + * <p /> * If a Block Ignite event is cancelled, the block will not be ignited. */ +@SuppressWarnings("serial") public class BlockIgniteEvent extends BlockEvent implements Cancellable { private IgniteCause cause; private boolean cancel; diff --git a/src/main/java/org/bukkit/event/block/BlockListener.java b/src/main/java/org/bukkit/event/block/BlockListener.java index 237ec8f3..383b34e2 100644 --- a/src/main/java/org/bukkit/event/block/BlockListener.java +++ b/src/main/java/org/bukkit/event/block/BlockListener.java @@ -23,11 +23,11 @@ public class BlockListener implements Listener { /** * Called when we try to place a block, to see if we can build it here or not. - *<p /> + * <p /> * Note: * <ul> - * <li>The Block returned by getBlock() is the block we are trying to place on, not the block we are trying to place.</li> - * <li>If you want to figure out what is being placed, use {@link BlockCanBuildEvent#getMaterial()} or {@link BlockCanBuildEvent#getMaterialId()} instead.</li> + * <li>The Block returned by getBlock() is the block we are trying to place on, not the block we are trying to place.</li> + * <li>If you want to figure out what is being placed, use {@link BlockCanBuildEvent#getMaterial()} or {@link BlockCanBuildEvent#getMaterialId()} instead.</li> * </ul> * * @param event Relevant event details @@ -36,7 +36,7 @@ public class BlockListener implements Listener { /** * Represents events with a source block and a destination block, currently only applies to liquid (lava and water). - *<p /> + * <p /> * If a Block From To event is cancelled, the block will not move (the liquid will not flow). * * @param event Relevant event details @@ -45,7 +45,7 @@ public class BlockListener implements Listener { /** * Called when a block is ignited. If you want to catch when a Player places fire, you need to use {@link BlockPlaceEvent}. - *<p /> + * <p /> * If a Block Ignite event is cancelled, the block will not be ignited. * * @param event Relevant event details @@ -61,7 +61,7 @@ public class BlockListener implements Listener { /** * Called when a block is placed by a player. - *<p /> + * <p /> * If a Block Place event is cancelled, the block will not be placed. * * @param event Relevant event details @@ -79,7 +79,7 @@ public class BlockListener implements Listener { /** * Called when leaves are decaying naturally. - *<p /> + * <p /> * If a Leaves Decay event is cancelled, the leaves will not decay. * * @param event Relevant event details @@ -97,7 +97,7 @@ public class BlockListener implements Listener { /** * Called when a block is destroyed as a result of being burnt by fire. - *<p /> + * <p /> * If a Block Burn event is cancelled, the block will not be destroyed as a result of being burnt by fire. * * @param event Relevant event details @@ -106,11 +106,11 @@ public class BlockListener implements Listener { /** * Called when a block is broken by a player. - *<p /> + * <p /> * Note: * Plugins wanting to simulate a traditional block drop should set the block to air and utilise their own methods for determining * what the default drop for the block being broken is and what to do about it, if anything. - *<p /> + * <p /> * If a Block Break event is cancelled, the block will not break. * * @param event Relevant event details @@ -120,13 +120,13 @@ public class BlockListener implements Listener { /** * Called when a block is formed or spreads based on world conditions. * Use {@link BlockSpreadEvent} to catch blocks that actually spread and don't just "randomly" form. - *<p /> + * <p /> * Examples: - *<ul> - * <li>Snow forming due to a snow storm.</li> - * <li>Ice forming in a snowy Biome like Tiga or Tundra.</li> + * <ul> + * <li>Snow forming due to a snow storm.</li> + * <li>Ice forming in a snowy Biome like Tiga or Tundra.</li> * </ul> - *<p /> + * <p /> * If a Block Form event is cancelled, the block will not be formed or will not spread. * * @see BlockSpreadEvent @@ -137,13 +137,13 @@ public class BlockListener implements Listener { /** * Called when a block spreads based on world conditions. * Use {@link BlockFormEvent} to catch blocks that "randomly" form instead of actually spread. - *<p /> + * <p /> * Examples: - *<ul> - * <li>Mushrooms spreading.</li> - * <li>Fire spreading.</li> + * <ul> + * <li>Mushrooms spreading.</li> + * <li>Fire spreading.</li> * </ul> - *<p /> + * <p /> * If a Block Spread event is cancelled, the block will not spread. * * @param event Relevant event details @@ -155,8 +155,8 @@ public class BlockListener implements Listener { * <p /> * Examples: * <ul> - * <li>Snow melting due to being near a light source.</li> - * <li>Ice melting due to being near a light source.</li> + * <li>Snow melting due to being near a light source.</li> + * <li>Ice melting due to being near a light source.</li> * </ul> * <p /> * If a Block Fade event is cancelled, the block will not fade, melt or disappear. @@ -167,7 +167,7 @@ public class BlockListener implements Listener { /** * Called when an item is dispensed from a block. - *<p /> + * <p /> * If a Block Dispense event is cancelled, the block will not dispense the item. * * @param event Relevant event details diff --git a/src/main/java/org/bukkit/event/block/BlockPhysicsEvent.java b/src/main/java/org/bukkit/event/block/BlockPhysicsEvent.java index d56df635..f35be74f 100644 --- a/src/main/java/org/bukkit/event/block/BlockPhysicsEvent.java +++ b/src/main/java/org/bukkit/event/block/BlockPhysicsEvent.java @@ -7,6 +7,7 @@ import org.bukkit.event.Cancellable; /** * Thrown when a block physics check is called */ +@SuppressWarnings("serial") public class BlockPhysicsEvent extends BlockEvent implements Cancellable { private final int changed; private boolean cancel = false; diff --git a/src/main/java/org/bukkit/event/block/BlockPistonEvent.java b/src/main/java/org/bukkit/event/block/BlockPistonEvent.java index 4c2560aa..93f66fee 100644 --- a/src/main/java/org/bukkit/event/block/BlockPistonEvent.java +++ b/src/main/java/org/bukkit/event/block/BlockPistonEvent.java @@ -4,9 +4,9 @@ import org.bukkit.Material; import org.bukkit.block.Block; import org.bukkit.block.BlockFace; import org.bukkit.event.Cancellable; -import org.bukkit.material.PistonBaseMaterial; -public abstract class BlockPistonEvent extends BlockEvent implements Cancellable { +@SuppressWarnings("serial") +public abstract class BlockPistonEvent extends BlockEvent implements Cancellable { private boolean cancelled; private BlockFace direction; diff --git a/src/main/java/org/bukkit/event/block/BlockPistonExtendEvent.java b/src/main/java/org/bukkit/event/block/BlockPistonExtendEvent.java index dff70f0b..d4cadb22 100644 --- a/src/main/java/org/bukkit/event/block/BlockPistonExtendEvent.java +++ b/src/main/java/org/bukkit/event/block/BlockPistonExtendEvent.java @@ -7,6 +7,7 @@ import java.util.List; import org.bukkit.block.Block; import org.bukkit.block.BlockFace; +@SuppressWarnings("serial") public class BlockPistonExtendEvent extends BlockPistonEvent { private int length; private List<Block> blocks; diff --git a/src/main/java/org/bukkit/event/block/BlockPistonRetractEvent.java b/src/main/java/org/bukkit/event/block/BlockPistonRetractEvent.java index 7534cbe0..0fec1e04 100644 --- a/src/main/java/org/bukkit/event/block/BlockPistonRetractEvent.java +++ b/src/main/java/org/bukkit/event/block/BlockPistonRetractEvent.java @@ -4,6 +4,7 @@ import org.bukkit.Location; import org.bukkit.block.Block; import org.bukkit.block.BlockFace; +@SuppressWarnings("serial") public class BlockPistonRetractEvent extends BlockPistonEvent { public BlockPistonRetractEvent(Block block, BlockFace direction) { super(Type.BLOCK_PISTON_RETRACT, block, direction); diff --git a/src/main/java/org/bukkit/event/block/BlockPlaceEvent.java b/src/main/java/org/bukkit/event/block/BlockPlaceEvent.java index ea143ca9..0a9f122f 100644 --- a/src/main/java/org/bukkit/event/block/BlockPlaceEvent.java +++ b/src/main/java/org/bukkit/event/block/BlockPlaceEvent.java @@ -8,9 +8,10 @@ import org.bukkit.inventory.ItemStack; /** * Called when a block is placed by a player. - *<p /> + * <p /> * If a Block Place event is cancelled, the block will not be placed. */ +@SuppressWarnings("serial") public class BlockPlaceEvent extends BlockEvent implements Cancellable { protected boolean cancel; protected boolean canBuild; diff --git a/src/main/java/org/bukkit/event/block/BlockRedstoneEvent.java b/src/main/java/org/bukkit/event/block/BlockRedstoneEvent.java index 9691a6be..be0a530a 100644 --- a/src/main/java/org/bukkit/event/block/BlockRedstoneEvent.java +++ b/src/main/java/org/bukkit/event/block/BlockRedstoneEvent.java @@ -5,6 +5,7 @@ import org.bukkit.block.Block; /** * Called when a redstone current changes */ +@SuppressWarnings("serial") public class BlockRedstoneEvent extends BlockEvent { private int oldCurrent; private int newCurrent; diff --git a/src/main/java/org/bukkit/event/block/BlockSpreadEvent.java b/src/main/java/org/bukkit/event/block/BlockSpreadEvent.java index 9e56ae78..6001d0ad 100644 --- a/src/main/java/org/bukkit/event/block/BlockSpreadEvent.java +++ b/src/main/java/org/bukkit/event/block/BlockSpreadEvent.java @@ -2,19 +2,22 @@ package org.bukkit.event.block; import org.bukkit.block.Block; import org.bukkit.block.BlockState; + /** * Called when a block spreads based on world conditions. * Use {@link BlockFormEvent} to catch blocks that "randomly" form instead of actually spread. - *<p /> + * <p /> * Examples: - *<ul> - * <li>Mushrooms spreading.</li> - * <li>Fire spreading.</li> + * <ul> + * <li>Mushrooms spreading.</li> + * <li>Fire spreading.</li> * </ul> - *<p /> + * <p /> * If a Block Spread event is cancelled, the block will not spread. + * * @see BlockFormEvent */ +@SuppressWarnings("serial") public class BlockSpreadEvent extends BlockFormEvent { private Block source; diff --git a/src/main/java/org/bukkit/event/block/LeavesDecayEvent.java b/src/main/java/org/bukkit/event/block/LeavesDecayEvent.java index 4757bb0e..07dd2e5f 100644 --- a/src/main/java/org/bukkit/event/block/LeavesDecayEvent.java +++ b/src/main/java/org/bukkit/event/block/LeavesDecayEvent.java @@ -5,9 +5,10 @@ import org.bukkit.event.Cancellable; /** * Called when leaves are decaying naturally. - *<p /> + * <p /> * If a Leaves Decay event is cancelled, the leaves will not decay. */ +@SuppressWarnings("serial") public class LeavesDecayEvent extends BlockEvent implements Cancellable { private boolean cancel = false; diff --git a/src/main/java/org/bukkit/event/block/SignChangeEvent.java b/src/main/java/org/bukkit/event/block/SignChangeEvent.java index 03b69586..28e69b94 100644 --- a/src/main/java/org/bukkit/event/block/SignChangeEvent.java +++ b/src/main/java/org/bukkit/event/block/SignChangeEvent.java @@ -9,6 +9,7 @@ import org.bukkit.event.Cancellable; * <p /> * If a Sign Change event is cancelled, the sign will not be changed. */ +@SuppressWarnings("serial") public class SignChangeEvent extends BlockEvent implements Cancellable { private boolean cancel = false; private Player player; diff --git a/src/main/java/org/bukkit/event/entity/CreatureSpawnEvent.java b/src/main/java/org/bukkit/event/entity/CreatureSpawnEvent.java index 394dd580..0dbcbf3b 100644 --- a/src/main/java/org/bukkit/event/entity/CreatureSpawnEvent.java +++ b/src/main/java/org/bukkit/event/entity/CreatureSpawnEvent.java @@ -7,9 +7,10 @@ import org.bukkit.event.Cancellable; /** * Called when a creature is spawned into a world. - *<p /> + * <p /> * If a Creature Spawn event is cancelled, the creature will not spawn. */ +@SuppressWarnings("serial") public class CreatureSpawnEvent extends EntityEvent implements Cancellable { private Location location; diff --git a/src/main/java/org/bukkit/event/entity/CreeperPowerEvent.java b/src/main/java/org/bukkit/event/entity/CreeperPowerEvent.java index a670696c..7386f401 100644 --- a/src/main/java/org/bukkit/event/entity/CreeperPowerEvent.java +++ b/src/main/java/org/bukkit/event/entity/CreeperPowerEvent.java @@ -5,9 +5,10 @@ import org.bukkit.event.Cancellable; /** * Called when a Creeper is struck by lightning. - *<p /> + * <p /> * If a Creeper Power event is cancelled, the Creeper will not be powered. */ +@SuppressWarnings("serial") public class CreeperPowerEvent extends EntityEvent implements Cancellable { private boolean canceled; diff --git a/src/main/java/org/bukkit/event/entity/EndermanPickupEvent.java b/src/main/java/org/bukkit/event/entity/EndermanPickupEvent.java index 9624000d..ee5a5f35 100644 --- a/src/main/java/org/bukkit/event/entity/EndermanPickupEvent.java +++ b/src/main/java/org/bukkit/event/entity/EndermanPickupEvent.java @@ -4,6 +4,7 @@ import org.bukkit.block.Block; import org.bukkit.entity.Entity; import org.bukkit.event.Cancellable; +@SuppressWarnings("serial") public class EndermanPickupEvent extends EntityEvent implements Cancellable { private boolean cancel; diff --git a/src/main/java/org/bukkit/event/entity/EndermanPlaceEvent.java b/src/main/java/org/bukkit/event/entity/EndermanPlaceEvent.java index aca6228a..1c85eb78 100644 --- a/src/main/java/org/bukkit/event/entity/EndermanPlaceEvent.java +++ b/src/main/java/org/bukkit/event/entity/EndermanPlaceEvent.java @@ -4,6 +4,7 @@ import org.bukkit.Location; import org.bukkit.entity.Entity; import org.bukkit.event.Cancellable; +@SuppressWarnings("serial") public class EndermanPlaceEvent extends EntityEvent implements Cancellable { private boolean cancel; diff --git a/src/main/java/org/bukkit/event/entity/EntityCombustByBlockEvent.java b/src/main/java/org/bukkit/event/entity/EntityCombustByBlockEvent.java index addb42fd..c6175cd2 100644 --- a/src/main/java/org/bukkit/event/entity/EntityCombustByBlockEvent.java +++ b/src/main/java/org/bukkit/event/entity/EntityCombustByBlockEvent.java @@ -3,6 +3,7 @@ package org.bukkit.event.entity; import org.bukkit.block.Block; import org.bukkit.entity.Entity; +@SuppressWarnings("serial") public class EntityCombustByBlockEvent extends EntityCombustEvent { private Block combuster; @@ -16,6 +17,7 @@ public class EntityCombustByBlockEvent extends EntityCombustEvent { * The combuster can be lava or a block that is on fire. * * WARNING: block may be null. + * * @return the Block that set the combustee alight. */ public Block getCombuster() { diff --git a/src/main/java/org/bukkit/event/entity/EntityCombustByEntityEvent.java b/src/main/java/org/bukkit/event/entity/EntityCombustByEntityEvent.java index 15ab75f1..af3d245a 100644 --- a/src/main/java/org/bukkit/event/entity/EntityCombustByEntityEvent.java +++ b/src/main/java/org/bukkit/event/entity/EntityCombustByEntityEvent.java @@ -2,6 +2,7 @@ package org.bukkit.event.entity; import org.bukkit.entity.Entity; +@SuppressWarnings("serial") public class EntityCombustByEntityEvent extends EntityCombustEvent { private Entity combuster; @@ -13,6 +14,7 @@ public class EntityCombustByEntityEvent extends EntityCombustEvent { /** * The combuster can be a WeatherStorm a Blaze, or an Entity holding a FIRE_ASPECT enchanted item. + * * @return the Entity that set the combustee alight. */ public Entity getCombuster() { diff --git a/src/main/java/org/bukkit/event/entity/EntityCombustEvent.java b/src/main/java/org/bukkit/event/entity/EntityCombustEvent.java index 9b3f38f3..156fa637 100644 --- a/src/main/java/org/bukkit/event/entity/EntityCombustEvent.java +++ b/src/main/java/org/bukkit/event/entity/EntityCombustEvent.java @@ -5,9 +5,10 @@ import org.bukkit.event.Cancellable; /** * Called when an entity combusts. - *<p /> + * <p /> * If an Entity Combust event is cancelled, the entity will not combust. */ +@SuppressWarnings("serial") public class EntityCombustEvent extends EntityEvent implements Cancellable { private int duration; private boolean cancel; @@ -37,6 +38,7 @@ public class EntityCombustEvent extends EntityEvent implements Cancellable { * The number of seconds the combustee should be alight for. * * This value will only ever increase the combustion time, not decrease existing combustion times. + * * @param duration the time in seconds to be alight for. */ public void setDuration(int duration) { diff --git a/src/main/java/org/bukkit/event/entity/EntityDamageByBlockEvent.java b/src/main/java/org/bukkit/event/entity/EntityDamageByBlockEvent.java index f141c009..f18b7049 100644 --- a/src/main/java/org/bukkit/event/entity/EntityDamageByBlockEvent.java +++ b/src/main/java/org/bukkit/event/entity/EntityDamageByBlockEvent.java @@ -6,6 +6,7 @@ import org.bukkit.entity.Entity; /** * Called when an entity is damaged by a block */ +@SuppressWarnings("serial") public class EntityDamageByBlockEvent extends EntityDamageEvent { private Block damager; diff --git a/src/main/java/org/bukkit/event/entity/EntityDamageByEntityEvent.java b/src/main/java/org/bukkit/event/entity/EntityDamageByEntityEvent.java index 62b4df94..8efc3cbc 100644 --- a/src/main/java/org/bukkit/event/entity/EntityDamageByEntityEvent.java +++ b/src/main/java/org/bukkit/event/entity/EntityDamageByEntityEvent.java @@ -5,6 +5,7 @@ import org.bukkit.entity.Entity; /** * Called when an entity is damaged by an entity */ +@SuppressWarnings("serial") public class EntityDamageByEntityEvent extends EntityDamageEvent { private Entity damager; diff --git a/src/main/java/org/bukkit/event/entity/EntityDamageByProjectileEvent.java b/src/main/java/org/bukkit/event/entity/EntityDamageByProjectileEvent.java index 5419b019..e4fe40e0 100644 --- a/src/main/java/org/bukkit/event/entity/EntityDamageByProjectileEvent.java +++ b/src/main/java/org/bukkit/event/entity/EntityDamageByProjectileEvent.java @@ -8,6 +8,7 @@ import org.bukkit.entity.Projectile; * * @deprecated use {@link EntityDamageByEntityEvent} instead, where {@link EntityDamageByEntityEvent#getDamager()} will return the {@link Projectile} */ +@SuppressWarnings("serial") @Deprecated public class EntityDamageByProjectileEvent extends EntityDamageByEntityEvent { diff --git a/src/main/java/org/bukkit/event/entity/EntityDamageEvent.java b/src/main/java/org/bukkit/event/entity/EntityDamageEvent.java index 1d871fc8..95e1682e 100644 --- a/src/main/java/org/bukkit/event/entity/EntityDamageEvent.java +++ b/src/main/java/org/bukkit/event/entity/EntityDamageEvent.java @@ -7,6 +7,7 @@ import org.bukkit.event.Event; /** * Stores data for damage events */ +@SuppressWarnings("serial") public class EntityDamageEvent extends EntityEvent implements Cancellable { private int damage; diff --git a/src/main/java/org/bukkit/event/entity/EntityDeathEvent.java b/src/main/java/org/bukkit/event/entity/EntityDeathEvent.java index a7e47ee2..96d0ef70 100644 --- a/src/main/java/org/bukkit/event/entity/EntityDeathEvent.java +++ b/src/main/java/org/bukkit/event/entity/EntityDeathEvent.java @@ -7,6 +7,7 @@ import org.bukkit.inventory.ItemStack; /** * Thrown whenever a LivingEntity dies */ +@SuppressWarnings("serial") public class EntityDeathEvent extends EntityEvent { private List<ItemStack> drops; private int dropExp = 0; diff --git a/src/main/java/org/bukkit/event/entity/EntityEvent.java b/src/main/java/org/bukkit/event/entity/EntityEvent.java index ef35d00b..af93e074 100644 --- a/src/main/java/org/bukkit/event/entity/EntityEvent.java +++ b/src/main/java/org/bukkit/event/entity/EntityEvent.java @@ -6,6 +6,7 @@ import org.bukkit.event.Event; /** * Represents an Entity-related event */ +@SuppressWarnings("serial") public class EntityEvent extends Event { protected Entity entity; diff --git a/src/main/java/org/bukkit/event/entity/EntityExplodeEvent.java b/src/main/java/org/bukkit/event/entity/EntityExplodeEvent.java index 9701a8a0..7eed8f4a 100644 --- a/src/main/java/org/bukkit/event/entity/EntityExplodeEvent.java +++ b/src/main/java/org/bukkit/event/entity/EntityExplodeEvent.java @@ -10,6 +10,7 @@ import java.util.List; /** * Called when an entity explodes */ +@SuppressWarnings("serial") public class EntityExplodeEvent extends EntityEvent implements Cancellable { private boolean cancel; private Location location; @@ -40,6 +41,7 @@ public class EntityExplodeEvent extends EntityEvent implements Cancellable { /** * Returns the list of blocks that would have been removed or were * removed from the explosion event. + * * @return All blown-up blocks */ public List<Block> blockList() { @@ -50,6 +52,7 @@ public class EntityExplodeEvent extends EntityEvent implements Cancellable { * Returns the location where the explosion happened. * It is not possible to get this value from the Entity as * the Entity no longer exists in the world. + * * @return The location of the explosion */ public Location getLocation() { @@ -67,6 +70,7 @@ public class EntityExplodeEvent extends EntityEvent implements Cancellable { /** * Sets the percentage of blocks to drop from this explosion + * * @param yield The new yield percentage */ public void setYield(float yield) { diff --git a/src/main/java/org/bukkit/event/entity/EntityInteractEvent.java b/src/main/java/org/bukkit/event/entity/EntityInteractEvent.java index 0fec15b6..b1b58a5c 100644 --- a/src/main/java/org/bukkit/event/entity/EntityInteractEvent.java +++ b/src/main/java/org/bukkit/event/entity/EntityInteractEvent.java @@ -7,6 +7,7 @@ import org.bukkit.event.Cancellable; /** * Called when an entity interacts with an object */ +@SuppressWarnings("serial") public class EntityInteractEvent extends EntityEvent implements Cancellable { protected Block block; diff --git a/src/main/java/org/bukkit/event/entity/EntityListener.java b/src/main/java/org/bukkit/event/entity/EntityListener.java index 3e8db64e..b4399736 100644 --- a/src/main/java/org/bukkit/event/entity/EntityListener.java +++ b/src/main/java/org/bukkit/event/entity/EntityListener.java @@ -12,7 +12,7 @@ public class EntityListener implements Listener { /** * Called when a creature is spawned into a world. - *<p /> + * <p /> * If a Creature Spawn event is cancelled, the creature will not spawn. * * @param event Relevant event details @@ -28,7 +28,7 @@ public class EntityListener implements Listener { /** * Called when an entity combusts. - *<p /> + * <p /> * If an Entity Combust event is cancelled, the entity will not combust. * * @param event Relevant event details @@ -107,7 +107,7 @@ public class EntityListener implements Listener { /** * Called when a Creeper is struck by lightning. - *<p /> + * <p /> * If a Creeper Power event is cancelled, the Creeper will not be powered. * * @param event Relevant event details diff --git a/src/main/java/org/bukkit/event/entity/EntityPortalEnterEvent.java b/src/main/java/org/bukkit/event/entity/EntityPortalEnterEvent.java index 137d6fbb..44f506b1 100644 --- a/src/main/java/org/bukkit/event/entity/EntityPortalEnterEvent.java +++ b/src/main/java/org/bukkit/event/entity/EntityPortalEnterEvent.java @@ -1,12 +1,12 @@ package org.bukkit.event.entity; - import org.bukkit.entity.Entity; import org.bukkit.Location; /** * Stores data for entities standing inside a portal block */ +@SuppressWarnings("serial") public class EntityPortalEnterEvent extends EntityEvent { private Location location; diff --git a/src/main/java/org/bukkit/event/entity/EntityRegainHealthEvent.java b/src/main/java/org/bukkit/event/entity/EntityRegainHealthEvent.java index 16352403..dd167912 100644 --- a/src/main/java/org/bukkit/event/entity/EntityRegainHealthEvent.java +++ b/src/main/java/org/bukkit/event/entity/EntityRegainHealthEvent.java @@ -7,6 +7,7 @@ import org.bukkit.event.Event; /** * Stores data for health-regain events */ +@SuppressWarnings("serial") public class EntityRegainHealthEvent extends EntityEvent implements Cancellable { private boolean cancelled; diff --git a/src/main/java/org/bukkit/event/entity/EntityTameEvent.java b/src/main/java/org/bukkit/event/entity/EntityTameEvent.java index af7363d4..5b0759f8 100644 --- a/src/main/java/org/bukkit/event/entity/EntityTameEvent.java +++ b/src/main/java/org/bukkit/event/entity/EntityTameEvent.java @@ -7,6 +7,7 @@ import org.bukkit.event.Cancellable; /** * Thrown when a LivingEntity is tamed */ +@SuppressWarnings("serial") public class EntityTameEvent extends EntityEvent implements Cancellable { private boolean cancelled; private AnimalTamer owner; diff --git a/src/main/java/org/bukkit/event/entity/EntityTargetEvent.java b/src/main/java/org/bukkit/event/entity/EntityTargetEvent.java index ad2392a6..e4a45f6d 100644 --- a/src/main/java/org/bukkit/event/entity/EntityTargetEvent.java +++ b/src/main/java/org/bukkit/event/entity/EntityTargetEvent.java @@ -6,6 +6,7 @@ import org.bukkit.event.Cancellable; /** * Called when a creature targets or untargets another entity */ +@SuppressWarnings("serial") public class EntityTargetEvent extends EntityEvent implements Cancellable { private boolean cancel; private Entity target; @@ -28,6 +29,7 @@ public class EntityTargetEvent extends EntityEvent implements Cancellable { /** * Returns the reason for the targeting + * * @return The reason */ public TargetReason getReason() { @@ -38,6 +40,7 @@ public class EntityTargetEvent extends EntityEvent implements Cancellable { * Get the entity that this is targeting. * This will be null in the case that the event is called when * the mob forgets its target. + * * @return The entity */ public Entity getTarget() { diff --git a/src/main/java/org/bukkit/event/entity/ExplosionPrimeEvent.java b/src/main/java/org/bukkit/event/entity/ExplosionPrimeEvent.java index 2fd38537..850aa8de 100644 --- a/src/main/java/org/bukkit/event/entity/ExplosionPrimeEvent.java +++ b/src/main/java/org/bukkit/event/entity/ExplosionPrimeEvent.java @@ -7,6 +7,7 @@ import org.bukkit.event.Cancellable; /** * Called when an entity has made a decision to explode. */ +@SuppressWarnings("serial") public class ExplosionPrimeEvent extends EntityEvent implements Cancellable { private boolean cancel; private float radius; diff --git a/src/main/java/org/bukkit/event/entity/FoodLevelChangeEvent.java b/src/main/java/org/bukkit/event/entity/FoodLevelChangeEvent.java index 4adacfef..f6854ce7 100644 --- a/src/main/java/org/bukkit/event/entity/FoodLevelChangeEvent.java +++ b/src/main/java/org/bukkit/event/entity/FoodLevelChangeEvent.java @@ -6,6 +6,7 @@ import org.bukkit.event.Cancellable; /** * Called when a human entity's food level changes */ +@SuppressWarnings("serial") public class FoodLevelChangeEvent extends EntityEvent implements Cancellable { private boolean cancel = false; private int level; diff --git a/src/main/java/org/bukkit/event/entity/ItemSpawnEvent.java b/src/main/java/org/bukkit/event/entity/ItemSpawnEvent.java index 8d6e4876..19544295 100644 --- a/src/main/java/org/bukkit/event/entity/ItemSpawnEvent.java +++ b/src/main/java/org/bukkit/event/entity/ItemSpawnEvent.java @@ -7,6 +7,7 @@ import org.bukkit.event.Cancellable; /** * Called when an item is spawned into a world */ +@SuppressWarnings("serial") public class ItemSpawnEvent extends EntityEvent implements Cancellable { private Location location; diff --git a/src/main/java/org/bukkit/event/entity/PigZapEvent.java b/src/main/java/org/bukkit/event/entity/PigZapEvent.java index bd9a61a5..174a2d08 100644 --- a/src/main/java/org/bukkit/event/entity/PigZapEvent.java +++ b/src/main/java/org/bukkit/event/entity/PigZapEvent.java @@ -6,6 +6,7 @@ import org.bukkit.event.Cancellable; /** * Stores data for pigs being zapped */ +@SuppressWarnings("serial") public class PigZapEvent extends EntityEvent implements Cancellable { private boolean canceled; diff --git a/src/main/java/org/bukkit/event/entity/PlayerDeathEvent.java b/src/main/java/org/bukkit/event/entity/PlayerDeathEvent.java index 4fa78fd0..46c650d7 100644 --- a/src/main/java/org/bukkit/event/entity/PlayerDeathEvent.java +++ b/src/main/java/org/bukkit/event/entity/PlayerDeathEvent.java @@ -8,6 +8,7 @@ import org.bukkit.inventory.ItemStack; /** * Thrown whenever a {@link Player} dies */ +@SuppressWarnings("serial") public class PlayerDeathEvent extends EntityDeathEvent { private int newExp = 0; private String deathMessage = ""; @@ -53,7 +54,7 @@ public class PlayerDeathEvent extends EntityDeathEvent { * <p> * This does not indicate how much EXP should be dropped, please see * {@link #setDroppedExp(int)} for that. - * + * * @get exp New EXP of the respawned player */ public void setNewExp(int exp) { diff --git a/src/main/java/org/bukkit/event/entity/ProjectileHitEvent.java b/src/main/java/org/bukkit/event/entity/ProjectileHitEvent.java index b1e21f9b..e5b2e60a 100644 --- a/src/main/java/org/bukkit/event/entity/ProjectileHitEvent.java +++ b/src/main/java/org/bukkit/event/entity/ProjectileHitEvent.java @@ -5,6 +5,7 @@ import org.bukkit.entity.Projectile; /** * Called when a projectile hits an object */ +@SuppressWarnings("serial") public class ProjectileHitEvent extends EntityEvent { public ProjectileHitEvent(Projectile projectile) { diff --git a/src/main/java/org/bukkit/event/entity/SlimeSplitEvent.java b/src/main/java/org/bukkit/event/entity/SlimeSplitEvent.java index 3ca784a9..57d52bac 100644 --- a/src/main/java/org/bukkit/event/entity/SlimeSplitEvent.java +++ b/src/main/java/org/bukkit/event/entity/SlimeSplitEvent.java @@ -6,6 +6,7 @@ import org.bukkit.event.Cancellable; /** * Called when a Slime splits into smaller Slimes upon death */ +@SuppressWarnings("serial") public class SlimeSplitEvent extends EntityEvent implements Cancellable { private boolean cancel; private int count; diff --git a/src/main/java/org/bukkit/event/inventory/FurnaceBurnEvent.java b/src/main/java/org/bukkit/event/inventory/FurnaceBurnEvent.java index d455864f..d1849f96 100644 --- a/src/main/java/org/bukkit/event/inventory/FurnaceBurnEvent.java +++ b/src/main/java/org/bukkit/event/inventory/FurnaceBurnEvent.java @@ -4,9 +4,11 @@ import org.bukkit.block.Block; import org.bukkit.event.Cancellable; import org.bukkit.event.Event; import org.bukkit.inventory.ItemStack; + /** * Called when an ItemStack is successfully burned as fuel in a furnace. */ +@SuppressWarnings("serial") public class FurnaceBurnEvent extends Event implements Cancellable { private Block furnace; private ItemStack fuel; diff --git a/src/main/java/org/bukkit/event/inventory/FurnaceSmeltEvent.java b/src/main/java/org/bukkit/event/inventory/FurnaceSmeltEvent.java index 4b42b46c..9b00384d 100644 --- a/src/main/java/org/bukkit/event/inventory/FurnaceSmeltEvent.java +++ b/src/main/java/org/bukkit/event/inventory/FurnaceSmeltEvent.java @@ -8,7 +8,8 @@ import org.bukkit.inventory.ItemStack; /** * Called when an ItemStack is successfully smelted in a furnace. */ -public class FurnaceSmeltEvent extends Event implements Cancellable{ +@SuppressWarnings("serial") +public class FurnaceSmeltEvent extends Event implements Cancellable { private Block furnace; private ItemStack source; private ItemStack result; @@ -56,7 +57,7 @@ public class FurnaceSmeltEvent extends Event implements Cancellable{ * @param result new result ItemStack */ public void setResult(ItemStack result) { - this.result = result; + this.result = result; } public boolean isCancelled() { diff --git a/src/main/java/org/bukkit/event/inventory/InventoryListener.java b/src/main/java/org/bukkit/event/inventory/InventoryListener.java index 83e7e6d5..f34fa2ba 100644 --- a/src/main/java/org/bukkit/event/inventory/InventoryListener.java +++ b/src/main/java/org/bukkit/event/inventory/InventoryListener.java @@ -1,8 +1,9 @@ package org.bukkit.event.inventory; import org.bukkit.event.Listener; + /** -* Handles all events thrown in relation to Blocks + * Handles all events thrown in relation to Blocks */ public class InventoryListener implements Listener { public InventoryListener() {} diff --git a/src/main/java/org/bukkit/event/painting/PaintingBreakByEntityEvent.java b/src/main/java/org/bukkit/event/painting/PaintingBreakByEntityEvent.java index 2826d8fa..00d6533a 100644 --- a/src/main/java/org/bukkit/event/painting/PaintingBreakByEntityEvent.java +++ b/src/main/java/org/bukkit/event/painting/PaintingBreakByEntityEvent.java @@ -6,6 +6,7 @@ import org.bukkit.entity.Painting; /** * Triggered when a painting is removed by an entity */ +@SuppressWarnings("serial") public class PaintingBreakByEntityEvent extends PaintingBreakEvent { private Entity remover; diff --git a/src/main/java/org/bukkit/event/painting/PaintingBreakEvent.java b/src/main/java/org/bukkit/event/painting/PaintingBreakEvent.java index 98420666..8268b00d 100644 --- a/src/main/java/org/bukkit/event/painting/PaintingBreakEvent.java +++ b/src/main/java/org/bukkit/event/painting/PaintingBreakEvent.java @@ -6,6 +6,7 @@ import org.bukkit.event.Cancellable; /** * Triggered when a painting is removed */ +@SuppressWarnings("serial") public class PaintingBreakEvent extends PaintingEvent implements Cancellable { private boolean cancelled; diff --git a/src/main/java/org/bukkit/event/painting/PaintingEvent.java b/src/main/java/org/bukkit/event/painting/PaintingEvent.java index bf576c67..c2c606ba 100644 --- a/src/main/java/org/bukkit/event/painting/PaintingEvent.java +++ b/src/main/java/org/bukkit/event/painting/PaintingEvent.java @@ -6,6 +6,7 @@ import org.bukkit.event.Event; /** * Represents a painting-related event. */ +@SuppressWarnings("serial") public class PaintingEvent extends Event { protected Painting painting; diff --git a/src/main/java/org/bukkit/event/painting/PaintingPlaceEvent.java b/src/main/java/org/bukkit/event/painting/PaintingPlaceEvent.java index c56ec239..7e460c83 100644 --- a/src/main/java/org/bukkit/event/painting/PaintingPlaceEvent.java +++ b/src/main/java/org/bukkit/event/painting/PaintingPlaceEvent.java @@ -10,6 +10,7 @@ import org.bukkit.event.Event; /** * Triggered when a painting is created in the world */ +@SuppressWarnings("serial") public class PaintingPlaceEvent extends PaintingEvent implements Cancellable { private boolean cancelled; diff --git a/src/main/java/org/bukkit/event/player/PlayerAnimationEvent.java b/src/main/java/org/bukkit/event/player/PlayerAnimationEvent.java index 93a3f757..4f703f3a 100644 --- a/src/main/java/org/bukkit/event/player/PlayerAnimationEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerAnimationEvent.java @@ -6,6 +6,7 @@ import org.bukkit.event.Cancellable; /** * Represents a player animation event */ +@SuppressWarnings("serial") public class PlayerAnimationEvent extends PlayerEvent implements Cancellable { private PlayerAnimationType animationType; diff --git a/src/main/java/org/bukkit/event/player/PlayerBedEnterEvent.java b/src/main/java/org/bukkit/event/player/PlayerBedEnterEvent.java index 0ba13eb6..53aeac38 100644 --- a/src/main/java/org/bukkit/event/player/PlayerBedEnterEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerBedEnterEvent.java @@ -7,6 +7,7 @@ import org.bukkit.event.Cancellable; /** * This event is fired when the player is almost about to enter the bed. */ +@SuppressWarnings("serial") public class PlayerBedEnterEvent extends PlayerEvent implements Cancellable { private boolean cancel = false; diff --git a/src/main/java/org/bukkit/event/player/PlayerBedLeaveEvent.java b/src/main/java/org/bukkit/event/player/PlayerBedLeaveEvent.java index 8e91f2aa..2cc36edd 100644 --- a/src/main/java/org/bukkit/event/player/PlayerBedLeaveEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerBedLeaveEvent.java @@ -6,6 +6,7 @@ import org.bukkit.entity.Player; /** * This event is fired when the player is leaving a bed. */ +@SuppressWarnings("serial") public class PlayerBedLeaveEvent extends PlayerEvent { private Block bed; diff --git a/src/main/java/org/bukkit/event/player/PlayerBucketEmptyEvent.java b/src/main/java/org/bukkit/event/player/PlayerBucketEmptyEvent.java index b7ddc92d..b44155e4 100644 --- a/src/main/java/org/bukkit/event/player/PlayerBucketEmptyEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerBucketEmptyEvent.java @@ -9,9 +9,10 @@ import org.bukkit.inventory.ItemStack; /** * Called when a player empties a bucket */ +@SuppressWarnings("serial") public class PlayerBucketEmptyEvent extends PlayerBucketEvent { public PlayerBucketEmptyEvent(Player who, Block blockClicked, BlockFace blockFace, Material bucket, ItemStack itemInHand) { - super(Type.PLAYER_BUCKET_EMPTY, who, blockClicked, blockFace, bucket, itemInHand); + super(Type.PLAYER_BUCKET_EMPTY, who, blockClicked, blockFace, bucket, itemInHand); } } diff --git a/src/main/java/org/bukkit/event/player/PlayerBucketEvent.java b/src/main/java/org/bukkit/event/player/PlayerBucketEvent.java index ec45668c..c8f830e0 100644 --- a/src/main/java/org/bukkit/event/player/PlayerBucketEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerBucketEvent.java @@ -7,6 +7,7 @@ import org.bukkit.entity.Player; import org.bukkit.event.Cancellable; import org.bukkit.inventory.ItemStack; +@SuppressWarnings("serial") public abstract class PlayerBucketEvent extends PlayerEvent implements Cancellable { private ItemStack itemStack; @@ -50,7 +51,6 @@ public abstract class PlayerBucketEvent extends PlayerEvent implements Cancellab this.itemStack = itemStack; } - /** * Return the block clicked * diff --git a/src/main/java/org/bukkit/event/player/PlayerBucketFillEvent.java b/src/main/java/org/bukkit/event/player/PlayerBucketFillEvent.java index 5f1ff0df..4a5dbe48 100644 --- a/src/main/java/org/bukkit/event/player/PlayerBucketFillEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerBucketFillEvent.java @@ -9,6 +9,7 @@ import org.bukkit.inventory.ItemStack; /** * Called when a player fills a bucket */ +@SuppressWarnings("serial") public class PlayerBucketFillEvent extends PlayerBucketEvent { public PlayerBucketFillEvent(Player who, Block blockClicked, BlockFace blockFace, Material bucket, ItemStack itemInHand) { super(Type.PLAYER_BUCKET_FILL, who, blockClicked, blockFace, bucket, itemInHand); diff --git a/src/main/java/org/bukkit/event/player/PlayerChangedWorldEvent.java b/src/main/java/org/bukkit/event/player/PlayerChangedWorldEvent.java index badbc13f..e718dc0a 100644 --- a/src/main/java/org/bukkit/event/player/PlayerChangedWorldEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerChangedWorldEvent.java @@ -3,6 +3,7 @@ package org.bukkit.event.player; import org.bukkit.World; import org.bukkit.entity.Player; +@SuppressWarnings("serial") public class PlayerChangedWorldEvent extends PlayerEvent { private final World from; diff --git a/src/main/java/org/bukkit/event/player/PlayerChatEvent.java b/src/main/java/org/bukkit/event/player/PlayerChatEvent.java index 5c71f3ea..67067d87 100644 --- a/src/main/java/org/bukkit/event/player/PlayerChatEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerChatEvent.java @@ -10,6 +10,7 @@ import org.bukkit.event.Cancellable; /** * Holds information for player chat and commands */ +@SuppressWarnings("serial") public class PlayerChatEvent extends PlayerEvent implements Cancellable { private boolean cancel = false; private String message; diff --git a/src/main/java/org/bukkit/event/player/PlayerCommandPreprocessEvent.java b/src/main/java/org/bukkit/event/player/PlayerCommandPreprocessEvent.java index 2979edba..67addfe9 100644 --- a/src/main/java/org/bukkit/event/player/PlayerCommandPreprocessEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerCommandPreprocessEvent.java @@ -6,6 +6,7 @@ import org.bukkit.entity.Player; * Called early in the command handling process. This event is only * for very exceptional cases and you should not normally use it. */ +@SuppressWarnings("serial") public class PlayerCommandPreprocessEvent extends PlayerChatEvent { public PlayerCommandPreprocessEvent(final Player player, final String message) { super(Type.PLAYER_COMMAND_PREPROCESS, player, message); diff --git a/src/main/java/org/bukkit/event/player/PlayerDropItemEvent.java b/src/main/java/org/bukkit/event/player/PlayerDropItemEvent.java index 926d09d9..50928987 100644 --- a/src/main/java/org/bukkit/event/player/PlayerDropItemEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerDropItemEvent.java @@ -7,6 +7,7 @@ import org.bukkit.event.Cancellable; /** * Thrown when a player drops an item from their inventory */ +@SuppressWarnings("serial") public class PlayerDropItemEvent extends PlayerEvent implements Cancellable { private final Item drop; private boolean cancel = false; diff --git a/src/main/java/org/bukkit/event/player/PlayerEggThrowEvent.java b/src/main/java/org/bukkit/event/player/PlayerEggThrowEvent.java index 6b2a8ea7..9a8cda48 100644 --- a/src/main/java/org/bukkit/event/player/PlayerEggThrowEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerEggThrowEvent.java @@ -7,6 +7,7 @@ import org.bukkit.entity.Player; /** * Called when a player throws an egg and it might hatch */ +@SuppressWarnings("serial") public class PlayerEggThrowEvent extends PlayerEvent { private Egg egg; private boolean hatching; @@ -44,7 +45,7 @@ public class PlayerEggThrowEvent extends PlayerEvent { * Sets whether the egg will hatch or not. * * @param hatching true if you want the egg to hatch - * false if you want it not to + * false if you want it not to */ public void setHatching(boolean hatching) { this.hatching = hatching; diff --git a/src/main/java/org/bukkit/event/player/PlayerEvent.java b/src/main/java/org/bukkit/event/player/PlayerEvent.java index f426bc1e..c567a0e8 100644 --- a/src/main/java/org/bukkit/event/player/PlayerEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerEvent.java @@ -6,6 +6,7 @@ import org.bukkit.event.Event; /** * Represents a player related event */ +@SuppressWarnings("serial") public class PlayerEvent extends Event { protected Player player; diff --git a/src/main/java/org/bukkit/event/player/PlayerFishEvent.java b/src/main/java/org/bukkit/event/player/PlayerFishEvent.java index 8cbcb741..285e8ab8 100644 --- a/src/main/java/org/bukkit/event/player/PlayerFishEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerFishEvent.java @@ -7,6 +7,7 @@ import org.bukkit.entity.Entity; /** * Thrown when a player is fishing */ +@SuppressWarnings("serial") public class PlayerFishEvent extends PlayerEvent implements Cancellable { private final Entity entity; private boolean cancel = false; diff --git a/src/main/java/org/bukkit/event/player/PlayerGameModeChangeEvent.java b/src/main/java/org/bukkit/event/player/PlayerGameModeChangeEvent.java index bc160161..e1dc0da3 100644 --- a/src/main/java/org/bukkit/event/player/PlayerGameModeChangeEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerGameModeChangeEvent.java @@ -4,6 +4,7 @@ import org.bukkit.GameMode; import org.bukkit.entity.Player; import org.bukkit.event.Cancellable; +@SuppressWarnings("serial") public class PlayerGameModeChangeEvent extends PlayerEvent implements Cancellable { private boolean cancelled; diff --git a/src/main/java/org/bukkit/event/player/PlayerInteractEntityEvent.java b/src/main/java/org/bukkit/event/player/PlayerInteractEntityEvent.java index 07663db3..3a8d3d44 100644 --- a/src/main/java/org/bukkit/event/player/PlayerInteractEntityEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerInteractEntityEvent.java @@ -7,6 +7,7 @@ import org.bukkit.event.Cancellable; /** * Represents an event that is called when a player right clicks an entity. */ +@SuppressWarnings("serial") public class PlayerInteractEntityEvent extends PlayerEvent implements Cancellable { protected Entity clickedEntity; boolean cancelled = false; diff --git a/src/main/java/org/bukkit/event/player/PlayerInteractEvent.java b/src/main/java/org/bukkit/event/player/PlayerInteractEvent.java index e0b357a5..9db1f0de 100644 --- a/src/main/java/org/bukkit/event/player/PlayerInteractEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerInteractEvent.java @@ -11,6 +11,7 @@ import org.bukkit.event.block.Action; /** * Called when a player interacts with an object or air. */ +@SuppressWarnings("serial") public class PlayerInteractEvent extends PlayerEvent implements Cancellable { protected ItemStack item; protected Action action; @@ -141,6 +142,7 @@ public class PlayerInteractEvent extends PlayerEvent implements Cancellable { /** * This controls the action to take with the block (if any) that was clicked on * This event gets processed for all blocks, but most don't have a default action + * * @return the action to take with the interacted block */ public Result useInteractedBlock() { @@ -158,6 +160,7 @@ public class PlayerInteractEvent extends PlayerEvent implements Cancellable { * This controls the action to take with the item the player is holding * This includes both blocks and items (such as flint and steel or records) * When this is set to default, it will be allowed if no action is taken on the interacted block + * * @return the action to take with the item in hand */ public Result useItemInHand() { diff --git a/src/main/java/org/bukkit/event/player/PlayerInventoryEvent.java b/src/main/java/org/bukkit/event/player/PlayerInventoryEvent.java index f75e2b58..b425fe22 100644 --- a/src/main/java/org/bukkit/event/player/PlayerInventoryEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerInventoryEvent.java @@ -6,6 +6,7 @@ import org.bukkit.inventory.Inventory; /** * Represents a player related inventory event */ +@SuppressWarnings("serial") public class PlayerInventoryEvent extends PlayerEvent { protected Inventory inventory; diff --git a/src/main/java/org/bukkit/event/player/PlayerItemHeldEvent.java b/src/main/java/org/bukkit/event/player/PlayerItemHeldEvent.java index 3f5adba9..8a7fad3c 100644 --- a/src/main/java/org/bukkit/event/player/PlayerItemHeldEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerItemHeldEvent.java @@ -5,6 +5,7 @@ import org.bukkit.entity.Player; /** * Fired when a player changes their currently held item */ +@SuppressWarnings("serial") public class PlayerItemHeldEvent extends PlayerEvent { private int previous; private int current; diff --git a/src/main/java/org/bukkit/event/player/PlayerJoinEvent.java b/src/main/java/org/bukkit/event/player/PlayerJoinEvent.java index 179abc2c..a0672940 100644 --- a/src/main/java/org/bukkit/event/player/PlayerJoinEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerJoinEvent.java @@ -5,6 +5,7 @@ import org.bukkit.entity.Player; /** * Called when a player joins a server */ +@SuppressWarnings("serial") public class PlayerJoinEvent extends PlayerEvent { private String joinMessage; diff --git a/src/main/java/org/bukkit/event/player/PlayerKickEvent.java b/src/main/java/org/bukkit/event/player/PlayerKickEvent.java index 927594f3..97559f3e 100644 --- a/src/main/java/org/bukkit/event/player/PlayerKickEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerKickEvent.java @@ -6,6 +6,7 @@ import org.bukkit.event.Cancellable; /** * Called when a player gets kicked from the server */ +@SuppressWarnings("serial") public class PlayerKickEvent extends PlayerEvent implements Cancellable { private String leaveMessage; private String kickReason; diff --git a/src/main/java/org/bukkit/event/player/PlayerLoginEvent.java b/src/main/java/org/bukkit/event/player/PlayerLoginEvent.java index 9ef98aac..2bda0ec3 100644 --- a/src/main/java/org/bukkit/event/player/PlayerLoginEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerLoginEvent.java @@ -5,6 +5,7 @@ import org.bukkit.entity.Player; /** * Stores details for players attempting to log in */ +@SuppressWarnings("serial") public class PlayerLoginEvent extends PlayerEvent { private Result result; private String message; diff --git a/src/main/java/org/bukkit/event/player/PlayerMoveEvent.java b/src/main/java/org/bukkit/event/player/PlayerMoveEvent.java index de421a0b..1de15fb6 100644 --- a/src/main/java/org/bukkit/event/player/PlayerMoveEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerMoveEvent.java @@ -8,6 +8,7 @@ import org.bukkit.event.Event; /** * Holds information for player movement events */ +@SuppressWarnings("serial") public class PlayerMoveEvent extends PlayerEvent implements Cancellable { private boolean cancel = false; private Location from; diff --git a/src/main/java/org/bukkit/event/player/PlayerPickupItemEvent.java b/src/main/java/org/bukkit/event/player/PlayerPickupItemEvent.java index 3148e148..ac1b27b0 100644 --- a/src/main/java/org/bukkit/event/player/PlayerPickupItemEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerPickupItemEvent.java @@ -7,6 +7,7 @@ import org.bukkit.event.Cancellable; /** * Thrown when a player picks an item up from the ground */ +@SuppressWarnings("serial") public class PlayerPickupItemEvent extends PlayerEvent implements Cancellable { private final Item item; private boolean cancel = false; diff --git a/src/main/java/org/bukkit/event/player/PlayerPortalEvent.java b/src/main/java/org/bukkit/event/player/PlayerPortalEvent.java index 01f64362..ad500f4d 100644 --- a/src/main/java/org/bukkit/event/player/PlayerPortalEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerPortalEvent.java @@ -7,6 +7,7 @@ import org.bukkit.entity.Player; /** * Called when a player completes the portaling process by standing in a portal */ +@SuppressWarnings("serial") public class PlayerPortalEvent extends PlayerTeleportEvent { protected boolean useTravelAgent = true; diff --git a/src/main/java/org/bukkit/event/player/PlayerPreLoginEvent.java b/src/main/java/org/bukkit/event/player/PlayerPreLoginEvent.java index ac833e33..cfdc2fc2 100644 --- a/src/main/java/org/bukkit/event/player/PlayerPreLoginEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerPreLoginEvent.java @@ -6,6 +6,7 @@ import org.bukkit.event.Event; /** * Stores details for players attempting to log in */ +@SuppressWarnings("serial") public class PlayerPreLoginEvent extends Event { private Result result; private String message; diff --git a/src/main/java/org/bukkit/event/player/PlayerQuitEvent.java b/src/main/java/org/bukkit/event/player/PlayerQuitEvent.java index fa012ad1..28598e70 100644 --- a/src/main/java/org/bukkit/event/player/PlayerQuitEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerQuitEvent.java @@ -5,6 +5,7 @@ import org.bukkit.entity.Player; /** * Called when a player leaves a server */ +@SuppressWarnings("serial") public class PlayerQuitEvent extends PlayerEvent { private String quitMessage; diff --git a/src/main/java/org/bukkit/event/player/PlayerRespawnEvent.java b/src/main/java/org/bukkit/event/player/PlayerRespawnEvent.java index 819e3798..6b82420d 100644 --- a/src/main/java/org/bukkit/event/player/PlayerRespawnEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerRespawnEvent.java @@ -3,6 +3,7 @@ package org.bukkit.event.player; import org.bukkit.Location; import org.bukkit.entity.Player; +@SuppressWarnings("serial") public class PlayerRespawnEvent extends PlayerEvent { private Location respawnLocation; private boolean isBedSpawn; diff --git a/src/main/java/org/bukkit/event/player/PlayerTeleportEvent.java b/src/main/java/org/bukkit/event/player/PlayerTeleportEvent.java index 667cb33e..468f9e57 100644 --- a/src/main/java/org/bukkit/event/player/PlayerTeleportEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerTeleportEvent.java @@ -7,6 +7,7 @@ import org.bukkit.event.Event; /** * Holds information for player teleport events */ +@SuppressWarnings("serial") public class PlayerTeleportEvent extends PlayerMoveEvent { private TeleportCause cause = TeleportCause.UNKNOWN; @@ -32,6 +33,7 @@ public class PlayerTeleportEvent extends PlayerMoveEvent { /** * Gets the cause of this teleportation event + * * @return Cause of the event */ public TeleportCause getCause() { diff --git a/src/main/java/org/bukkit/event/player/PlayerToggleSneakEvent.java b/src/main/java/org/bukkit/event/player/PlayerToggleSneakEvent.java index 1e645f1c..1c6eb418 100644 --- a/src/main/java/org/bukkit/event/player/PlayerToggleSneakEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerToggleSneakEvent.java @@ -6,6 +6,7 @@ import org.bukkit.event.Cancellable; /** * Called when a player toggles their sneaking state */ +@SuppressWarnings("serial") public class PlayerToggleSneakEvent extends PlayerEvent implements Cancellable { private boolean isSneaking; private boolean cancel = false; diff --git a/src/main/java/org/bukkit/event/player/PlayerToggleSprintEvent.java b/src/main/java/org/bukkit/event/player/PlayerToggleSprintEvent.java index ef86ae48..be8d53fa 100644 --- a/src/main/java/org/bukkit/event/player/PlayerToggleSprintEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerToggleSprintEvent.java @@ -6,6 +6,7 @@ import org.bukkit.event.Cancellable; /** * Called when a player toggles their sprinting state */ +@SuppressWarnings("serial") public class PlayerToggleSprintEvent extends PlayerEvent implements Cancellable { private boolean isSprinting; private boolean cancel = false; diff --git a/src/main/java/org/bukkit/event/player/PlayerVelocityEvent.java b/src/main/java/org/bukkit/event/player/PlayerVelocityEvent.java index f658ec05..45575cf0 100644 --- a/src/main/java/org/bukkit/event/player/PlayerVelocityEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerVelocityEvent.java @@ -5,6 +5,7 @@ import org.bukkit.event.Cancellable; import org.bukkit.event.Event;
import org.bukkit.util.Vector;
+@SuppressWarnings("serial")
public class PlayerVelocityEvent extends PlayerEvent implements Cancellable {
/**
diff --git a/src/main/java/org/bukkit/event/server/MapInitializeEvent.java b/src/main/java/org/bukkit/event/server/MapInitializeEvent.java index 12ef1781..003bff4f 100644 --- a/src/main/java/org/bukkit/event/server/MapInitializeEvent.java +++ b/src/main/java/org/bukkit/event/server/MapInitializeEvent.java @@ -6,17 +6,18 @@ import org.bukkit.map.MapView; /** * Called when a map is initialized. */ +@SuppressWarnings("serial") public class MapInitializeEvent extends ServerEvent { private final MapView mapView; - + public MapInitializeEvent(MapView mapView) { super(Event.Type.MAP_INITIALIZE); this.mapView = mapView; } - + /** * Gets the map initialized in this event. - * + * * @return Map for this event */ public MapView getMap() { diff --git a/src/main/java/org/bukkit/event/server/PluginDisableEvent.java b/src/main/java/org/bukkit/event/server/PluginDisableEvent.java index 6e9a21e1..195c93bf 100644 --- a/src/main/java/org/bukkit/event/server/PluginDisableEvent.java +++ b/src/main/java/org/bukkit/event/server/PluginDisableEvent.java @@ -5,6 +5,7 @@ import org.bukkit.plugin.Plugin; /** * Called when a plugin is disabled. */ +@SuppressWarnings("serial") public class PluginDisableEvent extends PluginEvent { public PluginDisableEvent(Plugin plugin) { super(Type.PLUGIN_DISABLE, plugin); diff --git a/src/main/java/org/bukkit/event/server/PluginEnableEvent.java b/src/main/java/org/bukkit/event/server/PluginEnableEvent.java index f3eaa6eb..089b679e 100644 --- a/src/main/java/org/bukkit/event/server/PluginEnableEvent.java +++ b/src/main/java/org/bukkit/event/server/PluginEnableEvent.java @@ -5,6 +5,7 @@ import org.bukkit.plugin.Plugin; /** * Called when a plugin is enabled. */ +@SuppressWarnings("serial") public class PluginEnableEvent extends PluginEvent { public PluginEnableEvent(Plugin plugin) { super(Type.PLUGIN_ENABLE, plugin); diff --git a/src/main/java/org/bukkit/event/server/PluginEvent.java b/src/main/java/org/bukkit/event/server/PluginEvent.java index 937cf495..13c26195 100644 --- a/src/main/java/org/bukkit/event/server/PluginEvent.java +++ b/src/main/java/org/bukkit/event/server/PluginEvent.java @@ -5,6 +5,7 @@ import org.bukkit.plugin.Plugin; /** * Used for plugin enable and disable events */ +@SuppressWarnings("serial") public class PluginEvent extends ServerEvent { private final Plugin plugin; diff --git a/src/main/java/org/bukkit/event/server/ServerCommandEvent.java b/src/main/java/org/bukkit/event/server/ServerCommandEvent.java index b33044ed..c4c41ba2 100644 --- a/src/main/java/org/bukkit/event/server/ServerCommandEvent.java +++ b/src/main/java/org/bukkit/event/server/ServerCommandEvent.java @@ -6,9 +6,11 @@ import org.bukkit.command.ConsoleCommandSender; /** * Server Command events */ +@SuppressWarnings("serial") public class ServerCommandEvent extends ServerEvent { private String command; private CommandSender sender; + @Deprecated public ServerCommandEvent(ConsoleCommandSender console, String message) { this(Type.SERVER_COMMAND, console, message); @@ -40,6 +42,7 @@ public class ServerCommandEvent extends ServerEvent { /** * Get the command sender. + * * @return The sender */ public CommandSender getSender() { diff --git a/src/main/java/org/bukkit/event/server/ServerEvent.java b/src/main/java/org/bukkit/event/server/ServerEvent.java index 6c2b3749..8c2ed26c 100644 --- a/src/main/java/org/bukkit/event/server/ServerEvent.java +++ b/src/main/java/org/bukkit/event/server/ServerEvent.java @@ -5,6 +5,7 @@ import org.bukkit.event.Event; /** * Miscellaneous server events */ +@SuppressWarnings("serial") public class ServerEvent extends Event { public ServerEvent(final Type type) { super(type); diff --git a/src/main/java/org/bukkit/event/server/ServerListPingEvent.java b/src/main/java/org/bukkit/event/server/ServerListPingEvent.java index ea170e21..d5162faa 100644 --- a/src/main/java/org/bukkit/event/server/ServerListPingEvent.java +++ b/src/main/java/org/bukkit/event/server/ServerListPingEvent.java @@ -7,13 +7,14 @@ import org.bukkit.event.Event; /** * Called when a server list ping is coming in. */ +@SuppressWarnings("serial") public class ServerListPingEvent extends ServerEvent { - + private InetAddress address; private String motd; private int numPlayers; private int maxPlayers; - + public ServerListPingEvent(InetAddress address, String motd, int numPlayers, int maxPlayers) { super(Event.Type.SERVER_LIST_PING); this.address = address; @@ -24,7 +25,7 @@ public class ServerListPingEvent extends ServerEvent { /** * Get the address the ping is coming from. - * + * * @return the address */ public InetAddress getAddress() { @@ -33,7 +34,7 @@ public class ServerListPingEvent extends ServerEvent { /** * Get the message of the day message. - * + * * @return the message of the day */ public String getMotd() { @@ -42,7 +43,7 @@ public class ServerListPingEvent extends ServerEvent { /** * Change the message of the day message. - * + * * @param motd the message of the day */ public void setMotd(String motd) { @@ -51,7 +52,7 @@ public class ServerListPingEvent extends ServerEvent { /** * Get the number of players sent. - * + * * @return the number of players */ public int getNumPlayers() { @@ -60,7 +61,7 @@ public class ServerListPingEvent extends ServerEvent { /** * Get the maximum number of players sent. - * + * * @return the the maximum number of player */ public int getMaxPlayers() { @@ -69,7 +70,7 @@ public class ServerListPingEvent extends ServerEvent { /** * Set the maximum number of players sent. - * + * * @param maxPlayers the maximum number of player */ public void setMaxPlayers(int maxPlayers) { diff --git a/src/main/java/org/bukkit/event/server/ServerListener.java b/src/main/java/org/bukkit/event/server/ServerListener.java index d49b1e0a..24a550a3 100644 --- a/src/main/java/org/bukkit/event/server/ServerListener.java +++ b/src/main/java/org/bukkit/event/server/ServerListener.java @@ -27,17 +27,17 @@ public class ServerListener implements Listener { * @param event Relevant event details */ public void onServerCommand(ServerCommandEvent event) {} - + /** * Called when a map item is initialized (created or loaded into memory) - * + * * @param event Relevant event details */ public void onMapInitialize(MapInitializeEvent event) {} - + /** * Called when a server list ping has come in. - * + * * @param event Relevant event details */ public void onServerListPing(ServerListPingEvent event) {} diff --git a/src/main/java/org/bukkit/event/vehicle/VehicleBlockCollisionEvent.java b/src/main/java/org/bukkit/event/vehicle/VehicleBlockCollisionEvent.java index d29c5ead..5d53ec29 100644 --- a/src/main/java/org/bukkit/event/vehicle/VehicleBlockCollisionEvent.java +++ b/src/main/java/org/bukkit/event/vehicle/VehicleBlockCollisionEvent.java @@ -6,6 +6,7 @@ import org.bukkit.entity.Vehicle; /** * Raised when a vehicle collides with a block. */ +@SuppressWarnings("serial") public class VehicleBlockCollisionEvent extends VehicleCollisionEvent { private Block block; diff --git a/src/main/java/org/bukkit/event/vehicle/VehicleCollisionEvent.java b/src/main/java/org/bukkit/event/vehicle/VehicleCollisionEvent.java index 5eea95c2..526adeef 100644 --- a/src/main/java/org/bukkit/event/vehicle/VehicleCollisionEvent.java +++ b/src/main/java/org/bukkit/event/vehicle/VehicleCollisionEvent.java @@ -5,6 +5,7 @@ import org.bukkit.entity.Vehicle; /** * Raised when a vehicle collides. */ +@SuppressWarnings("serial") public class VehicleCollisionEvent extends VehicleEvent { public VehicleCollisionEvent(Type type, Vehicle vehicle) { super(type, vehicle); diff --git a/src/main/java/org/bukkit/event/vehicle/VehicleCreateEvent.java b/src/main/java/org/bukkit/event/vehicle/VehicleCreateEvent.java index dd0d54ac..f9ea7958 100644 --- a/src/main/java/org/bukkit/event/vehicle/VehicleCreateEvent.java +++ b/src/main/java/org/bukkit/event/vehicle/VehicleCreateEvent.java @@ -5,6 +5,7 @@ import org.bukkit.entity.Vehicle; /** * Raised when a vehicle is created. */ +@SuppressWarnings("serial") public class VehicleCreateEvent extends VehicleEvent { public VehicleCreateEvent(Vehicle vehicle) { super(Type.VEHICLE_CREATE, vehicle); diff --git a/src/main/java/org/bukkit/event/vehicle/VehicleDamageEvent.java b/src/main/java/org/bukkit/event/vehicle/VehicleDamageEvent.java index 6bdb70cb..3811049d 100644 --- a/src/main/java/org/bukkit/event/vehicle/VehicleDamageEvent.java +++ b/src/main/java/org/bukkit/event/vehicle/VehicleDamageEvent.java @@ -7,6 +7,7 @@ import org.bukkit.event.Cancellable; /** * Raised when a vehicle receives damage. */ +@SuppressWarnings("serial") public class VehicleDamageEvent extends VehicleEvent implements Cancellable { private Entity attacker; private int damage; diff --git a/src/main/java/org/bukkit/event/vehicle/VehicleDestroyEvent.java b/src/main/java/org/bukkit/event/vehicle/VehicleDestroyEvent.java index 461f89f2..ac087e34 100644 --- a/src/main/java/org/bukkit/event/vehicle/VehicleDestroyEvent.java +++ b/src/main/java/org/bukkit/event/vehicle/VehicleDestroyEvent.java @@ -9,6 +9,7 @@ import org.bukkit.event.Cancellable; * or the environment. This is not raised if the boat is simply 'removed' * due to other means. */ +@SuppressWarnings("serial") public class VehicleDestroyEvent extends VehicleEvent implements Cancellable { private Entity attacker; private boolean cancelled; diff --git a/src/main/java/org/bukkit/event/vehicle/VehicleEnterEvent.java b/src/main/java/org/bukkit/event/vehicle/VehicleEnterEvent.java index b7600f7f..04b3e069 100644 --- a/src/main/java/org/bukkit/event/vehicle/VehicleEnterEvent.java +++ b/src/main/java/org/bukkit/event/vehicle/VehicleEnterEvent.java @@ -7,6 +7,7 @@ import org.bukkit.event.Cancellable; /** * Raised when an entity enters a vehicle. */ +@SuppressWarnings("serial") public class VehicleEnterEvent extends VehicleEvent implements Cancellable { private boolean cancelled; private Entity entered; diff --git a/src/main/java/org/bukkit/event/vehicle/VehicleEntityCollisionEvent.java b/src/main/java/org/bukkit/event/vehicle/VehicleEntityCollisionEvent.java index a475c99d..a2b285a4 100644 --- a/src/main/java/org/bukkit/event/vehicle/VehicleEntityCollisionEvent.java +++ b/src/main/java/org/bukkit/event/vehicle/VehicleEntityCollisionEvent.java @@ -7,6 +7,7 @@ import org.bukkit.event.Cancellable; /** * Raised when a vehicle collides with an entity. */ +@SuppressWarnings("serial") public class VehicleEntityCollisionEvent extends VehicleCollisionEvent implements Cancellable { private Entity entity; private boolean cancelled = false; diff --git a/src/main/java/org/bukkit/event/vehicle/VehicleEvent.java b/src/main/java/org/bukkit/event/vehicle/VehicleEvent.java index dd271438..5e2a1fd9 100644 --- a/src/main/java/org/bukkit/event/vehicle/VehicleEvent.java +++ b/src/main/java/org/bukkit/event/vehicle/VehicleEvent.java @@ -6,6 +6,7 @@ import org.bukkit.event.Event; /** * Represents a vehicle-related event. */ +@SuppressWarnings("serial") public class VehicleEvent extends Event { protected Vehicle vehicle; diff --git a/src/main/java/org/bukkit/event/vehicle/VehicleExitEvent.java b/src/main/java/org/bukkit/event/vehicle/VehicleExitEvent.java index 909192a2..e6a44e02 100644 --- a/src/main/java/org/bukkit/event/vehicle/VehicleExitEvent.java +++ b/src/main/java/org/bukkit/event/vehicle/VehicleExitEvent.java @@ -7,6 +7,7 @@ import org.bukkit.event.Cancellable; /** * Raised when a living entity exits a vehicle. */ +@SuppressWarnings("serial") public class VehicleExitEvent extends VehicleEvent implements Cancellable { private boolean cancelled; private LivingEntity exited; diff --git a/src/main/java/org/bukkit/event/vehicle/VehicleMoveEvent.java b/src/main/java/org/bukkit/event/vehicle/VehicleMoveEvent.java index 7cea78eb..9365d7be 100644 --- a/src/main/java/org/bukkit/event/vehicle/VehicleMoveEvent.java +++ b/src/main/java/org/bukkit/event/vehicle/VehicleMoveEvent.java @@ -6,6 +6,7 @@ import org.bukkit.entity.Vehicle; /** * Raised when a vehicle moves. */ +@SuppressWarnings("serial") public class VehicleMoveEvent extends VehicleEvent { private Location from; private Location to; diff --git a/src/main/java/org/bukkit/event/vehicle/VehicleUpdateEvent.java b/src/main/java/org/bukkit/event/vehicle/VehicleUpdateEvent.java index 814e14e9..5fc193f3 100644 --- a/src/main/java/org/bukkit/event/vehicle/VehicleUpdateEvent.java +++ b/src/main/java/org/bukkit/event/vehicle/VehicleUpdateEvent.java @@ -2,6 +2,7 @@ package org.bukkit.event.vehicle; import org.bukkit.entity.Vehicle; +@SuppressWarnings("serial") public class VehicleUpdateEvent extends VehicleEvent { public VehicleUpdateEvent(Vehicle vehicle) { super(Type.VEHICLE_UPDATE, vehicle); diff --git a/src/main/java/org/bukkit/event/weather/LightningStrikeEvent.java b/src/main/java/org/bukkit/event/weather/LightningStrikeEvent.java index cced3ef7..2bcd37a0 100644 --- a/src/main/java/org/bukkit/event/weather/LightningStrikeEvent.java +++ b/src/main/java/org/bukkit/event/weather/LightningStrikeEvent.java @@ -7,6 +7,7 @@ import org.bukkit.event.Cancellable; /** * Stores data for lightning striking */ +@SuppressWarnings("serial") public class LightningStrikeEvent extends WeatherEvent implements Cancellable { private boolean canceled; diff --git a/src/main/java/org/bukkit/event/weather/ThunderChangeEvent.java b/src/main/java/org/bukkit/event/weather/ThunderChangeEvent.java index c53f7ff4..89153766 100644 --- a/src/main/java/org/bukkit/event/weather/ThunderChangeEvent.java +++ b/src/main/java/org/bukkit/event/weather/ThunderChangeEvent.java @@ -6,6 +6,7 @@ import org.bukkit.event.Cancellable; /** * Stores data for thunder state changing in a world */ +@SuppressWarnings("serial") public class ThunderChangeEvent extends WeatherEvent implements Cancellable { private boolean canceled; diff --git a/src/main/java/org/bukkit/event/weather/WeatherChangeEvent.java b/src/main/java/org/bukkit/event/weather/WeatherChangeEvent.java index f6e9e2ec..955be2ee 100644 --- a/src/main/java/org/bukkit/event/weather/WeatherChangeEvent.java +++ b/src/main/java/org/bukkit/event/weather/WeatherChangeEvent.java @@ -6,6 +6,7 @@ import org.bukkit.event.Cancellable; /** * Stores data for weather changing in a world */ +@SuppressWarnings("serial") public class WeatherChangeEvent extends WeatherEvent implements Cancellable { private boolean canceled; diff --git a/src/main/java/org/bukkit/event/weather/WeatherEvent.java b/src/main/java/org/bukkit/event/weather/WeatherEvent.java index 8c78f86c..5036a3e0 100644 --- a/src/main/java/org/bukkit/event/weather/WeatherEvent.java +++ b/src/main/java/org/bukkit/event/weather/WeatherEvent.java @@ -6,6 +6,7 @@ import org.bukkit.event.Event; /** * Represents a Weather-related event */ +@SuppressWarnings("serial") public class WeatherEvent extends Event { protected World world; diff --git a/src/main/java/org/bukkit/event/world/ChunkEvent.java b/src/main/java/org/bukkit/event/world/ChunkEvent.java index 3e789b73..c36fe670 100644 --- a/src/main/java/org/bukkit/event/world/ChunkEvent.java +++ b/src/main/java/org/bukkit/event/world/ChunkEvent.java @@ -5,6 +5,7 @@ import org.bukkit.Chunk; /** * Represents a Chunk related event */ +@SuppressWarnings("serial") public class ChunkEvent extends WorldEvent { protected Chunk chunk; diff --git a/src/main/java/org/bukkit/event/world/ChunkLoadEvent.java b/src/main/java/org/bukkit/event/world/ChunkLoadEvent.java index 9eb6cc42..870de349 100644 --- a/src/main/java/org/bukkit/event/world/ChunkLoadEvent.java +++ b/src/main/java/org/bukkit/event/world/ChunkLoadEvent.java @@ -5,6 +5,7 @@ import org.bukkit.Chunk; /** * Called when a chunk is loaded */ +@SuppressWarnings("serial") public class ChunkLoadEvent extends ChunkEvent { private final boolean newChunk; diff --git a/src/main/java/org/bukkit/event/world/ChunkPopulateEvent.java b/src/main/java/org/bukkit/event/world/ChunkPopulateEvent.java index aa10a63b..02affec2 100644 --- a/src/main/java/org/bukkit/event/world/ChunkPopulateEvent.java +++ b/src/main/java/org/bukkit/event/world/ChunkPopulateEvent.java @@ -8,6 +8,7 @@ import org.bukkit.generator.BlockPopulator; * * If your intent is to populate the chunk using this event, please see {@link BlockPopulator} */ +@SuppressWarnings("serial") public class ChunkPopulateEvent extends ChunkEvent { public ChunkPopulateEvent(final Chunk chunk) { super(Type.CHUNK_POPULATED, chunk); diff --git a/src/main/java/org/bukkit/event/world/ChunkUnloadEvent.java b/src/main/java/org/bukkit/event/world/ChunkUnloadEvent.java index dd030eb6..8c4e7667 100644 --- a/src/main/java/org/bukkit/event/world/ChunkUnloadEvent.java +++ b/src/main/java/org/bukkit/event/world/ChunkUnloadEvent.java @@ -6,6 +6,7 @@ import org.bukkit.event.Cancellable; /** * Called when a chunk is unloaded */ +@SuppressWarnings("serial") public class ChunkUnloadEvent extends ChunkEvent implements Cancellable { private boolean cancel = false; diff --git a/src/main/java/org/bukkit/event/world/PortalCreateEvent.java b/src/main/java/org/bukkit/event/world/PortalCreateEvent.java index 8a04128a..26f35735 100644 --- a/src/main/java/org/bukkit/event/world/PortalCreateEvent.java +++ b/src/main/java/org/bukkit/event/world/PortalCreateEvent.java @@ -9,6 +9,7 @@ import java.util.Collection; /** * Called when the world attempts to create a matching end to a portal */ +@SuppressWarnings("serial") public class PortalCreateEvent extends WorldEvent implements Cancellable { private boolean cancel = false; private ArrayList<Block> blocks = new ArrayList<Block>(); diff --git a/src/main/java/org/bukkit/event/world/SpawnChangeEvent.java b/src/main/java/org/bukkit/event/world/SpawnChangeEvent.java index 10576b01..4ea14dc6 100644 --- a/src/main/java/org/bukkit/event/world/SpawnChangeEvent.java +++ b/src/main/java/org/bukkit/event/world/SpawnChangeEvent.java @@ -7,6 +7,7 @@ import org.bukkit.Location; * An event that is called when a world's spawn changes. The * world's previous spawn location is included. */ +@SuppressWarnings("serial") public class SpawnChangeEvent extends WorldEvent { private Location previousLocation; diff --git a/src/main/java/org/bukkit/event/world/StructureGrowEvent.java b/src/main/java/org/bukkit/event/world/StructureGrowEvent.java index 7743ae9d..b3e33822 100644 --- a/src/main/java/org/bukkit/event/world/StructureGrowEvent.java +++ b/src/main/java/org/bukkit/event/world/StructureGrowEvent.java @@ -47,7 +47,7 @@ public class StructureGrowEvent extends WorldEvent implements Cancellable { } /** - * Checks if structure was grown using bonemeal. + * Checks if structure was grown using bonemeal. * * @return True if the structure was grown using bonemeal. */ diff --git a/src/main/java/org/bukkit/event/world/WorldEvent.java b/src/main/java/org/bukkit/event/world/WorldEvent.java index 5f42fb76..e822dae4 100644 --- a/src/main/java/org/bukkit/event/world/WorldEvent.java +++ b/src/main/java/org/bukkit/event/world/WorldEvent.java @@ -6,6 +6,7 @@ import org.bukkit.event.Event; /** * Represents events within a world */ +@SuppressWarnings("serial") public class WorldEvent extends Event { private final World world; diff --git a/src/main/java/org/bukkit/event/world/WorldInitEvent.java b/src/main/java/org/bukkit/event/world/WorldInitEvent.java index e14e05b1..79fbcd33 100644 --- a/src/main/java/org/bukkit/event/world/WorldInitEvent.java +++ b/src/main/java/org/bukkit/event/world/WorldInitEvent.java @@ -5,6 +5,7 @@ import org.bukkit.World; /** * Called when a World is initializing */ +@SuppressWarnings("serial") public class WorldInitEvent extends WorldEvent { public WorldInitEvent(World world) { super(Type.WORLD_INIT, world); diff --git a/src/main/java/org/bukkit/event/world/WorldLoadEvent.java b/src/main/java/org/bukkit/event/world/WorldLoadEvent.java index 7214ae04..3519d338 100644 --- a/src/main/java/org/bukkit/event/world/WorldLoadEvent.java +++ b/src/main/java/org/bukkit/event/world/WorldLoadEvent.java @@ -5,6 +5,7 @@ import org.bukkit.World; /** * Called when a World is loaded */ +@SuppressWarnings("serial") public class WorldLoadEvent extends WorldEvent { public WorldLoadEvent(World world) { super(Type.WORLD_LOAD, world); diff --git a/src/main/java/org/bukkit/event/world/WorldSaveEvent.java b/src/main/java/org/bukkit/event/world/WorldSaveEvent.java index fec1e002..414bd296 100644 --- a/src/main/java/org/bukkit/event/world/WorldSaveEvent.java +++ b/src/main/java/org/bukkit/event/world/WorldSaveEvent.java @@ -2,6 +2,7 @@ package org.bukkit.event.world; import org.bukkit.World; +@SuppressWarnings("serial") public class WorldSaveEvent extends WorldEvent { public WorldSaveEvent(World world) { super(Type.WORLD_SAVE, world); diff --git a/src/main/java/org/bukkit/event/world/WorldUnloadEvent.java b/src/main/java/org/bukkit/event/world/WorldUnloadEvent.java index 30c0f15a..821d6ef7 100644 --- a/src/main/java/org/bukkit/event/world/WorldUnloadEvent.java +++ b/src/main/java/org/bukkit/event/world/WorldUnloadEvent.java @@ -6,6 +6,7 @@ import org.bukkit.event.Cancellable; /** * Called when a World is unloaded */ +@SuppressWarnings("serial") public class WorldUnloadEvent extends WorldEvent implements Cancellable { private boolean isCancelled; diff --git a/src/main/java/org/bukkit/generator/ChunkGenerator.java b/src/main/java/org/bukkit/generator/ChunkGenerator.java index be630927..fda6a83f 100644 --- a/src/main/java/org/bukkit/generator/ChunkGenerator.java +++ b/src/main/java/org/bukkit/generator/ChunkGenerator.java @@ -17,10 +17,11 @@ public abstract class ChunkGenerator { * Shapes the chunk for the given coordinates.<br /> * <br /> * This method should return a byte[32768] in the following format: + * * <pre> - * for (int x = 0; x < 16; x++) { - * for (int z = 0; z < 16; z++) { - * for (int y = 0; y < 128; y++) { + * for (int x = 0; x < 16; x++) { + * for (int z = 0; z < 16; z++) { + * for (int y = 0; y < 128; y++) { * // result[(x * 16 + z) * 128 + y] = ??; * } * } @@ -50,16 +51,13 @@ public abstract class ChunkGenerator { Block highest = world.getBlockAt(x, world.getHighestBlockYAt(x, z), z); switch (world.getEnvironment()) { - case NETHER: - return true; - case THE_END: - return highest.getType() != Material.AIR - && highest.getType() != Material.WATER - && highest.getType() != Material.LAVA; - case NORMAL: - default: - return highest.getType() == Material.SAND - || highest.getType() == Material.GRAVEL; + case NETHER: + return true; + case THE_END: + return highest.getType() != Material.AIR && highest.getType() != Material.WATER && highest.getType() != Material.LAVA; + case NORMAL: + default: + return highest.getType() == Material.SAND || highest.getType() == Material.GRAVEL; } } diff --git a/src/main/java/org/bukkit/inventory/FurnaceRecipe.java b/src/main/java/org/bukkit/inventory/FurnaceRecipe.java index adff8e27..fe45e705 100644 --- a/src/main/java/org/bukkit/inventory/FurnaceRecipe.java +++ b/src/main/java/org/bukkit/inventory/FurnaceRecipe.java @@ -12,6 +12,7 @@ public class FurnaceRecipe implements Recipe { /** * Create a furnace recipe to craft the specified ItemStack. + * * @param result The item you want the recipe to create. * @param source The input material. */ @@ -24,6 +25,7 @@ public class FurnaceRecipe implements Recipe { /** * Create a furnace recipe to craft the specified ItemStack. + * * @param result The item you want the recipe to create. * @param source The input material. */ @@ -34,6 +36,7 @@ public class FurnaceRecipe implements Recipe { /** * Sets the input of this furnace recipe. + * * @param input The input material. * @return The changed recipe, so you can chain calls. */ @@ -44,6 +47,7 @@ public class FurnaceRecipe implements Recipe { /** * Sets the input of this furnace recipe. + * * @param input The input material. * @return The changed recipe, so you can chain calls. */ @@ -57,6 +61,7 @@ public class FurnaceRecipe implements Recipe { /** * Get the input material. + * * @return The input material. */ public MaterialData getInput() { @@ -65,6 +70,7 @@ public class FurnaceRecipe implements Recipe { /** * Get the result of this recipe. + * * @return The resulting stack. */ public ItemStack getResult() { diff --git a/src/main/java/org/bukkit/inventory/ItemStack.java b/src/main/java/org/bukkit/inventory/ItemStack.java index 73316827..87cd9ca6 100644 --- a/src/main/java/org/bukkit/inventory/ItemStack.java +++ b/src/main/java/org/bukkit/inventory/ItemStack.java @@ -349,16 +349,16 @@ public class ItemStack implements ConfigurationSerializable { } public static ItemStack deserialize(Map<String, Object> args) { - Material type = Material.getMaterial((String)args.get("type")); + Material type = Material.getMaterial((String) args.get("type")); short damage = 0; int amount = 1; if (args.containsKey("damage")) { - damage = (Short)args.get("damage"); + damage = (Short) args.get("damage"); } if (args.containsKey("amount")) { - amount = (Integer)args.get("amount"); + amount = (Integer) args.get("amount"); } ItemStack result = new ItemStack(type, amount, damage); @@ -367,13 +367,14 @@ public class ItemStack implements ConfigurationSerializable { Object raw = args.get("enchantments"); if (raw instanceof Map) { - Map<Object, Object> map = (Map<Object, Object>)raw; + @SuppressWarnings("unchecked") + Map<Object, Object> map = (Map<Object, Object>) raw; for (Map.Entry<Object, Object> entry : map.entrySet()) { Enchantment enchantment = Enchantment.getByName(entry.getKey().toString()); if ((enchantment != null) && (entry.getValue() instanceof Integer)) { - result.addEnchantment(enchantment, (Integer)entry.getValue()); + result.addEnchantment(enchantment, (Integer) entry.getValue()); } } } diff --git a/src/main/java/org/bukkit/inventory/PlayerInventory.java b/src/main/java/org/bukkit/inventory/PlayerInventory.java index db655bce..e5f797a0 100644 --- a/src/main/java/org/bukkit/inventory/PlayerInventory.java +++ b/src/main/java/org/bukkit/inventory/PlayerInventory.java @@ -43,7 +43,7 @@ public interface PlayerInventory extends Inventory { /** * Put the given ItemStacks into the armor slots * - * @param items The ItemStacks to use as armour + * @param items The ItemStacks to use as armour */ public void setArmorContents(ItemStack[] items); diff --git a/src/main/java/org/bukkit/inventory/Recipe.java b/src/main/java/org/bukkit/inventory/Recipe.java index 7a019853..7977ce2d 100644 --- a/src/main/java/org/bukkit/inventory/Recipe.java +++ b/src/main/java/org/bukkit/inventory/Recipe.java @@ -7,6 +7,7 @@ public interface Recipe { /** * Get the result of this recipe. + * * @return The result stack */ ItemStack getResult(); diff --git a/src/main/java/org/bukkit/inventory/ShapedRecipe.java b/src/main/java/org/bukkit/inventory/ShapedRecipe.java index 9df52a87..d099ca5b 100644 --- a/src/main/java/org/bukkit/inventory/ShapedRecipe.java +++ b/src/main/java/org/bukkit/inventory/ShapedRecipe.java @@ -16,6 +16,7 @@ public class ShapedRecipe implements Recipe { /** * Create a shaped recipe to craft the specified ItemStack. The constructor merely determines the * result and type; to set the actual recipe, you'll need to call the appropriate methods. + * * @param result The item you want the recipe to create. * @see ShapedRecipe#shape(String...) * @see ShapedRecipe#setIngredient(char, Material) @@ -29,6 +30,7 @@ public class ShapedRecipe implements Recipe { /** * Set the shape of this recipe to the specified rows. Each character represents a different * ingredient; exactly what each character represents is set separately. + * * @param shape The rows of the recipe (up to 3 rows). * @return The changed recipe, so you can chain calls. */ @@ -57,6 +59,7 @@ public class ShapedRecipe implements Recipe { /** * Sets the material that a character in the recipe shape refers to. + * * @param key The character that represents the ingredient in the shape. * @param ingredient The ingredient. * @return The changed recipe, so you can chain calls. @@ -71,6 +74,7 @@ public class ShapedRecipe implements Recipe { /** * Sets the material that a character in the recipe shape refers to. + * * @param key The character that represents the ingredient in the shape. * @param ingredient The ingredient. * @return The changed recipe, so you can chain calls. @@ -81,6 +85,7 @@ public class ShapedRecipe implements Recipe { /** * Sets the material that a character in the recipe shape refers to. + * * @param key The character that represents the ingredient in the shape. * @param ingredient The ingredient. * @param raw The raw material data as an integer. @@ -108,6 +113,7 @@ public class ShapedRecipe implements Recipe { /** * Get the ingredients map. + * * @return The mapping of character to ingredients. */ public HashMap<Character, MaterialData> getIngredientMap() { @@ -116,6 +122,7 @@ public class ShapedRecipe implements Recipe { /** * Get the shape. + * * @return The recipe's shape. */ public String[] getShape() { @@ -124,6 +131,7 @@ public class ShapedRecipe implements Recipe { /** * Get the result. + * * @return The result stack. */ public ItemStack getResult() { diff --git a/src/main/java/org/bukkit/inventory/ShapelessRecipe.java b/src/main/java/org/bukkit/inventory/ShapelessRecipe.java index 4cb92668..1ed559e8 100644 --- a/src/main/java/org/bukkit/inventory/ShapelessRecipe.java +++ b/src/main/java/org/bukkit/inventory/ShapelessRecipe.java @@ -16,6 +16,7 @@ public class ShapelessRecipe implements Recipe { /** * Create a shapeless recipe to craft the specified ItemStack. The constructor merely determines the * result and type; to set the actual recipe, you'll need to call the appropriate methods. + * * @param result The item you want the recipe to create. * @see ShapelessRecipe#addIngredient(Material) * @see ShapelessRecipe#addIngredient(MaterialData) @@ -26,6 +27,7 @@ public class ShapelessRecipe implements Recipe { /** * Adds the specified ingredient. + * * @param ingredient The ingredient to add. * @return The changed recipe, so you can chain calls. */ @@ -35,6 +37,7 @@ public class ShapelessRecipe implements Recipe { /** * Adds the specified ingredient. + * * @param ingredient The ingredient to add. * @return The changed recipe, so you can chain calls. */ @@ -44,6 +47,7 @@ public class ShapelessRecipe implements Recipe { /** * Adds the specified ingredient. + * * @param ingredient The ingredient to add. * @param rawdata The data value. * @return The changed recipe, so you can chain calls. @@ -54,6 +58,7 @@ public class ShapelessRecipe implements Recipe { /** * Adds multiples of the specified ingredient. + * * @param count How many to add (can't be more than 9!) * @param ingredient The ingredient to add. * @return The changed recipe, so you can chain calls. @@ -70,6 +75,7 @@ public class ShapelessRecipe implements Recipe { /** * Adds multiples of the specified ingredient. + * * @param count How many to add (can't be more than 9!) * @param ingredient The ingredient to add. * @return The changed recipe, so you can chain calls. @@ -80,6 +86,7 @@ public class ShapelessRecipe implements Recipe { /** * Adds multiples of the specified ingredient. + * * @param count How many to add (can't be more than 9!) * @param ingredient The ingredient to add. * @param rawdata The data value. @@ -97,6 +104,7 @@ public class ShapelessRecipe implements Recipe { /** * Removes an ingredient from the list. If the ingredient occurs multiple times, * only one instance of it is removed. + * * @param ingredient The ingredient to remove * @return The changed recipe. */ @@ -107,6 +115,7 @@ public class ShapelessRecipe implements Recipe { /** * Get the result of this recipe. + * * @return The result stack. */ public ItemStack getResult() { @@ -115,6 +124,7 @@ public class ShapelessRecipe implements Recipe { /** * Get the list of ingredients used for this recipe. + * * @return The input list */ public ArrayList<MaterialData> getIngredientList() { diff --git a/src/main/java/org/bukkit/map/MapCanvas.java b/src/main/java/org/bukkit/map/MapCanvas.java index 1681366a..f75e2093 100644 --- a/src/main/java/org/bukkit/map/MapCanvas.java +++ b/src/main/java/org/bukkit/map/MapCanvas.java @@ -7,69 +7,77 @@ import java.awt.Image; * specific {@link MapRenderer} and represents that renderer's layer on the map. */ public interface MapCanvas { - + /** * Get the map this canvas is attached to. + * * @return The MapView this canvas is attached to. */ public MapView getMapView(); - + /** * Get the cursor collection associated with this canvas. + * * @return The MapCursorCollection associated with this canvas. */ public MapCursorCollection getCursors(); - + /** * Set the cursor collection associated with this canvas. This does not * usually need to be called since a MapCursorCollection is already * provided. + * * @param cursors The MapCursorCollection to associate with this canvas. */ public void setCursors(MapCursorCollection cursors); - + /** * Draw a pixel to the canvas. + * * @param x The x coordinate, from 0 to 127. * @param y The y coordinate, from 0 to 127. * @param color The color. See {@link MapPalette}. */ public void setPixel(int x, int y, byte color); - + /** * Get a pixel from the canvas. + * * @param x The x coordinate, from 0 to 127. * @param y The y coordinate, from 0 to 127. * @return The color. See {@link MapPalette}. */ public byte getPixel(int x, int y); - + /** * Get a pixel from the layers below this canvas. - * @param x The x coordinate, from 0 to 127. + * + * @param x The x coordinate, from 0 to 127. * @param y The y coordinate, from 0 to 127. * @return The color. See {@link MapPalette}. */ public byte getBasePixel(int x, int y); - + /** * Draw an image to the map. The image will be clipped if necessary. + * * @param x The x coordinate of the image. * @param y The y coordinate of the image. * @param image The Image to draw. */ public void drawImage(int x, int y, Image image); - + /** * Render text to the map using fancy formatting. Newline (\n) characters * will move down one line and return to the original column, and the text * color can be changed using sequences such as "§12;", replacing 12 with * the palette index of the color (see {@link MapPalette}). + * * @param x The column to start rendering on. * @param y The row to start rendering on. * @param font The font to use. * @param text The formatted text to render. */ public void drawText(int x, int y, MapFont font, String text); - + } diff --git a/src/main/java/org/bukkit/map/MapCursor.java b/src/main/java/org/bukkit/map/MapCursor.java index 957db93b..6ef06597 100644 --- a/src/main/java/org/bukkit/map/MapCursor.java +++ b/src/main/java/org/bukkit/map/MapCursor.java @@ -4,13 +4,14 @@ package org.bukkit.map; * Represents a cursor on a map. */ public final class MapCursor { - + private byte x, y; private byte direction, type; private boolean visible; /** * Initialize the map cursor. + * * @param x The x coordinate, from -128 to 127. * @param y The y coordinate, from -128 to 127. * @param direction The facing of the cursor, from 0 to 15. @@ -24,73 +25,82 @@ public final class MapCursor { setRawType(type); this.visible = visible; } - + /** * Get the X position of this cursor. + * * @return The X coordinate. */ public byte getX() { return x; } - + /** * Get the Y position of this cursor. + * * @return The Y coordinate. */ public byte getY() { return y; } - + /** * Get the direction of this cursor. + * * @return The facing of the cursor, from 0 to 15. */ public byte getDirection() { return direction; } - + /** * Get the type of this cursor. + * * @return The type (color/style) of the map cursor. */ public Type getType() { return Type.byValue(type); } - + /** * Get the type of this cursor. + * * @return The type (color/style) of the map cursor. */ public byte getRawType() { return type; } - + /** * Get the visibility status of this cursor. + * * @return True if visible, false otherwise. */ public boolean isVisible() { return visible; } - + /** * Set the X position of this cursor. + * * @param x The X coordinate. */ public void setX(byte x) { this.x = x; } - + /** * Set the Y position of this cursor. + * * @param y The Y coordinate. */ public void setY(byte y) { this.y = y; } - + /** * Set the direction of this cursor. + * * @param direction The facing of the cursor, from 0 to 15. */ public void setDirection(byte direction) { @@ -99,17 +109,19 @@ public final class MapCursor { } this.direction = direction; } - + /** * Set the type of this cursor. + * * @param type The type (color/style) of the map cursor. */ public void setType(Type type) { setRawType(type.value); } - + /** * Set the type of this cursor. + * * @param type The type (color/style) of the map cursor. */ public void setRawType(byte type) { @@ -118,17 +130,18 @@ public final class MapCursor { } this.type = type; } - + /** * Set the visibility status of this cursor. + * * @param visible True if visible. */ public void setVisible(boolean visible) { this.visible = visible; } - + /** - * Represents the standard types of map cursors. More may be made available + * Represents the standard types of map cursors. More may be made available * by texture packs - the value is used by the client as an index in the * file './misc/mapicons.png' from minecraft.jar or from a texture pack. */ @@ -138,17 +151,17 @@ public final class MapCursor { RED_POINTER(2), BLUE_POINTER(3), WHITE_CROSS(4); - + private byte value; - + private Type(int value) { this.value = (byte) value; } - + public byte getValue() { return value; } - + public static Type byValue(byte value) { for (Type t : values()) { if (t.value == value) return t; @@ -156,5 +169,5 @@ public final class MapCursor { return null; } } - + } diff --git a/src/main/java/org/bukkit/map/MapCursorCollection.java b/src/main/java/org/bukkit/map/MapCursorCollection.java index ac5d3e30..1e234a14 100644 --- a/src/main/java/org/bukkit/map/MapCursorCollection.java +++ b/src/main/java/org/bukkit/map/MapCursorCollection.java @@ -8,37 +8,41 @@ import java.util.List; * MapCursorCollection is linked to a specific {@link MapRenderer}. */ public final class MapCursorCollection { - + private List<MapCursor> cursors = new ArrayList<MapCursor>(); - + /** * Get the amount of cursors in this collection. + * * @return The size of this collection. */ public int size() { return cursors.size(); } - + /** * Get a cursor from this collection. + * * @param index The index of the cursor. * @return The MapCursor. */ public MapCursor getCursor(int index) { return cursors.get(index); } - + /** * Remove a cursor from the collection. + * * @param cursor The MapCursor to remove. * @return Whether the cursor was removed successfully. */ public boolean removeCursor(MapCursor cursor) { return cursors.remove(cursor); } - + /** * Add a cursor to the collection. + * * @param cursor The MapCursor to add. * @return The MapCursor that was passed. */ @@ -46,9 +50,10 @@ public final class MapCursorCollection { cursors.add(cursor); return cursor; } - + /** * Add a cursor to the collection. + * * @param x The x coordinate, from -128 to 127. * @param y The y coordinate, from -128 to 127. * @param direction The facing of the cursor, from 0 to 15. @@ -57,9 +62,10 @@ public final class MapCursorCollection { public MapCursor addCursor(int x, int y, byte direction) { return addCursor(x, y, direction, (byte) 0, true); } - + /** * Add a cursor to the collection. + * * @param x The x coordinate, from -128 to 127. * @param y The y coordinate, from -128 to 127. * @param direction The facing of the cursor, from 0 to 15. @@ -69,9 +75,10 @@ public final class MapCursorCollection { public MapCursor addCursor(int x, int y, byte direction, byte type) { return addCursor(x, y, direction, type, true); } - + /** * Add a cursor to the collection. + * * @param x The x coordinate, from -128 to 127. * @param y The y coordinate, from -128 to 127. * @param direction The facing of the cursor, from 0 to 15. @@ -82,5 +89,5 @@ public final class MapCursorCollection { public MapCursor addCursor(int x, int y, byte direction, byte type, boolean visible) { return addCursor(new MapCursor((byte) x, (byte) y, direction, type, visible)); } - + } diff --git a/src/main/java/org/bukkit/map/MapFont.java b/src/main/java/org/bukkit/map/MapFont.java index 6d38d525..a6016ffc 100644 --- a/src/main/java/org/bukkit/map/MapFont.java +++ b/src/main/java/org/bukkit/map/MapFont.java @@ -6,13 +6,14 @@ import java.util.HashMap; * Represents a bitmap font drawable to a map. */ public class MapFont { - + private final HashMap<Character, CharacterSprite> chars = new HashMap<Character, CharacterSprite>(); private int height = 0; protected boolean malleable = true; - + /** * Set the sprite for a given character. + * * @param ch The character to set the sprite for. * @param sprite The CharacterSprite to set. * @throws IllegalStateException if this font is static. @@ -21,24 +22,26 @@ public class MapFont { if (!malleable) { throw new IllegalStateException("this font is not malleable"); } - + chars.put(ch, sprite); if (sprite.getHeight() > height) { height = sprite.getHeight(); } } - + /** * Get the sprite for a given character. + * * @param ch The character to get the sprite for. * @return The CharacterSprite associated with the character, or null if there is none. */ public CharacterSprite getChar(char ch) { return chars.get(ch); } - + /** * Get the width of the given text as it would be rendered using this font. + * * @param text The text. * @return The width in pixels. */ @@ -46,24 +49,26 @@ public class MapFont { if (!isValid(text)) { throw new IllegalArgumentException("text contains invalid characters"); } - + int result = 0; for (int i = 0; i < text.length(); ++i) { result += chars.get(text.charAt(i)).getWidth(); } return result; } - + /** * Get the height of this font. + * * @return The height of the font. */ public int getHeight() { return height; } - + /** * Check whether the given text is valid. + * * @param text The text. * @return True if the string contains only defined characters, false otherwise. */ @@ -75,28 +80,29 @@ public class MapFont { } return true; } - + /** * Represents the graphics for a single character in a MapFont. */ public static class CharacterSprite { - + private final int width; private final int height; private final boolean[] data; - + public CharacterSprite(int width, int height, boolean[] data) { this.width = width; this.height = height; this.data = data; - + if (data.length != width * height) { throw new IllegalArgumentException("size of data does not match dimensions"); } } - + /** * Get the value of a pixel of the character. + * * @param row The row, in the range [0,8). * @param col The column, in the range [0,8). * @return True if the pixel is solid, false if transparent. @@ -105,23 +111,25 @@ public class MapFont { if (row < 0 || col < 0 || row >= height || col >= width) return false; return data[row * width + col]; } - + /** * Get the width of the character sprite. + * * @return The width of the character. */ public int getWidth() { return width; } - + /** * Get the height of the character sprite. + * * @return The height of the character. */ public int getHeight() { return height; } - + } - + } diff --git a/src/main/java/org/bukkit/map/MapPalette.java b/src/main/java/org/bukkit/map/MapPalette.java index dcc254ea..b9935b7d 100644 --- a/src/main/java/org/bukkit/map/MapPalette.java +++ b/src/main/java/org/bukkit/map/MapPalette.java @@ -9,15 +9,14 @@ import java.awt.image.BufferedImage; * Represents the palette that map items use. */ public final class MapPalette { - + // Internal mechanisms - private MapPalette() {} - + private static Color c(int r, int g, int b) { return new Color(r, g, b); } - + private static double getDistance(Color c1, Color c2) { double rmean = (c1.getRed() + c2.getRed()) / 2.0; double r = c1.getRed() - c2.getRed(); @@ -28,7 +27,7 @@ public final class MapPalette { double weightB = 2 + (255 - rmean) / 256.0; return weightR * r * r + weightG * g * g + weightB * b * b; } - + private static final Color[] colors = { new Color(0, 0, 0, 0), new Color(0, 0, 0, 0), new Color(0, 0, 0, 0), new Color(0, 0, 0, 0), @@ -46,9 +45,8 @@ public final class MapPalette { c(45,45,180), c(55,55,220), c(64,64,255), c(55,55,220), c(73,58,35), c(89,71,43), c(104,83,50), c(89,71,43) }; - + // Interface - /** * The base color ranges. Each entry corresponds to four colors of varying * shades with values entry to entry + 3. @@ -67,8 +65,10 @@ public final class MapPalette { public static final byte DARK_GRAY = 44; public static final byte BLUE = 48; public static final byte DARK_BROWN = 52; + /** * Resize an image to 128x128. + * * @param image The image to resize. * @return The resized image. */ @@ -82,6 +82,7 @@ public final class MapPalette { /** * Convert an Image to a byte[] using the palette. + * * @param image The image to convert. * @return A byte[] containing the pixels of the image. */ @@ -90,10 +91,10 @@ public final class MapPalette { Graphics2D graphics = temp.createGraphics(); graphics.drawImage(image, 0, 0, null); graphics.dispose(); - + int[] pixels = new int[temp.getWidth() * temp.getHeight()]; temp.getRGB(0, 0, temp.getWidth(), temp.getHeight(), pixels, 0, temp.getWidth()); - + byte[] result = new byte[temp.getWidth() * temp.getHeight()]; for (int i = 0; i < pixels.length; i++) { result[i] = matchColor(new Color(pixels[i])); @@ -103,6 +104,7 @@ public final class MapPalette { /** * Get the index of the closest matching color in the palette to the given color. + * * @param r The red component of the color. * @param b The blue component of the color. * @param g The green component of the color. @@ -111,18 +113,19 @@ public final class MapPalette { public static byte matchColor(int r, int g, int b) { return matchColor(new Color(r, g, b)); } - + /** * Get the index of the closest matching color in the palette to the given color. + * * @param color The Color to match. * @return The index in the palette. */ public static byte matchColor(Color color) { if (color.getAlpha() < 128) return 0; - + int index = 0; double best = -1; - + for (int i = 4; i < colors.length; i++) { double distance = getDistance(color, colors[i]); if (distance < best || best == -1) { @@ -133,9 +136,10 @@ public final class MapPalette { return (byte) index; } - + /** * Get the value of the given color in the palette. + * * @param index The index in the palette. * @return The Color of the palette entry. */ @@ -146,5 +150,5 @@ public final class MapPalette { return colors[index]; } } - + } diff --git a/src/main/java/org/bukkit/map/MapRenderer.java b/src/main/java/org/bukkit/map/MapRenderer.java index 2c1d00a6..342c9f8b 100644 --- a/src/main/java/org/bukkit/map/MapRenderer.java +++ b/src/main/java/org/bukkit/map/MapRenderer.java @@ -6,45 +6,49 @@ import org.bukkit.entity.Player; * Represents a renderer for a map. */ public abstract class MapRenderer { - + private boolean contextual; - + /** * Initialize the map renderer base to be non-contextual. See {@link #isContextual()}. */ public MapRenderer() { this(false); } - + /** * Initialize the map renderer base with the given contextual status. + * * @param contextual Whether the renderer is contextual. See {@link #isContextual()}. */ public MapRenderer(boolean contextual) { this.contextual = contextual; } - + /** * Get whether the renderer is contextual, i.e. has different canvases for * different players. + * * @return True if contextual, false otherwise. */ final public boolean isContextual() { return contextual; } - + /** * Initialize this MapRenderer for the given map. + * * @param map The MapView being initialized. */ public void initialize(MapView map) { } - + /** * Render to the given map. + * * @param map The MapView being rendered to. * @param canvas The canvas to use for rendering. * @param player The player who triggered the rendering. */ abstract public void render(MapView map, MapCanvas canvas, Player player); - + } diff --git a/src/main/java/org/bukkit/map/MapView.java b/src/main/java/org/bukkit/map/MapView.java index b0811f80..821afd69 100644 --- a/src/main/java/org/bukkit/map/MapView.java +++ b/src/main/java/org/bukkit/map/MapView.java @@ -7,7 +7,7 @@ import org.bukkit.World; * Represents a map item. */ public interface MapView { - + /** * An enum representing all possible scales a map can be set to. */ @@ -17,120 +17,135 @@ public interface MapView { NORMAL(2), FAR(3), FARTHEST(4); - + private byte value; - + private Scale(int value) { this.value = (byte) value; } - + /** * Get the scale given the raw value. + * * @param value The raw scale * @return The enum scale, or null for an invalid input */ public static Scale valueOf(byte value) { - switch(value) { - case 0: return CLOSEST; - case 1: return CLOSE; - case 2: return NORMAL; - case 3: return FAR; - case 4: return FARTHEST; - default: return null; + switch (value) { + case 0: return CLOSEST; + case 1: return CLOSE; + case 2: return NORMAL; + case 3: return FAR; + case 4: return FARTHEST; + default: return null; } } - + /** * Get the raw value of this scale level. + * * @return The scale value */ public byte getValue() { return value; } } - + /** * Get the ID of this map item. Corresponds to the damage value of a map * in an inventory. + * * @return The ID of the map. */ public short getId(); - + /** * Check whether this map is virtual. A map is virtual if its lowermost * MapRenderer is plugin-provided. + * * @return Whether the map is virtual. */ public boolean isVirtual(); - + /** * Get the scale of this map. + * * @return The scale of the map. */ public Scale getScale(); - + /** * Set the scale of this map. + * * @param scale The scale to set. */ public void setScale(Scale scale); - + /** * Get the center X position of this map. + * * @return The center X position. */ public int getCenterX(); - + /** * Get the center Z position of this map. + * * @return The center Z position. */ public int getCenterZ(); - + /** * Set the center X position of this map. + * * @param x The center X position. */ public void setCenterX(int x); - + /** * Set the center Z position of this map. + * * @param z The center Z position. */ public void setCenterZ(int z); - + /** * Get the world that this map is associated with. Primarily used by the * internal renderer, but may be used by external renderers. May return * null if the world the map is associated with is not loaded. + * * @return The World this map is associated with. */ public World getWorld(); - + /** * Set the world that this map is associated with. The world is used by * the internal renderer, and may also be used by external renderers. + * * @param world The World to associate this map with. */ public void setWorld(World world); - + /** * Get a list of MapRenderers currently in effect. + * * @return A List<MapRenderer> containing each map renderer. */ public List<MapRenderer> getRenderers(); - + /** * Add a renderer to this map. + * * @param renderer The MapRenderer to add. */ public void addRenderer(MapRenderer renderer); - + /** * Remove a renderer from this map. + * * @param renderer The MapRenderer to remove. * @return True if the renderer was successfully removed. */ public boolean removeRenderer(MapRenderer renderer); - + } diff --git a/src/main/java/org/bukkit/map/MinecraftFont.java b/src/main/java/org/bukkit/map/MinecraftFont.java index d84d5c2f..9ec8d10f 100644 --- a/src/main/java/org/bukkit/map/MinecraftFont.java +++ b/src/main/java/org/bukkit/map/MinecraftFont.java @@ -4,9 +4,9 @@ package org.bukkit.map; * Represents the built-in Minecraft font. */ public class MinecraftFont extends MapFont { - + private static final int spaceSize = 2; - + private static final String fontChars = " !\"#$%&'()*+,-./0123456789:;<=>?" + "@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_" + @@ -17,7 +17,7 @@ public class MinecraftFont extends MapFont { "\u00FF\u00D6\u00DC\u00F8\u00A3\u00D8\u00D7\u0191" + // ÿÖÜø£Ø׃ "\u00E1\u00ED\u00F3\u00FA\u00F1\u00D1\u00AA\u00BA" + // áÃóúñѪº "\u00BF\u00AE\u00AC\u00BD\u00BC\u00A1\u00AB\u00BB"; // ¿®¬½¼¡«» - + private static final int[][] fontData = new int[][] { /* null */ {0,0,0,0,0,0,0,0}, /* 1 */ {126,129,165,129,189,153,129,126}, @@ -276,31 +276,31 @@ public class MinecraftFont extends MapFont { /* 254 */ {0,0,60,60,60,60,0,0}, /* 255 */ {0,0,0,0,0,0,0,0}, }; - + /** * A static non-malleable MinecraftFont. */ public static final MinecraftFont Font = new MinecraftFont(false); - + /** * Initialize a new MinecraftFont. */ public MinecraftFont() { this(true); } - + private MinecraftFont(boolean malleable) { for (int i = 1; i < fontData.length; ++i) { char ch = (char) i; if (i >= 32 && i < 32 + fontChars.length()) { ch = fontChars.charAt(i - 32); } - + if (ch == ' ') { setChar(ch, new CharacterSprite(spaceSize, 8, new boolean[spaceSize * 8])); continue; } - + int[] rows = fontData[i]; int width = 0; for (int r = 0; r < 8; ++r) { @@ -311,18 +311,18 @@ public class MinecraftFont extends MapFont { } } ++width; - + boolean[] data = new boolean[width * 8]; for (int r = 0; r < 8; ++r) { for (int c = 0; c < width; ++c) { data[r * width + c] = (rows[r] & (1 << c)) != 0; } } - + setChar(ch, new CharacterSprite(width, 8, data)); } - + this.malleable = malleable; } - + } diff --git a/src/main/java/org/bukkit/material/Bed.java b/src/main/java/org/bukkit/material/Bed.java index fe40c100..f763ac26 100644 --- a/src/main/java/org/bukkit/material/Bed.java +++ b/src/main/java/org/bukkit/material/Bed.java @@ -17,6 +17,7 @@ public class Bed extends MaterialData implements Directional { /** * Instantiate a bed facing in a particular direction. + * * @param direction the direction the bed's head is facing */ public Bed(BlockFace direction) { @@ -51,6 +52,7 @@ public class Bed extends MaterialData implements Directional { /** * Configure this to be either the head or the foot of the bed + * * @param isHeadOfBed True to make it the head. */ public void setHeadOfBed(boolean isHeadOfBed) { diff --git a/src/main/java/org/bukkit/material/Directional.java b/src/main/java/org/bukkit/material/Directional.java index 2d44baa1..25624d26 100644 --- a/src/main/java/org/bukkit/material/Directional.java +++ b/src/main/java/org/bukkit/material/Directional.java @@ -6,6 +6,7 @@ public interface Directional { /** * Sets the direction that this block is facing in + * * @param face The facing direction */ public void setFacingDirection(BlockFace face); diff --git a/src/main/java/org/bukkit/material/Door.java b/src/main/java/org/bukkit/material/Door.java index 2938ac36..5086555e 100644 --- a/src/main/java/org/bukkit/material/Door.java +++ b/src/main/java/org/bukkit/material/Door.java @@ -29,6 +29,7 @@ public class Door extends MaterialData implements Directional { /** * Check to see if the door is open. + * * @return true if the door has swung counterclockwise around its hinge. */ public boolean isOpen() { @@ -37,6 +38,7 @@ public class Door extends MaterialData implements Directional { /** * Configure this door to be either open or closed; + * * @param isOpen True to open the door. */ public void setOpen(boolean isOpen) { @@ -52,6 +54,7 @@ public class Door extends MaterialData implements Directional { /** * Configure this part of the door to be either the top or the bottom half; + * * @param isTopHalf True to make it the top half. */ public void setTopHalf(boolean isTopHalf) { @@ -82,6 +85,7 @@ public class Door extends MaterialData implements Directional { /** * Set the direction that this door should is facing. + * * @param face the direction */ public void setFacingDirection(BlockFace face) { @@ -104,6 +108,7 @@ public class Door extends MaterialData implements Directional { /** * Get the direction that this door is facing. + * * @return the direction */ public BlockFace getFacing() { diff --git a/src/main/java/org/bukkit/material/Furnace.java b/src/main/java/org/bukkit/material/Furnace.java index b80fe53a..dad56bc4 100644 --- a/src/main/java/org/bukkit/material/Furnace.java +++ b/src/main/java/org/bukkit/material/Furnace.java @@ -14,6 +14,7 @@ public class Furnace extends FurnaceAndDispenser { /** * Instantiate a furnace facing in a particular direction. + * * @param direction the direction the furnace's "opening" is facing */ public Furnace(BlockFace direction) { diff --git a/src/main/java/org/bukkit/material/Lever.java b/src/main/java/org/bukkit/material/Lever.java index 6101fa4e..369d16de 100644 --- a/src/main/java/org/bukkit/material/Lever.java +++ b/src/main/java/org/bukkit/material/Lever.java @@ -39,6 +39,7 @@ public class Lever extends SimpleAttachableMaterialData implements Redstone { /** * Set this lever to be powered or not. + * * @param isPowered whether the lever should be powered or not */ public void setPowered(boolean isPowered) { diff --git a/src/main/java/org/bukkit/material/PistonBaseMaterial.java b/src/main/java/org/bukkit/material/PistonBaseMaterial.java index 4a219bb4..c2a30e1a 100644 --- a/src/main/java/org/bukkit/material/PistonBaseMaterial.java +++ b/src/main/java/org/bukkit/material/PistonBaseMaterial.java @@ -1,4 +1,3 @@ - package org.bukkit.material; import org.bukkit.Material; @@ -25,46 +24,46 @@ public class PistonBaseMaterial extends MaterialData implements Directional, Red } public void setFacingDirection(BlockFace face) { - byte data = (byte)(getData() & 0x8); + byte data = (byte) (getData() & 0x8); switch (face) { - case UP: - data |= 1; - break; - case EAST: - data |= 2; - break; - case WEST: - data |= 3; - break; - case NORTH: - data |= 4; - break; - case SOUTH: - data |= 5; - break; + case UP: + data |= 1; + break; + case EAST: + data |= 2; + break; + case WEST: + data |= 3; + break; + case NORTH: + data |= 4; + break; + case SOUTH: + data |= 5; + break; } setData(data); } public BlockFace getFacing() { - byte dir = (byte)(getData() & 7); + byte dir = (byte) (getData() & 7); switch (dir) { - case 0: - return BlockFace.DOWN; - case 1: - return BlockFace.UP; - case 2: - return BlockFace.EAST; - case 3: - return BlockFace.WEST; - case 4: - return BlockFace.NORTH; - case 5: - return BlockFace.SOUTH; - default: - return BlockFace.SELF; + case 0: + return BlockFace.DOWN; + case 1: + return BlockFace.UP; + case 2: + return BlockFace.EAST; + case 3: + return BlockFace.WEST; + case 4: + return BlockFace.NORTH; + case 5: + return BlockFace.SOUTH; + default: + return BlockFace.SELF; } } diff --git a/src/main/java/org/bukkit/material/PistonExtensionMaterial.java b/src/main/java/org/bukkit/material/PistonExtensionMaterial.java index 2d727a94..47edc5cd 100644 --- a/src/main/java/org/bukkit/material/PistonExtensionMaterial.java +++ b/src/main/java/org/bukkit/material/PistonExtensionMaterial.java @@ -1,4 +1,3 @@ - package org.bukkit.material; import org.bukkit.Material; @@ -25,46 +24,46 @@ public class PistonExtensionMaterial extends MaterialData implements Attachable } public void setFacingDirection(BlockFace face) { - byte data = (byte)(getData() & 0x8); + byte data = (byte) (getData() & 0x8); switch (face) { - case UP: - data |= 1; - break; - case EAST: - data |= 2; - break; - case WEST: - data |= 3; - break; - case NORTH: - data |= 4; - break; - case SOUTH: - data |= 5; - break; + case UP: + data |= 1; + break; + case EAST: + data |= 2; + break; + case WEST: + data |= 3; + break; + case NORTH: + data |= 4; + break; + case SOUTH: + data |= 5; + break; } setData(data); } public BlockFace getFacing() { - byte dir = (byte)(getData() & 7); + byte dir = (byte) (getData() & 7); switch (dir) { - case 0: - return BlockFace.DOWN; - case 1: - return BlockFace.UP; - case 2: - return BlockFace.EAST; - case 3: - return BlockFace.WEST; - case 4: - return BlockFace.NORTH; - case 5: - return BlockFace.SOUTH; - default: - return BlockFace.SELF; + case 0: + return BlockFace.DOWN; + case 1: + return BlockFace.UP; + case 2: + return BlockFace.EAST; + case 3: + return BlockFace.WEST; + case 4: + return BlockFace.NORTH; + case 5: + return BlockFace.SOUTH; + default: + return BlockFace.SELF; } } diff --git a/src/main/java/org/bukkit/material/PoweredRail.java b/src/main/java/org/bukkit/material/PoweredRail.java index 27c19c89..857c4499 100644 --- a/src/main/java/org/bukkit/material/PoweredRail.java +++ b/src/main/java/org/bukkit/material/PoweredRail.java @@ -32,6 +32,7 @@ public class PoweredRail extends ExtendedRails implements Redstone { /** * Set whether this PoweredRail should be powered or not. + * * @param isPowered whether or not the rail is powered */ public void setPowered(boolean isPowered) { diff --git a/src/main/java/org/bukkit/material/Pumpkin.java b/src/main/java/org/bukkit/material/Pumpkin.java index 4e08becf..78ec3aa0 100644 --- a/src/main/java/org/bukkit/material/Pumpkin.java +++ b/src/main/java/org/bukkit/material/Pumpkin.java @@ -14,6 +14,7 @@ public class Pumpkin extends MaterialData implements Directional { /** * Instantiate a pumpkin facing in a particular direction. + * * @param direction the direction the pumkin's face is facing */ public Pumpkin(BlockFace direction) { diff --git a/src/main/java/org/bukkit/material/Rails.java b/src/main/java/org/bukkit/material/Rails.java index 3d6a959e..cfe812fc 100644 --- a/src/main/java/org/bukkit/material/Rails.java +++ b/src/main/java/org/bukkit/material/Rails.java @@ -97,6 +97,7 @@ public class Rails extends MaterialData { /** * Return the data without the extended properties used by {@link PoweredRail} and {@link DetectorRail}. Overridden in {@link ExtendedRails} + * * @return the data without the extended part */ protected byte getConvertedData() { @@ -105,10 +106,11 @@ public class Rails extends MaterialData { /** * Set the direction of these tracks<br> - * Note that tracks are bidirectional and that the direction - * returned is the ascending direction if the track is set on a - * slope. If it is set as a curve, the corner of the track should - * be supplied. + * Note that tracks are bidirectional and that the direction + * returned is the ascending direction if the track is set on a + * slope. If it is set as a curve, the corner of the track should + * be supplied. + * * @param face the direction the track should be facing * @param isOnSlope whether or not the track should be on a slope */ diff --git a/src/main/java/org/bukkit/material/TexturedMaterial.java b/src/main/java/org/bukkit/material/TexturedMaterial.java index 59de8be5..93b13d72 100644 --- a/src/main/java/org/bukkit/material/TexturedMaterial.java +++ b/src/main/java/org/bukkit/material/TexturedMaterial.java @@ -27,14 +27,14 @@ public abstract class TexturedMaterial extends MaterialData { /** * Retrieve a list of possible textures. The first element of the list will be used as a default. - * + * * @return a list of possible textures for this block */ public abstract List<Material> getTextures(); /** * Gets the current Material this block is made of - * + * * @return Material of this block */ public Material getMaterial() { @@ -42,13 +42,13 @@ public abstract class TexturedMaterial extends MaterialData { if (n > getTextures().size() - 1) { n = 0; } - + return getTextures().get(n); } /** * Sets the material this block is made of - * + * * @param material * New material of this block */ diff --git a/src/main/java/org/bukkit/material/TrapDoor.java b/src/main/java/org/bukkit/material/TrapDoor.java index b16835db..2fa9b590 100644 --- a/src/main/java/org/bukkit/material/TrapDoor.java +++ b/src/main/java/org/bukkit/material/TrapDoor.java @@ -40,17 +40,17 @@ public class TrapDoor extends SimpleAttachableMaterialData { byte data = (byte) (getData() & 0x3); switch (data) { - case 0x0: - return BlockFace.WEST; + case 0x0: + return BlockFace.WEST; - case 0x1: - return BlockFace.EAST; + case 0x1: + return BlockFace.EAST; - case 0x2: - return BlockFace.SOUTH; + case 0x2: + return BlockFace.SOUTH; - case 0x3: - return BlockFace.NORTH; + case 0x3: + return BlockFace.NORTH; } return null; @@ -61,15 +61,15 @@ public class TrapDoor extends SimpleAttachableMaterialData { byte data = (byte) (getData() & 0x4); switch (face) { - case WEST: - data |= 0x1; - break; - case NORTH: - data |= 0x2; - break; - case SOUTH: - data |= 0x3; - break; + case WEST: + data |= 0x1; + break; + case NORTH: + data |= 0x2; + break; + case SOUTH: + data |= 0x3; + break; } setData(data); diff --git a/src/main/java/org/bukkit/permissions/Permissible.java b/src/main/java/org/bukkit/permissions/Permissible.java index a7f61773..cbbafe5a 100644 --- a/src/main/java/org/bukkit/permissions/Permissible.java +++ b/src/main/java/org/bukkit/permissions/Permissible.java @@ -1,4 +1,3 @@ - package org.bukkit.permissions; import java.util.Set; diff --git a/src/main/java/org/bukkit/permissions/PermissibleBase.java b/src/main/java/org/bukkit/permissions/PermissibleBase.java index 6da5663b..d0b6a5a6 100644 --- a/src/main/java/org/bukkit/permissions/PermissibleBase.java +++ b/src/main/java/org/bukkit/permissions/PermissibleBase.java @@ -23,12 +23,12 @@ public class PermissibleBase implements Permissible { this.opable = opable; if (opable instanceof Permissible) { - this.parent = (Permissible)opable; + this.parent = (Permissible) opable; } recalculatePermissions(); } - + public boolean isOp() { if (opable == null) { return false; @@ -90,11 +90,8 @@ public class PermissibleBase implements Permissible { if (isPermissionSet(name)) { return permissions.get(name).getValue(); - } else if (perm != null) { - return perm.getDefault().getValue(isOp()); - } else { - return Permission.DEFAULT_PERMISSION.getValue(isOp()); } + return perm.getDefault().getValue(isOp()); } public PermissionAttachment addAttachment(Plugin plugin, String name, boolean value) { diff --git a/src/main/java/org/bukkit/permissions/Permission.java b/src/main/java/org/bukkit/permissions/Permission.java index bfb4adec..ecd6eac1 100644 --- a/src/main/java/org/bukkit/permissions/Permission.java +++ b/src/main/java/org/bukkit/permissions/Permission.java @@ -1,4 +1,3 @@ - package org.bukkit.permissions; import java.util.ArrayList; @@ -53,7 +52,7 @@ public class Permission { this.name = name; this.description = (description == null) ? "" : description; this.defaultValue = (defaultValue == null) ? PermissionDefault.FALSE : defaultValue; - + if (children != null) { this.children.putAll(children); } @@ -282,7 +281,7 @@ public class Permission { if (data.containsKey("description")) { try { - desc = (String)data.get("description"); + desc = (String) data.get("description"); } catch (ClassCastException ex) { throw new IllegalArgumentException("'description' key is of wrong type", ex); } @@ -295,7 +294,7 @@ public class Permission { Object parents = data.get("parents"); if (parents instanceof String) { - result.addParent((String)parents, true); + result.addParent((String) parents, true); } } catch (ClassCastException ex) { throw new IllegalArgumentException("'parents' key is of wrong type", ex); @@ -305,33 +304,31 @@ public class Permission { return result; } - + @SuppressWarnings("unchecked") private static Map<String, Boolean> extractChildren(Map<String, Object> data, String name, PermissionDefault def, List<Permission> output) { - Map<String, Object> input = (Map<String, Object>)data.get("children"); - Map<String, Boolean> children = new LinkedHashMap(); + Map<String, Object> input = (Map<String, Object>) data.get("children"); + Map<String, Boolean> children = new LinkedHashMap<String, Boolean>(); for (Map.Entry<String, Object> entry : input.entrySet()) { if ((entry.getValue() instanceof Boolean)) { - children.put(entry.getKey(), (Boolean)entry.getValue()); + children.put(entry.getKey(), (Boolean) entry.getValue()); } else if ((entry.getValue() instanceof Map)) { try { - try - { - Permission perm = loadPermission((String)entry.getKey(), (Map<String, Object>)entry.getValue(), def, output); + try { + Permission perm = loadPermission((String) entry.getKey(), (Map<String, Object>) entry.getValue(), def, output); children.put(perm.getName(), Boolean.valueOf(true)); if (output != null) { output.add(perm); } - } - catch (Throwable ex) { - Bukkit.getServer().getLogger().log(Level.SEVERE, "Permission node '" + (String)entry.getKey() + "' in child of " + name + " is invalid", ex); + } catch (Throwable ex) { + Bukkit.getServer().getLogger().log(Level.SEVERE, "Permission node '" + (String) entry.getKey() + "' in child of " + name + " is invalid", ex); } } catch (ClassCastException ex) { - throw new IllegalArgumentException("Child '" + (String)entry.getKey() + "' contains invalid map type"); + throw new IllegalArgumentException("Child '" + (String) entry.getKey() + "' contains invalid map type"); } } else { - throw new IllegalArgumentException("Child '" + (String)entry.getKey() + "' contains invalid value"); + throw new IllegalArgumentException("Child '" + (String) entry.getKey() + "' contains invalid value"); } } diff --git a/src/main/java/org/bukkit/permissions/PermissionAttachment.java b/src/main/java/org/bukkit/permissions/PermissionAttachment.java index d5cfeb20..30ad37b8 100644 --- a/src/main/java/org/bukkit/permissions/PermissionAttachment.java +++ b/src/main/java/org/bukkit/permissions/PermissionAttachment.java @@ -1,4 +1,3 @@ - package org.bukkit.permissions; import java.util.LinkedHashMap; diff --git a/src/main/java/org/bukkit/permissions/PermissionAttachmentInfo.java b/src/main/java/org/bukkit/permissions/PermissionAttachmentInfo.java index b43190d4..77f49172 100644 --- a/src/main/java/org/bukkit/permissions/PermissionAttachmentInfo.java +++ b/src/main/java/org/bukkit/permissions/PermissionAttachmentInfo.java @@ -1,4 +1,3 @@ - package org.bukkit.permissions; /** diff --git a/src/main/java/org/bukkit/permissions/PermissionDefault.java b/src/main/java/org/bukkit/permissions/PermissionDefault.java index 78ff2f98..eb507c4c 100644 --- a/src/main/java/org/bukkit/permissions/PermissionDefault.java +++ b/src/main/java/org/bukkit/permissions/PermissionDefault.java @@ -27,16 +27,16 @@ public enum PermissionDefault { */ public boolean getValue(boolean op) { switch (this) { - case TRUE: - return true; - case FALSE: - return false; - case OP: - return op; - case NOT_OP: - return !op; - default: - return false; + case TRUE: + return true; + case FALSE: + return false; + case OP: + return op; + case NOT_OP: + return !op; + default: + return false; } } @@ -54,7 +54,7 @@ public enum PermissionDefault { public String toString() { return names[0]; } - + static { for (PermissionDefault value : values()) { for (String name : value.names) { diff --git a/src/main/java/org/bukkit/permissions/PermissionRemovedExecutor.java b/src/main/java/org/bukkit/permissions/PermissionRemovedExecutor.java index 7dc09125..a9543cf8 100644 --- a/src/main/java/org/bukkit/permissions/PermissionRemovedExecutor.java +++ b/src/main/java/org/bukkit/permissions/PermissionRemovedExecutor.java @@ -1,4 +1,3 @@ - package org.bukkit.permissions; /** diff --git a/src/main/java/org/bukkit/plugin/AuthorNagException.java b/src/main/java/org/bukkit/plugin/AuthorNagException.java index 838b4455..6565a441 100644 --- a/src/main/java/org/bukkit/plugin/AuthorNagException.java +++ b/src/main/java/org/bukkit/plugin/AuthorNagException.java @@ -1,5 +1,6 @@ package org.bukkit.plugin; +@SuppressWarnings("serial") public class AuthorNagException extends RuntimeException { private final String message; diff --git a/src/main/java/org/bukkit/plugin/IllegalPluginAccessException.java b/src/main/java/org/bukkit/plugin/IllegalPluginAccessException.java index 88e6cb7e..4e60e208 100644 --- a/src/main/java/org/bukkit/plugin/IllegalPluginAccessException.java +++ b/src/main/java/org/bukkit/plugin/IllegalPluginAccessException.java @@ -3,6 +3,7 @@ package org.bukkit.plugin; /** * Thrown when a plugin attempts to interact with the server when it is not enabled */ +@SuppressWarnings("serial") public class IllegalPluginAccessException extends RuntimeException { /** @@ -12,6 +13,7 @@ public class IllegalPluginAccessException extends RuntimeException { /** * Constructs an instance of <code>IllegalPluginAccessException</code> with the specified detail message. + * * @param msg the detail message. */ public IllegalPluginAccessException(String msg) { diff --git a/src/main/java/org/bukkit/plugin/Plugin.java b/src/main/java/org/bukkit/plugin/Plugin.java index ff867e19..4bf8c11d 100644 --- a/src/main/java/org/bukkit/plugin/Plugin.java +++ b/src/main/java/org/bukkit/plugin/Plugin.java @@ -35,25 +35,25 @@ public interface Plugin extends CommandExecutor { * @return The configuration */ public Configuration getConfiguration(); - + /** * Gets a {@link FileConfiguration} for this plugin, read through "config.yml" * <p> * If there is a default config.yml embedded in this plugin, it will be provided * as a default for this Configuration. - * + * * @return Plugin configuration */ public FileConfiguration getConfig(); - + /** * Gets an embedded resource in this plugin - * + * * @param filename Filename of the resource * @return File if found, otherwise null */ public InputStream getResource(String filename); - + /** * Saves the {@link FileConfiguration} retrievable by {@link #getConfig()}. */ @@ -69,13 +69,13 @@ public interface Plugin extends CommandExecutor { * Saves the raw contents of any resource embedded with a plugin's .jar file assuming it can be found using * {@link #getResource(String)}. The resource is saved into the plugin's data folder using the same hierarchy * as the .jar file (subdirectories are preserved). - * + * * @param resourcePath the embedded resource path to look for within the plugin's .jar file. (No preceding slash). * @param replace if true, the embedded resource will overwrite the contents of an existing file. * @throws IllegalArgumentException if the resource path is null, empty, or points to a nonexistent resource. */ public void saveResource(String resourcePath, boolean replace); - + /** * Discards any data in {@link #getConfig()} and reloads from disk. */ @@ -120,12 +120,14 @@ public interface Plugin extends CommandExecutor { /** * Simple boolean if we can still nag to the logs about things + * * @return boolean whether we can nag */ public boolean isNaggable(); /** * Set naggable state + * * @param canNag is this plugin still naggable? */ public void setNaggable(boolean canNag); diff --git a/src/main/java/org/bukkit/plugin/PluginDescriptionFile.java b/src/main/java/org/bukkit/plugin/PluginDescriptionFile.java index f3f864d8..6469ed68 100644 --- a/src/main/java/org/bukkit/plugin/PluginDescriptionFile.java +++ b/src/main/java/org/bukkit/plugin/PluginDescriptionFile.java @@ -38,6 +38,7 @@ public final class PluginDescriptionFile { /** * Loads a PluginDescriptionFile from the specified reader + * * @param reader The reader * @throws InvalidDescriptionException If the PluginDescriptionFile is invalid */ @@ -153,6 +154,7 @@ public final class PluginDescriptionFile { return defaultPerm; } + @SuppressWarnings("unchecked") private void loadMap(Map<String, Object> map) throws InvalidDescriptionException { try { name = map.get("name").toString(); @@ -235,7 +237,7 @@ public final class PluginDescriptionFile { if (map.containsKey("load")) { try { - order = PluginLoadOrder.valueOf(((String)map.get("load")).toUpperCase().replaceAll("\\W", "")); + order = PluginLoadOrder.valueOf(((String) map.get("load")).toUpperCase().replaceAll("\\W", "")); } catch (ClassCastException ex) { throw new InvalidDescriptionException(ex, "load is of wrong type"); } catch (IllegalArgumentException ex) { @@ -265,7 +267,7 @@ public final class PluginDescriptionFile { if (map.containsKey("default-permission")) { try { - defaultPerm = defaultPerm.getByName((String)map.get("default-permission")); + defaultPerm = PermissionDefault.getByName((String) map.get("default-permission")); } catch (ClassCastException ex) { throw new InvalidDescriptionException(ex, "default-permission is of wrong type"); } catch (IllegalArgumentException ex) { @@ -275,9 +277,9 @@ public final class PluginDescriptionFile { if (map.containsKey("permissions")) { try { - Map<String, Map<String, Object>> perms = (Map<String, Map<String, Object>>) map.get("permissions"); + Map<String, Map<String, Object>> perms = (Map<String, Map<String, Object>>) map.get("permissions"); - permissions = Permission.loadPermissions(perms, "Permission node '%s' in plugin description file for " + getFullName() + " is invalid", defaultPerm); + permissions = Permission.loadPermissions(perms, "Permission node '%s' in plugin description file for " + getFullName() + " is invalid", defaultPerm); } catch (ClassCastException ex) { throw new InvalidDescriptionException(ex, "permissions are of wrong type"); } diff --git a/src/main/java/org/bukkit/plugin/PluginLoadOrder.java b/src/main/java/org/bukkit/plugin/PluginLoadOrder.java index c1ae4be4..bd647230 100644 --- a/src/main/java/org/bukkit/plugin/PluginLoadOrder.java +++ b/src/main/java/org/bukkit/plugin/PluginLoadOrder.java @@ -1,4 +1,3 @@ - package org.bukkit.plugin; /** diff --git a/src/main/java/org/bukkit/plugin/PluginLoader.java b/src/main/java/org/bukkit/plugin/PluginLoader.java index 43e29fdb..5144d710 100644 --- a/src/main/java/org/bukkit/plugin/PluginLoader.java +++ b/src/main/java/org/bukkit/plugin/PluginLoader.java @@ -17,7 +17,7 @@ public interface PluginLoader { * * @param file File to attempt to load * @return Plugin that was contained in the specified file, or null if - * unsuccessful + * unsuccessful * @throws InvalidPluginException Thrown when the specified file is not a plugin * @throws InvalidDescriptionException If the plugin description file was invalid * @throws UnknownDependencyException If a required dependency could not be found @@ -30,7 +30,7 @@ public interface PluginLoader { * @param file File to attempt to load * @param ignoreSoftDependencies Loader will ignore soft dependencies if this flag is set to true * @return Plugin that was contained in the specified file, or null if - * unsuccessful + * unsuccessful * @throws InvalidPluginException Thrown when the specified file is not a plugin * @throws InvalidDescriptionException If the plugin description file was invalid * @throws UnknownDependencyException If a required dependency could not be found @@ -39,6 +39,7 @@ public interface PluginLoader { /** * Returns a list of all filename filters expected by this PluginLoader + * * @return The filters */ public Pattern[] getPluginFileFilters(); diff --git a/src/main/java/org/bukkit/plugin/RegisteredListener.java b/src/main/java/org/bukkit/plugin/RegisteredListener.java index dc74c143..4f7e7bf2 100644 --- a/src/main/java/org/bukkit/plugin/RegisteredListener.java +++ b/src/main/java/org/bukkit/plugin/RegisteredListener.java @@ -28,6 +28,7 @@ public class RegisteredListener { /** * Gets the listener for this registration + * * @return Registered Listener */ public Listener getListener() { @@ -36,6 +37,7 @@ public class RegisteredListener { /** * Gets the plugin for this registration + * * @return Registered Plugin */ public Plugin getPlugin() { @@ -44,6 +46,7 @@ public class RegisteredListener { /** * Gets the priority for this registration + * * @return Registered Priority */ public Event.Priority getPriority() { @@ -52,6 +55,7 @@ public class RegisteredListener { /** * Calls the event executor + * * @param event The event */ public void callEvent(Event event) { diff --git a/src/main/java/org/bukkit/plugin/RegisteredServiceProvider.java b/src/main/java/org/bukkit/plugin/RegisteredServiceProvider.java index 71ad64e7..ba3ff15e 100644 --- a/src/main/java/org/bukkit/plugin/RegisteredServiceProvider.java +++ b/src/main/java/org/bukkit/plugin/RegisteredServiceProvider.java @@ -2,7 +2,7 @@ package org.bukkit.plugin; /** * A registered service provider. - * + * * @param <T> Service */ public class RegisteredServiceProvider<T> implements Comparable<RegisteredServiceProvider<?>> { @@ -12,8 +12,7 @@ public class RegisteredServiceProvider<T> implements Comparable<RegisteredServic private T provider; private ServicePriority priority; - public RegisteredServiceProvider(Class<T> service, T provider, - ServicePriority priority, Plugin plugin) { + public RegisteredServiceProvider(Class<T> service, T provider, ServicePriority priority, Plugin plugin) { this.service = service; this.plugin = plugin; diff --git a/src/main/java/org/bukkit/plugin/ServicesManager.java b/src/main/java/org/bukkit/plugin/ServicesManager.java index 3d853a3f..c1a5fd65 100644 --- a/src/main/java/org/bukkit/plugin/ServicesManager.java +++ b/src/main/java/org/bukkit/plugin/ServicesManager.java @@ -22,8 +22,7 @@ public interface ServicesManager { * @param plugin plugin with the provider * @param priority priority of the provider */ - public <T> void register(Class<T> service, T provider, Plugin plugin, - ServicePriority priority); + public <T> void register(Class<T> service, T provider, Plugin plugin, ServicePriority priority); /** * Unregister all the providers registered by a particular plugin. @@ -83,8 +82,7 @@ public interface ServicesManager { * @param service The service interface * @return list of registrations */ - public <T> Collection<RegisteredServiceProvider<T>> getRegistrations( - Class<T> service); + public <T> Collection<RegisteredServiceProvider<T>> getRegistrations(Class<T> service); /** * Get a list of known services. A service is known if it has registered diff --git a/src/main/java/org/bukkit/plugin/SimplePluginManager.java b/src/main/java/org/bukkit/plugin/SimplePluginManager.java index a79c3583..f0888554 100644 --- a/src/main/java/org/bukkit/plugin/SimplePluginManager.java +++ b/src/main/java/org/bukkit/plugin/SimplePluginManager.java @@ -118,7 +118,7 @@ public final class SimplePluginManager implements PluginManager { boolean allFailed = false; boolean finalPass = false; - LinkedList<File> filesList = new LinkedList(Arrays.asList(files)); + LinkedList<File> filesList = new LinkedList<File>(Arrays.asList(files)); if (!(server.getUpdateFolder().equals(""))) { updateDirectory = new File(directory, server.getUpdateFolder()); @@ -285,7 +285,7 @@ public final class SimplePluginManager implements PluginManager { } public void disablePlugins() { - for (Plugin plugin: getPlugins()) { + for (Plugin plugin : getPlugins()) { disablePlugin(plugin); } } diff --git a/src/main/java/org/bukkit/plugin/SimpleServicesManager.java b/src/main/java/org/bukkit/plugin/SimpleServicesManager.java index c699d291..c0f0a54c 100644 --- a/src/main/java/org/bukkit/plugin/SimpleServicesManager.java +++ b/src/main/java/org/bukkit/plugin/SimpleServicesManager.java @@ -28,8 +28,7 @@ public class SimpleServicesManager implements ServicesManager { * @param plugin plugin with the provider * @param priority priority of the provider */ - public <T> void register(Class<T> service, T provider, - Plugin plugin, ServicePriority priority) { + public <T> void register(Class<T> service, T provider, Plugin plugin, ServicePriority priority) { synchronized (providers) { List<RegisteredServiceProvider<?>> registered = providers.get(service); diff --git a/src/main/java/org/bukkit/plugin/java/JavaPlugin.java b/src/main/java/org/bukkit/plugin/java/JavaPlugin.java index 5ffde7ac..3b2b06e3 100644 --- a/src/main/java/org/bukkit/plugin/java/JavaPlugin.java +++ b/src/main/java/org/bukkit/plugin/java/JavaPlugin.java @@ -108,7 +108,7 @@ public abstract class JavaPlugin implements Plugin { * the configuration file will have no values. * * @return The configuration. - * @deprecated See the new + * @deprecated See the new */ @Deprecated public Configuration getConfiguration() { @@ -118,14 +118,14 @@ public abstract class JavaPlugin implements Plugin { } return config; } - + public FileConfiguration getConfig() { if (newConfig == null) { reloadConfig(); } return newConfig; } - + public void reloadConfig() { newConfig = YamlConfiguration.loadConfiguration(configFile); @@ -136,7 +136,7 @@ public abstract class JavaPlugin implements Plugin { newConfig.setDefaults(defConfig); } } - + public void saveConfig() { try { newConfig.save(configFile); @@ -150,36 +150,31 @@ public abstract class JavaPlugin implements Plugin { } public void saveResource(String resourcePath, boolean replace) { - if(resourcePath == null || resourcePath.equals("")) { + if (resourcePath == null || resourcePath.equals("")) { throw new IllegalArgumentException("ResourcePath cannot be null or empty"); } resourcePath = resourcePath.replace('\\', '/'); InputStream in = getResource(resourcePath); - if(in == null) { + if (in == null) { throw new IllegalArgumentException("The embedded resource '" + resourcePath + "' cannot be found in " + getFile()); } - File outFile = new File(getDataFolder(), resourcePath); + File outFile = new File(getDataFolder(), resourcePath); int lastIndex = resourcePath.lastIndexOf('/'); File outDir = new File(getDataFolder(), resourcePath.substring(0, lastIndex >= 0 ? lastIndex : 0)); - - - if(!outDir.exists()) { - outDir.mkdirs(); - } - if(in == null) { - in = new ByteArrayInputStream(new byte[0]); + if (!outDir.exists()) { + outDir.mkdirs(); } try { - if(!outFile.exists() || replace) { + if (!outFile.exists() || replace) { OutputStream out = new FileOutputStream(outFile); byte[] buf = new byte[1024]; int len; - while((len=in.read(buf))>0) { - out.write(buf,0,len); + while ((len = in.read(buf)) > 0) { + out.write(buf, 0, len); } out.close(); in.close(); @@ -190,7 +185,7 @@ public abstract class JavaPlugin implements Plugin { Logger.getLogger(JavaPlugin.class.getName()).log(Level.SEVERE, "Could not save " + outFile.getName() + " to " + outFile, ex); } } - + public InputStream getResource(String filename) { if (filename == null) { throw new IllegalArgumentException("Filename cannot be null"); @@ -249,9 +244,7 @@ public abstract class JavaPlugin implements Plugin { * @param file File containing this plugin * @param classLoader ClassLoader which holds this plugin */ - protected final void initialize(PluginLoader loader, Server server, - PluginDescriptionFile description, File dataFolder, File file, - ClassLoader classLoader) { + protected final void initialize(PluginLoader loader, Server server, PluginDescriptionFile description, File dataFolder, File file, ClassLoader classLoader) { if (!initialized) { this.initialized = true; this.loader = loader; diff --git a/src/main/java/org/bukkit/plugin/java/JavaPluginLoader.java b/src/main/java/org/bukkit/plugin/java/JavaPluginLoader.java index 0bd5ec9a..0bb16653 100644 --- a/src/main/java/org/bukkit/plugin/java/JavaPluginLoader.java +++ b/src/main/java/org/bukkit/plugin/java/JavaPluginLoader.java @@ -51,6 +51,7 @@ public class JavaPluginLoader implements PluginLoader { return loadPlugin(file, false); } + @SuppressWarnings("unchecked") public Plugin loadPlugin(File file, boolean ignoreSoftDependencies) throws InvalidPluginException, InvalidDescriptionException, UnknownDependencyException { JavaPlugin result = null; PluginDescriptionFile description = null; @@ -117,7 +118,7 @@ public class JavaPluginLoader implements PluginLoader { ArrayList<String> depend; try { - depend = (ArrayList) description.getDepend(); + depend = (ArrayList<String>) description.getDepend(); if (depend == null) { depend = new ArrayList<String>(); } @@ -140,7 +141,7 @@ public class JavaPluginLoader implements PluginLoader { ArrayList<String> softDepend; try { - softDepend = (ArrayList) description.getSoftDepend(); + softDepend = (ArrayList<String>) description.getSoftDepend(); if (softDepend == null) { softDepend = new ArrayList<String>(); } @@ -231,20 +232,22 @@ public class JavaPluginLoader implements PluginLoader { public void setClass(final String name, final Class<?> clazz) { if (!classes.containsKey(name)) { classes.put(name, clazz); - + if (ConfigurationSerializable.class.isAssignableFrom(clazz)) { - Class<? extends ConfigurationSerializable> serializable = (Class<? extends ConfigurationSerializable>)clazz; + @SuppressWarnings("unchecked") + Class<? extends ConfigurationSerializable> serializable = (Class<? extends ConfigurationSerializable>) clazz; ConfigurationSerialization.registerClass(serializable); } } } - + public void removeClass(String name) { Class<?> clazz = classes.remove(name); try { if ((clazz != null) && (ConfigurationSerializable.class.isAssignableFrom(clazz))) { - Class<? extends ConfigurationSerializable> serializable = (Class<? extends ConfigurationSerializable>)clazz; + @SuppressWarnings("unchecked") + Class<? extends ConfigurationSerializable> serializable = (Class<? extends ConfigurationSerializable>) clazz; ConfigurationSerialization.unregisterClass(serializable); } } catch (NullPointerException ex) { @@ -407,11 +410,11 @@ public class JavaPluginLoader implements PluginLoader { }; case PLAYER_TOGGLE_SPRINT: - return new EventExecutor() { - public void execute(Listener listener, Event event) { - ((PlayerListener) listener).onPlayerToggleSprint((PlayerToggleSprintEvent) event); - } - }; + return new EventExecutor() { + public void execute(Listener listener, Event event) { + ((PlayerListener) listener).onPlayerToggleSprint((PlayerToggleSprintEvent) event); + } + }; case PLAYER_BUCKET_EMPTY: return new EventExecutor() { @@ -554,7 +557,6 @@ public class JavaPluginLoader implements PluginLoader { } }; - case BLOCK_FADE: return new EventExecutor() { public void execute(Listener listener, Event event) { @@ -829,7 +831,7 @@ public class JavaPluginLoader implements PluginLoader { public void execute(Listener listener, Event event) { ((EntityListener) listener).onFoodLevelChange((FoodLevelChangeEvent) event); } - }; + }; case SLIME_SPLIT: return new EventExecutor() { diff --git a/src/main/java/org/bukkit/scheduler/BukkitScheduler.java b/src/main/java/org/bukkit/scheduler/BukkitScheduler.java index 5d087911..637d22e0 100644 --- a/src/main/java/org/bukkit/scheduler/BukkitScheduler.java +++ b/src/main/java/org/bukkit/scheduler/BukkitScheduler.java @@ -77,7 +77,7 @@ public interface BukkitScheduler { * Calls a method on the main thread and returns a Future object * This task will be executed by the main server thread * - * Note: The Future.get() methods must NOT be called from the main thread + * Note: The Future.get() methods must NOT be called from the main thread * Note2: There is at least an average of 10ms latency until the isDone() method returns true * * @param <T> The callable's return type @@ -142,7 +142,7 @@ public interface BukkitScheduler { public List<BukkitWorker> getActiveWorkers(); /** - * Returns a list of all pending tasks. The ordering of the tasks is not related to their order of execution. + * Returns a list of all pending tasks. The ordering of the tasks is not related to their order of execution. * * @return Active workers */ diff --git a/src/main/java/org/bukkit/scheduler/BukkitWorker.java b/src/main/java/org/bukkit/scheduler/BukkitWorker.java index b85a01cd..3783608c 100644 --- a/src/main/java/org/bukkit/scheduler/BukkitWorker.java +++ b/src/main/java/org/bukkit/scheduler/BukkitWorker.java @@ -3,7 +3,7 @@ package org.bukkit.scheduler; import org.bukkit.plugin.Plugin; /** - * Represents a worker thread for the scheduler. This gives information about + * Represents a worker thread for the scheduler. This gives information about * the Thread object for the task, owner of the task and the taskId. * * Workers are used to execute async tasks. diff --git a/src/main/java/org/bukkit/util/BlockIterator.java b/src/main/java/org/bukkit/util/BlockIterator.java index b8d10e48..9357a36c 100644 --- a/src/main/java/org/bukkit/util/BlockIterator.java +++ b/src/main/java/org/bukkit/util/BlockIterator.java @@ -15,27 +15,27 @@ import java.util.NoSuchElementException; public class BlockIterator implements Iterator<Block> { - private final World world; - private final int maxDistance; + private final World world; + private final int maxDistance; - private static final int gridSize = 1 << 24; + private static final int gridSize = 1 << 24; - private boolean end = false; + private boolean end = false; - private Block[] blockQueue = new Block[3]; - private int currentBlock = 0; - private int currentDistance = 0; - private int maxDistanceInt; + private Block[] blockQueue = new Block[3]; + private int currentBlock = 0; + private int currentDistance = 0; + private int maxDistanceInt; - private int secondError; - private int thirdError; + private int secondError; + private int thirdError; - private int secondStep; - private int thirdStep; + private int secondStep; + private int thirdStep; - private BlockFace mainFace; - private BlockFace secondFace; - private BlockFace thirdFace; + private BlockFace mainFace; + private BlockFace secondFace; + private BlockFace thirdFace; /** * Constructs the BlockIterator @@ -66,7 +66,7 @@ public class BlockIterator implements Iterator<Block> { double secondPosition = 0; double thirdPosition = 0; - Block startBlock = world.getBlockAt((int) Math.floor(startClone.getX()), (int) Math.floor(startClone.getY()), (int) Math.floor(startClone.getZ())); + Block startBlock = this.world.getBlockAt((int) Math.floor(startClone.getX()), (int) Math.floor(startClone.getY()), (int) Math.floor(startClone.getZ())); if (getXLength(direction) > mainDirection) { mainFace = getXFace(direction); @@ -214,15 +214,15 @@ public class BlockIterator implements Iterator<Block> { } private double getXLength(Vector direction) { - return(Math.abs(direction.getX())); + return Math.abs(direction.getX()); } private double getYLength(Vector direction) { - return(Math.abs(direction.getY())); + return Math.abs(direction.getY()); } private double getZLength(Vector direction) { - return(Math.abs(direction.getZ())); + return Math.abs(direction.getZ()); } private double getPosition(double direction, double position, int blockPosition) { @@ -281,7 +281,7 @@ public class BlockIterator implements Iterator<Block> { * Constructs the BlockIterator. * * @param entity Information from the entity is used to set up the trace - * @param maxDistance This is the maximum distance in blocks for the trace. Setting this value above 140 may lead to problems with unloaded chunks. A value of 0 indicates no limit + * @param maxDistance This is the maximum distance in blocks for the trace. Setting this value above 140 may lead to problems with unloaded chunks. A value of 0 indicates no limit * */ diff --git a/src/main/java/org/bukkit/util/BlockVector.java b/src/main/java/org/bukkit/util/BlockVector.java index 06d0b9cf..8cdd4280 100644 --- a/src/main/java/org/bukkit/util/BlockVector.java +++ b/src/main/java/org/bukkit/util/BlockVector.java @@ -23,6 +23,7 @@ public class BlockVector extends Vector { /** * Construct the vector with another vector. + * * @param vec The other vector. */ public BlockVector(Vector vec) { @@ -111,22 +112,22 @@ public class BlockVector extends Vector { v.z = z; return v; } - + public static BlockVector deserialize(Map<String, Object> args) { double x = 0; double y = 0; double z = 0; - + if (args.containsKey("x")) { - x = (Double)args.get("x"); + x = (Double) args.get("x"); } if (args.containsKey("y")) { - y = (Double)args.get("y"); + y = (Double) args.get("y"); } if (args.containsKey("z")) { - z = (Double)args.get("z"); + z = (Double) args.get("z"); } - + return new BlockVector(x, y, z); } } diff --git a/src/main/java/org/bukkit/util/NumberConversions.java b/src/main/java/org/bukkit/util/NumberConversions.java index 39bad86b..b6cf1009 100644 --- a/src/main/java/org/bukkit/util/NumberConversions.java +++ b/src/main/java/org/bukkit/util/NumberConversions.java @@ -8,12 +8,12 @@ public final class NumberConversions { public static int toInt(Object object) { if (object instanceof Number) { - return ((Number)object).intValue(); + return ((Number) object).intValue(); } else { int result = 0; try { - result = Integer.valueOf((String)object); + result = Integer.valueOf((String) object); } catch (Throwable ex) {} return result; @@ -22,12 +22,12 @@ public final class NumberConversions { public static float toFloat(Object object) { if (object instanceof Number) { - return ((Number)object).floatValue(); + return ((Number) object).floatValue(); } else { float result = 0; try { - result = Float.valueOf((String)object); + result = Float.valueOf((String) object); } catch (Throwable ex) {} return result; @@ -36,12 +36,12 @@ public final class NumberConversions { public static double toDouble(Object object) { if (object instanceof Number) { - return ((Number)object).doubleValue(); + return ((Number) object).doubleValue(); } else { double result = 0; try { - result = Double.valueOf((String)object); + result = Double.valueOf((String) object); } catch (Throwable ex) {} return result; @@ -50,12 +50,12 @@ public final class NumberConversions { public static long toLong(Object object) { if (object instanceof Number) { - return ((Number)object).longValue(); + return ((Number) object).longValue(); } else { long result = 0; try { - result = Long.valueOf((String)object); + result = Long.valueOf((String) object); } catch (Throwable ex) {} return result; @@ -64,12 +64,12 @@ public final class NumberConversions { public static short toShort(Object object) { if (object instanceof Number) { - return ((Number)object).shortValue(); + return ((Number) object).shortValue(); } else { short result = 0; try { - result = Short.valueOf((String)object); + result = Short.valueOf((String) object); } catch (Throwable ex) {} return result; @@ -78,12 +78,12 @@ public final class NumberConversions { public static byte toByte(Object object) { if (object instanceof Number) { - return ((Number)object).byteValue(); + return ((Number) object).byteValue(); } else { byte result = 0; try { - result = Byte.valueOf((String)object); + result = Byte.valueOf((String) object); } catch (Throwable ex) {} return result; diff --git a/src/main/java/org/bukkit/util/Vector.java b/src/main/java/org/bukkit/util/Vector.java index d8e2289e..215e2222 100644 --- a/src/main/java/org/bukkit/util/Vector.java +++ b/src/main/java/org/bukkit/util/Vector.java @@ -165,7 +165,7 @@ public class Vector implements Cloneable, ConfigurationSerializable { } /** - * Get the distance between this vector and another. The value + * Get the distance between this vector and another. The value * of this method is not cached and uses a costly square-root function, so * do not repeatedly call this method to get the vector's magnitude. NaN * will be returned if the inner result of the sqrt() function overflows, @@ -641,29 +641,29 @@ public class Vector implements Cloneable, ConfigurationSerializable { public Map<String, Object> serialize() { Map<String, Object> result = new LinkedHashMap<String, Object>(); - + result.put("x", getX()); result.put("y", getY()); result.put("z", getZ()); - + return result; } - + public static Vector deserialize(Map<String, Object> args) { double x = 0; double y = 0; double z = 0; - + if (args.containsKey("x")) { - x = (Double)args.get("x"); + x = (Double) args.get("x"); } if (args.containsKey("y")) { - y = (Double)args.get("y"); + y = (Double) args.get("y"); } if (args.containsKey("z")) { - z = (Double)args.get("z"); + z = (Double) args.get("z"); } - + return new Vector(x, y, z); } } diff --git a/src/main/java/org/bukkit/util/config/Configuration.java b/src/main/java/org/bukkit/util/config/Configuration.java index 2259452e..07a6bab7 100644 --- a/src/main/java/org/bukkit/util/config/Configuration.java +++ b/src/main/java/org/bukkit/util/config/Configuration.java @@ -29,9 +29,11 @@ import org.yaml.snakeyaml.representer.Representer; * select child nodes by delimiting node names with periods. * * <p> - * For example, given the following configuration file:</p> + * For example, given the following configuration file: + * </p> * - * <pre>members: + * <pre> + * members: * - Hollie * - Jason * - Bobo @@ -44,13 +46,14 @@ import org.yaml.snakeyaml.representer.Representer; * sturmeh: * cool: false * eats: - * babies: true</pre> + * babies: true + * </pre> * - * <p>Calling code could access sturmeh's baby eating state by using - * <code>getBoolean("sturmeh.eats.babies", false)</code>. For lists, there are - * methods such as <code>getStringList</code> that will return a type safe list. + * <p> + * Calling code could access sturmeh's baby eating state by using <code>getBoolean("sturmeh.eats.babies", false)</code>. For lists, there are methods such as <code>getStringList</code> that will return a type safe list. * - * <p>This class is currently incomplete. It is not yet possible to get a node. + * <p> + * This class is currently incomplete. It is not yet possible to get a node. * </p> * * @deprecated See {@link YamlConfiguration} @@ -163,7 +166,8 @@ public class Configuration extends ConfigurationNode { } yaml.dump(root, writer); return true; - } catch (IOException e) {} finally { + } catch (IOException e) { + } finally { try { if (stream != null) { stream.close(); @@ -190,6 +194,7 @@ public class Configuration extends ConfigurationNode { /** * This method returns an empty ConfigurationNode for using as a * default in methods that select a node from a node list. + * * @return The empty node. */ public static ConfigurationNode getEmptyNode() { diff --git a/src/main/java/org/bukkit/util/config/ConfigurationNode.java b/src/main/java/org/bukkit/util/config/ConfigurationNode.java index 8e148030..e2f16278 100644 --- a/src/main/java/org/bukkit/util/config/ConfigurationNode.java +++ b/src/main/java/org/bukkit/util/config/ConfigurationNode.java @@ -40,17 +40,16 @@ public class ConfigurationNode { Map<String, Object> map = new TreeMap<String, Object>(); Set<String> keys = node.keySet(); - for( String k : keys ) { + for (String k : keys) { Object tmp = node.get(k); - if( tmp instanceof Map<?,?> ) { - Map<String, Object> rec = recursiveBuilder((Map <String,Object>) tmp); + if (tmp instanceof Map<?, ?>) { + Map<String, Object> rec = recursiveBuilder((Map<String, Object>) tmp); Set<String> subkeys = rec.keySet(); - for( String sk : subkeys ) { + for (String sk : subkeys) { map.put(k + "." + sk, rec.get(sk)); } - } - else { + } else { map.put(k, tmp); } } diff --git a/src/main/java/org/bukkit/util/noise/NoiseGenerator.java b/src/main/java/org/bukkit/util/noise/NoiseGenerator.java index 10a46b00..b060ed77 100644 --- a/src/main/java/org/bukkit/util/noise/NoiseGenerator.java +++ b/src/main/java/org/bukkit/util/noise/NoiseGenerator.java @@ -1,4 +1,3 @@ - package org.bukkit.util.noise; /** @@ -12,7 +11,7 @@ public abstract class NoiseGenerator { /** * Speedy floor, faster than (int)Math.floor(x) - * + * * @param x Value to floor * @return Floored value */ diff --git a/src/main/java/org/bukkit/util/noise/OctaveGenerator.java b/src/main/java/org/bukkit/util/noise/OctaveGenerator.java index b0588372..87777374 100644 --- a/src/main/java/org/bukkit/util/noise/OctaveGenerator.java +++ b/src/main/java/org/bukkit/util/noise/OctaveGenerator.java @@ -1,4 +1,3 @@ - package org.bukkit.util.noise; /** diff --git a/src/main/java/org/bukkit/util/noise/PerlinNoiseGenerator.java b/src/main/java/org/bukkit/util/noise/PerlinNoiseGenerator.java index 1c067c8a..ca6043e2 100644 --- a/src/main/java/org/bukkit/util/noise/PerlinNoiseGenerator.java +++ b/src/main/java/org/bukkit/util/noise/PerlinNoiseGenerator.java @@ -5,7 +5,7 @@ import org.bukkit.World; /** * Generates noise using the "classic" perlin generator - * + * * @see SimplexNoiseGenerator "Improved" and faster version with slighly different results */ public class PerlinNoiseGenerator extends NoiseGenerator { diff --git a/src/main/java/org/bukkit/util/noise/PerlinOctaveGenerator.java b/src/main/java/org/bukkit/util/noise/PerlinOctaveGenerator.java index a22e8e8a..d959dae0 100644 --- a/src/main/java/org/bukkit/util/noise/PerlinOctaveGenerator.java +++ b/src/main/java/org/bukkit/util/noise/PerlinOctaveGenerator.java @@ -1,4 +1,3 @@ - package org.bukkit.util.noise; import java.util.Random; diff --git a/src/main/java/org/bukkit/util/noise/SimplexOctaveGenerator.java b/src/main/java/org/bukkit/util/noise/SimplexOctaveGenerator.java index fb963871..d041fbc2 100644 --- a/src/main/java/org/bukkit/util/noise/SimplexOctaveGenerator.java +++ b/src/main/java/org/bukkit/util/noise/SimplexOctaveGenerator.java @@ -1,4 +1,3 @@ - package org.bukkit.util.noise; import java.util.Random; @@ -9,7 +8,7 @@ import org.bukkit.World; */ public class SimplexOctaveGenerator extends OctaveGenerator { private double wScale = 1; - + /** * Creates a simplex octave generator for the given world * @@ -102,8 +101,8 @@ public class SimplexOctaveGenerator extends OctaveGenerator { z *= zScale; w *= wScale; - for (int i = 0; i < octaves.length; i++) { - result += ((SimplexNoiseGenerator)octaves[i]).noise(x * freq, y * freq, z * freq, w * freq) * amp; + for (NoiseGenerator octave : octaves) { + result += ((SimplexNoiseGenerator) octave).noise(x * freq, y * freq, z * freq, w * freq) * amp; max += amp; freq *= frequency; amp *= amplitude; diff --git a/src/main/java/org/bukkit/util/permissions/DefaultPermissions.java b/src/main/java/org/bukkit/util/permissions/DefaultPermissions.java index 82a41385..ebccd45c 100644 --- a/src/main/java/org/bukkit/util/permissions/DefaultPermissions.java +++ b/src/main/java/org/bukkit/util/permissions/DefaultPermissions.java @@ -7,9 +7,8 @@ import org.bukkit.permissions.PermissionDefault; public final class DefaultPermissions { private static final String ROOT = "craftbukkit"; - private static final String PREFIX = ROOT + "."; private static final String LEGACY_PREFIX = "craft"; - + private DefaultPermissions() {} public static Permission registerPermission(Permission perm) { |