From 88c17a7f86eacd1bc49c8f97577bf3c8bc60662f Mon Sep 17 00:00:00 2001 From: Erik Broes Date: Sun, 15 Jan 2012 14:37:30 +0100 Subject: Generic cleaning --- src/main/java/org/bukkit/Achievement.java | 4 +- src/main/java/org/bukkit/Bukkit.java | 2 +- src/main/java/org/bukkit/EntityEffect.java | 93 +++++++++++----------- src/main/java/org/bukkit/Material.java | 1 - src/main/java/org/bukkit/Server.java | 14 ++-- src/main/java/org/bukkit/Statistic.java | 2 +- src/main/java/org/bukkit/World.java | 31 +++----- src/main/java/org/bukkit/block/Block.java | 6 +- src/main/java/org/bukkit/block/BlockState.java | 2 +- src/main/java/org/bukkit/block/Sign.java | 4 +- src/main/java/org/bukkit/command/Command.java | 2 +- .../bukkit/command/defaults/BanListCommand.java | 2 +- .../bukkit/command/defaults/TimingsCommand.java | 3 +- .../org/bukkit/configuration/MemorySection.java | 2 - .../file/FileConfigurationOptions.java | 1 - .../configuration/file/YamlConfiguration.java | 3 - .../bukkit/configuration/file/YamlConstructor.java | 2 + .../bukkit/configuration/file/YamlRepresenter.java | 4 +- src/main/java/org/bukkit/entity/Animals.java | 1 - src/main/java/org/bukkit/entity/Minecart.java | 2 +- src/main/java/org/bukkit/entity/Player.java | 22 +++-- src/main/java/org/bukkit/entity/Projectile.java | 2 +- src/main/java/org/bukkit/entity/Tameable.java | 4 +- src/main/java/org/bukkit/event/Event.java | 16 ++-- .../bukkit/event/block/EntityBlockFormEvent.java | 6 +- .../event/entity/EntityCombustByBlockEvent.java | 2 +- .../bukkit/event/entity/EntityCombustEvent.java | 2 +- .../org/bukkit/event/entity/EntityDamageEvent.java | 32 ++++---- .../org/bukkit/event/entity/EntityListener.java | 2 +- .../org/bukkit/event/entity/EntityTargetEvent.java | 2 +- .../org/bukkit/event/entity/PlayerDeathEvent.java | 28 +++---- .../bukkit/event/player/PlayerEggThrowEvent.java | 4 +- .../bukkit/event/player/PlayerInteractEvent.java | 2 +- .../org/bukkit/event/player/PlayerMoveEvent.java | 4 +- .../org/bukkit/event/world/ChunkPopulateEvent.java | 2 +- .../java/org/bukkit/event/world/WorldListener.java | 5 +- .../java/org/bukkit/generator/BlockPopulator.java | 2 +- .../java/org/bukkit/generator/ChunkGenerator.java | 2 +- src/main/java/org/bukkit/inventory/Inventory.java | 3 +- src/main/java/org/bukkit/map/MapRenderer.java | 2 +- src/main/java/org/bukkit/material/Colorable.java | 1 - .../java/org/bukkit/permissions/Permissible.java | 6 +- .../java/org/bukkit/permissions/Permission.java | 16 ++-- .../bukkit/permissions/PermissionAttachment.java | 6 +- src/main/java/org/bukkit/plugin/PluginLoader.java | 4 +- src/main/java/org/bukkit/plugin/PluginManager.java | 29 ++++--- .../org/bukkit/plugin/SimplePluginManager.java | 10 +-- .../java/org/bukkit/plugin/java/JavaPlugin.java | 2 +- .../org/bukkit/plugin/java/JavaPluginLoader.java | 6 +- .../PluginMessageListenerRegistration.java | 2 +- .../bukkit/plugin/messaging/StandardMessenger.java | 2 +- .../java/org/bukkit/scheduler/BukkitScheduler.java | 14 ++-- .../java/org/bukkit/scheduler/BukkitWorker.java | 2 +- src/main/java/org/bukkit/util/BlockIterator.java | 4 - src/main/java/org/bukkit/util/Vector.java | 5 +- .../java/org/bukkit/util/config/Configuration.java | 2 - .../org/bukkit/util/noise/OctaveGenerator.java | 6 +- .../bukkit/util/noise/SimplexNoiseGenerator.java | 2 +- 58 files changed, 209 insertions(+), 235 deletions(-) (limited to 'src/main/java') diff --git a/src/main/java/org/bukkit/Achievement.java b/src/main/java/org/bukkit/Achievement.java index 4fcffa69..06b41a1a 100644 --- a/src/main/java/org/bukkit/Achievement.java +++ b/src/main/java/org/bukkit/Achievement.java @@ -37,7 +37,7 @@ public enum Achievement { /** * Gets the ID for this achievement. - * + *

* Note that this is offset using {@link #STATISTIC_OFFSET} * * @return ID of this achievement @@ -48,7 +48,7 @@ public enum Achievement { /** * Gets the achievement associated with the given ID. - * + *

* Note that the ID must already be offset using {@link #STATISTIC_OFFSET} * * @param id ID of the achievement to return diff --git a/src/main/java/org/bukkit/Bukkit.java b/src/main/java/org/bukkit/Bukkit.java index 739c6099..d0d52eaa 100644 --- a/src/main/java/org/bukkit/Bukkit.java +++ b/src/main/java/org/bukkit/Bukkit.java @@ -42,7 +42,7 @@ public final class Bukkit { /** * Attempts to set the {@link Server} singleton. - * + *

* This cannot be done if the Server is already set. * * @param server Server instance diff --git a/src/main/java/org/bukkit/EntityEffect.java b/src/main/java/org/bukkit/EntityEffect.java index 9b2550dd..4a04e96a 100644 --- a/src/main/java/org/bukkit/EntityEffect.java +++ b/src/main/java/org/bukkit/EntityEffect.java @@ -4,51 +4,50 @@ package org.bukkit; * A list of all Effects that can happen to entities. */ public enum EntityEffect { - - /** - * When mobs get hurt. - */ - HURT((byte) 2), - - /** - * When a mob dies. - *

- * This will cause client-glitches! - */ - DEATH((byte) 3), - - /** - * The smoke when taming a wolf fails. - *

- * Without client-mods this will be ignored if the entity is not a wolf. - */ - WOLF_SMOKE((byte) 6), - - /** - * The hearts when taming a wolf succeeds. - *

- * Without client-mods this will be ignored if the entity is not a wolf. - */ - WOLF_HEARTS((byte) 7), - - /** - * When a wolf shakes (after being wet). - *

- * Without client-mods this will be ignored if the entity is not a wolf. - */ - WOLF_SHAKE((byte) 8); - - private final byte data; - - EntityEffect(byte data) - { - this.data = data; - } - - /** - * @return The data-value that is sent to the client to play this effect. - */ - public byte getData() { - return data; - } + + /** + * When mobs get hurt. + */ + HURT((byte) 2), + + /** + * When a mob dies. + *

+ * This will cause client-glitches! + */ + DEATH((byte) 3), + + /** + * The smoke when taming a wolf fails. + *

+ * Without client-mods this will be ignored if the entity is not a wolf. + */ + WOLF_SMOKE((byte) 6), + + /** + * The hearts when taming a wolf succeeds. + *

+ * Without client-mods this will be ignored if the entity is not a wolf. + */ + WOLF_HEARTS((byte) 7), + + /** + * When a wolf shakes (after being wet). + *

+ * Without client-mods this will be ignored if the entity is not a wolf. + */ + WOLF_SHAKE((byte) 8); + + private final byte data; + + EntityEffect(byte data) { + this.data = data; + } + + /** + * @return The data-value that is sent to the client to play this effect. + */ + public byte getData() { + return data; + } } diff --git a/src/main/java/org/bukkit/Material.java b/src/main/java/org/bukkit/Material.java index 49e47993..23747603 100644 --- a/src/main/java/org/bukkit/Material.java +++ b/src/main/java/org/bukkit/Material.java @@ -2,7 +2,6 @@ package org.bukkit; import java.lang.reflect.Constructor; import java.lang.reflect.InvocationTargetException; -import java.util.Arrays; import java.util.HashMap; import java.util.Map; import java.util.logging.Level; diff --git a/src/main/java/org/bukkit/Server.java b/src/main/java/org/bukkit/Server.java index 6c78def2..c10dba94 100644 --- a/src/main/java/org/bukkit/Server.java +++ b/src/main/java/org/bukkit/Server.java @@ -30,14 +30,14 @@ import org.bukkit.scheduler.BukkitScheduler; public interface Server extends PluginMessageRecipient { /** * Used for all administrative messages, such as an operator using a command. - * + *

* For use in {@link #broadcast(java.lang.String, java.lang.String)} */ public static final String BROADCAST_CHANNEL_ADMINISTRATIVE = "bukkit.broadcast.admin"; /** * Used for all announcement messages, such as informing users that a player has joined. - * + *

* For use in {@link #broadcast(java.lang.String, java.lang.String)} */ public static final String BROADCAST_CHANNEL_USERS = "bukkit.broadcast.user"; @@ -155,7 +155,7 @@ public interface Server extends PluginMessageRecipient { /** * Broadcast a message to all players. - * + *

* This is the same as calling {@link #broadcast(java.lang.String, java.lang.String)} to {@link #BROADCAST_CHANNEL_USERS} * * @param message the message @@ -166,7 +166,7 @@ public interface Server extends PluginMessageRecipient { /** * Gets the name of the update folder. The update folder is used to safely update * plugins at the right moment on a plugin load. - * + *

* The update folder name is relative to the plugins folder. * * @return The name of the update folder @@ -183,7 +183,7 @@ public interface Server extends PluginMessageRecipient { /** * Gets a player object by the given username - * + *

* This method may not return objects for offline players * * @param name Name to look up @@ -202,7 +202,7 @@ public interface Server extends PluginMessageRecipient { /** * Attempts to match any players with the given name, and returns a list * of all possibly matches - * + *

* This list is not sorted in any particular order. If an exact match is found, * the returned list will only contain a single result. * @@ -457,7 +457,7 @@ public interface Server extends PluginMessageRecipient { /** * Gets the player by the given name, regardless if they are offline or online. - * + *

* This will return an object even if the player does not exist. To this method, all players will exist. * * @param name Name of the player to retrieve diff --git a/src/main/java/org/bukkit/Statistic.java b/src/main/java/org/bukkit/Statistic.java index 97923b8c..e7195bb6 100644 --- a/src/main/java/org/bukkit/Statistic.java +++ b/src/main/java/org/bukkit/Statistic.java @@ -47,7 +47,7 @@ public enum Statistic { /** * Checks if this is a substatistic. - * + *

* A substatistic exists in mass for each block or item, depending on {@link #isBlock()} * * @return true if this is a substatistic diff --git a/src/main/java/org/bukkit/World.java b/src/main/java/org/bukkit/World.java index 4e2e34bf..bf77db6e 100644 --- a/src/main/java/org/bukkit/World.java +++ b/src/main/java/org/bukkit/World.java @@ -82,7 +82,6 @@ public interface World extends PluginMessageRecipient { * * @param x X-coordinate of the block * @param z Z-coordinate of the block - * * @return Highest non-empty block */ public Block getHighestBlockAt(int x, int z); @@ -91,7 +90,6 @@ public interface World extends PluginMessageRecipient { * Gets the highest non-empty block at the given coordinates * * @param location Coordinates to get the highest block - * * @return Highest non-empty block */ public Block getHighestBlockAt(Location location); @@ -154,7 +152,7 @@ public interface World extends PluginMessageRecipient { /** * Loads the {@link Chunk} at the specified coordinates - * + *

* If the chunk does not exist, it will be generated. * This method is analogous to {@link #loadChunk(int, int, boolean)} where generate is true. * @@ -175,7 +173,7 @@ public interface World extends PluginMessageRecipient { /** * Safely unloads and saves the {@link Chunk} at the specified coordinates - * + *

* This method is analogous to {@link #unloadChunk(int, int, boolean, boolean)} where safe and saveis true * * @param chunk the chunk to unload @@ -185,7 +183,7 @@ public interface World extends PluginMessageRecipient { /** * Safely unloads and saves the {@link Chunk} at the specified coordinates - * + *

* This method is analogous to {@link #unloadChunk(int, int, boolean, boolean)} where safe and saveis true * * @param x X-coordinate of the chunk @@ -196,7 +194,7 @@ public interface World extends PluginMessageRecipient { /** * Safely unloads and optionally saves the {@link Chunk} at the specified coordinates - * + *

* This method is analogous to {@link #unloadChunk(int, int, boolean, boolean)} where save is true * * @param x X-coordinate of the chunk @@ -219,7 +217,7 @@ public interface World extends PluginMessageRecipient { /** * Safely queues the {@link Chunk} at the specified coordinates for unloading - * + *

* This method is analogous to {@link #unloadChunkRequest(int, int, boolean)} where safe is true * * @param x X-coordinate of the chunk @@ -366,7 +364,7 @@ public interface World extends PluginMessageRecipient { /** * Gets a semi-unique identifier for this world. - * + *

* While it is highly unlikely that this may be shared with another World, * it is not guaranteed to be unique * @@ -395,7 +393,7 @@ public interface World extends PluginMessageRecipient { /** * Gets the relative in-game time of this world. - * + *

* The relative time is analogous to hours * 1000 * * @return The current relative time @@ -405,7 +403,7 @@ public interface World extends PluginMessageRecipient { /** * Sets the relative in-game time on the server. - * + *

* The relative time is analogous to hours * 1000 *

* Note that setting the relative time below the current relative time will @@ -650,43 +648,40 @@ public interface World extends PluginMessageRecipient { /** * Gets the biome for the given block coordinates. - * + *

* It is safe to run this method when the block does not exist, it will not create the block. * * @param x X coordinate of the block * @param z Z coordinate of the block - * * @return Biome of the requested block */ public Biome getBiome(int x, int z); /** * Gets the temperature for the given block coordinates. - * + *

* It is safe to run this method when the block does not exist, it will not create the block. * * @param x X coordinate of the block * @param z Z coordinate of the block - * * @return Temperature of the requested block */ public double getTemperature(int x, int z); /** * Gets the humidity for the given block coordinates. - * + *

* It is safe to run this method when the block does not exist, it will not create the block. * * @param x X coordinate of the block * @param z Z coordinate of the block - * * @return Humidity of the requested block */ public double getHumidity(int x, int z); /** * Gets the maximum height of this world. - * + *

* If the max height is 100, there are only blocks from y=0 to y=99. * * @return Maximum height of the world @@ -695,7 +690,7 @@ public interface World extends PluginMessageRecipient { /** * Gets the sea level for this world. - * + *

* This is often half of {@link #getMaxHeight()} * * @return Sea level diff --git a/src/main/java/org/bukkit/block/Block.java b/src/main/java/org/bukkit/block/Block.java index 58030574..c758bb31 100644 --- a/src/main/java/org/bukkit/block/Block.java +++ b/src/main/java/org/bukkit/block/Block.java @@ -186,7 +186,7 @@ public interface Block { /** * Captures the current state of this block. You may then cast that state * into any accepted type, such as Furnace or Sign. - * + *

* The returned object will never be updated, and you are not guaranteed that * (for example) a sign is still a sign after you capture its state. * @@ -248,7 +248,7 @@ public interface Block { /** * Checks if this block is empty. - * + *

* A block is considered empty when {@link #getType()} returns {@link Material#AIR}. * * @return true if this block is empty @@ -257,7 +257,7 @@ public interface Block { /** * Checks if this block is liquid. - * + *

* A block is considered liquid when {@link #getType()} returns {@link Material#WATER}, {@link Material#STATIONARY_WATER}, {@link Material#LAVA} or {@link Material#STATIONARY_LAVA}. * * @return true if this block is liquid diff --git a/src/main/java/org/bukkit/block/BlockState.java b/src/main/java/org/bukkit/block/BlockState.java index efdd2f3a..65de77d3 100644 --- a/src/main/java/org/bukkit/block/BlockState.java +++ b/src/main/java/org/bukkit/block/BlockState.java @@ -7,7 +7,7 @@ import org.bukkit.material.MaterialData; /** * Represents a captured state of a block, which will not change automatically. - * + *

* Unlike Block, which only one object can exist per coordinate, BlockState can * exist multiple times for any given Block. Note that another plugin may change * the state of the block and you will not know, or they may change the block to diff --git a/src/main/java/org/bukkit/block/Sign.java b/src/main/java/org/bukkit/block/Sign.java index 6c26408a..9ceaecdb 100644 --- a/src/main/java/org/bukkit/block/Sign.java +++ b/src/main/java/org/bukkit/block/Sign.java @@ -14,7 +14,7 @@ public interface Sign extends BlockState { /** * Gets the line of text at the specified index. - * + *

* For example, getLine(0) will return the first line of text. * * @param index Line number to get the text from, starting at 0 @@ -25,7 +25,7 @@ public interface Sign extends BlockState { /** * Sets the line of text at the specified index. - * + *

* For example, setLine(0, "Line One") will set the first line of text to * "Line One". * diff --git a/src/main/java/org/bukkit/command/Command.java b/src/main/java/org/bukkit/command/Command.java index c4305878..6ce96119 100644 --- a/src/main/java/org/bukkit/command/Command.java +++ b/src/main/java/org/bukkit/command/Command.java @@ -75,7 +75,7 @@ public abstract class Command { /** * Tests the given {@link CommandSender} to see if they can perform this command. - * + *

* If they do not have permission, they will be informed that they cannot do this. * * @param target User to test diff --git a/src/main/java/org/bukkit/command/defaults/BanListCommand.java b/src/main/java/org/bukkit/command/defaults/BanListCommand.java index b844faed..36ca99f4 100644 --- a/src/main/java/org/bukkit/command/defaults/BanListCommand.java +++ b/src/main/java/org/bukkit/command/defaults/BanListCommand.java @@ -20,7 +20,7 @@ public class BanListCommand extends VanillaCommand { StringBuilder message = new StringBuilder().append(ChatColor.GRAY).append("Ban list:"); int count = 0; - for (OfflinePlayer p : Bukkit.getServer().getBannedPlayers()){ + for (OfflinePlayer p : Bukkit.getServer().getBannedPlayers()) { if (count++ > 0) { message.append(", "); } diff --git a/src/main/java/org/bukkit/command/defaults/TimingsCommand.java b/src/main/java/org/bukkit/command/defaults/TimingsCommand.java index 3798f5e9..6b725797 100644 --- a/src/main/java/org/bukkit/command/defaults/TimingsCommand.java +++ b/src/main/java/org/bukkit/command/defaults/TimingsCommand.java @@ -29,8 +29,7 @@ public class TimingsCommand extends Command { plugin.resetTimings(); } sender.sendMessage("Timings reset"); - } - else if("merged".equals(args[0]) || seperate) { + } else if ("merged".equals(args[0]) || seperate) { int index = 0; int pluginIdx = 0; diff --git a/src/main/java/org/bukkit/configuration/MemorySection.java b/src/main/java/org/bukkit/configuration/MemorySection.java index 036b2258..6d6c3f9d 100644 --- a/src/main/java/org/bukkit/configuration/MemorySection.java +++ b/src/main/java/org/bukkit/configuration/MemorySection.java @@ -1,7 +1,5 @@ package org.bukkit.configuration; -import org.bukkit.configuration.serialization.ConfigurationSerializable; -import java.io.File; import java.util.ArrayList; import java.util.LinkedHashMap; import java.util.LinkedHashSet; diff --git a/src/main/java/org/bukkit/configuration/file/FileConfigurationOptions.java b/src/main/java/org/bukkit/configuration/file/FileConfigurationOptions.java index e99c4cfa..3d225443 100644 --- a/src/main/java/org/bukkit/configuration/file/FileConfigurationOptions.java +++ b/src/main/java/org/bukkit/configuration/file/FileConfigurationOptions.java @@ -56,7 +56,6 @@ public class FileConfigurationOptions extends MemoryConfigurationOptions { * but you may include one if you wish for extra spacing. *

* Null is a valid value which will indicate that no header is to be applied. - * * * @param value New header * @return This object, for chaining diff --git a/src/main/java/org/bukkit/configuration/file/YamlConfiguration.java b/src/main/java/org/bukkit/configuration/file/YamlConfiguration.java index 6349dc9a..14b2c297 100644 --- a/src/main/java/org/bukkit/configuration/file/YamlConfiguration.java +++ b/src/main/java/org/bukkit/configuration/file/YamlConfiguration.java @@ -12,11 +12,8 @@ import org.bukkit.Bukkit; 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; import org.yaml.snakeyaml.Yaml; -import org.yaml.snakeyaml.constructor.SafeConstructor; import org.yaml.snakeyaml.error.YAMLException; import org.yaml.snakeyaml.representer.Representer; diff --git a/src/main/java/org/bukkit/configuration/file/YamlConstructor.java b/src/main/java/org/bukkit/configuration/file/YamlConstructor.java index 678730eb..9e6e1d2d 100644 --- a/src/main/java/org/bukkit/configuration/file/YamlConstructor.java +++ b/src/main/java/org/bukkit/configuration/file/YamlConstructor.java @@ -17,6 +17,7 @@ public class YamlConstructor extends SafeConstructor { } private class ConstructCustomObject extends ConstructYamlMap { + @Override public Object construct(Node node) { if (node.isTwoStepsConstruction()) { throw new YAMLException("Unexpected referential mapping structure. Node: " + node); @@ -40,6 +41,7 @@ public class YamlConstructor extends SafeConstructor { return raw; } + @Override public void construct2ndStep(Node node, Object object) { throw new YAMLException("Unexpected referential mapping structure. Node: " + node); } diff --git a/src/main/java/org/bukkit/configuration/file/YamlRepresenter.java b/src/main/java/org/bukkit/configuration/file/YamlRepresenter.java index fbdc181c..817e66f1 100644 --- a/src/main/java/org/bukkit/configuration/file/YamlRepresenter.java +++ b/src/main/java/org/bukkit/configuration/file/YamlRepresenter.java @@ -1,4 +1,3 @@ - package org.bukkit.configuration.file; import java.util.LinkedHashMap; @@ -9,7 +8,6 @@ import org.bukkit.configuration.serialization.ConfigurationSerializable; import org.bukkit.configuration.serialization.ConfigurationSerialization; import org.yaml.snakeyaml.nodes.Node; -import org.yaml.snakeyaml.representer.Represent; import org.yaml.snakeyaml.representer.Representer; public class YamlRepresenter extends Representer { @@ -20,6 +18,7 @@ public class YamlRepresenter extends Representer { } private class RepresentConfigurationSection extends RepresentMap { + @Override @SuppressWarnings("unchecked") public Node representData(Object data) { return super.representData(((ConfigurationSection) data).getValues(false)); @@ -27,6 +26,7 @@ public class YamlRepresenter extends Representer { } private class RepresentConfigurationSerializable extends RepresentMap { + @Override @SuppressWarnings("unchecked") public Node representData(Object data) { ConfigurationSerializable serializable = (ConfigurationSerializable) data; diff --git a/src/main/java/org/bukkit/entity/Animals.java b/src/main/java/org/bukkit/entity/Animals.java index 960c441f..9ce52193 100644 --- a/src/main/java/org/bukkit/entity/Animals.java +++ b/src/main/java/org/bukkit/entity/Animals.java @@ -2,7 +2,6 @@ package org.bukkit.entity; /** * Represents an Animal. - * */ public interface Animals extends Creature { /** diff --git a/src/main/java/org/bukkit/entity/Minecart.java b/src/main/java/org/bukkit/entity/Minecart.java index 554c3fdb..35807bf8 100644 --- a/src/main/java/org/bukkit/entity/Minecart.java +++ b/src/main/java/org/bukkit/entity/Minecart.java @@ -67,7 +67,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 diff --git a/src/main/java/org/bukkit/entity/Player.java b/src/main/java/org/bukkit/entity/Player.java index 8132cf66..6b35240e 100644 --- a/src/main/java/org/bukkit/entity/Player.java +++ b/src/main/java/org/bukkit/entity/Player.java @@ -16,12 +16,11 @@ import org.bukkit.plugin.messaging.PluginMessageRecipient; /** * Represents a player, connected or not - * */ public interface Player extends HumanEntity, CommandSender, OfflinePlayer, PluginMessageRecipient { /** * Gets the "friendly" name to display of this player. This may include color. - * + *

* Note that this name will not be displayed in game, only in chat and places * defined by plugins * @@ -31,7 +30,7 @@ public interface Player extends HumanEntity, CommandSender, OfflinePlayer, Plugi /** * Sets the "friendly" name to display of this player. This may include color. - * + *

* Note that this name will not be displayed in game, only in chat and places * defined by plugins * @@ -153,7 +152,7 @@ public interface Player extends HumanEntity, CommandSender, OfflinePlayer, Plugi /** * Loads the players current location, health, inventory, motion, and other information from the username.dat file, in the world/player folder - * + *

* Note: This will overwrite the players current inventory, health, motion, etc, with the state from the saved dat file. */ public void loadData(); @@ -220,7 +219,7 @@ public interface Player extends HumanEntity, CommandSender, OfflinePlayer, Plugi * 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. - * + *

* 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 * format. @@ -230,7 +229,6 @@ public interface Player extends HumanEntity, CommandSender, OfflinePlayer, Plugi * @param sy The y size of the cuboid * @param sz The z size of the cuboid * @param data The data to be sent - * * @return true if the chunk change packet was sent */ public boolean sendChunkChange(Location loc, int sx, int sy, int sz, byte[] data); @@ -303,7 +301,7 @@ public interface Player extends HumanEntity, CommandSender, OfflinePlayer, Plugi /** * Sets the current time on the player's client. When relative is true the player's time * will be kept synchronized to its world time with the specified offset. - * + *

* When using non relative time the player's time will stay fixed at the specified time parameter. It's up to * the caller to continue updating the player's time. To restore player time to normal use resetPlayerTime(). * @@ -471,19 +469,19 @@ public interface Player extends HumanEntity, CommandSender, OfflinePlayer, Plugi * @return Bed Spawn Location if bed exists, otherwise null. */ public Location getBedSpawnLocation(); - + /** * Determines if the Player is allowed to fly via jump key double-tap like in creative mode. - * + * * @return True if the player is allowed to fly. */ public boolean getAllowFlight(); - + /** * Sets if the Player is allowed to fly via jump key double-tap like in creative mode. - * + * * @param flight If flight should be allowed. */ public void setAllowFlight(boolean flight); - + } diff --git a/src/main/java/org/bukkit/entity/Projectile.java b/src/main/java/org/bukkit/entity/Projectile.java index c8212540..0f440035 100644 --- a/src/main/java/org/bukkit/entity/Projectile.java +++ b/src/main/java/org/bukkit/entity/Projectile.java @@ -24,7 +24,7 @@ public interface Projectile extends Entity { /** * Determine if this projectile should bounce or not when it hits. - * + *

* If a small fireball does not bounce it will set the target on fire. * * @return true if it should bounce. diff --git a/src/main/java/org/bukkit/entity/Tameable.java b/src/main/java/org/bukkit/entity/Tameable.java index a9dd8664..539bda1b 100644 --- a/src/main/java/org/bukkit/entity/Tameable.java +++ b/src/main/java/org/bukkit/entity/Tameable.java @@ -4,7 +4,7 @@ public interface Tameable { /** * Check if this is tamed - * + *

* If something is tamed then a player can not tame it through normal methods, even if it does not belong to anyone in particular. * * @return true if this has been tamed @@ -13,7 +13,7 @@ public interface Tameable { /** * Sets if this has been tamed. Not necessary if the method setOwner has been used, as it tames automatically. - * + *

* If something is tamed then a player can not tame it through normal methods, even if it does not belong to anyone in particular. * * @param tame true if tame diff --git a/src/main/java/org/bukkit/event/Event.java b/src/main/java/org/bukkit/event/Event.java index 08250268..90ff6dbd 100644 --- a/src/main/java/org/bukkit/event/Event.java +++ b/src/main/java/org/bukkit/event/Event.java @@ -78,7 +78,7 @@ public abstract class Event implements Serializable { Highest, /** * Event is listened to purely for monitoring the outcome of an event. - * + *

* No modifications to the event should be made under this priority */ Monitor @@ -333,7 +333,7 @@ public abstract class Event implements Serializable { /** * Called when a block is undergoing a universe physics * check on whether it can be built - * + *

* For example, cacti cannot be built on grass unless overridden here * * @see org.bukkit.event.block.BlockCanBuildEvent @@ -355,7 +355,7 @@ public abstract class Event implements Serializable { BLOCK_IGNITE(Category.BLOCK), /** * Called when a block undergoes a physics check - * + *

* A physics check is commonly called when an adjacent block changes * type * @@ -531,7 +531,7 @@ public abstract class Event implements Serializable { /** * Called when a chunk is loaded - * + *

* If a new chunk is being generated for loading, it will call * Type.CHUNK_GENERATION and then Type.CHUNK_LOADED upon completion * @@ -546,7 +546,7 @@ public abstract class Event implements Serializable { CHUNK_UNLOAD(Category.WORLD), /** * Called when a newly created chunk has been populated. - * + *

* If your intent is to populate the chunk using this event, please see {@link org.bukkit.generator.BlockPopulator} * * @see org.bukkit.event.world.ChunkPopulateEvent @@ -605,7 +605,7 @@ public abstract class Event implements Serializable { * * @see org.bukkit.event.entity.ItemDespawnEvent */ - ITEM_DESPAWN (Category.WORLD), + ITEM_DESPAWN(Category.WORLD), /** * ENTITY EVENTS @@ -667,10 +667,10 @@ public abstract class Event implements Serializable { ENTITY_EXPLODE(Category.LIVING_ENTITY), /** * Called when an entity has made a decision to explode. - * + *

* Provides an opportunity to act on the entity, change the explosion radius, * or to change the fire-spread flag. - * + *

* Canceling the event negates the entity's decision to explode. * For EntityCreeper, this resets the fuse but does not kill the Entity. * For EntityFireball and EntityTNTPrimed....? diff --git a/src/main/java/org/bukkit/event/block/EntityBlockFormEvent.java b/src/main/java/org/bukkit/event/block/EntityBlockFormEvent.java index fb115a03..7087661d 100644 --- a/src/main/java/org/bukkit/event/block/EntityBlockFormEvent.java +++ b/src/main/java/org/bukkit/event/block/EntityBlockFormEvent.java @@ -6,10 +6,10 @@ import org.bukkit.entity.Entity; /** * Called when a block is formed by entities. - *

+ *

* Examples: - *