Generic cleanup of warnings, whitespace and style.

By: Erik Broes <erikbroes@grum.nl>
This commit is contained in:
Bukkit/Spigot 2011-12-25 16:02:30 +01:00
parent 98960fd73e
commit aaab1cba23
257 changed files with 1408 additions and 1152 deletions

View File

@ -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);

View File

@ -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

View File

@ -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();

View File

@ -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();

View File

@ -241,7 +241,7 @@ public class Location implements Cloneable {
return this;
}
/**
/**
* Adds the location by a vector.
*
* @see Vector
@ -290,7 +290,7 @@ public class Location implements Cloneable {
return this;
}
/**
/**
* Subtracts the location by a vector.
*
* @see Vector
@ -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,

View File

@ -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.
*/

View File

@ -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);
/**

View File

@ -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
*

View File

@ -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() {

View File

@ -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();

View File

@ -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);
}
}

View File

@ -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);

View File

@ -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) {

View File

@ -1,4 +1,4 @@
package org.bukkit.command;
public interface ConsoleCommandSender extends CommandSender{
public interface ConsoleCommandSender extends CommandSender {
}

View File

@ -1,4 +1,3 @@
package org.bukkit.command;
/**

View File

@ -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);
}
}

View File

@ -1,4 +1,4 @@
package org.bukkit.command;
public interface RemoteConsoleCommandSender extends CommandSender{
public interface RemoteConsoleCommandSender extends CommandSender {
}

View File

@ -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();

View File

@ -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;

View File

@ -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) {

View File

@ -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);

View File

@ -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());

View File

@ -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;

View File

@ -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)) {

View File

@ -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;
}

View File

@ -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);
}

View File

@ -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>

View File

@ -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.

View File

@ -10,7 +10,7 @@ public class MemoryConfigurationOptions extends ConfigurationOptions {
@Override
public MemoryConfiguration configuration() {
return (MemoryConfiguration)super.configuration();
return (MemoryConfiguration) super.configuration();
}
@Override

View File

@ -40,7 +40,7 @@ public class MemorySection implements ConfigurationSection {
this.path = "";
this.fullPath = "";
this.parent = null;
this.root = (Configuration)this;
this.root = (Configuration) this;
}
/**
@ -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");
}
@ -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) {
@ -268,12 +263,13 @@ public class MemorySection implements ConfigurationSection {
}
}
@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) {
@ -457,7 +455,7 @@ public class MemorySection implements ConfigurationSection {
return null;
}
List<String> result = new ArrayList();
List<String> result = new ArrayList<String>();
for (Object object : list) {
if ((object instanceof String) || (isPrimitiveWrapper(object))) {
@ -479,29 +477,30 @@ public class MemorySection implements ConfigurationSection {
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);
}
}
@ -519,11 +518,11 @@ public class MemorySection implements ConfigurationSection {
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);
@ -547,29 +546,30 @@ public class MemorySection implements ConfigurationSection {
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);
}
}
@ -587,29 +587,30 @@ public class MemorySection implements ConfigurationSection {
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);
}
}
@ -627,29 +628,30 @@ public class MemorySection implements ConfigurationSection {
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);
}
}
@ -667,29 +669,30 @@ public class MemorySection implements ConfigurationSection {
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);
}
}
@ -707,31 +710,31 @@ public class MemorySection implements ConfigurationSection {
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);
}
}
@ -749,60 +752,62 @@ public class MemorySection implements ConfigurationSection {
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) {
@ -883,8 +888,9 @@ public class MemorySection implements ConfigurationSection {
}
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;
@ -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);
}
}
}
@ -991,7 +997,6 @@ 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>

View File

@ -195,6 +195,6 @@ public abstract class FileConfiguration extends MemoryConfiguration {
options = new FileConfigurationOptions(this);
}
return (FileConfigurationOptions)options;
return (FileConfigurationOptions) options;
}
}

View File

@ -15,7 +15,7 @@ public class FileConfigurationOptions extends MemoryConfigurationOptions {
@Override
public FileConfiguration configuration() {
return (FileConfiguration)super.configuration();
return (FileConfiguration) super.configuration();
}
@Override
@ -56,7 +56,7 @@ 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

View File

@ -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;
@ -56,7 +56,8 @@ public class YamlConfiguration extends FileConfiguration {
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);
@ -84,7 +85,8 @@ public class YamlConfiguration extends FileConfiguration {
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);
@ -120,13 +122,13 @@ public class YamlConfiguration extends FileConfiguration {
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()));
@ -168,6 +170,7 @@ public class YamlConfiguration extends FileConfiguration {
return result.toString();
}
@Override
protected String buildHeader() {
String header = options().header();
@ -175,7 +178,7 @@ public class YamlConfiguration extends FileConfiguration {
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)) {
@ -211,7 +214,7 @@ public class YamlConfiguration extends FileConfiguration {
options = new YamlConfigurationOptions(this);
}
return (YamlConfigurationOptions)options;
return (YamlConfigurationOptions) options;
}
/**

View File

@ -12,7 +12,7 @@ public class YamlConfigurationOptions extends FileConfigurationOptions {
@Override
public YamlConfiguration configuration() {
return (YamlConfiguration)super.configuration();
return (YamlConfiguration) super.configuration();
}
@Override

View File

@ -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 {
/**

View File

@ -58,7 +58,7 @@ public class ConfigurationSerialization {
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");
@ -151,7 +151,7 @@ public class ConfigurationSerialization {
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 + ")'");
@ -177,7 +177,7 @@ public class ConfigurationSerialization {
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());
}
@ -208,7 +208,9 @@ public class ConfigurationSerialization {
* @param clazz Class to unregister
*/
public static void unregisterClass(Class<? extends ConfigurationSerializable> clazz) {
while (aliases.values().remove(clazz));
while (aliases.values().remove(clazz)) {
;
}
}
/**

View File

@ -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,30 +166,35 @@ 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();
@ -205,8 +211,7 @@ public interface Entity {
/**
* 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
*/

View File

@ -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();

View File

@ -39,14 +39,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.
*

View File

@ -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();

View File

@ -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();

View File

@ -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.

View File

@ -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.
*/

View File

@ -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

View File

@ -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();

View File

@ -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;

View File

@ -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) {

View File

@ -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;

View File

@ -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;

View File

@ -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;

View File

@ -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;

View File

@ -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

View File

@ -6,6 +6,7 @@ import org.bukkit.event.Event;
/**
* Represents a block related event.
*/
@SuppressWarnings("serial")
public class BlockEvent extends Event {
protected Block block;

View File

@ -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;

View File

@ -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;

View File

@ -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;

View File

@ -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;

View File

@ -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

View File

@ -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;

View File

@ -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;

View File

@ -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;

View File

@ -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);

View File

@ -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;

View File

@ -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;

View File

@ -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;

View File

@ -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;

View File

@ -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;

View File

@ -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;

View File

@ -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;

View File

@ -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;

View File

@ -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;

View File

@ -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() {

View File

@ -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() {

View File

@ -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) {

View File

@ -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;

View File

@ -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;

View File

@ -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 {

View File

@ -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;

View File

@ -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;

View File

@ -6,6 +6,7 @@ import org.bukkit.event.Event;
/**
* Represents an Entity-related event
*/
@SuppressWarnings("serial")
public class EntityEvent extends Event {
protected Entity entity;

View File

@ -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) {

View File

@ -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;

View File

@ -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

View File

@ -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;

View File

@ -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;

View File

@ -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;

View File

@ -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() {

View File

@ -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;

View File

@ -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;

View File

@ -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;

View File

@ -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;

View File

@ -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 = "";

View File

@ -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) {

View File

@ -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;

View File

@ -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;

View File

@ -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() {

View File

@ -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() {}

View File

@ -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;

View File

@ -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;

View File

@ -6,6 +6,7 @@ import org.bukkit.event.Event;
/**
* Represents a painting-related event.
*/
@SuppressWarnings("serial")
public class PaintingEvent extends Event {
protected Painting painting;

Some files were not shown because too many files have changed in this diff Show More