Deprecated API


Contents
Deprecated Interfaces
org.bukkit.block.ContainerBlock
          in favour of InventoryHolder 
org.bukkit.entity.FallingSand
          See FallingBlock 
org.bukkit.entity.PoweredMinecart
          This class has been moved into a sub package; PoweredMinecart should be used instead. 
org.bukkit.entity.StorageMinecart
          This class has been moved into a sub package; StorageMinecart should be used instead. 
org.bukkit.command.TabCommandExecutor
          Remains for plugins that would have implemented it even without functionality 
 

Deprecated Classes
org.bukkit.material.Door
          No longer functions. Do not use. 
org.bukkit.event.painting.PaintingBreakByEntityEvent
          Use HangingBreakByEntityEvent instead. 
org.bukkit.event.painting.PaintingBreakEvent
          Use HangingBreakEvent instead. 
org.bukkit.event.painting.PaintingEvent
          Use HangingEvent instead. 
org.bukkit.event.painting.PaintingPlaceEvent
          Use HangingPlaceEvent instead. 
org.bukkit.event.player.PlayerChatEvent
          This event will fire from the main thread and allows the use of all of the Bukkit API, unlike the AsyncPlayerChatEvent.

Listening to this event forces chat to wait for the main thread which causes delays for chat.
AsyncPlayerChatEvent is the encouraged alternative for thread safe implementations.
 
org.bukkit.event.player.PlayerInventoryEvent
          Use InventoryClickEvent or InventoryOpenEvent instead, or one of the other inventory events in org.bukkit.event.inventory. 
org.bukkit.event.player.PlayerPreLoginEvent
          This event causes synchronization from the login thread; AsyncPlayerPreLoginEvent is preferred to keep the secondary threads asynchronous. 
 

Deprecated Enums
org.bukkit.entity.CreatureType
          Use EntityType instead. 
org.bukkit.potion.Potion.Tier
           
 

Deprecated Fields
org.bukkit.plugin.java.JavaPluginLoader.classes
          Internal field that wasn't intended to be exposed 
org.bukkit.plugin.java.JavaPluginLoader.fileFilters
          Internal field that wasn't intended to be exposed 
org.bukkit.plugin.java.JavaPluginLoader.loaders
          Internal field that wasn't intended to be exposed 
 

Deprecated Methods
org.bukkit.event.player.AsyncPlayerPreLoginEvent.disallow(PlayerPreLoginEvent.Result, String)
          This method uses a deprecated enum from PlayerPreLoginEvent 
org.bukkit.plugin.java.PluginClassLoader.findClass(String, boolean)
          Internal method that wasn't intended to be exposed 
org.bukkit.generator.ChunkGenerator.generate(World, Random, int, int)
           
org.bukkit.DyeColor.getByData(byte)
          The name is misleading. It would imply Material.INK_SACK but uses Material.WOOL 
org.bukkit.plugin.java.JavaPluginLoader.getClassByName(String)
          Internal method that wasn't intended to be exposed 
org.bukkit.plugin.java.PluginClassLoader.getClasses()
          Internal method that wasn't intended to be exposed 
org.bukkit.event.entity.CreatureSpawnEvent.getCreatureType()
          In favour of EntityEvent.getEntityType(). 
org.bukkit.block.CreatureSpawner.getCreatureType()
          In favour of CreatureSpawner.getSpawnedType(). 
org.bukkit.block.CreatureSpawner.getCreatureTypeId()
          Use CreatureSpawner.getCreatureTypeName(). 
org.bukkit.DyeColor.getData()
          The name is misleading. It would imply Material.INK_SACK but uses Material.WOOL 
org.bukkit.plugin.java.JavaPluginLoader.getDataFolder(File)
          Internal method that wasn't intended to be exposed 
org.bukkit.World.getEntitiesByClass(Class...)
           
org.bukkit.material.Door.getFacing()
          Does not work (correctly) anymore 
org.bukkit.event.player.PlayerCommandPreprocessEvent.getFormat()
          This method is provided for backward compatibility with no guarantee to the use of the format. 
org.bukkit.event.inventory.FurnaceBurnEvent.getFurnace()
          In favour of BlockEvent.getBlock(). 
org.bukkit.event.inventory.FurnaceSmeltEvent.getFurnace()
          In favour of BlockEvent.getBlock(). 
org.bukkit.event.player.PlayerEggThrowEvent.getHatchType()
          In favour of PlayerEggThrowEvent.getHatchingType(). 
org.bukkit.material.Door.getHingeCorner()
          Does not work (correctly) anymore 
org.bukkit.event.player.PlayerCommandPreprocessEvent.getRecipients()
          This method is provided for backward compatibility with no guarantee to the effect of viewing or modifying the set. 
org.bukkit.event.player.AsyncPlayerPreLoginEvent.getResult()
          This method uses a deprecated enum from PlayerPreLoginEvent 
org.bukkit.potion.Potion.getTier()
           
org.bukkit.entity.Player.isOnGround()
          Inconsistent with org.bukkit.craftbukkit.entity.Entity#isOnGround() 
org.bukkit.material.Door.isOpen()
          Does not work (correctly) anymore 
org.bukkit.plugin.java.JavaPluginLoader.loadPlugin(File, boolean)
          Relic method from PluginLoader that didn't get purged 
org.bukkit.plugin.java.JavaPluginLoader.removeClass(String)
          Internal method that wasn't intended to be exposed 
org.bukkit.scheduler.BukkitScheduler.scheduleAsyncDelayedTask(Plugin, Runnable)
          This name is misleading, as it does not schedule "a sync" task, but rather, "an async" task 
org.bukkit.scheduler.BukkitScheduler.scheduleAsyncDelayedTask(Plugin, Runnable, long)
          This name is misleading, as it does not schedule "a sync" task, but rather, "an async" task 
org.bukkit.scheduler.BukkitScheduler.scheduleAsyncRepeatingTask(Plugin, Runnable, long, long)
          This name is misleading, as it does not schedule "a sync" task, but rather, "an async" task 
org.bukkit.plugin.java.JavaPluginLoader.setClass(String, Class)
          Internal method that wasn't intended to be exposed 
org.bukkit.block.CreatureSpawner.setCreatureType(CreatureType)
          In favour of CreatureSpawner.setSpawnedType(EntityType). 
org.bukkit.block.CreatureSpawner.setCreatureTypeId(String)
          Use CreatureSpawner.setCreatureTypeByName(String). 
org.bukkit.material.Door.setFacingDirection(BlockFace)
          Does not work (correctly) anymore 
org.bukkit.event.player.PlayerCommandPreprocessEvent.setFormat(String)
          This method is provided for backward compatibility with no guarantee to the effect of modifying the format. 
org.bukkit.event.player.PlayerEggThrowEvent.setHatchType(CreatureType)
          In favour of PlayerEggThrowEvent.setHatchingType(EntityType). 
org.bukkit.material.Door.setOpen(boolean)
          Does not work (correctly) anymore 
org.bukkit.event.player.AsyncPlayerPreLoginEvent.setResult(PlayerPreLoginEvent.Result)
          This method uses a deprecated enum from PlayerPreLoginEvent 
org.bukkit.potion.Potion.setTier(Potion.Tier)
          In favour of Potion.setLevel(int) 
org.bukkit.material.Door.setTopHalf(boolean)
          Shouldn't be used anymore 
org.bukkit.entity.LivingEntity.shootArrow()
          Use launchProjectile(Arrow.class) instead 
org.bukkit.World.spawnCreature(Location, CreatureType)
           
org.bukkit.World.spawnCreature(Location, EntityType)
          Has issues spawning non LivingEntities. Use spawnEntity instead. 
org.bukkit.command.Command.tabComplete(CommandSender, String[])
          This method is not supported and returns null 
org.bukkit.entity.LivingEntity.throwEgg()
          Use launchProjectile(Egg.class) instead 
org.bukkit.entity.LivingEntity.throwSnowball()
          Use launchProjectile(Snowball.class) instead 
org.bukkit.entity.CreatureType.toEntityType()
           
org.bukkit.entity.Player.updateInventory()
          This method should not be relied upon as it is a temporary work-around for a larger, more complicated issue. 
 

Deprecated Constructors
org.bukkit.event.block.BlockIgniteEvent(Block, BlockIgniteEvent.IgniteCause, Player)
           
org.bukkit.event.entity.CreatureSpawnEvent(Entity, CreatureType, Location, CreatureSpawnEvent.SpawnReason)
           
org.bukkit.event.entity.EntityChangeBlockEvent(LivingEntity, Block, Material)
          Provided as a backward compatibility before the data byte was provided, and type increased to all entities 
org.bukkit.inventory.ItemStack(int, int, short, Byte)
          this method uses an ambiguous data byte object 
org.bukkit.inventory.ItemStack(Material, int, short, Byte)
          this method uses an ambiguous data byte object 
org.bukkit.plugin.java.JavaPluginLoader(Server)
           
org.bukkit.event.player.PlayerEggThrowEvent(Player, Egg, boolean, byte, CreatureType)
           
org.bukkit.event.player.PlayerLoginEvent(Player)
          Address should be provided in other constructor 
org.bukkit.event.player.PlayerLoginEvent(Player, PlayerLoginEvent.Result, String)
          Address and hostname should be provided in other constructor 
org.bukkit.event.player.PlayerLoginEvent(Player, String)
          Address should be provided in other constructor 
org.bukkit.plugin.java.PluginClassLoader(JavaPluginLoader, URL[], ClassLoader)
           
org.bukkit.potion.Potion(PotionType, int, boolean)
          In favour of using Potion.Potion(PotionType) with Potion.splash(). 
org.bukkit.potion.Potion(PotionType, int, boolean, boolean)
          In favour of using Potion.Potion(PotionType) with Potion.extend() and possibly Potion.splash(). 
org.bukkit.potion.Potion(PotionType, Potion.Tier)
          In favour of Potion.Potion(PotionType, int) 
org.bukkit.potion.Potion(PotionType, Potion.Tier, boolean)
          In favour of Potion.Potion(PotionType, int, boolean) 
org.bukkit.potion.Potion(PotionType, Potion.Tier, boolean, boolean)
          In favour of Potion.Potion(PotionType, int, boolean, boolean) 
 

Deprecated Enum Constants
org.bukkit.event.entity.CreatureSpawnEvent.SpawnReason.BED
          No longer used 
 



Copyright © 2013. All Rights Reserved.