Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Enums
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors
• Deprecated Enum Constants

Deprecated Interfaces

Interface and Description
org.bukkit.BlockChangeDelegate rarely used API that was largely for implementation purposes
org.bukkit.entity.Fish in favor of FishHook
org.bukkit.UnsafeValues

Deprecated Classes

Class and Description
org.spigotmc.CustomTimingsHandler
org.bukkit.material.FlowerPot Flower pots are now tile entities, use FlowerPot.
org.bukkit.event.player.PlayerAchievementAwardedEvent future versions of Minecraft do not have achievements
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.
com.destroystokyo.paper.event.player.PlayerLocaleChangeEvent Replaced by PlayerLocaleChangeEvent upstream
org.bukkit.event.player.PlayerPickupItemEvent EntityPickupItemEvent
org.bukkit.event.player.PlayerPreLoginEvent This event causes synchronization from the login thread; AsyncPlayerPreLoginEvent is preferred to keep the secondary threads asynchronous.
org.bukkit.potion.Potion
org.bukkit.material.SpawnEgg use SpawnEggMeta
org.bukkit.command.defaults.VanillaCommand

Deprecated Enums

Enum and Description
org.bukkit.Achievement future versions of Minecraft do not have achievements
org.bukkit.entity.Arrow.PickupRule
org.bukkit.event.entity.EntityDamageEvent.DamageModifier This API is responsible for a large number of implementation problems and is in general unsustainable to maintain. It is likely to be removed very soon in a subsequent release. Please see https://www.spigotmc.org/threads/194446/ for more information.
org.bukkit.entity.Evoker.Spell future versions of Minecraft have additional spell casting entities.
org.bukkit.entity.Horse.Variant different variants are differing classes
org.bukkit.scoreboard.NameTagVisibility replaced by Team.OptionStatus
org.bukkit.entity.Skeleton.SkeletonType

Deprecated Fields

Field and Description
org.bukkit.map.MapPalette.BLUE Magic value
org.bukkit.map.MapPalette.BROWN Magic value
org.bukkit.map.MapPalette.DARK_BROWN Magic value
org.bukkit.map.MapPalette.DARK_GRAY Magic value
org.bukkit.map.MapPalette.DARK_GREEN Magic value
org.bukkit.map.MapPalette.GRAY_1 Magic value
org.bukkit.map.MapPalette.GRAY_2 Magic value
org.bukkit.map.MapPalette.LIGHT_BROWN Magic value
org.bukkit.map.MapPalette.LIGHT_GRAY Magic value
org.bukkit.map.MapPalette.LIGHT_GREEN Magic value
org.bukkit.event.block.BlockCanBuildEvent.material Magic value
org.bukkit.map.MapPalette.PALE_BLUE Magic value
org.bukkit.map.MapPalette.RED Magic value
org.bukkit.map.MapPalette.TRANSPARENT Magic value
org.bukkit.map.MapPalette.WHITE Magic value

Deprecated Methods

Method and Description
org.bukkit.map.MapCursorCollection.addCursor(int, int, byte, byte) Magic value
org.bukkit.map.MapCursorCollection.addCursor(int, int, byte, byte, boolean) Magic value
org.bukkit.inventory.ShapelessRecipe.addIngredient(int, Material, int) Magic value
org.bukkit.inventory.ShapelessRecipe.addIngredient(Material, int) Magic value
org.bukkit.plugin.SimplePluginManager.addPermission(Permission, boolean)
org.bukkit.scoreboard.Team.addPlayer(OfflinePlayer) Teams can contain entries that aren't players
org.bukkit.inventory.Inventory.all(int) Magic value
org.bukkit.entity.Player.awardAchievement(Achievement) future versions of Minecraft do not have achievements
org.bukkit.map.MapCursor.Type.byValue(byte) Magic value
org.bukkit.inventory.PlayerInventory.clear(int, int) Magic value
org.bukkit.inventory.Inventory.contains(int) Magic value
org.bukkit.inventory.Inventory.contains(int, int) Magic value
org.bukkit.plugin.SimplePluginManager.dirtyPermissibles()
org.bukkit.event.player.AsyncPlayerPreLoginEvent.disallow(PlayerPreLoginEvent.Result, String) This method uses a deprecated enum from PlayerPreLoginEvent
org.bukkit.inventory.Inventory.first(int) Magic value
org.bukkit.entity.EntityType.fromId(int) Magic value
org.bukkit.entity.EntityType.fromName(String) Magic value
org.bukkit.generator.ChunkGenerator.generate(World, Random, int, int)
org.bukkit.generator.ChunkGenerator.generateBlockSections(World, Random, int, int, ChunkGenerator.BiomeGrid) Magic value
org.bukkit.generator.ChunkGenerator.generateExtBlockSections(World, Random, int, int, ChunkGenerator.BiomeGrid) Magic value
org.bukkit.World.generateTree(Location, TreeType, BlockChangeDelegate) rarely used API that was largely for implementation purposes
org.bukkit.inventory.meta.BannerMeta.getBaseColor() banner color is now stored as the data value, not meta.
org.bukkit.entity.FishHook.getBiteChance() has no effect in newer Minecraft versions
org.bukkit.entity.FallingBlock.getBlockData() Magic value
org.bukkit.ChunkSnapshot.getBlockData(int, int, int) Magic value
org.bukkit.entity.FallingBlock.getBlockId() Magic value
org.bukkit.ChunkSnapshot.getBlockTypeId(int, int, int) Magic value
org.bukkit.World.getBlockTypeIdAt(int, int, int) Magic value
org.bukkit.World.getBlockTypeIdAt(Location) Magic value
org.bukkit.potion.PotionType.getByDamageValue(int) Non-functional
org.bukkit.EntityEffect.getByData(byte) Magic value
org.bukkit.CropState.getByData(byte) Magic value
org.bukkit.TreeSpecies.getByData(byte) Magic value
org.bukkit.GrassSpecies.getByData(byte) Magic value
org.bukkit.SandstoneType.getByData(byte) Magic value
org.bukkit.CoalType.getByData(byte) Magic value
org.bukkit.material.types.DoublePlantSpecies.getByData(byte) Magic value
org.bukkit.material.types.StoneType.getByData(byte) Magic value
org.bukkit.material.types.PrismarineType.getByData(byte) Magic value
org.bukkit.material.types.MushroomBlockTexture.getByData(byte) Magic value
org.bukkit.material.types.SandType.getByData(byte) Magic value
org.bukkit.material.types.DirtType.getByData(byte) Magic value
org.bukkit.material.types.SpongeType.getByData(byte) Magic value
org.bukkit.DyeColor.getByDyeData(byte) Magic value
org.bukkit.potion.PotionType.getByEffect(PotionEffectType) Misleading
org.bukkit.Note.Tone.getById(byte) Magic value
org.bukkit.Art.getById(int) Magic value
org.bukkit.Effect.getById(int) Magic value
org.bukkit.block.PistonMoveReaction.getById(int) Magic value
org.bukkit.potion.PotionEffectType.getById(int) Magic value
org.bukkit.enchantments.Enchantment.getById(int) Magic value
org.bukkit.Effect.getByName(String) Spigot specific API, use Particle.
org.bukkit.Instrument.getByType(byte) Magic value
org.bukkit.Difficulty.getByValue(int) Magic value
org.bukkit.GameMode.getByValue(int) Magic value
org.bukkit.DyeColor.getByWoolData(byte) Magic value
org.bukkit.event.block.BlockPhysicsEvent.getChangedTypeId() Magic value
org.bukkit.plugin.PluginDescriptionFile.getClassLoaderOf() unused
org.bukkit.entity.Player.Spigot.getCollidesWithEntities() see LivingEntity.isCollidable()
org.bukkit.map.MapPalette.getColor(byte) Magic value
org.bukkit.Server.Spigot.getConfig()
org.bukkit.material.ExtendedRails.getConvertedData() Magic value
org.bukkit.material.Rails.getConvertedData() Magic value
org.bukkit.block.CreatureSpawner.getCreatureTypeName() magic value, use CreatureSpawner.getSpawnedType().
org.bukkit.entity.Evoker.getCurrentSpell() future versions of Minecraft have additional spell casting entities.
org.bukkit.potion.PotionType.getDamageValue() Non-functional
org.bukkit.EntityEffect.getData() Magic value
org.bukkit.CropState.getData() Magic value
org.bukkit.TreeSpecies.getData() Magic value
org.bukkit.GrassSpecies.getData() Magic value
org.bukkit.SandstoneType.getData() Magic value
org.bukkit.CoalType.getData() Magic value
org.bukkit.material.MaterialData.getData() Magic value
org.bukkit.material.types.DoublePlantSpecies.getData() Magic value
org.bukkit.material.types.StoneType.getData() Magic value
org.bukkit.material.types.PrismarineType.getData() Magic value
org.bukkit.material.types.MushroomBlockTexture.getData() Magic value
org.bukkit.material.types.SandType.getData() Magic value
org.bukkit.material.types.DirtType.getData() Magic value
org.bukkit.material.types.SpongeType.getData() Magic value
org.bukkit.block.Block.getData() Magic value
org.bukkit.event.entity.EntityChangeBlockEvent.getData() Magic value
org.bukkit.generator.ChunkGenerator.ChunkData.getData(int, int, int) Uses magic values
org.bukkit.DyeColor.getDyeData() Magic value
org.bukkit.potion.PotionBrewer.getEffectsFromDamage(int) Non-Functional
org.bukkit.World.getEntitiesByClass(Class<T>...)
org.bukkit.World.Environment.getEnvironment(int) Magic value
org.bukkit.event.enchantment.PrepareItemEnchantEvent.getExpLevelCostsOffered() Use PrepareItemEnchantEvent.getOffers() instead of this method
org.bukkit.material.Door.getHingeCorner() This method should not be used; use hinge and facing accessors instead.
org.bukkit.World.Environment.getId() Magic value
org.bukkit.Material.getId() Magic value
org.bukkit.Art.getId() Magic value
org.bukkit.Note.getId() Magic value
org.bukkit.Note.Tone.getId() Magic value
org.bukkit.Effect.getId() Magic value
org.bukkit.block.PistonMoveReaction.getId() Magic value
org.bukkit.entity.Ocelot.Type.getId() Magic value
org.bukkit.potion.PotionEffectType.getId() Magic value
org.bukkit.inventory.InventoryView.Property.getId() Magic value
org.bukkit.enchantments.Enchantment.getId() Magic value
org.bukkit.map.MapView.getId() Magic value
org.bukkit.Note.Tone.getId(boolean) Magic value
org.bukkit.entity.HumanEntity.getItemInHand() Humans may now dual wield in their off hand, use explicit methods in PlayerInventory.
org.bukkit.inventory.EntityEquipment.getItemInHand() entities can duel wield now use the methods for the specific hand instead
org.bukkit.inventory.PlayerInventory.getItemInHand() players can duel wield now use the methods for the specific hand instead
org.bukkit.inventory.EntityEquipment.getItemInHandDropChance() entities can duel wield now use the methods for the specific hand instead
org.bukkit.material.MaterialData.getItemTypeId() Magic value
org.bukkit.event.block.BlockPistonExtendEvent.getLength() slime blocks make the value of this method inaccurate due to blocks being pushed at the side
org.bukkit.entity.Player.Spigot.getLocale() Use Player.getLocale()
org.bukkit.Bukkit.getMap(short) Magic value
org.bukkit.Server.getMap(short) Magic value
org.bukkit.Material.getMaterial(int) Magic value
org.bukkit.event.block.BlockCanBuildEvent.getMaterialId() Magic value
org.bukkit.entity.Damageable.getMaxHealth() use Attribute.GENERIC_MAX_HEALTH.
org.bukkit.entity.Boat.getMaxSpeed() boats are complex and many of these methods do not work correctly across multiple versions.
org.bukkit.Effect.getName() Spigot specific API, use Particle.
org.bukkit.entity.EntityType.getName() Magic value
org.bukkit.potion.Potion.getNameId() Non-functional
org.bukkit.scoreboard.Team.getNameTagVisibility() see Team.getOption(org.bukkit.scoreboard.Team.Option)
org.bukkit.Material.getNewData(byte) Magic value
org.bukkit.entity.Boat.getOccupiedDeceleration() boats are complex and many of these methods do not work correctly across multiple versions.
org.bukkit.Bukkit.getOfflinePlayer(String) Persistent storage of users should be by UUID as names are no longer unique past a single session.
org.bukkit.Server.getOfflinePlayer(String) Persistent storage of users should be by UUID as names are no longer unique past a single session.
org.bukkit.block.Skull.getOwner() See Skull.getOwningPlayer().
org.bukkit.inventory.meta.SkullMeta.getOwner() see SkullMeta.setOwningPlayer(org.bukkit.OfflinePlayer).
org.bukkit.entity.Entity.getPassenger() entities may have multiple passengers, use Entity.getPassengers()
org.bukkit.entity.Arrow.getPickupRule() Use Arrow.getPickupStatus() as an upstream compatible replacement for this function
org.bukkit.scoreboard.Score.getPlayer() Scoreboards can contain entries that aren't players
org.bukkit.scoreboard.Scoreboard.getPlayers() Scoreboards can contain entries that aren't players
org.bukkit.scoreboard.Team.getPlayers() Teams can contain entries that aren't players
org.bukkit.scoreboard.Scoreboard.getPlayerTeam(OfflinePlayer) Scoreboards can contain entries that aren't players
org.bukkit.ChunkSnapshot.getRawBiomeRainfall(int, int) this is not a chunk property in current Minecraft versions
org.bukkit.block.BlockState.getRawData() Magic value
org.bukkit.plugin.PluginDescriptionFile.getRawName() Internal use
org.bukkit.block.NoteBlock.getRawNote() Magic value
org.bukkit.map.MapCursor.getRawType() Magic value
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.event.block.BlockPistonRetractEvent.getRetractLocation()
org.bukkit.event.server.ServerListPingEvent.getSampleText() Will be removed in 1.13, use PaperServerListPingEvent.getPlayerSample()
com.destroystokyo.paper.event.server.PaperServerListPingEvent.getSampleText()
org.bukkit.scoreboard.Objective.getScore(OfflinePlayer) Scoreboards can contain entries that aren't players
org.bukkit.scoreboard.Scoreboard.getScores(OfflinePlayer) Scoreboards can contain entries that aren't players
org.bukkit.entity.HumanEntity.getShoulderEntityLeft() There are currently no well defined semantics regarding serialized entities in Bukkit. Use with care.
org.bukkit.entity.HumanEntity.getShoulderEntityRight() There are currently no well defined semantics regarding serialized entities in Bukkit. Use with care.
org.bukkit.entity.Skeleton.getSkeletonType() should check what class instance this is
org.bukkit.entity.FallingBlock.getSourceLoc() replaced by Entity.getOrigin()
org.bukkit.entity.TNTPrimed.getSourceLoc() replaced by Entity.getOrigin()
org.bukkit.material.SpawnEgg.getSpawnedType() This is now stored in SpawnEggMeta.
org.bukkit.material.TexturedMaterial.getTextureIndex() Magic value
org.bukkit.material.Step.getTextureIndex() Magic value
org.bukkit.Instrument.getType() Magic value
org.bukkit.entity.Ocelot.Type.getType(int) Magic value
org.bukkit.block.Block.getTypeId() Magic value
org.bukkit.block.BlockState.getTypeId() Magic value
org.bukkit.entity.EntityType.getTypeId() Magic value
org.bukkit.inventory.ItemStack.getTypeId() Magic value
org.bukkit.BlockChangeDelegate.getTypeId(int, int, int) Magic value
org.bukkit.generator.ChunkGenerator.ChunkData.getTypeId(int, int, int) Uses magic values
org.bukkit.entity.Boat.getUnoccupiedDeceleration() boats are complex and many of these methods do not work correctly across multiple versions.
org.bukkit.Bukkit.getUnsafe()
org.bukkit.Server.getUnsafe()
org.bukkit.Difficulty.getValue() Magic value
org.bukkit.GameMode.getValue() Magic value
org.bukkit.map.MapCursor.Type.getValue() Magic value
org.bukkit.map.MapView.Scale.getValue() Magic value
org.bukkit.entity.AbstractHorse.getVariant() different variants are different classes
org.bukkit.entity.Zombie.getVillagerProfession()
org.bukkit.DyeColor.getWoolData() Magic value
org.bukkit.entity.Boat.getWorkOnLand() boats are complex and many of these methods do not work correctly across multiple versions.
org.bukkit.entity.Player.hasAchievement(Achievement) future versions of Minecraft do not have achievements
org.bukkit.scoreboard.Team.hasPlayer(OfflinePlayer) Teams can contain entries that aren't players
org.bukkit.boss.BossBar.hide() BossBar.setVisible(boolean)
org.bukkit.entity.Player.hidePlayer(Player) see Player.hidePlayer(Plugin, Player)
org.bukkit.map.MapPalette.imageToBytes(Image) Magic value
org.bukkit.entity.Horse.isCarryingChest() see ChestedHorse
org.bukkit.entity.Guardian.isElder() should check if instance of ElderGuardian.
org.bukkit.entity.ExperienceOrb.isFromBottle() Use getSpawnReason() == EXP_BOTTLE
org.bukkit.WorldBorder.isInBounds(Location) use WorldBorder.isInside(Location) for an upstream compatible replacement
org.bukkit.Note.Tone.isSharped(byte) Magic value
org.bukkit.inventory.meta.ItemMeta.Spigot.isUnbreakable() see ItemMeta.isUnbreakable()
org.bukkit.entity.Zombie.isVillager() check if instanceof ZombieVillager.
org.bukkit.entity.Villager.Profession.isZombie() Unused
org.bukkit.map.MapPalette.matchColor(Color) Magic value
org.bukkit.map.MapPalette.matchColor(int, int, int) Magic value
org.bukkit.block.NoteBlock.play(byte, byte) Magic value
org.bukkit.World.Spigot.playEffect(Location, Effect) Spigot specific API, use Particle.
org.bukkit.entity.Player.playEffect(Location, Effect, int) Magic value
org.bukkit.World.Spigot.playEffect(Location, Effect, int, int, float, float, float, float, int, int) Spigot specific API, use Particle.
org.bukkit.entity.Player.Spigot.playEffect(Location, Effect, int, int, float, float, float, float, int, int)
org.bukkit.entity.Player.playNote(Location, byte, byte) Magic value
org.bukkit.NamespacedKey.randomKey() should never be used by plugins, for internal use only!!
org.bukkit.World.refreshChunk(int, int) This method is not guaranteed to work suitably across all client implementations.
org.bukkit.inventory.Inventory.remove(int) Magic value
org.bukkit.entity.Player.removeAchievement(Achievement) future versions of Minecraft do not have achievements
org.bukkit.inventory.ShapelessRecipe.removeIngredient(int, Material, int) Magic value
org.bukkit.inventory.ShapelessRecipe.removeIngredient(Material, int) Magic value
org.bukkit.scoreboard.Team.removePlayer(OfflinePlayer) Teams can contain entries that aren't players
org.bukkit.entity.Damageable.resetMaxHealth() use Attribute.GENERIC_MAX_HEALTH.
org.bukkit.scoreboard.Scoreboard.resetScores(OfflinePlayer) Scoreboards can contain entries that aren't players
org.bukkit.scheduler.BukkitScheduler.runTask(Plugin, BukkitRunnable) Use BukkitRunnable.runTask(Plugin)
org.bukkit.scheduler.BukkitScheduler.runTaskAsynchronously(Plugin, BukkitRunnable) Use BukkitRunnable.runTaskAsynchronously(Plugin)
org.bukkit.scheduler.BukkitScheduler.runTaskLater(Plugin, BukkitRunnable, long) Use BukkitRunnable.runTaskLater(Plugin, long)
org.bukkit.scheduler.BukkitScheduler.runTaskLaterAsynchronously(Plugin, BukkitRunnable, long) Use BukkitRunnable.runTaskLaterAsynchronously(Plugin, long)
org.bukkit.scheduler.BukkitScheduler.runTaskTimer(Plugin, BukkitRunnable, long, long) Use BukkitRunnable.runTaskTimer(Plugin, long, long)
org.bukkit.scheduler.BukkitScheduler.runTaskTimerAsynchronously(Plugin, BukkitRunnable, long, long) Use BukkitRunnable.runTaskTimerAsynchronously(Plugin, long, long)
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.scheduler.BukkitScheduler.scheduleSyncDelayedTask(Plugin, BukkitRunnable) Use BukkitRunnable.runTask(Plugin)
org.bukkit.scheduler.BukkitScheduler.scheduleSyncDelayedTask(Plugin, BukkitRunnable, long) Use BukkitRunnable.runTaskLater(Plugin, long)
org.bukkit.scheduler.BukkitScheduler.scheduleSyncRepeatingTask(Plugin, BukkitRunnable, long, long) Use BukkitRunnable.runTaskTimer(Plugin, long, long) *
org.bukkit.entity.Player.sendBlockChange(Location, int, byte) Magic value
org.bukkit.entity.Player.sendBlockChange(Location, Material, byte) Magic value
org.bukkit.entity.Player.sendChunkChange(Location, int, int, int, byte[]) Magic value
org.bukkit.entity.Player.sendMessage(ChatMessageType, BaseComponent...) This is unlikely the API you want to use. See Player.sendActionBar(String) for a more proper Action Bar API. This deprecated API may send unsafe items to the client.
org.bukkit.entity.Player.Spigot.sendMessage(ChatMessageType, BaseComponent...) This is unlikely the API you want to use. See Player.sendActionBar(String) for a more proper Action Bar API. This deprecated API may send unsafe items to the client.
org.bukkit.entity.Player.Spigot.sendMessage(ChatMessageType, BaseComponent) This is unlikely the API you want to use. See Player.sendActionBar(String) for a more proper Action Bar API. This deprecated API may send unsafe items to the client.
org.bukkit.entity.Player.sendTitle(String, String) API behavior subject to change
org.bukkit.inventory.meta.BannerMeta.setBaseColor(DyeColor) banner color is now stored as the data value, not meta.
org.bukkit.entity.FishHook.setBiteChance(double) has no effect in newer Minecraft versions
org.bukkit.generator.ChunkGenerator.ChunkData.setBlock(int, int, int, int) Uses magic values
org.bukkit.generator.ChunkGenerator.ChunkData.setBlock(int, int, int, int, byte) Uses magic values
org.bukkit.event.entity.HorseJumpEvent.setCancelled(boolean) horse jumping was moved client side.
org.bukkit.entity.Horse.setCarryingChest(boolean) see ChestedHorse
org.bukkit.entity.Player.Spigot.setCollidesWithEntities(boolean) LivingEntity.setCollidable(boolean)
org.bukkit.block.CreatureSpawner.setCreatureTypeByName(String) magic value, use CreatureSpawner.setSpawnedType(org.bukkit.entity.EntityType).
org.bukkit.entity.Evoker.setCurrentSpell(Evoker.Spell) future versions of Minecraft have additional spell casting entities.
org.bukkit.event.inventory.InventoryClickEvent.setCursor(ItemStack) This changes the ItemStack in their hand before any calculations are applied to the Inventory, which has a tendency to create inconsistencies between the Player and the server, and to make unexpected changes in the behavior of the clicked Inventory.
org.bukkit.material.MaterialData.setData(byte) Magic value
org.bukkit.block.Block.setData(byte) Magic value
org.bukkit.block.Block.setData(byte, boolean) Magic value
org.bukkit.entity.Guardian.setElder(boolean) Must spawn a new ElderGuardian.
org.bukkit.material.Mushroom.setFacePainted(BlockFace, boolean) Use MushroomBlockType cap options
org.bukkit.inventory.ShapedRecipe.setIngredient(char, Material, int) Magic value
org.bukkit.inventory.FurnaceRecipe.setInput(Material, int) Magic value
org.bukkit.entity.HumanEntity.setItemInHand(ItemStack) Humans may now dual wield in their off hand, use explicit methods in PlayerInventory.
org.bukkit.inventory.EntityEquipment.setItemInHand(ItemStack) entities can duel wield now use the methods for the specific hand instead
org.bukkit.inventory.PlayerInventory.setItemInHand(ItemStack) players can duel wield now use the methods for the specific hand instead
org.bukkit.inventory.EntityEquipment.setItemInHandDropChance(float) entities can duel wield now use the methods for the specific hand instead
org.bukkit.inventory.meta.PotionMeta.setMainEffect(PotionEffectType) use PotionType(org.bukkit.potion.PotionEffectType, boolean, boolean)
org.bukkit.entity.Damageable.setMaxHealth(double) use Attribute.GENERIC_MAX_HEALTH.
org.bukkit.entity.Boat.setMaxSpeed(double) boats are complex and many of these methods do not work correctly across multiple versions.
org.bukkit.scoreboard.Team.setNameTagVisibility(NameTagVisibility) see Team.setOption(org.bukkit.scoreboard.Team.Option, org.bukkit.scoreboard.Team.OptionStatus)
org.bukkit.entity.Boat.setOccupiedDeceleration(double) boats are complex and many of these methods do not work correctly across multiple versions.
org.bukkit.block.Skull.setOwner(String) see Skull.setOwningPlayer(org.bukkit.OfflinePlayer).
org.bukkit.inventory.meta.SkullMeta.setOwner(String) see SkullMeta.setOwningPlayer(org.bukkit.OfflinePlayer).
org.bukkit.entity.Entity.setPassenger(Entity) entities may have multiple passengers, use Entity.getPassengers()
org.bukkit.entity.Arrow.setPickupRule(Arrow.PickupRule) Use Arrow.setPickupStatus(PickupStatus) with Arrow.PickupStatus as an upstream compatible replacement for this function
org.bukkit.event.entity.HorseJumpEvent.setPower(float) horse jumping was moved client side.
org.bukkit.block.BlockState.setRawData(byte) Magic value
org.bukkit.block.NoteBlock.setRawNote(byte) Magic value
org.bukkit.map.MapCursor.setRawType(byte) Magic value
org.bukkit.BlockChangeDelegate.setRawTypeId(int, int, int, int) Magic value
org.bukkit.BlockChangeDelegate.setRawTypeIdAndData(int, int, int, int, int) Magic value
org.bukkit.generator.ChunkGenerator.ChunkData.setRegion(int, int, int, int, int, int, int) Uses magic values.
org.bukkit.generator.ChunkGenerator.ChunkData.setRegion(int, int, int, int, int, int, int, int) Uses magic values.
org.bukkit.entity.Player.setResourcePack(String) use Player.setResourcePack(String, String)
org.bukkit.event.player.AsyncPlayerPreLoginEvent.setResult(PlayerPreLoginEvent.Result) This method uses a deprecated enum from PlayerPreLoginEvent
org.bukkit.event.server.ServerListPingEvent.setSampleText(List<String>) Will be removed in 1.13, use PaperServerListPingEvent.getPlayerSample()
com.destroystokyo.paper.event.server.PaperServerListPingEvent.setSampleText(List<String>)
org.bukkit.entity.HumanEntity.setShoulderEntityLeft(Entity) There are currently no well defined semantics regarding serialized entities in Bukkit. Use with care.
org.bukkit.entity.HumanEntity.setShoulderEntityRight(Entity) There are currently no well defined semantics regarding serialized entities in Bukkit. Use with care.
org.bukkit.entity.Skeleton.setSkeletonType(Skeleton.SkeletonType) Must spawn a new subtype variant
org.bukkit.material.SpawnEgg.setSpawnedType(EntityType) This is now stored in SpawnEggMeta.
org.bukkit.material.Mushroom.setStem() Use Mushroom.setBlockTexture(org.bukkit.material.types.MushroomBlockTexture) with MushroomBlockTexture.STEM_SIDES or MushroomBlockTexture.ALL_STEM
org.bukkit.entity.Player.setSubtitle(BaseComponent) Use Player.updateTitle(Title)
org.bukkit.entity.Player.setSubtitle(BaseComponent[]) Use Player.updateTitle(Title)
org.bukkit.material.TexturedMaterial.setTextureIndex(int) Magic value
org.bukkit.material.Step.setTextureIndex(int) Magic value
org.bukkit.entity.Player.setTexturePack(String) Minecraft no longer uses textures packs. Instead you should use Player.setResourcePack(String).
org.bukkit.entity.Player.setTitleTimes(int, int, int) Use Player.updateTitle(Title)
org.bukkit.block.Block.setTypeId(int) Magic value
org.bukkit.block.BlockState.setTypeId(int) Magic value
org.bukkit.inventory.ItemStack.setTypeId(int) Magic value
org.bukkit.block.Block.setTypeId(int, boolean) Magic value
org.bukkit.BlockChangeDelegate.setTypeId(int, int, int, int) Magic value
org.bukkit.block.Block.setTypeIdAndData(int, byte, boolean) Magic value
org.bukkit.BlockChangeDelegate.setTypeIdAndData(int, int, int, int, int) Magic value
org.bukkit.inventory.meta.ItemMeta.Spigot.setUnbreakable(boolean) see ItemMeta.setUnbreakable(boolean)
org.bukkit.entity.Boat.setUnoccupiedDeceleration(double) boats are complex and many of these methods do not work correctly across multiple versions.
org.bukkit.entity.AbstractHorse.setVariant(Horse.Variant) you are required to spawn a different entity
org.bukkit.entity.Zombie.setVillager(boolean) must spawn ZombieVillager.
org.bukkit.entity.Zombie.setVillagerProfession(Villager.Profession)
org.bukkit.entity.Boat.setWorkOnLand(boolean) boats are complex and many of these methods do not work correctly across multiple versions.
org.bukkit.boss.BossBar.show() BossBar.setVisible(boolean)
org.bukkit.entity.Player.showPlayer(Player) see Player.showPlayer(Plugin, Player)
org.bukkit.entity.Player.showTitle(BaseComponent) Use Player.sendTitle(Title) or Player.updateTitle(Title)
org.bukkit.entity.Player.showTitle(BaseComponent[]) Use Player.sendTitle(Title) or Player.updateTitle(Title)
org.bukkit.entity.Player.showTitle(BaseComponent[], BaseComponent[], int, int, int) Use Player.sendTitle(Title) or Player.updateTitle(Title)
org.bukkit.entity.Player.showTitle(BaseComponent, BaseComponent, int, int, int) Use Player.sendTitle(Title) or Player.updateTitle(Title)
org.bukkit.World.spawnFallingBlock(Location, int, byte) Magic value
org.bukkit.World.spawnFallingBlock(Location, Material, byte) Magic value
org.bukkit.potion.Potion.toDamageValue() Non-functional
org.bukkit.material.MaterialData.toItemStack() this method creates an ItemStack of size 0 which is not generally useful. Consider MaterialData.toItemStack(int).
org.bukkit.Chunk.unload(boolean, boolean) it is never safe to remove a chunk in use
org.bukkit.World.unloadChunk(int, int, boolean, boolean) it is never safe to remove a chunk in use
org.bukkit.map.MapView.Scale.valueOf(byte) Magic value

Deprecated Constructors

Constructor and Description
org.bukkit.event.player.AsyncPlayerPreLoginEvent(String, InetAddress)
org.bukkit.material.Banner(int) Magic value
org.bukkit.material.Banner(int, byte) Magic value
org.bukkit.material.Banner(Material, byte) Magic value
org.bukkit.material.Bed(int) Magic value
org.bukkit.material.Bed(int, byte) Magic value
org.bukkit.material.Bed(Material, byte) Magic value
org.bukkit.event.block.BlockBurnEvent(Block)
org.bukkit.event.block.BlockCanBuildEvent(Block, int, boolean) Magic value
org.bukkit.event.block.BlockPhysicsEvent(Block, int) Magic value
org.bukkit.event.block.BlockPhysicsEvent(Block, int, int, int, int) Magic value
org.bukkit.event.block.BlockPistonExtendEvent(Block, int, BlockFace)
org.bukkit.event.block.BlockPlaceEvent(Block, BlockState, Block, ItemStack, Player, boolean)
org.bukkit.material.Button(int) Magic value
org.bukkit.material.Button(int, byte) Magic value
org.bukkit.material.Button(Material, byte) Magic value
org.bukkit.material.Cake(int) Magic value
org.bukkit.material.Cake(int, byte) Magic value
org.bukkit.material.Cake(Material, byte) Magic value
org.bukkit.material.Cauldron(byte) Magic value
org.bukkit.material.Cauldron(int, byte) Magic value
org.bukkit.material.Chest(int) Magic value
org.bukkit.material.Chest(int, byte) Magic value
org.bukkit.material.Chest(Material, byte) Magic value
org.bukkit.material.Coal(int) Magic value
org.bukkit.material.Coal(int, byte) Magic value
org.bukkit.material.Coal(Material, byte) Magic value
org.bukkit.material.CocoaPlant(int) Magic value
org.bukkit.material.CocoaPlant(int, byte) Magic value
org.bukkit.material.Command(int) Magic value
org.bukkit.material.Command(int, byte) Magic value
org.bukkit.material.Command(Material, byte) Magic value
org.bukkit.material.Comparator(int) Magic value
org.bukkit.material.Comparator(int, byte) Magic value
org.bukkit.material.Comparator(Material, byte) Magic value
org.bukkit.material.Crops(int) Magic value
org.bukkit.material.Crops(int, byte) Magic value
org.bukkit.material.Crops(Material, byte) Magic value
org.bukkit.material.DetectorRail(int) Magic value
org.bukkit.material.DetectorRail(int, byte) Magic value
org.bukkit.material.DetectorRail(Material, byte) Magic value
org.bukkit.material.Diode(int) Magic value
org.bukkit.material.Diode(int, byte) Magic value
org.bukkit.material.Diode(Material, byte) Magic value
org.bukkit.material.DirectionalContainer(int) Magic value
org.bukkit.material.DirectionalContainer(int, byte) Magic value
org.bukkit.material.DirectionalContainer(Material, byte) Magic value
org.bukkit.material.Dirt(int) Magic value
org.bukkit.material.Dirt(int, byte) Magic value
org.bukkit.material.Dirt(Material, byte) Magic value
org.bukkit.material.Dispenser(int) Magic value
org.bukkit.material.Dispenser(int, byte) Magic value
org.bukkit.material.Dispenser(Material, byte) Magic value
org.bukkit.material.Door() Artifact of old API, equivalent to new Door(Material.WOODEN_DOOR);
org.bukkit.material.Door(int) Magic value
org.bukkit.material.Door(int, byte) Magic value
org.bukkit.material.Door(Material, byte) Magic value
org.bukkit.material.DoublePlant(int) Magic value
org.bukkit.material.DoublePlant(int, byte) Magic value
org.bukkit.material.DoublePlant(Material, byte) Magic value
org.bukkit.material.Dye(int) Magic value
org.bukkit.material.Dye(int, byte) Magic value
org.bukkit.material.Dye(Material, byte) Magic value
org.bukkit.material.EnderChest(int) Magic value
org.bukkit.material.EnderChest(int, byte) Magic value
org.bukkit.material.EnderChest(Material, byte) Magic value
org.bukkit.event.entity.EntityChangeBlockEvent(Entity, Block, Material, byte) Magic value
org.bukkit.event.entity.EntityDamageByBlockEvent(Block, Entity, EntityDamageEvent.DamageCause, double)
org.bukkit.event.entity.EntityDamageByEntityEvent(Entity, Entity, EntityDamageEvent.DamageCause, double)
org.bukkit.event.entity.EntityDamageEvent(Entity, EntityDamageEvent.DamageCause, double)
org.bukkit.event.entity.EntityShootBowEvent(LivingEntity, ItemStack, Projectile, float)
org.bukkit.material.ExtendedRails(int) Magic value
org.bukkit.material.ExtendedRails(int, byte) Magic value
org.bukkit.material.ExtendedRails(Material, byte) Magic value
org.bukkit.material.FlowerPot(int) Magic value
org.bukkit.material.FlowerPot(int, byte) Magic value
org.bukkit.material.FlowerPot(Material, byte) Magic value
org.bukkit.material.Furnace(int) Magic value
org.bukkit.material.Furnace(int, byte) Magic value
org.bukkit.material.Furnace(Material, byte) Magic value
org.bukkit.material.FurnaceAndDispenser(int) Magic value
org.bukkit.material.FurnaceAndDispenser(int, byte) Magic value
org.bukkit.material.FurnaceAndDispenser(Material, byte) Magic value
org.bukkit.inventory.FurnaceRecipe(ItemStack, Material, int) Magic value
org.bukkit.inventory.FurnaceRecipe(ItemStack, Material, int, float) Magic value
org.bukkit.material.Hopper(int) Magic value
org.bukkit.material.Hopper(int, byte) Magic value
org.bukkit.material.Hopper(Material, byte) Magic value
org.bukkit.event.entity.ItemSpawnEvent(Item, Location)
org.bukkit.inventory.ItemStack(int) Magic value
org.bukkit.inventory.ItemStack(int, int) Magic value
org.bukkit.inventory.ItemStack(int, int, short) Magic value
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.material.Ladder(int) Magic value
org.bukkit.material.Ladder(int, byte) Magic value
org.bukkit.material.Ladder(Material, byte) Magic value
org.bukkit.material.Leaves(int) Magic value
org.bukkit.material.Leaves(int, byte) Magic value
org.bukkit.material.Leaves(Material, byte) Magic value
org.bukkit.material.Lever(int) Magic value
org.bukkit.material.Lever(int, byte) Magic value
org.bukkit.material.Lever(Material, byte) Magic value
org.bukkit.material.LongGrass(int) Magic value
org.bukkit.material.LongGrass(int, byte) Magic value
org.bukkit.material.LongGrass(Material, byte) Magic value
org.bukkit.map.MapCursor(byte, byte, byte, byte, boolean) Magic value
org.bukkit.material.MaterialData(int) Magic value
org.bukkit.material.MaterialData(int, byte) Magic value
org.bukkit.material.MaterialData(Material, byte) Magic value
org.bukkit.material.MonsterEggs(int) Magic value
org.bukkit.material.MonsterEggs(int, byte) Magic value
org.bukkit.material.MonsterEggs(Material, byte) Magic value
org.bukkit.material.Mushroom(int, byte) Magic value
org.bukkit.material.Mushroom(Material, byte) Magic value
org.bukkit.NamespacedKey(String, String) should never be used by plugins, for internal use only!!
org.bukkit.material.NetherWarts(int) Magic value
org.bukkit.material.NetherWarts(int, byte) Magic value
org.bukkit.material.NetherWarts(Material, byte) Magic value
org.bukkit.material.Observer(int) Magic value
org.bukkit.material.Observer(int, byte) Magic value
org.bukkit.material.Observer(Material, byte) Magic value
org.bukkit.material.PistonBaseMaterial(int) Magic value
org.bukkit.material.PistonBaseMaterial(int, byte) Magic value
org.bukkit.material.PistonBaseMaterial(Material, byte) Magic value
org.bukkit.material.PistonExtensionMaterial(int) Magic value
org.bukkit.material.PistonExtensionMaterial(int, byte) Magic value
org.bukkit.material.PistonExtensionMaterial(Material, byte) Magic value
org.bukkit.event.player.PlayerAttemptPickupItemEvent(Player, Item)
org.bukkit.event.player.PlayerPreLoginEvent(String, InetAddress)
org.bukkit.event.player.PlayerResourcePackStatusEvent(Player, PlayerResourcePackStatusEvent.Status)
org.bukkit.potion.Potion(int)
org.bukkit.potion.Potion(PotionType, int, boolean) In favour of using Potion(PotionType) with Potion.splash().
org.bukkit.potion.Potion(PotionType, int, boolean, boolean) In favour of using Potion(PotionType) with Potion.extend() and possibly Potion.splash().
org.bukkit.material.PoweredRail(int) Magic value
org.bukkit.material.PoweredRail(int, byte) Magic value
org.bukkit.material.PoweredRail(Material, byte) Magic value
org.bukkit.material.PressurePlate(int) Magic value
org.bukkit.material.PressurePlate(int, byte) Magic value
org.bukkit.material.PressurePlate(Material, byte) Magic value
org.bukkit.material.Prismarine(int) Magic value
org.bukkit.material.Prismarine(int, byte) Magic value
org.bukkit.material.Prismarine(Material, byte) Magic value
org.bukkit.material.Pumpkin(int) Magic value
org.bukkit.material.Pumpkin(int, byte) Magic value
org.bukkit.material.Pumpkin(Material, byte) Magic value
org.bukkit.material.Rails(int) Magic value
org.bukkit.material.Rails(int, byte) Magic value
org.bukkit.material.Rails(Material, byte) Magic value
org.bukkit.material.RedstoneTorch(int) Magic value
org.bukkit.material.RedstoneTorch(int, byte) Magic value
org.bukkit.material.RedstoneTorch(Material, byte) Magic value
org.bukkit.material.RedstoneWire(int) Magic value
org.bukkit.material.RedstoneWire(int, byte) Magic value
org.bukkit.material.RedstoneWire(Material, byte) Magic value
org.bukkit.material.Sand(int) Magic value
org.bukkit.material.Sand(int, byte) Magic value
org.bukkit.material.Sand(Material, byte) Magic value
org.bukkit.material.Sandstone(int) Magic value
org.bukkit.material.Sandstone(int, byte) Magic value
org.bukkit.material.Sandstone(Material, byte) Magic value
org.bukkit.material.Sapling(int, byte) Magic value
org.bukkit.material.Sapling(Material, byte) Magic value
org.bukkit.inventory.ShapedRecipe(ItemStack)
org.bukkit.inventory.ShapelessRecipe(ItemStack)
org.bukkit.material.Sign(int) Magic value
org.bukkit.material.Sign(int, byte) Magic value
org.bukkit.material.Sign(Material, byte) Magic value
org.bukkit.material.SimpleAttachableMaterialData(int) Magic value
org.bukkit.material.SimpleAttachableMaterialData(int, byte) Magic value
org.bukkit.material.SimpleAttachableMaterialData(Material, byte) Magic value
org.bukkit.material.Skull(int) Magic value
org.bukkit.material.Skull(int, byte) Magic value
org.bukkit.material.Skull(Material, byte) Magic value
org.bukkit.material.SmoothBrick(int) Magic value
org.bukkit.material.SmoothBrick(int, byte) Magic value
org.bukkit.material.SmoothBrick(Material, byte) Magic value
org.bukkit.material.SpawnEgg(byte) Magic value
org.bukkit.material.SpawnEgg(int, byte) Magic value
org.bukkit.material.Sponge(int) Magic value
org.bukkit.material.Sponge(int, byte) Magic value
org.bukkit.material.Sponge(Material, byte) Magic value
org.bukkit.material.Stairs(int) Magic value
org.bukkit.material.Stairs(int, byte) Magic value
org.bukkit.material.Stairs(Material, byte) Magic value
org.bukkit.material.Step(int) Magic value
org.bukkit.material.Step(int, byte) Magic value
org.bukkit.material.Step(Material, byte) Magic value
org.bukkit.material.Stone(int) Magic value
org.bukkit.material.Stone(int, byte) Magic value
org.bukkit.material.Stone(Material, byte) Magic value
org.bukkit.material.TexturedMaterial(int) Magic value
org.bukkit.material.TexturedMaterial(int, byte) Magic value
org.bukkit.material.TexturedMaterial(Material, byte) Magic value
org.bukkit.material.Torch(int) Magic value
org.bukkit.material.Torch(int, byte) Magic value
org.bukkit.material.Torch(Material, byte) Magic value
org.bukkit.material.TrapDoor(int) Magic value
org.bukkit.material.TrapDoor(int, byte) Magic value
org.bukkit.material.TrapDoor(Material, byte) Magic value
org.bukkit.material.Tree(int) Magic value
org.bukkit.material.Tree(int, byte) Magic value
org.bukkit.material.Tree(Material, byte) Magic value
org.bukkit.material.Tripwire(int) Magic value
org.bukkit.material.Tripwire(int, byte) Magic value
org.bukkit.material.TripwireHook(int) Magic value
org.bukkit.material.TripwireHook(int, byte) Magic value
org.bukkit.material.Vine(byte) Magic value
org.bukkit.material.Vine(int, byte) Magic value
org.bukkit.material.Wood(int) Magic value
org.bukkit.material.Wood(int, byte) Magic value
org.bukkit.material.Wood(Material, byte) Magic value
org.bukkit.material.WoodenStep(int) Magic value
org.bukkit.material.WoodenStep(int, byte) Magic value
org.bukkit.material.WoodenStep(Material, byte) Magic value
org.bukkit.material.Wool(int) Magic value
org.bukkit.material.Wool(int, byte) Magic value
org.bukkit.material.Wool(Material, byte) Magic value

Deprecated Enum Constants

Enum Constant and Description
org.bukkit.Effect.CLOUD Spigot specific API, use Particle.
org.bukkit.Effect.COLOURED_DUST Spigot specific API, use Particle.
org.bukkit.Effect.CRIT Spigot specific API, use Particle.
org.bukkit.EntityEffect.DEATH although this effect may trigger other events on non-living entities, it's only supported usage is on living ones.
org.bukkit.Effect.EXPLOSION Spigot specific API, use Particle.
org.bukkit.Effect.EXPLOSION_HUGE Spigot specific API, use Particle.
org.bukkit.Effect.EXPLOSION_LARGE Spigot specific API, use Particle.
org.bukkit.Effect.FIREWORKS_SPARK Spigot specific API, use Particle.
org.bukkit.Effect.FLAME Spigot specific API, use Particle.
org.bukkit.Effect.FLYING_GLYPH Spigot specific API, use Particle.
org.bukkit.Effect.FOOTSTEP Spigot specific API, use Particle.
org.bukkit.Effect.HAPPY_VILLAGER Spigot specific API, use Particle.
org.bukkit.Effect.HEART Spigot specific API, use Particle.
org.bukkit.entity.Villager.Profession.HUSK Unused
org.bukkit.Effect.INSTANT_SPELL Spigot specific API, use Particle.
org.bukkit.Effect.ITEM_BREAK Spigot specific API, use Particle.
org.bukkit.Effect.LARGE_SMOKE Spigot specific API, use Particle.
org.bukkit.Effect.LAVA_POP Spigot specific API, use Particle.
org.bukkit.Effect.LAVADRIP Spigot specific API, use Particle.
org.bukkit.Effect.MAGIC_CRIT Spigot specific API, use Particle.
org.bukkit.entity.Villager.Profession.NORMAL Unused
org.bukkit.Effect.NOTE Spigot specific API, use Particle.
org.bukkit.Effect.PARTICLE_SMOKE Spigot specific API, use Particle.
org.bukkit.Effect.PORTAL Spigot specific API, use Particle.
org.bukkit.Effect.POTION_SWIRL Spigot specific API, use Particle.
org.bukkit.Effect.POTION_SWIRL_TRANSPARENT Spigot specific API, use Particle.
org.bukkit.EntityEffect.SHEEP_EAT although this effect may trigger other events on non-living entities, it's only supported usage is on living ones.
org.bukkit.Effect.SLIME Spigot specific API, use Particle.
org.bukkit.Effect.SMALL_SMOKE Spigot specific API, use Particle.
org.bukkit.Effect.SNOW_SHOVEL Spigot specific API, use Particle.
org.bukkit.Effect.SNOWBALL_BREAK Spigot specific API, use Particle.
org.bukkit.Effect.SPELL Spigot specific API, use Particle.
org.bukkit.Effect.SPLASH Spigot specific API, use Particle.
org.bukkit.Effect.TILE_BREAK Spigot specific API, use Particle.
org.bukkit.Effect.TILE_DUST Spigot specific API, use Particle.
org.bukkit.plugin.PluginAwareness.Flags.UTF8 all plugins are now assumed to be UTF-8 aware.
org.bukkit.Effect.VILLAGER_THUNDERCLOUD Spigot specific API, use Particle.
org.bukkit.Effect.VOID_FOG Spigot specific API, use Particle.
org.bukkit.Effect.WATERDRIP Spigot specific API, use Particle.
org.bukkit.Effect.WITCH_MAGIC Spigot specific API, use Particle.