From 0023e5549a48eec4310b04111883933ac0b2c3e7 Mon Sep 17 00:00:00 2001 From: Bukkit/Spigot Date: Mon, 25 Nov 2024 07:52:33 +1100 Subject: [PATCH] #1082: Add "since" to Deprecation annotations By: DerFrZocker --- .../src/main/java/org/bukkit/BanEntry.java | 2 +- .../src/main/java/org/bukkit/BanList.java | 12 +- .../src/main/java/org/bukkit/Bukkit.java | 36 +- .../main/java/org/bukkit/ChunkSnapshot.java | 6 +- .../src/main/java/org/bukkit/CoalType.java | 4 +- .../src/main/java/org/bukkit/CropState.java | 4 +- .../src/main/java/org/bukkit/Difficulty.java | 4 +- .../src/main/java/org/bukkit/DyeColor.java | 10 +- .../src/main/java/org/bukkit/Effect.java | 24 +- .../main/java/org/bukkit/EntityEffect.java | 8 +- .../src/main/java/org/bukkit/FeatureFlag.java | 6 +- .../src/main/java/org/bukkit/GameEvent.java | 44 +- .../src/main/java/org/bukkit/GameMode.java | 4 +- .../main/java/org/bukkit/GrassSpecies.java | 4 +- .../src/main/java/org/bukkit/Instrument.java | 4 +- .../src/main/java/org/bukkit/Material.java | 936 +++++++++--------- .../main/java/org/bukkit/MusicInstrument.java | 4 +- .../main/java/org/bukkit/NamespacedKey.java | 2 +- paper-api/src/main/java/org/bukkit/Note.java | 10 +- .../main/java/org/bukkit/OfflinePlayer.java | 2 +- .../main/java/org/bukkit/SandstoneType.java | 4 +- .../src/main/java/org/bukkit/Server.java | 36 +- .../src/main/java/org/bukkit/SkullType.java | 2 +- .../main/java/org/bukkit/StructureType.java | 2 +- paper-api/src/main/java/org/bukkit/Tag.java | 12 +- .../src/main/java/org/bukkit/TreeSpecies.java | 6 +- .../java/org/bukkit/UndefinedNullability.java | 2 +- .../main/java/org/bukkit/UnsafeValues.java | 2 +- paper-api/src/main/java/org/bukkit/World.java | 84 +- .../bukkit/attribute/AttributeModifier.java | 2 +- .../src/main/java/org/bukkit/block/Bed.java | 2 +- .../src/main/java/org/bukkit/block/Block.java | 2 +- .../java/org/bukkit/block/BlockState.java | 4 +- .../main/java/org/bukkit/block/BlockType.java | 2 +- .../org/bukkit/block/CreatureSpawner.java | 4 +- .../java/org/bukkit/block/DecoratedPot.java | 2 +- .../main/java/org/bukkit/block/Lockable.java | 4 +- .../org/bukkit/block/PistonMoveReaction.java | 4 +- .../src/main/java/org/bukkit/block/Sign.java | 18 +- .../src/main/java/org/bukkit/block/Skull.java | 12 +- .../java/org/bukkit/block/SuspiciousSand.java | 2 +- .../org/bukkit/block/banner/PatternType.java | 4 +- .../org/bukkit/block/data/type/Switch.java | 6 +- .../org/bukkit/block/data/type/Vault.java | 4 +- .../main/java/org/bukkit/boss/BossBar.java | 4 +- .../main/java/org/bukkit/command/Command.java | 4 +- .../configuration/file/FileConfiguration.java | 2 +- .../file/FileConfigurationOptions.java | 8 +- .../configuration/file/YamlConfiguration.java | 4 +- .../file/YamlConfigurationOptions.java | 4 +- .../configuration/file/YamlConstructor.java | 2 +- .../configuration/file/YamlRepresenter.java | 2 +- .../org/bukkit/enchantments/Enchantment.java | 14 +- .../enchantments/EnchantmentTarget.java | 2 +- .../enchantments/EnchantmentWrapper.java | 2 +- .../java/org/bukkit/entity/AbstractArrow.java | 6 +- .../java/org/bukkit/entity/AbstractHorse.java | 4 +- .../org/bukkit/entity/AbstractSkeleton.java | 4 +- .../main/java/org/bukkit/entity/Ageable.java | 8 +- .../org/bukkit/entity/AreaEffectCloud.java | 4 +- .../java/org/bukkit/entity/ArmorStand.java | 20 +- .../main/java/org/bukkit/entity/Arrow.java | 4 +- .../src/main/java/org/bukkit/entity/Boat.java | 26 +- .../java/org/bukkit/entity/Damageable.java | 6 +- .../java/org/bukkit/entity/Endermite.java | 4 +- .../main/java/org/bukkit/entity/Entity.java | 6 +- .../java/org/bukkit/entity/EntityType.java | 8 +- .../main/java/org/bukkit/entity/Evoker.java | 6 +- .../java/org/bukkit/entity/FallingBlock.java | 2 +- .../main/java/org/bukkit/entity/FishHook.java | 4 +- .../main/java/org/bukkit/entity/Guardian.java | 4 +- .../main/java/org/bukkit/entity/Horse.java | 6 +- .../java/org/bukkit/entity/HumanEntity.java | 12 +- .../org/bukkit/entity/LingeringPotion.java | 2 +- .../java/org/bukkit/entity/LivingEntity.java | 4 +- .../main/java/org/bukkit/entity/Ocelot.java | 10 +- .../org/bukkit/entity/PiglinAbstract.java | 4 +- .../main/java/org/bukkit/entity/Player.java | 24 +- .../java/org/bukkit/entity/Projectile.java | 4 +- .../main/java/org/bukkit/entity/Skeleton.java | 2 +- .../java/org/bukkit/entity/SplashPotion.java | 2 +- .../java/org/bukkit/entity/TippedArrow.java | 2 +- .../main/java/org/bukkit/entity/Zoglin.java | 4 +- .../main/java/org/bukkit/entity/Zombie.java | 12 +- .../bukkit/event/block/BlockBurnEvent.java | 2 +- .../event/block/BlockCanBuildEvent.java | 2 +- .../event/block/BlockPistonExtendEvent.java | 4 +- .../event/block/BlockPistonRetractEvent.java | 2 +- .../bukkit/event/block/BlockPlaceEvent.java | 2 +- .../event/block/CauldronLevelChangeEvent.java | 6 +- .../org/bukkit/event/block/NotePlayEvent.java | 4 +- .../bukkit/event/block/SignChangeEvent.java | 2 +- .../enchantment/PrepareItemEnchantEvent.java | 2 +- .../event/entity/CreatureSpawnEvent.java | 2 +- .../entity/EntityCombustByBlockEvent.java | 2 +- .../entity/EntityCombustByEntityEvent.java | 2 +- .../event/entity/EntityCombustEvent.java | 4 +- .../event/entity/EntityCreatePortalEvent.java | 2 +- .../entity/EntityDamageByBlockEvent.java | 4 +- .../entity/EntityDamageByEntityEvent.java | 4 +- .../event/entity/EntityDamageEvent.java | 6 +- .../bukkit/event/entity/EntityPlaceEvent.java | 2 +- .../event/entity/EntityResurrectEvent.java | 2 +- .../event/entity/EntityShootBowEvent.java | 2 +- .../event/entity/EntityTargetEvent.java | 2 +- .../bukkit/event/entity/ExpBottleEvent.java | 2 +- .../bukkit/event/entity/HorseJumpEvent.java | 4 +- .../bukkit/event/entity/ItemSpawnEvent.java | 2 +- .../entity/LingeringPotionSplashEvent.java | 2 +- .../org/bukkit/event/entity/PigZapEvent.java | 2 +- .../event/entity/PlayerLeashEntityEvent.java | 2 +- .../event/entity/PotionSplashEvent.java | 2 +- .../event/entity/SheepDyeWoolEvent.java | 2 +- .../entity/VillagerReplenishTradeEvent.java | 4 +- .../event/hanging/HangingPlaceEvent.java | 2 +- .../event/inventory/InventoryClickEvent.java | 2 +- .../bukkit/event/inventory/InventoryType.java | 2 +- .../player/AsyncPlayerChatPreviewEvent.java | 2 +- .../player/AsyncPlayerPreLoginEvent.java | 12 +- .../event/player/PlayerAnimationEvent.java | 2 +- .../PlayerArmorStandManipulateEvent.java | 2 +- .../event/player/PlayerBedEnterEvent.java | 2 +- .../event/player/PlayerBucketEmptyEvent.java | 4 +- .../event/player/PlayerBucketEvent.java | 4 +- .../event/player/PlayerBucketFillEvent.java | 4 +- .../event/player/PlayerBucketFishEvent.java | 6 +- .../bukkit/event/player/PlayerChatEvent.java | 2 +- .../player/PlayerChatTabCompleteEvent.java | 2 +- .../player/PlayerCommandPreprocessEvent.java | 2 +- .../event/player/PlayerEditBookEvent.java | 2 +- .../event/player/PlayerHarvestBlockEvent.java | 2 +- .../event/player/PlayerInteractEvent.java | 2 +- .../event/player/PlayerItemConsumeEvent.java | 2 +- .../event/player/PlayerItemMendEvent.java | 2 +- .../event/player/PlayerPickupItemEvent.java | 2 +- .../event/player/PlayerPreLoginEvent.java | 4 +- .../event/player/PlayerRespawnEvent.java | 4 +- .../event/player/PlayerRiptideEvent.java | 2 +- .../event/player/PlayerShearEntityEvent.java | 2 +- .../player/PlayerUnleashEntityEvent.java | 2 +- .../event/server/BroadcastMessageEvent.java | 2 +- .../event/server/ServerListPingEvent.java | 2 +- .../event/weather/LightningStrikeEvent.java | 2 +- .../bukkit/event/world/PortalCreateEvent.java | 2 +- .../org/bukkit/generator/BlockPopulator.java | 2 +- .../org/bukkit/generator/ChunkGenerator.java | 16 +- .../org/bukkit/inventory/EntityEquipment.java | 8 +- .../bukkit/inventory/EquipmentSlotGroup.java | 2 +- .../org/bukkit/inventory/FurnaceRecipe.java | 12 +- .../org/bukkit/inventory/InventoryView.java | 2 +- .../java/org/bukkit/inventory/ItemStack.java | 8 +- .../java/org/bukkit/inventory/ItemType.java | 4 +- .../org/bukkit/inventory/PlayerInventory.java | 4 +- .../org/bukkit/inventory/RecipeChoice.java | 2 +- .../org/bukkit/inventory/ShapedRecipe.java | 4 +- .../org/bukkit/inventory/ShapelessRecipe.java | 10 +- .../org/bukkit/inventory/SmithingRecipe.java | 2 +- .../org/bukkit/inventory/meta/ItemMeta.java | 12 +- .../org/bukkit/inventory/meta/MapMeta.java | 12 +- .../org/bukkit/inventory/meta/PotionMeta.java | 6 +- .../org/bukkit/inventory/meta/SkullMeta.java | 4 +- .../bukkit/inventory/meta/SpawnEggMeta.java | 4 +- .../meta/tags/CustomItemTagContainer.java | 2 +- .../meta/tags/ItemTagAdapterContext.java | 2 +- .../inventory/meta/tags/ItemTagType.java | 2 +- .../java/org/bukkit/loot/LootContext.java | 4 +- .../main/java/org/bukkit/map/MapCanvas.java | 6 +- .../main/java/org/bukkit/map/MapCursor.java | 12 +- .../org/bukkit/map/MapCursorCollection.java | 6 +- .../main/java/org/bukkit/map/MapPalette.java | 38 +- .../src/main/java/org/bukkit/map/MapView.java | 4 +- .../main/java/org/bukkit/material/Banner.java | 4 +- .../main/java/org/bukkit/material/Bed.java | 4 +- .../main/java/org/bukkit/material/Button.java | 4 +- .../main/java/org/bukkit/material/Cake.java | 4 +- .../java/org/bukkit/material/Cauldron.java | 6 +- .../main/java/org/bukkit/material/Chest.java | 4 +- .../main/java/org/bukkit/material/Coal.java | 4 +- .../java/org/bukkit/material/CocoaPlant.java | 4 +- .../java/org/bukkit/material/Command.java | 4 +- .../java/org/bukkit/material/Comparator.java | 4 +- .../main/java/org/bukkit/material/Crops.java | 4 +- .../org/bukkit/material/DetectorRail.java | 4 +- .../main/java/org/bukkit/material/Diode.java | 4 +- .../bukkit/material/DirectionalContainer.java | 4 +- .../java/org/bukkit/material/Dispenser.java | 4 +- .../main/java/org/bukkit/material/Door.java | 8 +- .../main/java/org/bukkit/material/Dye.java | 4 +- .../java/org/bukkit/material/EnderChest.java | 4 +- .../org/bukkit/material/ExtendedRails.java | 6 +- .../java/org/bukkit/material/FlowerPot.java | 4 +- .../java/org/bukkit/material/Furnace.java | 4 +- .../bukkit/material/FurnaceAndDispenser.java | 4 +- .../main/java/org/bukkit/material/Gate.java | 4 +- .../main/java/org/bukkit/material/Hopper.java | 4 +- .../main/java/org/bukkit/material/Ladder.java | 4 +- .../main/java/org/bukkit/material/Leaves.java | 4 +- .../main/java/org/bukkit/material/Lever.java | 4 +- .../java/org/bukkit/material/LongGrass.java | 4 +- .../org/bukkit/material/MaterialData.java | 10 +- .../java/org/bukkit/material/MonsterEggs.java | 4 +- .../java/org/bukkit/material/Mushroom.java | 8 +- .../java/org/bukkit/material/NetherWarts.java | 4 +- .../java/org/bukkit/material/Observer.java | 4 +- .../bukkit/material/PistonBaseMaterial.java | 4 +- .../material/PistonExtensionMaterial.java | 4 +- .../java/org/bukkit/material/PoweredRail.java | 4 +- .../org/bukkit/material/PressurePlate.java | 4 +- .../java/org/bukkit/material/Pumpkin.java | 4 +- .../main/java/org/bukkit/material/Rails.java | 6 +- .../org/bukkit/material/RedstoneTorch.java | 4 +- .../org/bukkit/material/RedstoneWire.java | 4 +- .../java/org/bukkit/material/Sandstone.java | 4 +- .../java/org/bukkit/material/Sapling.java | 4 +- .../main/java/org/bukkit/material/Sign.java | 4 +- .../SimpleAttachableMaterialData.java | 4 +- .../main/java/org/bukkit/material/Skull.java | 4 +- .../java/org/bukkit/material/SmoothBrick.java | 4 +- .../java/org/bukkit/material/SpawnEgg.java | 10 +- .../main/java/org/bukkit/material/Stairs.java | 4 +- .../main/java/org/bukkit/material/Step.java | 8 +- .../org/bukkit/material/TexturedMaterial.java | 8 +- .../main/java/org/bukkit/material/Torch.java | 4 +- .../java/org/bukkit/material/TrapDoor.java | 4 +- .../main/java/org/bukkit/material/Tree.java | 4 +- .../java/org/bukkit/material/Tripwire.java | 4 +- .../org/bukkit/material/TripwireHook.java | 4 +- .../main/java/org/bukkit/material/Vine.java | 6 +- .../main/java/org/bukkit/material/Wood.java | 4 +- .../java/org/bukkit/material/WoodenStep.java | 4 +- .../main/java/org/bukkit/material/Wool.java | 4 +- .../material/types/MushroomBlockTexture.java | 4 +- .../persistence/PersistentDataType.java | 2 +- .../org/bukkit/plugin/PluginAwareness.java | 2 +- .../bukkit/plugin/PluginDescriptionFile.java | 2 +- .../bukkit/plugin/SimplePluginManager.java | 4 +- .../bukkit/plugin/java/JavaPluginLoader.java | 2 +- .../plugin/messaging/StandardMessenger.java | 4 +- .../java/org/bukkit/potion/PotionBrewer.java | 4 +- .../java/org/bukkit/potion/PotionData.java | 2 +- .../java/org/bukkit/potion/PotionEffect.java | 6 +- .../org/bukkit/potion/PotionEffectType.java | 14 +- .../potion/PotionEffectTypeWrapper.java | 2 +- .../java/org/bukkit/potion/PotionType.java | 8 +- .../org/bukkit/scheduler/BukkitScheduler.java | 24 +- .../java/org/bukkit/scoreboard/Criterias.java | 2 +- .../bukkit/scoreboard/NameTagVisibility.java | 2 +- .../java/org/bukkit/scoreboard/Objective.java | 4 +- .../java/org/bukkit/scoreboard/Score.java | 2 +- .../org/bukkit/scoreboard/Scoreboard.java | 16 +- .../main/java/org/bukkit/scoreboard/Team.java | 12 +- .../main/java/org/bukkit/util/Consumer.java | 2 +- .../test/java/org/bukkit/DeprecatedTest.java | 147 +++ .../provider/ClassNodeArgumentProvider.java | 53 + .../provider/ClassReaderArgumentProvider.java | 107 ++ .../bukkit/support/test/ClassNodeTest.java | 20 + .../bukkit/support/test/ClassReaderTest.java | 20 + 257 files changed, 1523 insertions(+), 1176 deletions(-) create mode 100644 paper-api/src/test/java/org/bukkit/DeprecatedTest.java create mode 100644 paper-api/src/test/java/org/bukkit/support/provider/ClassNodeArgumentProvider.java create mode 100644 paper-api/src/test/java/org/bukkit/support/provider/ClassReaderArgumentProvider.java create mode 100644 paper-api/src/test/java/org/bukkit/support/test/ClassNodeTest.java create mode 100644 paper-api/src/test/java/org/bukkit/support/test/ClassReaderTest.java diff --git a/paper-api/src/main/java/org/bukkit/BanEntry.java b/paper-api/src/main/java/org/bukkit/BanEntry.java index fc4da11c9d..c03d8b9360 100644 --- a/paper-api/src/main/java/org/bukkit/BanEntry.java +++ b/paper-api/src/main/java/org/bukkit/BanEntry.java @@ -52,7 +52,7 @@ public interface BanEntry { * @return the target name or IP address * @deprecated See {@link #getBanTarget()} */ - @Deprecated + @Deprecated(since = "1.20.1") @NotNull public String getTarget(); diff --git a/paper-api/src/main/java/org/bukkit/BanList.java b/paper-api/src/main/java/org/bukkit/BanList.java index a04cde615f..ac38b4af28 100644 --- a/paper-api/src/main/java/org/bukkit/BanList.java +++ b/paper-api/src/main/java/org/bukkit/BanList.java @@ -23,7 +23,7 @@ public interface BanList { * * @deprecated deprecated in favor of {@link #PROFILE} */ - @Deprecated + @Deprecated(since = "1.20.1") NAME, /** * Banned IP addresses @@ -43,7 +43,7 @@ public interface BanList { * @return the corresponding entry, or null if none found * @deprecated see {@link #getBanEntry(Object)} */ - @Deprecated + @Deprecated(since = "1.20.1") @Nullable public BanEntry getBanEntry(@NotNull String target); @@ -69,7 +69,7 @@ public interface BanList { * (updated) previous ban * @deprecated see {@link #addBan(Object, String, Date, String)} */ - @Deprecated + @Deprecated(since = "1.20.1") @Nullable public BanEntry addBan(@NotNull String target, @Nullable String reason, @Nullable Date expires, @Nullable String source); @@ -124,7 +124,7 @@ public interface BanList { * @return an immutable set containing every entry tracked by this list * @deprecated This return a generic class, prefer use {@link #getEntries()} */ - @Deprecated + @Deprecated(since = "1.20.1") @NotNull public Set getBanEntries(); @@ -155,7 +155,7 @@ public interface BanList { * active ban status, false otherwise * @deprecated see {@link #isBanned(Object)} */ - @Deprecated + @Deprecated(since = "1.20.1") public boolean isBanned(@NotNull String target); /** @@ -174,6 +174,6 @@ public interface BanList { * * @deprecated see {@link #pardon(Object)} */ - @Deprecated + @Deprecated(since = "1.20.1") public void pardon(@NotNull String target); } diff --git a/paper-api/src/main/java/org/bukkit/Bukkit.java b/paper-api/src/main/java/org/bukkit/Bukkit.java index 964677d9d5..8b6c906f09 100644 --- a/paper-api/src/main/java/org/bukkit/Bukkit.java +++ b/paper-api/src/main/java/org/bukkit/Bukkit.java @@ -481,7 +481,7 @@ public final class Bukkit { * @return the default ticks per animal spawns value * @deprecated Deprecated in favor of {@link #getTicksPerSpawns(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public static int getTicksPerAnimalSpawns() { return server.getTicksPerAnimalSpawns(); } @@ -506,7 +506,7 @@ public final class Bukkit { * @return the default ticks per monsters spawn value * @deprecated Deprecated in favor of {@link #getTicksPerSpawns(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public static int getTicksPerMonsterSpawns() { return server.getTicksPerMonsterSpawns(); } @@ -530,7 +530,7 @@ public final class Bukkit { * @return the default ticks per water mobs spawn value * @deprecated Deprecated in favor of {@link #getTicksPerSpawns(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public static int getTicksPerWaterSpawns() { return server.getTicksPerWaterSpawns(); } @@ -554,7 +554,7 @@ public final class Bukkit { * @return the default ticks per ambient mobs spawn value * @deprecated Deprecated in favor of {@link #getTicksPerSpawns(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public static int getTicksPerAmbientSpawns() { return server.getTicksPerAmbientSpawns(); } @@ -578,7 +578,7 @@ public final class Bukkit { * @return the default ticks per water ambient mobs spawn value * @deprecated Deprecated in favor of {@link #getTicksPerSpawns(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public static int getTicksPerWaterAmbientSpawns() { return server.getTicksPerAmbientSpawns(); } @@ -602,7 +602,7 @@ public final class Bukkit { * @return the default ticks per water underground creature spawn value * @deprecated Deprecated in favor of {@link #getTicksPerSpawns(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public static int getTicksPerWaterUndergroundCreatureSpawns() { return server.getTicksPerWaterUndergroundCreatureSpawns(); } @@ -803,7 +803,7 @@ public final class Bukkit { * @return a map view if it exists, or null otherwise * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Nullable public static MapView getMap(int id) { return server.getMap(id); @@ -1158,7 +1158,7 @@ public final class Bukkit { * @return true if the server should send a preview, false otherwise * @deprecated chat previews have been removed */ - @Deprecated + @Deprecated(since = "1.19.3") public static boolean shouldSendChatPreviews() { return server.shouldSendChatPreviews(); } @@ -1255,7 +1255,7 @@ public final class Bukkit { * @deprecated Persistent storage of users should be by UUID as names are no longer * unique past a single session. */ - @Deprecated + @Deprecated(since = "1.7.5") @NotNull public static OfflinePlayer getOfflinePlayer(@NotNull String name) { return server.getOfflinePlayer(name); @@ -1332,7 +1332,7 @@ public final class Bukkit { * * @deprecated see {@link #banIP(InetAddress)} */ - @Deprecated + @Deprecated(since = "1.20.1") public static void banIP(@NotNull String address) { server.banIP(address); } @@ -1344,7 +1344,7 @@ public final class Bukkit { * * @deprecated see {@link #unbanIP(InetAddress)} */ - @Deprecated + @Deprecated(since = "1.20.1") public static void unbanIP(@NotNull String address) { server.unbanIP(address); } @@ -1585,7 +1585,7 @@ public final class Bukkit { * @return the monster spawn limit * @deprecated Deprecated in favor of {@link #getSpawnLimit(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public static int getMonsterSpawnLimit() { return server.getMonsterSpawnLimit(); } @@ -1597,7 +1597,7 @@ public final class Bukkit { * @return the animal spawn limit * @deprecated Deprecated in favor of {@link #getSpawnLimit(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public static int getAnimalSpawnLimit() { return server.getAnimalSpawnLimit(); } @@ -1609,7 +1609,7 @@ public final class Bukkit { * @return the water animal spawn limit * @deprecated Deprecated in favor of {@link #getSpawnLimit(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public static int getWaterAnimalSpawnLimit() { return server.getWaterAnimalSpawnLimit(); } @@ -1621,7 +1621,7 @@ public final class Bukkit { * @return the water ambient spawn limit * @deprecated Deprecated in favor of {@link #getSpawnLimit(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public static int getWaterAmbientSpawnLimit() { return server.getAmbientSpawnLimit(); } @@ -1633,7 +1633,7 @@ public final class Bukkit { * @return the water underground creature limit * @deprecated Deprecated in favor of {@link #getSpawnLimit(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public static int getWaterUndergroundCreatureSpawnLimit() { return server.getWaterUndergroundCreatureSpawnLimit(); } @@ -1645,7 +1645,7 @@ public final class Bukkit { * @return the ambient spawn limit * @deprecated Deprecated in favor of {@link #getSpawnLimit(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public static int getAmbientSpawnLimit() { return server.getAmbientSpawnLimit(); } @@ -2170,7 +2170,7 @@ public final class Bukkit { * @return the unsafe values instance * @see UnsafeValues */ - @Deprecated + @Deprecated(since = "1.7.2") @NotNull public static UnsafeValues getUnsafe() { return server.getUnsafe(); diff --git a/paper-api/src/main/java/org/bukkit/ChunkSnapshot.java b/paper-api/src/main/java/org/bukkit/ChunkSnapshot.java index 0cf808356a..8832a2e090 100644 --- a/paper-api/src/main/java/org/bukkit/ChunkSnapshot.java +++ b/paper-api/src/main/java/org/bukkit/ChunkSnapshot.java @@ -65,7 +65,7 @@ public interface ChunkSnapshot { * @return 0-15 * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") int getData(int x, int y, int z); /** @@ -107,7 +107,7 @@ public interface ChunkSnapshot { * @deprecated biomes are now 3-dimensional */ @NotNull - @Deprecated + @Deprecated(since = "1.15") Biome getBiome(int x, int z); /** @@ -129,7 +129,7 @@ public interface ChunkSnapshot { * @return temperature at given coordinate * @deprecated biomes are now 3-dimensional */ - @Deprecated + @Deprecated(since = "1.15") double getRawBiomeTemperature(int x, int z); /** diff --git a/paper-api/src/main/java/org/bukkit/CoalType.java b/paper-api/src/main/java/org/bukkit/CoalType.java index c07499dbdd..082632bcfa 100644 --- a/paper-api/src/main/java/org/bukkit/CoalType.java +++ b/paper-api/src/main/java/org/bukkit/CoalType.java @@ -24,7 +24,7 @@ public enum CoalType { * @return A byte containing the data value of this coal type * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public byte getData() { return data; } @@ -37,7 +37,7 @@ public enum CoalType { * it doesn't exist * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Nullable public static CoalType getByData(final byte data) { return BY_DATA.get(data); diff --git a/paper-api/src/main/java/org/bukkit/CropState.java b/paper-api/src/main/java/org/bukkit/CropState.java index fb4832fb79..c36e0ffe9b 100644 --- a/paper-api/src/main/java/org/bukkit/CropState.java +++ b/paper-api/src/main/java/org/bukkit/CropState.java @@ -55,7 +55,7 @@ public enum CropState { * @return A byte containing the data value of this growth state * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public byte getData() { return data; } @@ -68,7 +68,7 @@ public enum CropState { * it doesn't exist * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Nullable public static CropState getByData(final byte data) { return BY_DATA.get(data); diff --git a/paper-api/src/main/java/org/bukkit/Difficulty.java b/paper-api/src/main/java/org/bukkit/Difficulty.java index 3f6cbefc2b..c1f1f29b70 100644 --- a/paper-api/src/main/java/org/bukkit/Difficulty.java +++ b/paper-api/src/main/java/org/bukkit/Difficulty.java @@ -46,7 +46,7 @@ public enum Difficulty { * @return An integer value of this difficulty * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public int getValue() { return value; } @@ -59,7 +59,7 @@ public enum Difficulty { * it doesn't exist * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Nullable public static Difficulty getByValue(final int value) { return BY_ID.get(value); diff --git a/paper-api/src/main/java/org/bukkit/DyeColor.java b/paper-api/src/main/java/org/bukkit/DyeColor.java index bd213cabdd..807747db77 100644 --- a/paper-api/src/main/java/org/bukkit/DyeColor.java +++ b/paper-api/src/main/java/org/bukkit/DyeColor.java @@ -98,7 +98,7 @@ public enum DyeColor { * @see #getDyeData() * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public byte getWoolData() { return woolData; } @@ -110,7 +110,7 @@ public enum DyeColor { * @see #getWoolData() * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public byte getDyeData() { return dyeData; } @@ -144,7 +144,7 @@ public enum DyeColor { * @see #getByDyeData(byte) * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Nullable public static DyeColor getByWoolData(final byte data) { int i = 0xff & data; @@ -163,7 +163,7 @@ public enum DyeColor { * @see #getByWoolData(byte) * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Nullable public static DyeColor getByDyeData(final byte data) { int i = 0xff & data; @@ -204,7 +204,7 @@ public enum DyeColor { * @return dye color * @deprecated legacy use only */ - @Deprecated + @Deprecated(since = "1.13") @NotNull public static DyeColor legacyValueOf(@Nullable String name) { return "SILVER".equals(name) ? DyeColor.LIGHT_GRAY : DyeColor.valueOf(name); diff --git a/paper-api/src/main/java/org/bukkit/Effect.java b/paper-api/src/main/java/org/bukkit/Effect.java index 0d07777714..c196201850 100644 --- a/paper-api/src/main/java/org/bukkit/Effect.java +++ b/paper-api/src/main/java/org/bukkit/Effect.java @@ -27,70 +27,70 @@ public enum Effect { * @deprecated no longer exists * @see Sound#BLOCK_WOODEN_DOOR_OPEN */ - @Deprecated + @Deprecated(since = "1.19.3") DOOR_TOGGLE(1006, Type.SOUND), /** * Sound of a door opening. * @deprecated no longer exists * @see Sound#BLOCK_IRON_DOOR_OPEN */ - @Deprecated + @Deprecated(since = "1.19.3") IRON_DOOR_TOGGLE(1005, Type.SOUND), /** * Sound of a trapdoor opening. * @deprecated no longer exists * @see Sound#BLOCK_WOODEN_TRAPDOOR_OPEN */ - @Deprecated + @Deprecated(since = "1.19.3") TRAPDOOR_TOGGLE(1007, Type.SOUND), /** * Sound of a door opening. * @deprecated no longer exists * @see Sound#BLOCK_IRON_TRAPDOOR_OPEN */ - @Deprecated + @Deprecated(since = "1.19.3") IRON_TRAPDOOR_TOGGLE(1037, Type.SOUND), /** * Sound of a door opening. * @deprecated no longer exists * @see Sound#BLOCK_FENCE_GATE_OPEN */ - @Deprecated + @Deprecated(since = "1.19.3") FENCE_GATE_TOGGLE(1008, Type.SOUND), /** * Sound of a door closing. * @deprecated no longer exists * @see Sound#BLOCK_WOODEN_DOOR_CLOSE */ - @Deprecated + @Deprecated(since = "1.19.3") DOOR_CLOSE(1012, Type.SOUND), /** * Sound of a door closing. * @deprecated no longer exists * @see Sound#BLOCK_IRON_DOOR_CLOSE */ - @Deprecated + @Deprecated(since = "1.19.3") IRON_DOOR_CLOSE(1011, Type.SOUND), /** * Sound of a trapdoor closing. * @deprecated no longer exists * @see Sound#BLOCK_WOODEN_TRAPDOOR_CLOSE */ - @Deprecated + @Deprecated(since = "1.19.3") TRAPDOOR_CLOSE(1013, Type.SOUND), /** * Sound of a door closing. * @deprecated no longer exists * @see Sound#BLOCK_IRON_TRAPDOOR_CLOSE */ - @Deprecated + @Deprecated(since = "1.19.3") IRON_TRAPDOOR_CLOSE(1036, Type.SOUND), /** * Sound of a door closing. * @deprecated no longer exists * @see Sound#BLOCK_FENCE_GATE_CLOSE */ - @Deprecated + @Deprecated(since = "1.19.3") FENCE_GATE_CLOSE(1014, Type.SOUND), /** * Sound of fire being extinguished. @@ -359,7 +359,7 @@ public enum Effect { * @return ID of this effect * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public int getId() { return this.id; } @@ -388,7 +388,7 @@ public enum Effect { * @return Effect with the given ID * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Nullable public static Effect getById(int id) { return BY_ID.get(id); diff --git a/paper-api/src/main/java/org/bukkit/EntityEffect.java b/paper-api/src/main/java/org/bukkit/EntityEffect.java index 9db85b2f6f..5b8dc0c5c2 100644 --- a/paper-api/src/main/java/org/bukkit/EntityEffect.java +++ b/paper-api/src/main/java/org/bukkit/EntityEffect.java @@ -57,7 +57,7 @@ public enum EntityEffect { * * @deprecated Use {@link LivingEntity#playHurtAnimation(float)} */ - @Deprecated + @Deprecated(since = "1.20.1") HURT(2, LivingEntity.class), /** * When a mob dies. @@ -69,7 +69,7 @@ public enum EntityEffect { * @see #SNOWBALL_BREAK * @see #ENTITY_DEATH */ - @Deprecated + @Deprecated(since = "1.12.2") DEATH(3, Entity.class), /** * Spawns the egg breaking particles @@ -132,7 +132,7 @@ public enum EntityEffect { * @see #SHEEP_EAT_GRASS * @see #TNT_MINECART_IGNITE */ - @Deprecated + @Deprecated(since = "1.12.2") SHEEP_EAT(10, Entity.class), /** * Plays the sheep eating grass animation @@ -347,7 +347,7 @@ public enum EntityEffect { * @return The data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public byte getData() { return data; } diff --git a/paper-api/src/main/java/org/bukkit/FeatureFlag.java b/paper-api/src/main/java/org/bukkit/FeatureFlag.java index a96600443a..5c33daf443 100644 --- a/paper-api/src/main/java/org/bukkit/FeatureFlag.java +++ b/paper-api/src/main/java/org/bukkit/FeatureFlag.java @@ -18,7 +18,7 @@ public interface FeatureFlag extends Keyed { * * @deprecated not available since 1.21.2 */ - @Deprecated + @Deprecated(since = "1.21.2") public static final FeatureFlag BUNDLE = Bukkit.getUnsafe().getFeatureFlag(NamespacedKey.minecraft("bundle")); /** @@ -26,7 +26,7 @@ public interface FeatureFlag extends Keyed { * * @deprecated not available since 1.20 */ - @Deprecated + @Deprecated(since = "1.20.2") public static final FeatureFlag UPDATE_1_20 = Bukkit.getUnsafe().getFeatureFlag(NamespacedKey.minecraft("update_1_20")); public static final FeatureFlag TRADE_REBALANCE = Bukkit.getUnsafe().getFeatureFlag(NamespacedKey.minecraft("trade_rebalance")); @@ -36,7 +36,7 @@ public interface FeatureFlag extends Keyed { * * @deprecated not available since 1.21 */ - @Deprecated + @Deprecated(since = "1.21") public static final FeatureFlag UPDATE_121 = Bukkit.getUnsafe().getFeatureFlag(NamespacedKey.minecraft("update_1_21")); public static final FeatureFlag WINTER_DROP = Bukkit.getUnsafe().getFeatureFlag(NamespacedKey.minecraft("winter_drop")); diff --git a/paper-api/src/main/java/org/bukkit/GameEvent.java b/paper-api/src/main/java/org/bukkit/GameEvent.java index cb5f7dfcdb..8d8d2d710a 100644 --- a/paper-api/src/main/java/org/bukkit/GameEvent.java +++ b/paper-api/src/main/java/org/bukkit/GameEvent.java @@ -20,41 +20,41 @@ public abstract class GameEvent implements Keyed { public static final GameEvent BLOCK_DETACH = getEvent("block_detach"); public static final GameEvent BLOCK_OPEN = getEvent("block_open"); public static final GameEvent BLOCK_PLACE = getEvent("block_place"); - @Deprecated + @Deprecated(since = "1.19") public static final GameEvent BLOCK_PRESS = getEvent("block_activate"); - @Deprecated + @Deprecated(since = "1.19") public static final GameEvent BLOCK_SWITCH = getEvent("block_activate"); - @Deprecated + @Deprecated(since = "1.19") public static final GameEvent BLOCK_UNPRESS = getEvent("block_deactivate"); - @Deprecated + @Deprecated(since = "1.19") public static final GameEvent BLOCK_UNSWITCH = getEvent("block_deactivate"); public static final GameEvent CONTAINER_CLOSE = getEvent("container_close"); public static final GameEvent CONTAINER_OPEN = getEvent("container_open"); - @Deprecated + @Deprecated(since = "1.20") public static final GameEvent DISPENSE_FAIL = getEvent("block_activate"); public static final GameEvent DRINK = getEvent("drink"); - @Deprecated + @Deprecated(since = "1.19") public static final GameEvent DRINKING_FINISH = getEvent("drink"); public static final GameEvent EAT = getEvent("eat"); - @Deprecated + @Deprecated(since = "1.19") public static final GameEvent ELYTRA_FREE_FALL = getEvent("elytra_glide"); public static final GameEvent ELYTRA_GLIDE = getEvent("elytra_glide"); public static final GameEvent ENTITY_DAMAGE = getEvent("entity_damage"); - @Deprecated + @Deprecated(since = "1.19") public static final GameEvent ENTITY_DAMAGED = getEvent("entity_damage"); public static final GameEvent ENTITY_DIE = getEvent("entity_die"); public static final GameEvent ENTITY_DISMOUNT = getEvent("entity_dismount"); - @Deprecated + @Deprecated(since = "1.19") public static final GameEvent ENTITY_DYING = getEvent("entity_die"); public static final GameEvent ENTITY_INTERACT = getEvent("entity_interact"); public static final GameEvent ENTITY_MOUNT = getEvent("entity_mount"); - @Deprecated + @Deprecated(since = "1.19") public static final GameEvent ENTITY_KILLED = getEvent("entity_die"); public static final GameEvent ENTITY_PLACE = getEvent("entity_place"); public static final GameEvent ENTITY_ACTION = getEvent("entity_action"); - @Deprecated + @Deprecated(since = "1.20.2") public static final GameEvent ENTITY_ROAR = getEvent("entity_action"); - @Deprecated + @Deprecated(since = "1.20.2") public static final GameEvent ENTITY_SHAKE = getEvent("entity_action"); public static final GameEvent EQUIP = getEvent("equip"); public static final GameEvent EXPLODE = getEvent("explode"); @@ -68,33 +68,33 @@ public abstract class GameEvent implements Keyed { public static final GameEvent JUKEBOX_PLAY = getEvent("jukebox_play"); public static final GameEvent JUKEBOX_STOP_PLAY = getEvent("jukebox_stop_play"); public static final GameEvent LIGHTNING_STRIKE = getEvent("lightning_strike"); - @Deprecated + @Deprecated(since = "1.19") public static final GameEvent MOB_INTERACT = getEvent("entity_interact"); public static final GameEvent NOTE_BLOCK_PLAY = getEvent("note_block_play"); - @Deprecated + @Deprecated(since = "1.20") public static final GameEvent PISTON_CONTRACT = getEvent("block_deactivate"); - @Deprecated + @Deprecated(since = "1.20") public static final GameEvent PISTON_EXTEND = getEvent("block_activate"); public static final GameEvent PRIME_FUSE = getEvent("prime_fuse"); public static final GameEvent PROJECTILE_LAND = getEvent("projectile_land"); public static final GameEvent PROJECTILE_SHOOT = getEvent("projectile_shoot"); - @Deprecated + @Deprecated(since = "1.19") public static final GameEvent RAVAGER_ROAR = getEvent("entity_action"); - @Deprecated + @Deprecated(since = "1.19") public static final GameEvent RING_BELL = getEvent("block_change"); public static final GameEvent SCULK_SENSOR_TENDRILS_CLICKING = getEvent("sculk_sensor_tendrils_clicking"); public static final GameEvent SHEAR = getEvent("shear"); public static final GameEvent SHRIEK = getEvent("shriek"); - @Deprecated + @Deprecated(since = "1.19") public static final GameEvent SHULKER_CLOSE = getEvent("container_close"); - @Deprecated + @Deprecated(since = "1.19") public static final GameEvent SHULKER_OPEN = getEvent("container_open"); public static final GameEvent SPLASH = getEvent("splash"); public static final GameEvent STEP = getEvent("step"); public static final GameEvent SWIM = getEvent("swim"); public static final GameEvent TELEPORT = getEvent("teleport"); public static final GameEvent UNEQUIP = getEvent("unequip"); - @Deprecated + @Deprecated(since = "1.19") public static final GameEvent WOLF_SHAKING = getEvent("entity_action"); public static final GameEvent RESONATE_1 = getEvent("resonate_1"); public static final GameEvent RESONATE_2 = getEvent("resonate_2"); @@ -120,7 +120,7 @@ public abstract class GameEvent implements Keyed { * @deprecated Use {@link Registry#get(NamespacedKey)} instead. */ @Nullable - @Deprecated + @Deprecated(since = "1.20.1") public static GameEvent getByKey(@NotNull NamespacedKey namespacedKey) { return Registry.GAME_EVENT.get(namespacedKey); } @@ -132,7 +132,7 @@ public abstract class GameEvent implements Keyed { * @deprecated use {@link Registry#iterator()}. */ @NotNull - @Deprecated + @Deprecated(since = "1.20.1") public static Collection values() { return Collections.unmodifiableCollection(Lists.newArrayList(Registry.GAME_EVENT)); } diff --git a/paper-api/src/main/java/org/bukkit/GameMode.java b/paper-api/src/main/java/org/bukkit/GameMode.java index 938c3217f9..3d693c42a8 100644 --- a/paper-api/src/main/java/org/bukkit/GameMode.java +++ b/paper-api/src/main/java/org/bukkit/GameMode.java @@ -46,7 +46,7 @@ public enum GameMode { * @return An integer value of this gamemode * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public int getValue() { return value; } @@ -59,7 +59,7 @@ public enum GameMode { * it doesn't exist * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Nullable public static GameMode getByValue(final int value) { return BY_ID.get(value); diff --git a/paper-api/src/main/java/org/bukkit/GrassSpecies.java b/paper-api/src/main/java/org/bukkit/GrassSpecies.java index f9c9ae463a..9b6d8134f1 100644 --- a/paper-api/src/main/java/org/bukkit/GrassSpecies.java +++ b/paper-api/src/main/java/org/bukkit/GrassSpecies.java @@ -35,7 +35,7 @@ public enum GrassSpecies { * @return A byte containing the data value of this grass species * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public byte getData() { return data; } @@ -48,7 +48,7 @@ public enum GrassSpecies { * if it doesn't exist * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Nullable public static GrassSpecies getByData(final byte data) { return BY_DATA.get(data); diff --git a/paper-api/src/main/java/org/bukkit/Instrument.java b/paper-api/src/main/java/org/bukkit/Instrument.java index 032d7b812d..90bf1521e5 100644 --- a/paper-api/src/main/java/org/bukkit/Instrument.java +++ b/paper-api/src/main/java/org/bukkit/Instrument.java @@ -132,7 +132,7 @@ public enum Instrument { * @return The type ID of this instrument. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public byte getType() { return this.type; } @@ -144,7 +144,7 @@ public enum Instrument { * @return The instrument * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Nullable public static Instrument getByType(final byte type) { return BY_DATA.get(type); diff --git a/paper-api/src/main/java/org/bukkit/Material.java b/paper-api/src/main/java/org/bukkit/Material.java index a53b79552a..f13be40124 100644 --- a/paper-api/src/main/java/org/bukkit/Material.java +++ b/paper-api/src/main/java/org/bukkit/Material.java @@ -3843,940 +3843,940 @@ public enum Material implements Keyed, Translatable { POTTED_AZALEA_BUSH(20430), POTTED_FLOWERING_AZALEA_BUSH(10609), // ----- Legacy Separator ----- - @Deprecated + @Deprecated(since = "1.13") LEGACY_AIR(0, 0), - @Deprecated + @Deprecated(since = "1.13") LEGACY_STONE(1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GRASS(2), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DIRT(3), - @Deprecated + @Deprecated(since = "1.13") LEGACY_COBBLESTONE(4), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WOOD(5, org.bukkit.material.Wood.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SAPLING(6, org.bukkit.material.Sapling.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BEDROCK(7), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WATER(8, org.bukkit.material.MaterialData.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_STATIONARY_WATER(9, org.bukkit.material.MaterialData.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_LAVA(10, org.bukkit.material.MaterialData.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_STATIONARY_LAVA(11, org.bukkit.material.MaterialData.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SAND(12), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GRAVEL(13), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GOLD_ORE(14), - @Deprecated + @Deprecated(since = "1.13") LEGACY_IRON_ORE(15), - @Deprecated + @Deprecated(since = "1.13") LEGACY_COAL_ORE(16), - @Deprecated + @Deprecated(since = "1.13") LEGACY_LOG(17, org.bukkit.material.Tree.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_LEAVES(18, org.bukkit.material.Leaves.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SPONGE(19), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GLASS(20), - @Deprecated + @Deprecated(since = "1.13") LEGACY_LAPIS_ORE(21), - @Deprecated + @Deprecated(since = "1.13") LEGACY_LAPIS_BLOCK(22), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DISPENSER(23, org.bukkit.material.Dispenser.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SANDSTONE(24, org.bukkit.material.Sandstone.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_NOTE_BLOCK(25), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BED_BLOCK(26, org.bukkit.material.Bed.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_POWERED_RAIL(27, org.bukkit.material.PoweredRail.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DETECTOR_RAIL(28, org.bukkit.material.DetectorRail.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PISTON_STICKY_BASE(29, org.bukkit.material.PistonBaseMaterial.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WEB(30), - @Deprecated + @Deprecated(since = "1.13") LEGACY_LONG_GRASS(31, org.bukkit.material.LongGrass.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DEAD_BUSH(32), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PISTON_BASE(33, org.bukkit.material.PistonBaseMaterial.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PISTON_EXTENSION(34, org.bukkit.material.PistonExtensionMaterial.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WOOL(35, org.bukkit.material.Wool.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PISTON_MOVING_PIECE(36), - @Deprecated + @Deprecated(since = "1.13") LEGACY_YELLOW_FLOWER(37), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RED_ROSE(38), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BROWN_MUSHROOM(39), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RED_MUSHROOM(40), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GOLD_BLOCK(41), - @Deprecated + @Deprecated(since = "1.13") LEGACY_IRON_BLOCK(42), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DOUBLE_STEP(43, org.bukkit.material.Step.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_STEP(44, org.bukkit.material.Step.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BRICK(45), - @Deprecated + @Deprecated(since = "1.13") LEGACY_TNT(46), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BOOKSHELF(47), - @Deprecated + @Deprecated(since = "1.13") LEGACY_MOSSY_COBBLESTONE(48), - @Deprecated + @Deprecated(since = "1.13") LEGACY_OBSIDIAN(49), - @Deprecated + @Deprecated(since = "1.13") LEGACY_TORCH(50, org.bukkit.material.Torch.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_FIRE(51), - @Deprecated + @Deprecated(since = "1.13") LEGACY_MOB_SPAWNER(52), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WOOD_STAIRS(53, org.bukkit.material.Stairs.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CHEST(54, org.bukkit.material.Chest.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_REDSTONE_WIRE(55, org.bukkit.material.RedstoneWire.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DIAMOND_ORE(56), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DIAMOND_BLOCK(57), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WORKBENCH(58), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CROPS(59, org.bukkit.material.Crops.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SOIL(60, org.bukkit.material.MaterialData.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_FURNACE(61, org.bukkit.material.Furnace.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BURNING_FURNACE(62, org.bukkit.material.Furnace.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SIGN_POST(63, 64, org.bukkit.material.Sign.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WOODEN_DOOR(64, org.bukkit.material.Door.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_LADDER(65, org.bukkit.material.Ladder.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RAILS(66, org.bukkit.material.Rails.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_COBBLESTONE_STAIRS(67, org.bukkit.material.Stairs.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WALL_SIGN(68, 64, org.bukkit.material.Sign.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_LEVER(69, org.bukkit.material.Lever.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_STONE_PLATE(70, org.bukkit.material.PressurePlate.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_IRON_DOOR_BLOCK(71, org.bukkit.material.Door.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WOOD_PLATE(72, org.bukkit.material.PressurePlate.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_REDSTONE_ORE(73), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GLOWING_REDSTONE_ORE(74), - @Deprecated + @Deprecated(since = "1.13") LEGACY_REDSTONE_TORCH_OFF(75, org.bukkit.material.RedstoneTorch.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_REDSTONE_TORCH_ON(76, org.bukkit.material.RedstoneTorch.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_STONE_BUTTON(77, org.bukkit.material.Button.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SNOW(78), - @Deprecated + @Deprecated(since = "1.13") LEGACY_ICE(79), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SNOW_BLOCK(80), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CACTUS(81, org.bukkit.material.MaterialData.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CLAY(82), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SUGAR_CANE_BLOCK(83, org.bukkit.material.MaterialData.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_JUKEBOX(84), - @Deprecated + @Deprecated(since = "1.13") LEGACY_FENCE(85), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PUMPKIN(86, org.bukkit.material.Pumpkin.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_NETHERRACK(87), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SOUL_SAND(88), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GLOWSTONE(89), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PORTAL(90), - @Deprecated + @Deprecated(since = "1.13") LEGACY_JACK_O_LANTERN(91, org.bukkit.material.Pumpkin.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CAKE_BLOCK(92, 64, org.bukkit.material.Cake.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DIODE_BLOCK_OFF(93, org.bukkit.material.Diode.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DIODE_BLOCK_ON(94, org.bukkit.material.Diode.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_STAINED_GLASS(95), - @Deprecated + @Deprecated(since = "1.13") LEGACY_TRAP_DOOR(96, org.bukkit.material.TrapDoor.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_MONSTER_EGGS(97, org.bukkit.material.MonsterEggs.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SMOOTH_BRICK(98, org.bukkit.material.SmoothBrick.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_HUGE_MUSHROOM_1(99, org.bukkit.material.Mushroom.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_HUGE_MUSHROOM_2(100, org.bukkit.material.Mushroom.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_IRON_FENCE(101), - @Deprecated + @Deprecated(since = "1.13") LEGACY_THIN_GLASS(102), - @Deprecated + @Deprecated(since = "1.13") LEGACY_MELON_BLOCK(103), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PUMPKIN_STEM(104, org.bukkit.material.MaterialData.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_MELON_STEM(105, org.bukkit.material.MaterialData.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_VINE(106, org.bukkit.material.Vine.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_FENCE_GATE(107, org.bukkit.material.Gate.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BRICK_STAIRS(108, org.bukkit.material.Stairs.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SMOOTH_STAIRS(109, org.bukkit.material.Stairs.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_MYCEL(110), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WATER_LILY(111), - @Deprecated + @Deprecated(since = "1.13") LEGACY_NETHER_BRICK(112), - @Deprecated + @Deprecated(since = "1.13") LEGACY_NETHER_FENCE(113), - @Deprecated + @Deprecated(since = "1.13") LEGACY_NETHER_BRICK_STAIRS(114, org.bukkit.material.Stairs.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_NETHER_WARTS(115, org.bukkit.material.NetherWarts.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_ENCHANTMENT_TABLE(116), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BREWING_STAND(117, org.bukkit.material.MaterialData.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CAULDRON(118, org.bukkit.material.Cauldron.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_ENDER_PORTAL(119), - @Deprecated + @Deprecated(since = "1.13") LEGACY_ENDER_PORTAL_FRAME(120), - @Deprecated + @Deprecated(since = "1.13") LEGACY_ENDER_STONE(121), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DRAGON_EGG(122), - @Deprecated + @Deprecated(since = "1.13") LEGACY_REDSTONE_LAMP_OFF(123), - @Deprecated + @Deprecated(since = "1.13") LEGACY_REDSTONE_LAMP_ON(124), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WOOD_DOUBLE_STEP(125, org.bukkit.material.Wood.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WOOD_STEP(126, org.bukkit.material.WoodenStep.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_COCOA(127, org.bukkit.material.CocoaPlant.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SANDSTONE_STAIRS(128, org.bukkit.material.Stairs.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_EMERALD_ORE(129), - @Deprecated + @Deprecated(since = "1.13") LEGACY_ENDER_CHEST(130, org.bukkit.material.EnderChest.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_TRIPWIRE_HOOK(131, org.bukkit.material.TripwireHook.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_TRIPWIRE(132, org.bukkit.material.Tripwire.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_EMERALD_BLOCK(133), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SPRUCE_WOOD_STAIRS(134, org.bukkit.material.Stairs.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BIRCH_WOOD_STAIRS(135, org.bukkit.material.Stairs.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_JUNGLE_WOOD_STAIRS(136, org.bukkit.material.Stairs.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_COMMAND(137, org.bukkit.material.Command.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BEACON(138), - @Deprecated + @Deprecated(since = "1.13") LEGACY_COBBLE_WALL(139), - @Deprecated + @Deprecated(since = "1.13") LEGACY_FLOWER_POT(140, org.bukkit.material.FlowerPot.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CARROT(141, org.bukkit.material.Crops.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_POTATO(142, org.bukkit.material.Crops.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WOOD_BUTTON(143, org.bukkit.material.Button.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SKULL(144, org.bukkit.material.Skull.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_ANVIL(145), - @Deprecated + @Deprecated(since = "1.13") LEGACY_TRAPPED_CHEST(146, org.bukkit.material.Chest.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GOLD_PLATE(147), - @Deprecated + @Deprecated(since = "1.13") LEGACY_IRON_PLATE(148), - @Deprecated + @Deprecated(since = "1.13") LEGACY_REDSTONE_COMPARATOR_OFF(149, org.bukkit.material.Comparator.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_REDSTONE_COMPARATOR_ON(150, org.bukkit.material.Comparator.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DAYLIGHT_DETECTOR(151), - @Deprecated + @Deprecated(since = "1.13") LEGACY_REDSTONE_BLOCK(152), - @Deprecated + @Deprecated(since = "1.13") LEGACY_QUARTZ_ORE(153), - @Deprecated + @Deprecated(since = "1.13") LEGACY_HOPPER(154, org.bukkit.material.Hopper.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_QUARTZ_BLOCK(155), - @Deprecated + @Deprecated(since = "1.13") LEGACY_QUARTZ_STAIRS(156, org.bukkit.material.Stairs.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_ACTIVATOR_RAIL(157, org.bukkit.material.PoweredRail.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DROPPER(158, org.bukkit.material.Dispenser.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_STAINED_CLAY(159), - @Deprecated + @Deprecated(since = "1.13") LEGACY_STAINED_GLASS_PANE(160), - @Deprecated + @Deprecated(since = "1.13") LEGACY_LEAVES_2(161, org.bukkit.material.Leaves.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_LOG_2(162, org.bukkit.material.Tree.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_ACACIA_STAIRS(163, org.bukkit.material.Stairs.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DARK_OAK_STAIRS(164, org.bukkit.material.Stairs.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SLIME_BLOCK(165), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BARRIER(166), - @Deprecated + @Deprecated(since = "1.13") LEGACY_IRON_TRAPDOOR(167, org.bukkit.material.TrapDoor.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PRISMARINE(168), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SEA_LANTERN(169), - @Deprecated + @Deprecated(since = "1.13") LEGACY_HAY_BLOCK(170), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CARPET(171), - @Deprecated + @Deprecated(since = "1.13") LEGACY_HARD_CLAY(172), - @Deprecated + @Deprecated(since = "1.13") LEGACY_COAL_BLOCK(173), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PACKED_ICE(174), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DOUBLE_PLANT(175), - @Deprecated + @Deprecated(since = "1.13") LEGACY_STANDING_BANNER(176, org.bukkit.material.Banner.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WALL_BANNER(177, org.bukkit.material.Banner.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DAYLIGHT_DETECTOR_INVERTED(178), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RED_SANDSTONE(179), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RED_SANDSTONE_STAIRS(180, org.bukkit.material.Stairs.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DOUBLE_STONE_SLAB2(181), - @Deprecated + @Deprecated(since = "1.13") LEGACY_STONE_SLAB2(182), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SPRUCE_FENCE_GATE(183, org.bukkit.material.Gate.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BIRCH_FENCE_GATE(184, org.bukkit.material.Gate.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_JUNGLE_FENCE_GATE(185, org.bukkit.material.Gate.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DARK_OAK_FENCE_GATE(186, org.bukkit.material.Gate.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_ACACIA_FENCE_GATE(187, org.bukkit.material.Gate.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SPRUCE_FENCE(188), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BIRCH_FENCE(189), - @Deprecated + @Deprecated(since = "1.13") LEGACY_JUNGLE_FENCE(190), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DARK_OAK_FENCE(191), - @Deprecated + @Deprecated(since = "1.13") LEGACY_ACACIA_FENCE(192), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SPRUCE_DOOR(193, org.bukkit.material.Door.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BIRCH_DOOR(194, org.bukkit.material.Door.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_JUNGLE_DOOR(195, org.bukkit.material.Door.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_ACACIA_DOOR(196, org.bukkit.material.Door.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DARK_OAK_DOOR(197, org.bukkit.material.Door.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_END_ROD(198), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CHORUS_PLANT(199), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CHORUS_FLOWER(200), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PURPUR_BLOCK(201), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PURPUR_PILLAR(202), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PURPUR_STAIRS(203, org.bukkit.material.Stairs.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PURPUR_DOUBLE_SLAB(204), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PURPUR_SLAB(205), - @Deprecated + @Deprecated(since = "1.13") LEGACY_END_BRICKS(206), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BEETROOT_BLOCK(207, org.bukkit.material.Crops.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GRASS_PATH(208), - @Deprecated + @Deprecated(since = "1.13") LEGACY_END_GATEWAY(209), - @Deprecated + @Deprecated(since = "1.13") LEGACY_COMMAND_REPEATING(210, org.bukkit.material.Command.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_COMMAND_CHAIN(211, org.bukkit.material.Command.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_FROSTED_ICE(212), - @Deprecated + @Deprecated(since = "1.13") LEGACY_MAGMA(213), - @Deprecated + @Deprecated(since = "1.13") LEGACY_NETHER_WART_BLOCK(214), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RED_NETHER_BRICK(215), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BONE_BLOCK(216), - @Deprecated + @Deprecated(since = "1.13") LEGACY_STRUCTURE_VOID(217), - @Deprecated + @Deprecated(since = "1.13") LEGACY_OBSERVER(218, org.bukkit.material.Observer.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WHITE_SHULKER_BOX(219, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_ORANGE_SHULKER_BOX(220, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_MAGENTA_SHULKER_BOX(221, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_LIGHT_BLUE_SHULKER_BOX(222, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_YELLOW_SHULKER_BOX(223, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_LIME_SHULKER_BOX(224, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PINK_SHULKER_BOX(225, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GRAY_SHULKER_BOX(226, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SILVER_SHULKER_BOX(227, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CYAN_SHULKER_BOX(228, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PURPLE_SHULKER_BOX(229, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BLUE_SHULKER_BOX(230, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BROWN_SHULKER_BOX(231, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GREEN_SHULKER_BOX(232, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RED_SHULKER_BOX(233, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BLACK_SHULKER_BOX(234, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WHITE_GLAZED_TERRACOTTA(235), - @Deprecated + @Deprecated(since = "1.13") LEGACY_ORANGE_GLAZED_TERRACOTTA(236), - @Deprecated + @Deprecated(since = "1.13") LEGACY_MAGENTA_GLAZED_TERRACOTTA(237), - @Deprecated + @Deprecated(since = "1.13") LEGACY_LIGHT_BLUE_GLAZED_TERRACOTTA(238), - @Deprecated + @Deprecated(since = "1.13") LEGACY_YELLOW_GLAZED_TERRACOTTA(239), - @Deprecated + @Deprecated(since = "1.13") LEGACY_LIME_GLAZED_TERRACOTTA(240), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PINK_GLAZED_TERRACOTTA(241), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GRAY_GLAZED_TERRACOTTA(242), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SILVER_GLAZED_TERRACOTTA(243), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CYAN_GLAZED_TERRACOTTA(244), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PURPLE_GLAZED_TERRACOTTA(245), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BLUE_GLAZED_TERRACOTTA(246), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BROWN_GLAZED_TERRACOTTA(247), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GREEN_GLAZED_TERRACOTTA(248), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RED_GLAZED_TERRACOTTA(249), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BLACK_GLAZED_TERRACOTTA(250), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CONCRETE(251), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CONCRETE_POWDER(252), - @Deprecated + @Deprecated(since = "1.13") LEGACY_STRUCTURE_BLOCK(255), // ----- Item Separator ----- - @Deprecated + @Deprecated(since = "1.13") LEGACY_IRON_SPADE(256, 1, 250), - @Deprecated + @Deprecated(since = "1.13") LEGACY_IRON_PICKAXE(257, 1, 250), - @Deprecated + @Deprecated(since = "1.13") LEGACY_IRON_AXE(258, 1, 250), - @Deprecated + @Deprecated(since = "1.13") LEGACY_FLINT_AND_STEEL(259, 1, 64), - @Deprecated + @Deprecated(since = "1.13") LEGACY_APPLE(260), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BOW(261, 1, 384), - @Deprecated + @Deprecated(since = "1.13") LEGACY_ARROW(262), - @Deprecated + @Deprecated(since = "1.13") LEGACY_COAL(263, org.bukkit.material.Coal.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DIAMOND(264), - @Deprecated + @Deprecated(since = "1.13") LEGACY_IRON_INGOT(265), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GOLD_INGOT(266), - @Deprecated + @Deprecated(since = "1.13") LEGACY_IRON_SWORD(267, 1, 250), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WOOD_SWORD(268, 1, 59), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WOOD_SPADE(269, 1, 59), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WOOD_PICKAXE(270, 1, 59), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WOOD_AXE(271, 1, 59), - @Deprecated + @Deprecated(since = "1.13") LEGACY_STONE_SWORD(272, 1, 131), - @Deprecated + @Deprecated(since = "1.13") LEGACY_STONE_SPADE(273, 1, 131), - @Deprecated + @Deprecated(since = "1.13") LEGACY_STONE_PICKAXE(274, 1, 131), - @Deprecated + @Deprecated(since = "1.13") LEGACY_STONE_AXE(275, 1, 131), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DIAMOND_SWORD(276, 1, 1561), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DIAMOND_SPADE(277, 1, 1561), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DIAMOND_PICKAXE(278, 1, 1561), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DIAMOND_AXE(279, 1, 1561), - @Deprecated + @Deprecated(since = "1.13") LEGACY_STICK(280), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BOWL(281), - @Deprecated + @Deprecated(since = "1.13") LEGACY_MUSHROOM_SOUP(282, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GOLD_SWORD(283, 1, 32), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GOLD_SPADE(284, 1, 32), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GOLD_PICKAXE(285, 1, 32), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GOLD_AXE(286, 1, 32), - @Deprecated + @Deprecated(since = "1.13") LEGACY_STRING(287), - @Deprecated + @Deprecated(since = "1.13") LEGACY_FEATHER(288), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SULPHUR(289), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WOOD_HOE(290, 1, 59), - @Deprecated + @Deprecated(since = "1.13") LEGACY_STONE_HOE(291, 1, 131), - @Deprecated + @Deprecated(since = "1.13") LEGACY_IRON_HOE(292, 1, 250), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DIAMOND_HOE(293, 1, 1561), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GOLD_HOE(294, 1, 32), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SEEDS(295), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WHEAT(296), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BREAD(297), - @Deprecated + @Deprecated(since = "1.13") LEGACY_LEATHER_HELMET(298, 1, 55), - @Deprecated + @Deprecated(since = "1.13") LEGACY_LEATHER_CHESTPLATE(299, 1, 80), - @Deprecated + @Deprecated(since = "1.13") LEGACY_LEATHER_LEGGINGS(300, 1, 75), - @Deprecated + @Deprecated(since = "1.13") LEGACY_LEATHER_BOOTS(301, 1, 65), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CHAINMAIL_HELMET(302, 1, 165), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CHAINMAIL_CHESTPLATE(303, 1, 240), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CHAINMAIL_LEGGINGS(304, 1, 225), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CHAINMAIL_BOOTS(305, 1, 195), - @Deprecated + @Deprecated(since = "1.13") LEGACY_IRON_HELMET(306, 1, 165), - @Deprecated + @Deprecated(since = "1.13") LEGACY_IRON_CHESTPLATE(307, 1, 240), - @Deprecated + @Deprecated(since = "1.13") LEGACY_IRON_LEGGINGS(308, 1, 225), - @Deprecated + @Deprecated(since = "1.13") LEGACY_IRON_BOOTS(309, 1, 195), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DIAMOND_HELMET(310, 1, 363), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DIAMOND_CHESTPLATE(311, 1, 528), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DIAMOND_LEGGINGS(312, 1, 495), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DIAMOND_BOOTS(313, 1, 429), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GOLD_HELMET(314, 1, 77), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GOLD_CHESTPLATE(315, 1, 112), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GOLD_LEGGINGS(316, 1, 105), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GOLD_BOOTS(317, 1, 91), - @Deprecated + @Deprecated(since = "1.13") LEGACY_FLINT(318), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PORK(319), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GRILLED_PORK(320), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PAINTING(321), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GOLDEN_APPLE(322), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SIGN(323, 16), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WOOD_DOOR(324, 64), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BUCKET(325, 16), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WATER_BUCKET(326, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_LAVA_BUCKET(327, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_MINECART(328, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SADDLE(329, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_IRON_DOOR(330, 64), - @Deprecated + @Deprecated(since = "1.13") LEGACY_REDSTONE(331), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SNOW_BALL(332, 16), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BOAT(333, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_LEATHER(334), - @Deprecated + @Deprecated(since = "1.13") LEGACY_MILK_BUCKET(335, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CLAY_BRICK(336), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CLAY_BALL(337), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SUGAR_CANE(338), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PAPER(339), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BOOK(340), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SLIME_BALL(341), - @Deprecated + @Deprecated(since = "1.13") LEGACY_STORAGE_MINECART(342, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_POWERED_MINECART(343, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_EGG(344, 16), - @Deprecated + @Deprecated(since = "1.13") LEGACY_COMPASS(345), - @Deprecated + @Deprecated(since = "1.13") LEGACY_FISHING_ROD(346, 1, 64), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WATCH(347), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GLOWSTONE_DUST(348), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RAW_FISH(349), - @Deprecated + @Deprecated(since = "1.13") LEGACY_COOKED_FISH(350), - @Deprecated + @Deprecated(since = "1.13") LEGACY_INK_SACK(351, org.bukkit.material.Dye.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BONE(352), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SUGAR(353), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CAKE(354, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BED(355, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DIODE(356), - @Deprecated + @Deprecated(since = "1.13") LEGACY_COOKIE(357), /** * @see org.bukkit.map.MapView */ - @Deprecated + @Deprecated(since = "1.13") LEGACY_MAP(358, org.bukkit.material.MaterialData.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SHEARS(359, 1, 238), - @Deprecated + @Deprecated(since = "1.13") LEGACY_MELON(360), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PUMPKIN_SEEDS(361), - @Deprecated + @Deprecated(since = "1.13") LEGACY_MELON_SEEDS(362), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RAW_BEEF(363), - @Deprecated + @Deprecated(since = "1.13") LEGACY_COOKED_BEEF(364), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RAW_CHICKEN(365), - @Deprecated + @Deprecated(since = "1.13") LEGACY_COOKED_CHICKEN(366), - @Deprecated + @Deprecated(since = "1.13") LEGACY_ROTTEN_FLESH(367), - @Deprecated + @Deprecated(since = "1.13") LEGACY_ENDER_PEARL(368, 16), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BLAZE_ROD(369), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GHAST_TEAR(370), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GOLD_NUGGET(371), - @Deprecated + @Deprecated(since = "1.13") LEGACY_NETHER_STALK(372), - @Deprecated + @Deprecated(since = "1.13") LEGACY_POTION(373, 1, org.bukkit.material.MaterialData.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GLASS_BOTTLE(374), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SPIDER_EYE(375), - @Deprecated + @Deprecated(since = "1.13") LEGACY_FERMENTED_SPIDER_EYE(376), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BLAZE_POWDER(377), - @Deprecated + @Deprecated(since = "1.13") LEGACY_MAGMA_CREAM(378), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BREWING_STAND_ITEM(379), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CAULDRON_ITEM(380), - @Deprecated + @Deprecated(since = "1.13") LEGACY_EYE_OF_ENDER(381), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SPECKLED_MELON(382), - @Deprecated + @Deprecated(since = "1.13") LEGACY_MONSTER_EGG(383, 64, org.bukkit.material.SpawnEgg.class), - @Deprecated + @Deprecated(since = "1.13") LEGACY_EXP_BOTTLE(384, 64), - @Deprecated + @Deprecated(since = "1.13") LEGACY_FIREBALL(385, 64), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BOOK_AND_QUILL(386, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_WRITTEN_BOOK(387, 16), - @Deprecated + @Deprecated(since = "1.13") LEGACY_EMERALD(388, 64), - @Deprecated + @Deprecated(since = "1.13") LEGACY_ITEM_FRAME(389), - @Deprecated + @Deprecated(since = "1.13") LEGACY_FLOWER_POT_ITEM(390), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CARROT_ITEM(391), - @Deprecated + @Deprecated(since = "1.13") LEGACY_POTATO_ITEM(392), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BAKED_POTATO(393), - @Deprecated + @Deprecated(since = "1.13") LEGACY_POISONOUS_POTATO(394), - @Deprecated + @Deprecated(since = "1.13") LEGACY_EMPTY_MAP(395), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GOLDEN_CARROT(396), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SKULL_ITEM(397), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CARROT_STICK(398, 1, 25), - @Deprecated + @Deprecated(since = "1.13") LEGACY_NETHER_STAR(399), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PUMPKIN_PIE(400), - @Deprecated + @Deprecated(since = "1.13") LEGACY_FIREWORK(401), - @Deprecated + @Deprecated(since = "1.13") LEGACY_FIREWORK_CHARGE(402), - @Deprecated + @Deprecated(since = "1.13") LEGACY_ENCHANTED_BOOK(403, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_REDSTONE_COMPARATOR(404), - @Deprecated + @Deprecated(since = "1.13") LEGACY_NETHER_BRICK_ITEM(405), - @Deprecated + @Deprecated(since = "1.13") LEGACY_QUARTZ(406), - @Deprecated + @Deprecated(since = "1.13") LEGACY_EXPLOSIVE_MINECART(407, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_HOPPER_MINECART(408, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PRISMARINE_SHARD(409), - @Deprecated + @Deprecated(since = "1.13") LEGACY_PRISMARINE_CRYSTALS(410), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RABBIT(411), - @Deprecated + @Deprecated(since = "1.13") LEGACY_COOKED_RABBIT(412), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RABBIT_STEW(413, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RABBIT_FOOT(414), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RABBIT_HIDE(415), - @Deprecated + @Deprecated(since = "1.13") LEGACY_ARMOR_STAND(416, 16), - @Deprecated + @Deprecated(since = "1.13") LEGACY_IRON_BARDING(417, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GOLD_BARDING(418, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DIAMOND_BARDING(419, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_LEASH(420), - @Deprecated + @Deprecated(since = "1.13") LEGACY_NAME_TAG(421), - @Deprecated + @Deprecated(since = "1.13") LEGACY_COMMAND_MINECART(422, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_MUTTON(423), - @Deprecated + @Deprecated(since = "1.13") LEGACY_COOKED_MUTTON(424), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BANNER(425, 16), - @Deprecated + @Deprecated(since = "1.13") LEGACY_END_CRYSTAL(426), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SPRUCE_DOOR_ITEM(427), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BIRCH_DOOR_ITEM(428), - @Deprecated + @Deprecated(since = "1.13") LEGACY_JUNGLE_DOOR_ITEM(429), - @Deprecated + @Deprecated(since = "1.13") LEGACY_ACACIA_DOOR_ITEM(430), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DARK_OAK_DOOR_ITEM(431), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CHORUS_FRUIT(432), - @Deprecated + @Deprecated(since = "1.13") LEGACY_CHORUS_FRUIT_POPPED(433), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BEETROOT(434), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BEETROOT_SEEDS(435), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BEETROOT_SOUP(436, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_DRAGONS_BREATH(437), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SPLASH_POTION(438, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SPECTRAL_ARROW(439), - @Deprecated + @Deprecated(since = "1.13") LEGACY_TIPPED_ARROW(440), - @Deprecated + @Deprecated(since = "1.13") LEGACY_LINGERING_POTION(441, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SHIELD(442, 1, 336), - @Deprecated + @Deprecated(since = "1.13") LEGACY_ELYTRA(443, 1, 431), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BOAT_SPRUCE(444, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BOAT_BIRCH(445, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BOAT_JUNGLE(446, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BOAT_ACACIA(447, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_BOAT_DARK_OAK(448, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_TOTEM(449, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_SHULKER_SHELL(450), - @Deprecated + @Deprecated(since = "1.13") LEGACY_IRON_NUGGET(452), - @Deprecated + @Deprecated(since = "1.13") LEGACY_KNOWLEDGE_BOOK(453, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GOLD_RECORD(2256, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_GREEN_RECORD(2257, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RECORD_3(2258, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RECORD_4(2259, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RECORD_5(2260, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RECORD_6(2261, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RECORD_7(2262, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RECORD_8(2263, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RECORD_9(2264, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RECORD_10(2265, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RECORD_11(2266, 1), - @Deprecated + @Deprecated(since = "1.13") LEGACY_RECORD_12(2267, 1), ; // - @Deprecated + @Deprecated(since = "1.13") public static final String LEGACY_PREFIX = "LEGACY_"; private final int id; @@ -4852,7 +4852,7 @@ public enum Material implements Keyed, Translatable { * @return ID of this material * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public int getId() { Preconditions.checkArgument(legacy, "Cannot get ID of Modern Material"); return id; @@ -4863,7 +4863,7 @@ public enum Material implements Keyed, Translatable { * * @return legacy status */ - @Deprecated + @Deprecated(since = "1.13") public boolean isLegacy() { return legacy; } @@ -4954,7 +4954,7 @@ public enum Material implements Keyed, Translatable { * @return New MaterialData with the given data * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @NotNull public MaterialData getNewData(final byte raw) { Preconditions.checkArgument(legacy, "Cannot get new data of Modern Material"); @@ -5119,7 +5119,7 @@ public enum Material implements Keyed, Translatable { * @deprecated currently does not have an implementation which is well * linked to the underlying server. Contributions welcome. */ - @Deprecated + @Deprecated(since = "1.13") public boolean isTransparent() { if (!isBlock()) { return false; diff --git a/paper-api/src/main/java/org/bukkit/MusicInstrument.java b/paper-api/src/main/java/org/bukkit/MusicInstrument.java index 807e89d026..708286af95 100644 --- a/paper-api/src/main/java/org/bukkit/MusicInstrument.java +++ b/paper-api/src/main/java/org/bukkit/MusicInstrument.java @@ -25,7 +25,7 @@ public abstract class MusicInstrument implements Keyed { * @deprecated Use {@link Registry#get(NamespacedKey)} instead. */ @Nullable - @Deprecated + @Deprecated(since = "1.20.1") public static MusicInstrument getByKey(@NotNull NamespacedKey namespacedKey) { return Registry.INSTRUMENT.get(namespacedKey); } @@ -37,7 +37,7 @@ public abstract class MusicInstrument implements Keyed { * @deprecated use {@link Registry#iterator()}. */ @NotNull - @Deprecated + @Deprecated(since = "1.20.1") public static Collection values() { return Collections.unmodifiableCollection(Lists.newArrayList(Registry.INSTRUMENT)); } diff --git a/paper-api/src/main/java/org/bukkit/NamespacedKey.java b/paper-api/src/main/java/org/bukkit/NamespacedKey.java index 9562fcd522..dd3c9dfde4 100644 --- a/paper-api/src/main/java/org/bukkit/NamespacedKey.java +++ b/paper-api/src/main/java/org/bukkit/NamespacedKey.java @@ -161,7 +161,7 @@ public final class NamespacedKey { */ @ApiStatus.Internal @NotNull - @Deprecated + @Deprecated(since = "1.20.5") public static NamespacedKey randomKey() { return new NamespacedKey(BUKKIT, UUID.randomUUID().toString()); } diff --git a/paper-api/src/main/java/org/bukkit/Note.java b/paper-api/src/main/java/org/bukkit/Note.java index 48aecc9421..3ecd0f34b7 100644 --- a/paper-api/src/main/java/org/bukkit/Note.java +++ b/paper-api/src/main/java/org/bukkit/Note.java @@ -41,7 +41,7 @@ public class Note { * @return the not sharped id of this tone. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public byte getId() { return getId(false); } @@ -55,7 +55,7 @@ public class Note { * @return the id of this tone. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public byte getId(boolean sharped) { byte id = (byte) (sharped && sharpable ? this.id + 1 : this.id); @@ -80,7 +80,7 @@ public class Note { * semitone have the id. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public boolean isSharped(byte id) { if (id == getId(false)) { return false; @@ -99,7 +99,7 @@ public class Note { * @return the tone to id. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Nullable public static Tone getById(byte id) { return BY_DATA.get(id); @@ -224,7 +224,7 @@ public class Note { * @return the internal id of this note. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public byte getId() { return note; } diff --git a/paper-api/src/main/java/org/bukkit/OfflinePlayer.java b/paper-api/src/main/java/org/bukkit/OfflinePlayer.java index ff59479f47..9f599e44c9 100644 --- a/paper-api/src/main/java/org/bukkit/OfflinePlayer.java +++ b/paper-api/src/main/java/org/bukkit/OfflinePlayer.java @@ -177,7 +177,7 @@ public interface OfflinePlayer extends ServerOperator, AnimalTamer, Configuratio * respawn anchors. */ @Nullable - @Deprecated + @Deprecated(since = "1.20.4") public Location getBedSpawnLocation(); /** diff --git a/paper-api/src/main/java/org/bukkit/SandstoneType.java b/paper-api/src/main/java/org/bukkit/SandstoneType.java index 6277451c3c..2306c5a6a6 100644 --- a/paper-api/src/main/java/org/bukkit/SandstoneType.java +++ b/paper-api/src/main/java/org/bukkit/SandstoneType.java @@ -25,7 +25,7 @@ public enum SandstoneType { * @return A byte containing the data value of this sandstone type * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public byte getData() { return data; } @@ -38,7 +38,7 @@ public enum SandstoneType { * if it doesn't exist * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Nullable public static SandstoneType getByData(final byte data) { return BY_DATA.get(data); diff --git a/paper-api/src/main/java/org/bukkit/Server.java b/paper-api/src/main/java/org/bukkit/Server.java index 6cd2f9ab64..41cbb3aee5 100644 --- a/paper-api/src/main/java/org/bukkit/Server.java +++ b/paper-api/src/main/java/org/bukkit/Server.java @@ -406,7 +406,7 @@ public interface Server extends PluginMessageRecipient { * @return the default ticks per animal spawns value * @deprecated Deprecated in favor of {@link #getTicksPerSpawns(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public int getTicksPerAnimalSpawns(); /** @@ -429,7 +429,7 @@ public interface Server extends PluginMessageRecipient { * @return the default ticks per monsters spawn value * @deprecated Deprecated in favor of {@link #getTicksPerSpawns(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public int getTicksPerMonsterSpawns(); /** @@ -451,7 +451,7 @@ public interface Server extends PluginMessageRecipient { * @return the default ticks per water mobs spawn value * @deprecated Deprecated in favor of {@link #getTicksPerSpawns(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public int getTicksPerWaterSpawns(); /** @@ -473,7 +473,7 @@ public interface Server extends PluginMessageRecipient { * @return the default ticks per water ambient mobs spawn value * @deprecated Deprecated in favor of {@link #getTicksPerSpawns(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public int getTicksPerWaterAmbientSpawns(); /** @@ -495,7 +495,7 @@ public interface Server extends PluginMessageRecipient { * @return the default ticks per water underground creature spawn value * @deprecated Deprecated in favor of {@link #getTicksPerSpawns(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public int getTicksPerWaterUndergroundCreatureSpawns(); /** @@ -517,7 +517,7 @@ public interface Server extends PluginMessageRecipient { * @return the default ticks per ambient mobs spawn value * @deprecated Deprecated in favor of {@link #getTicksPerSpawns(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public int getTicksPerAmbientSpawns(); /** @@ -689,7 +689,7 @@ public interface Server extends PluginMessageRecipient { * @return a map view if it exists, or null otherwise * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Nullable public MapView getMap(int id); @@ -993,7 +993,7 @@ public interface Server extends PluginMessageRecipient { * @return true if the server should send a preview, false otherwise * @deprecated chat previews have been removed */ - @Deprecated + @Deprecated(since = "1.19.3") public boolean shouldSendChatPreviews(); /** @@ -1072,7 +1072,7 @@ public interface Server extends PluginMessageRecipient { * @deprecated Persistent storage of users should be by UUID as names are no longer * unique past a single session. */ - @Deprecated + @Deprecated(since = "1.7.5") @NotNull public OfflinePlayer getOfflinePlayer(@NotNull String name); @@ -1137,7 +1137,7 @@ public interface Server extends PluginMessageRecipient { * * @deprecated see {@link #banIP(InetAddress)} */ - @Deprecated + @Deprecated(since = "1.20.1") public void banIP(@NotNull String address); /** @@ -1147,7 +1147,7 @@ public interface Server extends PluginMessageRecipient { * * @deprecated see {@link #unbanIP(InetAddress)} */ - @Deprecated + @Deprecated(since = "1.20.1") public void unbanIP(@NotNull String address); /** @@ -1350,7 +1350,7 @@ public interface Server extends PluginMessageRecipient { * @return the monster spawn limit * @deprecated Deprecated in favor of {@link #getSpawnLimit(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") int getMonsterSpawnLimit(); /** @@ -1360,7 +1360,7 @@ public interface Server extends PluginMessageRecipient { * @return the animal spawn limit * @deprecated Deprecated in favor of {@link #getSpawnLimit(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") int getAnimalSpawnLimit(); /** @@ -1370,7 +1370,7 @@ public interface Server extends PluginMessageRecipient { * @return the water animal spawn limit * @deprecated Deprecated in favor of {@link #getSpawnLimit(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") int getWaterAnimalSpawnLimit(); /** @@ -1380,7 +1380,7 @@ public interface Server extends PluginMessageRecipient { * @return the water ambient spawn limit * @deprecated Deprecated in favor of {@link #getSpawnLimit(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") int getWaterAmbientSpawnLimit(); /** @@ -1389,7 +1389,7 @@ public interface Server extends PluginMessageRecipient { * @return the water underground creature limit * @deprecated Deprecated in favor of {@link #getSpawnLimit(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") int getWaterUndergroundCreatureSpawnLimit(); /** @@ -1399,7 +1399,7 @@ public interface Server extends PluginMessageRecipient { * @return the ambient spawn limit * @deprecated Deprecated in favor of {@link #getSpawnLimit(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") int getAmbientSpawnLimit(); /** @@ -1849,7 +1849,7 @@ public interface Server extends PluginMessageRecipient { * @return the unsafe values instance * @see UnsafeValues */ - @Deprecated + @Deprecated(since = "1.7.2") @NotNull UnsafeValues getUnsafe(); } diff --git a/paper-api/src/main/java/org/bukkit/SkullType.java b/paper-api/src/main/java/org/bukkit/SkullType.java index 49f2f11288..9b97694294 100644 --- a/paper-api/src/main/java/org/bukkit/SkullType.java +++ b/paper-api/src/main/java/org/bukkit/SkullType.java @@ -4,7 +4,7 @@ package org.bukkit; * Represents the different types of skulls. * @deprecated check {@link Material} instead */ -@Deprecated +@Deprecated(since = "1.13") public enum SkullType { SKELETON, WITHER, diff --git a/paper-api/src/main/java/org/bukkit/StructureType.java b/paper-api/src/main/java/org/bukkit/StructureType.java index 2cc81c2048..3034769aea 100644 --- a/paper-api/src/main/java/org/bukkit/StructureType.java +++ b/paper-api/src/main/java/org/bukkit/StructureType.java @@ -23,7 +23,7 @@ import org.jetbrains.annotations.Nullable; * {@link org.bukkit.generator.structure.StructureType} instead. */ // Order is retrieved from WorldGenFactory -@Deprecated +@Deprecated(since = "1.19") public final class StructureType implements Keyed { private static final Map structureTypeMap = new HashMap<>(); diff --git a/paper-api/src/main/java/org/bukkit/Tag.java b/paper-api/src/main/java/org/bukkit/Tag.java index 2877eba001..274830961b 100644 --- a/paper-api/src/main/java/org/bukkit/Tag.java +++ b/paper-api/src/main/java/org/bukkit/Tag.java @@ -52,7 +52,7 @@ public interface Tag extends Keyed { /** * @deprecated {@link #WOOL_CARPETS}. */ - @Deprecated + @Deprecated(since = "1.19") Tag CARPETS = WOOL_CARPETS; /** * Vanilla block tag representing all wooden doors. @@ -828,7 +828,7 @@ public interface Tag extends Keyed { * * @deprecated use {@link #ITEMS_PIGLIN_FOOD} */ - @Deprecated + @Deprecated(since = "1.20.5") Tag PIGLIN_FOOD = ITEMS_PIGLIN_FOOD; /** * Vanilla item tag representing all fox food. @@ -839,7 +839,7 @@ public interface Tag extends Keyed { * * @deprecated use {@link #ITEMS_FOX_FOOD} */ - @Deprecated + @Deprecated(since = "1.20.5") Tag FOX_FOOD = ITEMS_FOX_FOOD; /** * Vanilla item tag representing all cow food. @@ -1137,7 +1137,7 @@ public interface Tag extends Keyed { * this constant now acts as a reference to {@link #ITEMS_BREAKS_DECORATED_POTS} which largely shares * the same contents of the old "minecraft:tools" tag. */ - @Deprecated(forRemoval = true) + @Deprecated(since = "1.20.6", forRemoval = true) Tag ITEMS_TOOLS = ITEMS_BREAKS_DECORATED_POTS; /** * Vanilla item tag representing all seeds plantable by villagers. @@ -1253,7 +1253,7 @@ public interface Tag extends Keyed { * * @deprecated use {@link #ITEMS_AXOLOTL_FOOD} */ - @Deprecated + @Deprecated(since = "1.20.5") Tag AXOLOTL_TEMPT_ITEMS = ITEMS_AXOLOTL_FOOD; /** * Vanilla item tag representing all items which are preferred for @@ -1340,7 +1340,7 @@ public interface Tag extends Keyed { * Vanilla tag representing entities which deflect arrows. * @deprecated use {@link #ENTITY_TYPES_DEFLECTS_PROJECTILES} */ - @Deprecated + @Deprecated(since = "1.20.5") Tag ENTITY_TYPES_DEFLECTS_ARROWS = ENTITY_TYPES_DEFLECTS_PROJECTILES; /** * Vanilla tag representing entities which can turn in boats. diff --git a/paper-api/src/main/java/org/bukkit/TreeSpecies.java b/paper-api/src/main/java/org/bukkit/TreeSpecies.java index 0128530162..9203f396c8 100644 --- a/paper-api/src/main/java/org/bukkit/TreeSpecies.java +++ b/paper-api/src/main/java/org/bukkit/TreeSpecies.java @@ -9,7 +9,7 @@ import org.jetbrains.annotations.Nullable; * * @deprecated Deprecated, see usage methods for replacement(s) */ -@Deprecated +@Deprecated(since = "1.19") public enum TreeSpecies { /** @@ -51,7 +51,7 @@ public enum TreeSpecies { * @return A byte containing the data value of this tree species * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public byte getData() { return data; } @@ -64,7 +64,7 @@ public enum TreeSpecies { * if it doesn't exist * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Nullable public static TreeSpecies getByData(final byte data) { return BY_DATA.get(data); diff --git a/paper-api/src/main/java/org/bukkit/UndefinedNullability.java b/paper-api/src/main/java/org/bukkit/UndefinedNullability.java index 4d4265c237..3f0ea49056 100644 --- a/paper-api/src/main/java/org/bukkit/UndefinedNullability.java +++ b/paper-api/src/main/java/org/bukkit/UndefinedNullability.java @@ -15,7 +15,7 @@ import org.jetbrains.annotations.ApiStatus; */ @Retention(RetentionPolicy.CLASS) @ApiStatus.Internal -@Deprecated +@Deprecated(since = "1.13.2") public @interface UndefinedNullability { /** diff --git a/paper-api/src/main/java/org/bukkit/UnsafeValues.java b/paper-api/src/main/java/org/bukkit/UnsafeValues.java index 752fef0205..ea78613038 100644 --- a/paper-api/src/main/java/org/bukkit/UnsafeValues.java +++ b/paper-api/src/main/java/org/bukkit/UnsafeValues.java @@ -29,7 +29,7 @@ import org.jetbrains.annotations.Nullable; * may be poorly named, throw exceptions, have misleading parameters, or any * other bad programming practice. */ -@Deprecated +@Deprecated(since = "1.7.2") public interface UnsafeValues { Material toLegacy(Material material); diff --git a/paper-api/src/main/java/org/bukkit/World.java b/paper-api/src/main/java/org/bukkit/World.java index e82e4d49d5..dff198dd75 100644 --- a/paper-api/src/main/java/org/bukkit/World.java +++ b/paper-api/src/main/java/org/bukkit/World.java @@ -209,7 +209,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * As of the current Minecraft version chunks are now strictly managed and * will not be loaded for more than 1 tick unless they are in use. */ - @Deprecated + @Deprecated(since = "1.14") public boolean isChunkInUse(int x, int z); /** @@ -299,7 +299,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * chunk as before as terrain decoration may be spread across chunks. Use of * this method should be avoided as it is known to produce buggy results. */ - @Deprecated + @Deprecated(since = "1.13") public boolean regenerateChunk(int x, int z); /** @@ -311,7 +311,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * * @deprecated This method is not guaranteed to work suitably across all client implementations. */ - @Deprecated + @Deprecated(since = "1.8") public boolean refreshChunk(int x, int z); /** @@ -563,7 +563,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @see #generateTree(org.bukkit.Location, java.util.Random, org.bukkit.TreeType, java.util.function.Consumer) * @deprecated this method does not handle tile entities (bee nests) */ - @Deprecated + @Deprecated(since = "1.17.1") public boolean generateTree(@NotNull Location loc, @NotNull TreeType type, @NotNull BlockChangeDelegate delegate); /** @@ -609,7 +609,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @return A List of all Entities currently residing in this world that * match the given class/interface */ - @Deprecated + @Deprecated(since = "1.1") @NotNull public Collection getEntitiesByClass(@NotNull Class... classes); @@ -1314,7 +1314,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * Material} are null or {@link Material} is not a block * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.7.5") @NotNull public FallingBlock spawnFallingBlock(@NotNull Location location, @NotNull Material material, byte data) throws IllegalArgumentException; @@ -1413,7 +1413,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @deprecated biomes are now 3-dimensional */ @NotNull - @Deprecated + @Deprecated(since = "1.15") Biome getBiome(int x, int z); /** @@ -1424,7 +1424,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @param bio new Biome type for this block * @deprecated biomes are now 3-dimensional */ - @Deprecated + @Deprecated(since = "1.15") void setBiome(int x, int z, @NotNull Biome bio); /** @@ -1441,7 +1441,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @return Temperature of the requested block * @deprecated biomes are now 3-dimensional */ - @Deprecated + @Deprecated(since = "1.15") public double getTemperature(int x, int z); /** @@ -1471,7 +1471,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @return Humidity of the requested block * @deprecated biomes are now 3-dimensional */ - @Deprecated + @Deprecated(since = "1.15") public double getHumidity(int x, int z); /** @@ -1585,7 +1585,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @return true if the world's spawn area will be kept loaded into memory. * @deprecated use {@link GameRule#SPAWN_CHUNK_RADIUS} for finer control */ - @Deprecated + @Deprecated(since = "1.20.5") public boolean getKeepSpawnInMemory(); /** @@ -1596,7 +1596,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * loaded into memory. * @deprecated use {@link GameRule#SPAWN_CHUNK_RADIUS} for finer control */ - @Deprecated + @Deprecated(since = "1.20.5") public void setKeepSpawnInMemory(boolean keepLoaded); /** @@ -1660,7 +1660,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * this method to always return the correct value. */ @Nullable - @Deprecated + @Deprecated(since = "1.16.1") public WorldType getWorldType(); /** @@ -1713,7 +1713,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @return The world's ticks per animal spawns value * @deprecated Deprecated in favor of {@link #getTicksPerSpawns(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public long getTicksPerAnimalSpawns(); /** @@ -1742,7 +1742,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * to set the world to * @deprecated Deprecated in favor of {@link #setTicksPerSpawns(SpawnCategory, int)} */ - @Deprecated + @Deprecated(since = "1.18.1") public void setTicksPerAnimalSpawns(int ticksPerAnimalSpawns); /** @@ -1770,7 +1770,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @return The world's ticks per monster spawns value * @deprecated Deprecated in favor of {@link #getTicksPerSpawns(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public long getTicksPerMonsterSpawns(); /** @@ -1799,7 +1799,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * want to set the world to * @deprecated Deprecated in favor of {@link #setTicksPerSpawns(SpawnCategory, int)} */ - @Deprecated + @Deprecated(since = "1.18.1") public void setTicksPerMonsterSpawns(int ticksPerMonsterSpawns); /** @@ -1825,7 +1825,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @return The world's ticks per water mob spawns value * @deprecated Deprecated in favor of {@link #getTicksPerSpawns(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public long getTicksPerWaterSpawns(); /** @@ -1852,7 +1852,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * want to set the world to * @deprecated Deprecated in favor of {@link #setTicksPerSpawns(SpawnCategory, int)} */ - @Deprecated + @Deprecated(since = "1.18.1") public void setTicksPerWaterSpawns(int ticksPerWaterSpawns); /** @@ -1874,7 +1874,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @return the default ticks per water ambient mobs spawn value * @deprecated Deprecated in favor of {@link #getTicksPerSpawns(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public long getTicksPerWaterAmbientSpawns(); /** @@ -1901,7 +1901,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * want to set the world to * @deprecated Deprecated in favor of {@link #setTicksPerSpawns(SpawnCategory, int)} */ - @Deprecated + @Deprecated(since = "1.18.1") public void setTicksPerWaterAmbientSpawns(int ticksPerAmbientSpawns); /** @@ -1923,7 +1923,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @return the default ticks per water underground creature spawn value * @deprecated Deprecated in favor of {@link #getTicksPerSpawns(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public long getTicksPerWaterUndergroundCreatureSpawns(); /** @@ -1950,7 +1950,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * want to set the world to * @deprecated Deprecated in favor of {@link #setTicksPerSpawns(SpawnCategory, int)} */ - @Deprecated + @Deprecated(since = "1.18.1") public void setTicksPerWaterUndergroundCreatureSpawns(int ticksPerWaterUndergroundCreatureSpawns); /** @@ -1976,7 +1976,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @return the default ticks per ambient mobs spawn value * @deprecated Deprecated in favor of {@link #getTicksPerSpawns(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") public long getTicksPerAmbientSpawns(); /** @@ -2003,7 +2003,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * want to set the world to * @deprecated Deprecated in favor of {@link #setTicksPerSpawns(SpawnCategory, int)} */ - @Deprecated + @Deprecated(since = "1.18.1") public void setTicksPerAmbientSpawns(int ticksPerAmbientSpawns); /** @@ -2064,7 +2064,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @return The monster spawn limit * @deprecated Deprecated in favor of {@link #getSpawnLimit(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") int getMonsterSpawnLimit(); /** @@ -2077,7 +2077,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @param limit the new mob limit * @deprecated Deprecated in favor of {@link #setSpawnLimit(SpawnCategory, int)} */ - @Deprecated + @Deprecated(since = "1.18.1") void setMonsterSpawnLimit(int limit); /** @@ -2087,7 +2087,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @return The animal spawn limit * @deprecated Deprecated in favor of {@link #getSpawnLimit(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") int getAnimalSpawnLimit(); /** @@ -2100,7 +2100,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @param limit the new mob limit * @deprecated Deprecated in favor of {@link #getSpawnLimit(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") void setAnimalSpawnLimit(int limit); /** @@ -2110,7 +2110,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @return The water animal spawn limit * @deprecated Deprecated in favor of {@link #getSpawnLimit(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") int getWaterAnimalSpawnLimit(); /** @@ -2123,7 +2123,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @param limit the new mob limit * @deprecated Deprecated in favor of {@link #setSpawnLimit(SpawnCategory, int)} */ - @Deprecated + @Deprecated(since = "1.18.1") void setWaterAnimalSpawnLimit(int limit); /** @@ -2133,7 +2133,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @return The water underground creature spawn limit * @deprecated Deprecated in favor of {@link #getSpawnLimit(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") int getWaterUndergroundCreatureSpawnLimit(); /** @@ -2146,7 +2146,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @param limit the new mob limit * @deprecated Deprecated in favor of {@link #setSpawnLimit(SpawnCategory, int)} */ - @Deprecated + @Deprecated(since = "1.18.1") void setWaterUndergroundCreatureSpawnLimit(int limit); /** @@ -2156,7 +2156,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @return the water ambient spawn limit * @deprecated Deprecated in favor of {@link #getSpawnLimit(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") int getWaterAmbientSpawnLimit(); /** @@ -2169,7 +2169,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @param limit the new mob limit * @deprecated Deprecated in favor of {@link #setSpawnLimit(SpawnCategory, int)} */ - @Deprecated + @Deprecated(since = "1.18.1") void setWaterAmbientSpawnLimit(int limit); /** @@ -2179,7 +2179,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @return The ambient spawn limit * @deprecated Deprecated in favor of {@link #getSpawnLimit(SpawnCategory)} */ - @Deprecated + @Deprecated(since = "1.18.1") int getAmbientSpawnLimit(); /** @@ -2192,7 +2192,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @param limit the new mob limit * @deprecated Deprecated in favor of {@link #setSpawnLimit(SpawnCategory, int)} */ - @Deprecated + @Deprecated(since = "1.18.1") void setAmbientSpawnLimit(int limit); /** @@ -2413,7 +2413,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @return String value of rule * @deprecated use {@link #getGameRuleValue(GameRule)} instead */ - @Deprecated + @Deprecated(since = "1.13") @Contract("null -> null; !null -> !null") @Nullable public String getGameRuleValue(@Nullable String rule); @@ -2431,7 +2431,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @return True if rule was set * @deprecated use {@link #setGameRule(GameRule, Object)} instead. */ - @Deprecated + @Deprecated(since = "1.13") public boolean setGameRuleValue(@NotNull String rule, @NotNull String value); /** @@ -2759,7 +2759,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * instead. */ @Nullable - @Deprecated + @Deprecated(since = "1.19") public Location locateNearestStructure(@NotNull Location origin, @NotNull org.bukkit.StructureType structureType, int radius, boolean findUnexplored); /** @@ -2984,7 +2984,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @return dimension ID * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public int getId() { return id; } @@ -2996,7 +2996,7 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient * @return The environment * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Nullable public static Environment getEnvironment(int id) { return lookup.get(id); diff --git a/paper-api/src/main/java/org/bukkit/attribute/AttributeModifier.java b/paper-api/src/main/java/org/bukkit/attribute/AttributeModifier.java index 6ffc895138..ecf3897bd2 100644 --- a/paper-api/src/main/java/org/bukkit/attribute/AttributeModifier.java +++ b/paper-api/src/main/java/org/bukkit/attribute/AttributeModifier.java @@ -123,7 +123,7 @@ public class AttributeModifier implements ConfigurationSerializable, Keyed { * @deprecated use {@link #getSlotGroup()} */ @Nullable - @Deprecated + @Deprecated(since = "1.20.5") public EquipmentSlot getSlot() { return slot == EquipmentSlotGroup.ANY ? null : slot.getExample(); } diff --git a/paper-api/src/main/java/org/bukkit/block/Bed.java b/paper-api/src/main/java/org/bukkit/block/Bed.java index f9bd74f9ce..20aaa7e15a 100644 --- a/paper-api/src/main/java/org/bukkit/block/Bed.java +++ b/paper-api/src/main/java/org/bukkit/block/Bed.java @@ -6,5 +6,5 @@ import org.bukkit.material.Colorable; * Represents a captured state of a bed. * @deprecated does not provide useful information beyond the material itself */ -@Deprecated +@Deprecated(since = "1.13") public interface Bed extends TileState, Colorable { } diff --git a/paper-api/src/main/java/org/bukkit/block/Block.java b/paper-api/src/main/java/org/bukkit/block/Block.java index f8e12868f2..ab65d9769b 100644 --- a/paper-api/src/main/java/org/bukkit/block/Block.java +++ b/paper-api/src/main/java/org/bukkit/block/Block.java @@ -40,7 +40,7 @@ public interface Block extends Metadatable, Translatable { * @return block specific metadata * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") byte getData(); /** diff --git a/paper-api/src/main/java/org/bukkit/block/BlockState.java b/paper-api/src/main/java/org/bukkit/block/BlockState.java index 3e07fc1bc0..dd1e7b71d7 100644 --- a/paper-api/src/main/java/org/bukkit/block/BlockState.java +++ b/paper-api/src/main/java/org/bukkit/block/BlockState.java @@ -221,14 +221,14 @@ public interface BlockState extends Metadatable { * @return The data as a raw byte. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public byte getRawData(); /** * @param data The new data value for the block. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public void setRawData(byte data); /** diff --git a/paper-api/src/main/java/org/bukkit/block/BlockType.java b/paper-api/src/main/java/org/bukkit/block/BlockType.java index cd575a2873..aea98cddf2 100644 --- a/paper-api/src/main/java/org/bukkit/block/BlockType.java +++ b/paper-api/src/main/java/org/bukkit/block/BlockType.java @@ -3634,6 +3634,6 @@ public interface BlockType extends Keyed, Translatable { * @deprecated only for internal use */ @Nullable - @Deprecated + @Deprecated(since = "1.20.6") Material asMaterial(); } diff --git a/paper-api/src/main/java/org/bukkit/block/CreatureSpawner.java b/paper-api/src/main/java/org/bukkit/block/CreatureSpawner.java index 3019cede48..cf337e23b2 100644 --- a/paper-api/src/main/java/org/bukkit/block/CreatureSpawner.java +++ b/paper-api/src/main/java/org/bukkit/block/CreatureSpawner.java @@ -15,7 +15,7 @@ public interface CreatureSpawner extends TileState, Spawner { * @deprecated magic value, use * {@link #setSpawnedType(org.bukkit.entity.EntityType)}. */ - @Deprecated + @Deprecated(since = "1.11.2") public void setCreatureTypeByName(@Nullable String creatureType); /** @@ -24,7 +24,7 @@ public interface CreatureSpawner extends TileState, Spawner { * @return The creature type's name if is set. * @deprecated magic value, use {@link #getSpawnedType()}. */ - @Deprecated + @Deprecated(since = "1.11.2") @Nullable public String getCreatureTypeName(); } diff --git a/paper-api/src/main/java/org/bukkit/block/DecoratedPot.java b/paper-api/src/main/java/org/bukkit/block/DecoratedPot.java index f76230e0bb..a04df8105a 100644 --- a/paper-api/src/main/java/org/bukkit/block/DecoratedPot.java +++ b/paper-api/src/main/java/org/bukkit/block/DecoratedPot.java @@ -51,7 +51,7 @@ public interface DecoratedPot extends TileState, BlockInventoryHolder { * @return the sherds * @deprecated in favor of {@link #getSherds()} */ - @Deprecated + @Deprecated(since = "1.20.1") @NotNull public List getShards(); diff --git a/paper-api/src/main/java/org/bukkit/block/Lockable.java b/paper-api/src/main/java/org/bukkit/block/Lockable.java index fc0c78381a..af8ac8419d 100644 --- a/paper-api/src/main/java/org/bukkit/block/Lockable.java +++ b/paper-api/src/main/java/org/bukkit/block/Lockable.java @@ -26,7 +26,7 @@ public interface Lockable { * @deprecated locks are not necessarily pure strings */ @NotNull - @Deprecated + @Deprecated(since = "1.21.2") String getLock(); /** @@ -36,7 +36,7 @@ public interface Lockable { * @param key the key required to access the container. * @deprecated locks are not necessarily pure strings */ - @Deprecated + @Deprecated(since = "1.21.2") void setLock(@Nullable String key); /** diff --git a/paper-api/src/main/java/org/bukkit/block/PistonMoveReaction.java b/paper-api/src/main/java/org/bukkit/block/PistonMoveReaction.java index b90f5dc345..c171f89ea4 100644 --- a/paper-api/src/main/java/org/bukkit/block/PistonMoveReaction.java +++ b/paper-api/src/main/java/org/bukkit/block/PistonMoveReaction.java @@ -50,7 +50,7 @@ public enum PistonMoveReaction { * @return The ID of the move reaction * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public int getId() { return this.id; } @@ -60,7 +60,7 @@ public enum PistonMoveReaction { * @return The move reaction with that ID * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Nullable public static PistonMoveReaction getById(int id) { return byId.get(id); diff --git a/paper-api/src/main/java/org/bukkit/block/Sign.java b/paper-api/src/main/java/org/bukkit/block/Sign.java index d9fae47539..5aa7148dd2 100644 --- a/paper-api/src/main/java/org/bukkit/block/Sign.java +++ b/paper-api/src/main/java/org/bukkit/block/Sign.java @@ -19,7 +19,7 @@ public interface Sign extends TileState, Colorable { * @return Array of Strings containing each line of text * @deprecated A sign may have multiple writable sides now. Use {@link Sign#getSide(Side)} and {@link SignSide#getLines()}. */ - @Deprecated + @Deprecated(since = "1.20") @NotNull public String[] getLines(); @@ -33,7 +33,7 @@ public interface Sign extends TileState, Colorable { * @throws IndexOutOfBoundsException Thrown when the line does not exist * @deprecated A sign may have multiple writable sides now. Use {@link #getSide(Side)} and {@link SignSide#getLine(int)}. */ - @Deprecated + @Deprecated(since = "1.20") @NotNull public String getLine(int index) throws IndexOutOfBoundsException; @@ -48,7 +48,7 @@ public interface Sign extends TileState, Colorable { * @throws IndexOutOfBoundsException If the index is out of the range 0..3 * @deprecated A sign may have multiple writable sides now. Use {@link #getSide(Side)} and {@link SignSide#setLine(int, String)}. */ - @Deprecated + @Deprecated(since = "1.20") public void setLine(int index, @NotNull String line) throws IndexOutOfBoundsException; /** @@ -57,7 +57,7 @@ public interface Sign extends TileState, Colorable { * @return if this sign is currently editable * @deprecated use {@link #isWaxed()} instead */ - @Deprecated + @Deprecated(since = "1.20.1") public boolean isEditable(); /** @@ -66,7 +66,7 @@ public interface Sign extends TileState, Colorable { * @param editable if this sign is currently editable * @deprecated use {@link #setWaxed(boolean)} instead */ - @Deprecated + @Deprecated(since = "1.20.1") public void setEditable(boolean editable); /** @@ -91,7 +91,7 @@ public interface Sign extends TileState, Colorable { * @return if this sign has glowing text * @deprecated A sign may have multiple writable sides now. Use {@link #getSide(Side)} and {@link SignSide#isGlowingText()}. */ - @Deprecated + @Deprecated(since = "1.20") public boolean isGlowingText(); /** @@ -100,7 +100,7 @@ public interface Sign extends TileState, Colorable { * @param glowing if this sign has glowing text * @deprecated A sign may have multiple writable sides now. Use {@link #getSide(Side)} and {@link SignSide#setGlowingText(boolean)}. */ - @Deprecated + @Deprecated(since = "1.20") public void setGlowingText(boolean glowing); /** @@ -110,7 +110,7 @@ public interface Sign extends TileState, Colorable { */ @NotNull @Override - @Deprecated + @Deprecated(since = "1.20") public DyeColor getColor(); /** @@ -119,7 +119,7 @@ public interface Sign extends TileState, Colorable { * @deprecated A sign may have multiple writable sides now. Use {@link #getSide(Side)} and {@link SignSide#setColor(org.bukkit.DyeColor)}. */ @Override - @Deprecated + @Deprecated(since = "1.20") public void setColor(@NotNull DyeColor color); /** diff --git a/paper-api/src/main/java/org/bukkit/block/Skull.java b/paper-api/src/main/java/org/bukkit/block/Skull.java index b39128bb0c..8ad781ea55 100644 --- a/paper-api/src/main/java/org/bukkit/block/Skull.java +++ b/paper-api/src/main/java/org/bukkit/block/Skull.java @@ -28,7 +28,7 @@ public interface Skull extends TileState { * @return the owner of the skull or null if the skull does not have an owner * @deprecated See {@link #getOwningPlayer()}. */ - @Deprecated + @Deprecated(since = "1.9.4") @Nullable public String getOwner(); @@ -42,7 +42,7 @@ public interface Skull extends TileState { * @return true if the owner was successfully set * @deprecated see {@link #setOwningPlayer(org.bukkit.OfflinePlayer)}. */ - @Deprecated + @Deprecated(since = "1.94") @Contract("null -> false") public boolean setOwner(@Nullable String name); @@ -115,7 +115,7 @@ public interface Skull extends TileState { * @return the rotation of the skull * @deprecated use {@link BlockData} */ - @Deprecated + @Deprecated(since = "1.13") @NotNull public BlockFace getRotation(); @@ -126,7 +126,7 @@ public interface Skull extends TileState { * @param rotation the rotation of the skull * @deprecated use {@link BlockData} */ - @Deprecated + @Deprecated(since = "1.13") public void setRotation(@NotNull BlockFace rotation); /** @@ -135,7 +135,7 @@ public interface Skull extends TileState { * @return the type of skull * @deprecated check {@link Material} instead */ - @Deprecated + @Deprecated(since = "1.13") @NotNull public SkullType getSkullType(); @@ -145,7 +145,7 @@ public interface Skull extends TileState { * @param skullType the type of skull * @deprecated check {@link Material} instead */ - @Deprecated + @Deprecated(since = "1.13") @Contract("_ -> fail") public void setSkullType(SkullType skullType); } diff --git a/paper-api/src/main/java/org/bukkit/block/SuspiciousSand.java b/paper-api/src/main/java/org/bukkit/block/SuspiciousSand.java index a7c4e4baf1..3b5f6341c8 100644 --- a/paper-api/src/main/java/org/bukkit/block/SuspiciousSand.java +++ b/paper-api/src/main/java/org/bukkit/block/SuspiciousSand.java @@ -5,6 +5,6 @@ package org.bukkit.block; * * @see BrushableBlock */ -@Deprecated +@Deprecated(since = "1.20") public interface SuspiciousSand extends BrushableBlock { } diff --git a/paper-api/src/main/java/org/bukkit/block/banner/PatternType.java b/paper-api/src/main/java/org/bukkit/block/banner/PatternType.java index eaf6cd7583..b6aa112ffc 100644 --- a/paper-api/src/main/java/org/bukkit/block/banner/PatternType.java +++ b/paper-api/src/main/java/org/bukkit/block/banner/PatternType.java @@ -69,7 +69,7 @@ public interface PatternType extends OldEnum, Keyed { * @deprecated magic value */ @NotNull - @Deprecated(forRemoval = true) + @Deprecated(since = "1.20.4", forRemoval = true) public String getIdentifier(); /** @@ -83,7 +83,7 @@ public interface PatternType extends OldEnum, Keyed { */ @Contract("null -> null") @Nullable - @Deprecated(forRemoval = true) + @Deprecated(since = "1.20.4", forRemoval = true) public static PatternType getByIdentifier(@Nullable String identifier) { if (identifier == null) { return null; diff --git a/paper-api/src/main/java/org/bukkit/block/data/type/Switch.java b/paper-api/src/main/java/org/bukkit/block/data/type/Switch.java index be06f8db02..df8c2d60e7 100644 --- a/paper-api/src/main/java/org/bukkit/block/data/type/Switch.java +++ b/paper-api/src/main/java/org/bukkit/block/data/type/Switch.java @@ -14,7 +14,7 @@ public interface Switch extends Directional, FaceAttachable, Powerable { * @deprecated use {@link #getAttachedFace()} */ @NotNull - @Deprecated + @Deprecated(since = "1.15.2") Face getFace(); /** @@ -23,7 +23,7 @@ public interface Switch extends Directional, FaceAttachable, Powerable { * @param face the new 'face' value * @deprecated use {@link #getAttachedFace()} */ - @Deprecated + @Deprecated(since = "1.15.2") void setFace(@NotNull Face face); /** @@ -31,7 +31,7 @@ public interface Switch extends Directional, FaceAttachable, Powerable { * * @deprecated use {@link AttachedFace} */ - @Deprecated + @Deprecated(since = "1.15.2") public enum Face { /** * The switch is mounted to the floor and pointing upwards. diff --git a/paper-api/src/main/java/org/bukkit/block/data/type/Vault.java b/paper-api/src/main/java/org/bukkit/block/data/type/Vault.java index 0ffa92a4a5..122f8c888b 100644 --- a/paper-api/src/main/java/org/bukkit/block/data/type/Vault.java +++ b/paper-api/src/main/java/org/bukkit/block/data/type/Vault.java @@ -24,7 +24,7 @@ public interface Vault extends Directional { * @return the 'vault_state' value * @deprecated see {@link #getVaultState()} */ - @Deprecated(forRemoval = true) + @Deprecated(since = "1.21.3", forRemoval = true) @NotNull State getTrialSpawnerState(); @@ -41,7 +41,7 @@ public interface Vault extends Directional { * @param state the new 'vault_state' value * @deprecated see {@link #setVaultState(State)} */ - @Deprecated(forRemoval = true) + @Deprecated(since = "1.21.3", forRemoval = true) void setTrialSpawnerState(@NotNull State state); /** diff --git a/paper-api/src/main/java/org/bukkit/boss/BossBar.java b/paper-api/src/main/java/org/bukkit/boss/BossBar.java index 70274f2e2a..c649535dcc 100644 --- a/paper-api/src/main/java/org/bukkit/boss/BossBar.java +++ b/paper-api/src/main/java/org/bukkit/boss/BossBar.java @@ -137,13 +137,13 @@ public interface BossBar { * Shows the previously hidden boss bar to all attached players * @deprecated {@link #setVisible(boolean)} */ - @Deprecated + @Deprecated(since = "1.9") void show(); /** * Hides this boss bar from all attached players * @deprecated {@link #setVisible(boolean)} */ - @Deprecated + @Deprecated(since = "1.9") void hide(); } diff --git a/paper-api/src/main/java/org/bukkit/command/Command.java b/paper-api/src/main/java/org/bukkit/command/Command.java index d498b16bb9..3ad2254c5f 100644 --- a/paper-api/src/main/java/org/bukkit/command/Command.java +++ b/paper-api/src/main/java/org/bukkit/command/Command.java @@ -321,7 +321,7 @@ public abstract class Command { * consoles or when this command is executed with * {@link Bukkit#dispatchCommand(CommandSender, String)}. */ - @Deprecated + @Deprecated(since = "1.20.4") @Nullable public String getPermissionMessage() { return permissionMessage; @@ -392,7 +392,7 @@ public abstract class Command { * consoles or when this command is executed with * {@link Bukkit#dispatchCommand(CommandSender, String)}. */ - @Deprecated + @Deprecated(since = "1.20.4") @NotNull public Command setPermissionMessage(@Nullable String permissionMessage) { this.permissionMessage = permissionMessage; diff --git a/paper-api/src/main/java/org/bukkit/configuration/file/FileConfiguration.java b/paper-api/src/main/java/org/bukkit/configuration/file/FileConfiguration.java index 70284de18d..646223d033 100644 --- a/paper-api/src/main/java/org/bukkit/configuration/file/FileConfiguration.java +++ b/paper-api/src/main/java/org/bukkit/configuration/file/FileConfiguration.java @@ -209,7 +209,7 @@ public abstract class FileConfiguration extends MemoryConfiguration { * {@link FileConfigurationOptions#getHeader()} instead. */ @NotNull - @Deprecated + @Deprecated(since = "1.18.1") protected String buildHeader() { return ""; } diff --git a/paper-api/src/main/java/org/bukkit/configuration/file/FileConfigurationOptions.java b/paper-api/src/main/java/org/bukkit/configuration/file/FileConfigurationOptions.java index c71f8a7b96..4bff5d18d9 100644 --- a/paper-api/src/main/java/org/bukkit/configuration/file/FileConfigurationOptions.java +++ b/paper-api/src/main/java/org/bukkit/configuration/file/FileConfigurationOptions.java @@ -67,7 +67,7 @@ public class FileConfigurationOptions extends MemoryConfigurationOptions { * @deprecated use getHeader() instead. */ @NotNull - @Deprecated + @Deprecated(since = "1.18.1") public String header() { StringBuilder stringHeader = new StringBuilder(); for (String line : header) { @@ -105,7 +105,7 @@ public class FileConfigurationOptions extends MemoryConfigurationOptions { * @deprecated use setHeader() instead */ @NotNull - @Deprecated + @Deprecated(since = "1.18.1") public FileConfigurationOptions header(@Nullable String value) { this.header = (value == null) ? Collections.emptyList() : Collections.unmodifiableList(Arrays.asList(value.split("\\n"))); return this; @@ -183,7 +183,7 @@ public class FileConfigurationOptions extends MemoryConfigurationOptions { * * @deprecated Call {@link #parseComments()} instead. */ - @Deprecated + @Deprecated(since = "1.18.1") public boolean copyHeader() { return parseComments; } @@ -195,7 +195,7 @@ public class FileConfigurationOptions extends MemoryConfigurationOptions { * @deprecated Call {@link #parseComments(boolean)} instead. */ @NotNull - @Deprecated + @Deprecated(since = "1.18.1") public FileConfigurationOptions copyHeader(boolean value) { parseComments = value; return this; diff --git a/paper-api/src/main/java/org/bukkit/configuration/file/YamlConfiguration.java b/paper-api/src/main/java/org/bukkit/configuration/file/YamlConfiguration.java index 9ae41b2bd4..b76cf252f4 100644 --- a/paper-api/src/main/java/org/bukkit/configuration/file/YamlConfiguration.java +++ b/paper-api/src/main/java/org/bukkit/configuration/file/YamlConfiguration.java @@ -42,12 +42,12 @@ public class YamlConfiguration extends FileConfiguration { /** * @deprecated unused, not intended to be API */ - @Deprecated + @Deprecated(since = "1.18.1") protected static final String COMMENT_PREFIX = "# "; /** * @deprecated unused, not intended to be API */ - @Deprecated + @Deprecated(since = "1.18.1") protected static final String BLANK_CONFIG = "{}\n"; private final DumperOptions yamlDumperOptions; private final LoaderOptions yamlLoaderOptions; diff --git a/paper-api/src/main/java/org/bukkit/configuration/file/YamlConfigurationOptions.java b/paper-api/src/main/java/org/bukkit/configuration/file/YamlConfigurationOptions.java index 3f7f6caf5f..3f69667e6b 100644 --- a/paper-api/src/main/java/org/bukkit/configuration/file/YamlConfigurationOptions.java +++ b/paper-api/src/main/java/org/bukkit/configuration/file/YamlConfigurationOptions.java @@ -46,7 +46,7 @@ public class YamlConfigurationOptions extends FileConfigurationOptions { @NotNull @Override - @Deprecated + @Deprecated(since = "1.18.1") public YamlConfigurationOptions header(@Nullable String value) { super.header(value); return this; @@ -68,7 +68,7 @@ public class YamlConfigurationOptions extends FileConfigurationOptions { @NotNull @Override - @Deprecated + @Deprecated(since = "1.18.1") public YamlConfigurationOptions copyHeader(boolean value) { super.copyHeader(value); return this; diff --git a/paper-api/src/main/java/org/bukkit/configuration/file/YamlConstructor.java b/paper-api/src/main/java/org/bukkit/configuration/file/YamlConstructor.java index 6235fe0da8..b9dc7e4b4a 100644 --- a/paper-api/src/main/java/org/bukkit/configuration/file/YamlConstructor.java +++ b/paper-api/src/main/java/org/bukkit/configuration/file/YamlConstructor.java @@ -17,7 +17,7 @@ public class YamlConstructor extends SafeConstructor { /** * @deprecated options required */ - @Deprecated + @Deprecated(since = "1.19.4") public YamlConstructor() { this(new LoaderOptions()); } diff --git a/paper-api/src/main/java/org/bukkit/configuration/file/YamlRepresenter.java b/paper-api/src/main/java/org/bukkit/configuration/file/YamlRepresenter.java index 09a85c4af6..3b43a41115 100644 --- a/paper-api/src/main/java/org/bukkit/configuration/file/YamlRepresenter.java +++ b/paper-api/src/main/java/org/bukkit/configuration/file/YamlRepresenter.java @@ -15,7 +15,7 @@ public class YamlRepresenter extends Representer { /** * @deprecated options required */ - @Deprecated + @Deprecated(since = "1.19.4") public YamlRepresenter() { this(new DumperOptions()); } diff --git a/paper-api/src/main/java/org/bukkit/enchantments/Enchantment.java b/paper-api/src/main/java/org/bukkit/enchantments/Enchantment.java index 241bc2ea61..e560a13a1b 100644 --- a/paper-api/src/main/java/org/bukkit/enchantments/Enchantment.java +++ b/paper-api/src/main/java/org/bukkit/enchantments/Enchantment.java @@ -239,7 +239,7 @@ public abstract class Enchantment implements Keyed, Translatable { * @deprecated enchantments are badly named, use {@link #getKey()}. */ @NotNull - @Deprecated + @Deprecated(since = "1.13") public abstract String getName(); /** @@ -263,7 +263,7 @@ public abstract class Enchantment implements Keyed, Translatable { * @deprecated enchantment groupings are now managed by tags, not categories */ @NotNull - @Deprecated + @Deprecated(since = "1.20.5") public abstract EnchantmentTarget getItemTarget(); /** @@ -275,7 +275,7 @@ public abstract class Enchantment implements Keyed, Translatable { * @return true if the enchantment is a treasure enchantment * @deprecated enchantment types are now managed by tags */ - @Deprecated + @Deprecated(since = "1.21") public abstract boolean isTreasure(); /** @@ -288,7 +288,7 @@ public abstract class Enchantment implements Keyed, Translatable { * only for {@link Enchantment#BINDING_CURSE} and * {@link Enchantment#VANISHING_CURSE}. */ - @Deprecated + @Deprecated(since = "1.13") public abstract boolean isCursed(); /** @@ -320,7 +320,7 @@ public abstract class Enchantment implements Keyed, Translatable { */ @Contract("null -> null") @Nullable - @Deprecated + @Deprecated(since = "1.20.3") public static Enchantment getByKey(@Nullable NamespacedKey key) { if (key == null) { return null; @@ -335,7 +335,7 @@ public abstract class Enchantment implements Keyed, Translatable { * @return Resulting Enchantment, or null if not found * @deprecated enchantments are badly named, use {@link #getByKey(org.bukkit.NamespacedKey)}. */ - @Deprecated + @Deprecated(since = "1.13") @Contract("null -> null") @Nullable public static Enchantment getByName(@Nullable String name) { @@ -353,7 +353,7 @@ public abstract class Enchantment implements Keyed, Translatable { * @deprecated use {@link Registry#iterator() Registry.ENCHANTMENT.iterator()} */ @NotNull - @Deprecated + @Deprecated(since = "1.20.3") public static Enchantment[] values() { return Lists.newArrayList(Registry.ENCHANTMENT).toArray(new Enchantment[0]); } diff --git a/paper-api/src/main/java/org/bukkit/enchantments/EnchantmentTarget.java b/paper-api/src/main/java/org/bukkit/enchantments/EnchantmentTarget.java index 455ff52d90..6fcc15d588 100644 --- a/paper-api/src/main/java/org/bukkit/enchantments/EnchantmentTarget.java +++ b/paper-api/src/main/java/org/bukkit/enchantments/EnchantmentTarget.java @@ -13,7 +13,7 @@ public enum EnchantmentTarget { * * @deprecated this target no longer exists in Vanilla */ - @Deprecated + @Deprecated(since = "1.16.1") ALL { @Override public boolean includes(@NotNull Material item) { diff --git a/paper-api/src/main/java/org/bukkit/enchantments/EnchantmentWrapper.java b/paper-api/src/main/java/org/bukkit/enchantments/EnchantmentWrapper.java index 7ad7bcf9a9..ac3a61fb5d 100644 --- a/paper-api/src/main/java/org/bukkit/enchantments/EnchantmentWrapper.java +++ b/paper-api/src/main/java/org/bukkit/enchantments/EnchantmentWrapper.java @@ -6,7 +6,7 @@ import org.jetbrains.annotations.NotNull; * A simple wrapper for ease of selecting {@link Enchantment}s * @deprecated only for backwards compatibility, EnchantmentWrapper is no longer used. */ -@Deprecated +@Deprecated(since = "1.20.3") public abstract class EnchantmentWrapper extends Enchantment { protected EnchantmentWrapper() { } diff --git a/paper-api/src/main/java/org/bukkit/entity/AbstractArrow.java b/paper-api/src/main/java/org/bukkit/entity/AbstractArrow.java index 4d99382496..9cebf79b62 100644 --- a/paper-api/src/main/java/org/bukkit/entity/AbstractArrow.java +++ b/paper-api/src/main/java/org/bukkit/entity/AbstractArrow.java @@ -20,7 +20,7 @@ public interface AbstractArrow extends Projectile { * @see #getWeapon() * @deprecated a function of the firing weapon */ - @Deprecated + @Deprecated(since = "1.21") public int getKnockbackStrength(); /** @@ -30,7 +30,7 @@ public interface AbstractArrow extends Projectile { * @see #setWeapon(org.bukkit.inventory.ItemStack) * @deprecated a function of the firing weapon */ - @Deprecated + @Deprecated(since = "1.21") public void setKnockbackStrength(int knockbackStrength); /** @@ -132,7 +132,7 @@ public interface AbstractArrow extends Projectile { * @see #setWeapon(org.bukkit.inventory.ItemStack) * @deprecated a function of the firing weapon instead */ - @Deprecated + @Deprecated(since = "1.21") public void setShotFromCrossbow(boolean shotFromCrossbow); /** diff --git a/paper-api/src/main/java/org/bukkit/entity/AbstractHorse.java b/paper-api/src/main/java/org/bukkit/entity/AbstractHorse.java index 0d88dce997..161af8bc4f 100644 --- a/paper-api/src/main/java/org/bukkit/entity/AbstractHorse.java +++ b/paper-api/src/main/java/org/bukkit/entity/AbstractHorse.java @@ -20,7 +20,7 @@ public interface AbstractHorse extends Vehicle, InventoryHolder, Tameable { * @return a {@link Horse.Variant} representing the horse's variant * @deprecated different variants are different classes */ - @Deprecated + @Deprecated(since = "1.11") @NotNull public Horse.Variant getVariant(); @@ -28,7 +28,7 @@ public interface AbstractHorse extends Vehicle, InventoryHolder, Tameable { * @param variant variant * @deprecated you are required to spawn a different entity */ - @Deprecated + @Deprecated(since = "1.11") @Contract("_ -> fail") public void setVariant(Horse.Variant variant); diff --git a/paper-api/src/main/java/org/bukkit/entity/AbstractSkeleton.java b/paper-api/src/main/java/org/bukkit/entity/AbstractSkeleton.java index e2fce218c6..6ffacd3af2 100644 --- a/paper-api/src/main/java/org/bukkit/entity/AbstractSkeleton.java +++ b/paper-api/src/main/java/org/bukkit/entity/AbstractSkeleton.java @@ -21,7 +21,7 @@ public interface AbstractSkeleton extends Monster { * @return Current type * @deprecated should check what class instance this is. */ - @Deprecated + @Deprecated(since = "1.17") @NotNull public Skeleton.SkeletonType getSkeletonType(); @@ -29,7 +29,7 @@ public interface AbstractSkeleton extends Monster { * @param type type * @deprecated Must spawn a new subtype variant */ - @Deprecated + @Deprecated(since = "1.17") @Contract("_ -> fail") public void setSkeletonType(Skeleton.SkeletonType type); } diff --git a/paper-api/src/main/java/org/bukkit/entity/Ageable.java b/paper-api/src/main/java/org/bukkit/entity/Ageable.java index 82b80a96bd..866fc0128e 100644 --- a/paper-api/src/main/java/org/bukkit/entity/Ageable.java +++ b/paper-api/src/main/java/org/bukkit/entity/Ageable.java @@ -25,7 +25,7 @@ public interface Ageable extends Creature { * @param lock new lock * @deprecated see {@link Breedable#setAgeLock(boolean)} */ - @Deprecated + @Deprecated(since = "1.16.2") public void setAgeLock(boolean lock); /** @@ -34,7 +34,7 @@ public interface Ageable extends Creature { * @return the current agelock * @deprecated see {@link Breedable#getAgeLock()} */ - @Deprecated + @Deprecated(since = "1.16.2") public boolean getAgeLock(); /** @@ -60,7 +60,7 @@ public interface Ageable extends Creature { * @return the ability to breed of the animal * @deprecated see {@link Breedable#canBreed()} */ - @Deprecated + @Deprecated(since = "1.16.2") public boolean canBreed(); /** @@ -70,6 +70,6 @@ public interface Ageable extends Creature { * @param breed breedability of the animal * @deprecated see {@link Breedable#setBreed(boolean)} */ - @Deprecated + @Deprecated(since = "1.16.2") public void setBreed(boolean breed); } diff --git a/paper-api/src/main/java/org/bukkit/entity/AreaEffectCloud.java b/paper-api/src/main/java/org/bukkit/entity/AreaEffectCloud.java index 1df234d653..9d99a67014 100644 --- a/paper-api/src/main/java/org/bukkit/entity/AreaEffectCloud.java +++ b/paper-api/src/main/java/org/bukkit/entity/AreaEffectCloud.java @@ -152,7 +152,7 @@ public interface AreaEffectCloud extends Entity { * @param data PotionData to set the base potion state to * @deprecated Upgraded / extended potions are now their own {@link PotionType} use {@link #setBasePotionType} instead. */ - @Deprecated + @Deprecated(since = "1.20.6") void setBasePotionData(@Nullable PotionData data); /** @@ -162,7 +162,7 @@ public interface AreaEffectCloud extends Entity { * @deprecated Upgraded / extended potions are now their own {@link PotionType} use {@link #getBasePotionType()} instead. */ @Nullable - @Deprecated + @Deprecated(since = "1.20.6") PotionData getBasePotionData(); /** diff --git a/paper-api/src/main/java/org/bukkit/entity/ArmorStand.java b/paper-api/src/main/java/org/bukkit/entity/ArmorStand.java index dc604d6ab9..d08c5eb82e 100644 --- a/paper-api/src/main/java/org/bukkit/entity/ArmorStand.java +++ b/paper-api/src/main/java/org/bukkit/entity/ArmorStand.java @@ -17,7 +17,7 @@ public interface ArmorStand extends LivingEntity { * @deprecated prefer {@link EntityEquipment#getItemInHand()} */ @NotNull - @Deprecated + @Deprecated(since = "1.15.2") ItemStack getItemInHand(); /** @@ -28,7 +28,7 @@ public interface ArmorStand extends LivingEntity { * @deprecated prefer * {@link EntityEquipment#setItemInHand(org.bukkit.inventory.ItemStack)} */ - @Deprecated + @Deprecated(since = "1.15.2") void setItemInHand(@Nullable ItemStack item); /** @@ -39,7 +39,7 @@ public interface ArmorStand extends LivingEntity { * @deprecated prefer {@link EntityEquipment#getBoots()} */ @NotNull - @Deprecated + @Deprecated(since = "1.15.2") ItemStack getBoots(); /** @@ -50,7 +50,7 @@ public interface ArmorStand extends LivingEntity { * @deprecated prefer * {@link EntityEquipment#setBoots(org.bukkit.inventory.ItemStack)} */ - @Deprecated + @Deprecated(since = "1.15.2") void setBoots(@Nullable ItemStack item); /** @@ -61,7 +61,7 @@ public interface ArmorStand extends LivingEntity { * @deprecated prefer {@link EntityEquipment#getLeggings()} */ @NotNull - @Deprecated + @Deprecated(since = "1.15.2") ItemStack getLeggings(); /** @@ -72,7 +72,7 @@ public interface ArmorStand extends LivingEntity { * @deprecated prefer * {@link EntityEquipment#setLeggings(org.bukkit.inventory.ItemStack)} */ - @Deprecated + @Deprecated(since = "1.15.2") void setLeggings(@Nullable ItemStack item); /** @@ -83,7 +83,7 @@ public interface ArmorStand extends LivingEntity { * @deprecated prefer {@link EntityEquipment#getChestplate()} */ @NotNull - @Deprecated + @Deprecated(since = "1.15.2") ItemStack getChestplate(); /** @@ -94,7 +94,7 @@ public interface ArmorStand extends LivingEntity { * @deprecated prefer * {@link EntityEquipment#setChestplate(org.bukkit.inventory.ItemStack)} */ - @Deprecated + @Deprecated(since = "1.15.2") void setChestplate(@Nullable ItemStack item); /** @@ -105,7 +105,7 @@ public interface ArmorStand extends LivingEntity { * @deprecated prefer {@link EntityEquipment#getHelmet()} */ @NotNull - @Deprecated + @Deprecated(since = "1.15.2") ItemStack getHelmet(); /** @@ -116,7 +116,7 @@ public interface ArmorStand extends LivingEntity { * @deprecated prefer * {@link EntityEquipment#setHelmet(org.bukkit.inventory.ItemStack)} */ - @Deprecated + @Deprecated(since = "1.15.2") void setHelmet(@Nullable ItemStack item); /** diff --git a/paper-api/src/main/java/org/bukkit/entity/Arrow.java b/paper-api/src/main/java/org/bukkit/entity/Arrow.java index a1615334ca..a292579c9f 100644 --- a/paper-api/src/main/java/org/bukkit/entity/Arrow.java +++ b/paper-api/src/main/java/org/bukkit/entity/Arrow.java @@ -17,7 +17,7 @@ public interface Arrow extends AbstractArrow { * @param data PotionData to set the base potion state to * @deprecated Upgraded / extended potions are now their own {@link PotionType} use {@link #setBasePotionType} instead. */ - @Deprecated + @Deprecated(since = "1.20.6") void setBasePotionData(@Nullable PotionData data); /** @@ -27,7 +27,7 @@ public interface Arrow extends AbstractArrow { * @deprecated Upgraded / extended potions are now their own {@link PotionType} use {@link #getBasePotionType()} instead. */ @Nullable - @Deprecated + @Deprecated(since = "1.20.6") PotionData getBasePotionData(); /** diff --git a/paper-api/src/main/java/org/bukkit/entity/Boat.java b/paper-api/src/main/java/org/bukkit/entity/Boat.java index dbdd2c1ad7..b77e4ed7f5 100644 --- a/paper-api/src/main/java/org/bukkit/entity/Boat.java +++ b/paper-api/src/main/java/org/bukkit/entity/Boat.java @@ -15,7 +15,7 @@ public interface Boat extends Vehicle { * @return the wood type * @deprecated deprecated in favor of {@link #getBoatType()} */ - @Deprecated + @Deprecated(since = "1.19") @NotNull TreeSpecies getWoodType(); @@ -25,7 +25,7 @@ public interface Boat extends Vehicle { * @param species the new wood type * @deprecated deprecated in favor of {@link #setBoatType(Type)} */ - @Deprecated + @Deprecated(since = "1.19") void setWoodType(@NotNull TreeSpecies species); /** @@ -34,7 +34,7 @@ public interface Boat extends Vehicle { * @return the boat type * @deprecated different boats types are now different entity types */ - @Deprecated + @Deprecated(since = "1.21.2") @NotNull Type getBoatType(); @@ -44,7 +44,7 @@ public interface Boat extends Vehicle { * @param type the new type * @deprecated different boats types are now different entity types */ - @Deprecated + @Deprecated(since = "1.21.2") void setBoatType(@NotNull Type type); /** @@ -54,7 +54,7 @@ public interface Boat extends Vehicle { * @return The max speed. * @deprecated boats are complex and many of these methods do not work correctly across multiple versions. */ - @Deprecated + @Deprecated(since = "1.9") public double getMaxSpeed(); /** @@ -63,7 +63,7 @@ public interface Boat extends Vehicle { * @param speed The max speed. * @deprecated boats are complex and many of these methods do not work correctly across multiple versions. */ - @Deprecated + @Deprecated(since = "1.9") public void setMaxSpeed(double speed); /** @@ -73,7 +73,7 @@ public interface Boat extends Vehicle { * @return The rate of deceleration * @deprecated boats are complex and many of these methods do not work correctly across multiple versions. */ - @Deprecated + @Deprecated(since = "1.9") public double getOccupiedDeceleration(); /** @@ -84,7 +84,7 @@ public interface Boat extends Vehicle { * @param rate deceleration rate * @deprecated boats are complex and many of these methods do not work correctly across multiple versions. */ - @Deprecated + @Deprecated(since = "1.9") public void setOccupiedDeceleration(double rate); /** @@ -95,7 +95,7 @@ public interface Boat extends Vehicle { * @return The rate of deceleration * @deprecated boats are complex and many of these methods do not work correctly across multiple versions. */ - @Deprecated + @Deprecated(since = "1.9") public double getUnoccupiedDeceleration(); /** @@ -107,7 +107,7 @@ public interface Boat extends Vehicle { * @param rate deceleration rate * @deprecated boats are complex and many of these methods do not work correctly across multiple versions. */ - @Deprecated + @Deprecated(since = "1.9") public void setUnoccupiedDeceleration(double rate); /** @@ -116,7 +116,7 @@ public interface Boat extends Vehicle { * @return whether boats can work on land * @deprecated boats are complex and many of these methods do not work correctly across multiple versions. */ - @Deprecated + @Deprecated(since = "1.9") public boolean getWorkOnLand(); /** @@ -125,7 +125,7 @@ public interface Boat extends Vehicle { * @param workOnLand whether boats can work on land * @deprecated boats are complex and many of these methods do not work correctly across multiple versions. */ - @Deprecated + @Deprecated(since = "1.9") public void setWorkOnLand(boolean workOnLand); /** @@ -140,7 +140,7 @@ public interface Boat extends Vehicle { * Represents the type of boats. * @deprecated different boats types are now different entity types */ - @Deprecated + @Deprecated(since = "1.21.2") public enum Type { OAK(Material.OAK_PLANKS), SPRUCE(Material.SPRUCE_PLANKS), diff --git a/paper-api/src/main/java/org/bukkit/entity/Damageable.java b/paper-api/src/main/java/org/bukkit/entity/Damageable.java index f8274def19..1d2447a28b 100644 --- a/paper-api/src/main/java/org/bukkit/entity/Damageable.java +++ b/paper-api/src/main/java/org/bukkit/entity/Damageable.java @@ -79,7 +79,7 @@ public interface Damageable extends Entity { * @return Maximum health * @deprecated use {@link Attribute#MAX_HEALTH}. */ - @Deprecated + @Deprecated(since = "1.11") double getMaxHealth(); /** @@ -94,13 +94,13 @@ public interface Damageable extends Entity { * @param health amount of health to set the maximum to * @deprecated use {@link Attribute#MAX_HEALTH}. */ - @Deprecated + @Deprecated(since = "1.11") void setMaxHealth(double health); /** * Resets the max health to the original amount. * @deprecated use {@link Attribute#MAX_HEALTH}. */ - @Deprecated + @Deprecated(since = "1.11") void resetMaxHealth(); } diff --git a/paper-api/src/main/java/org/bukkit/entity/Endermite.java b/paper-api/src/main/java/org/bukkit/entity/Endermite.java index 9e7f42caab..c77d1a4ea7 100644 --- a/paper-api/src/main/java/org/bukkit/entity/Endermite.java +++ b/paper-api/src/main/java/org/bukkit/entity/Endermite.java @@ -10,7 +10,7 @@ public interface Endermite extends Monster { * @return player spawned status * @deprecated this functionality no longer exists */ - @Deprecated + @Deprecated(since = "1.17") boolean isPlayerSpawned(); /** @@ -21,6 +21,6 @@ public interface Endermite extends Monster { * @param playerSpawned player spawned status * @deprecated this functionality no longer exists */ - @Deprecated + @Deprecated(since = "1.17") void setPlayerSpawned(boolean playerSpawned); } diff --git a/paper-api/src/main/java/org/bukkit/entity/Entity.java b/paper-api/src/main/java/org/bukkit/entity/Entity.java index dee99ac294..b57969f153 100644 --- a/paper-api/src/main/java/org/bukkit/entity/Entity.java +++ b/paper-api/src/main/java/org/bukkit/entity/Entity.java @@ -321,7 +321,7 @@ public interface Entity extends Metadatable, CommandSender, Nameable, Persistent * @deprecated entities may have multiple passengers, use * {@link #getPassengers()} */ - @Deprecated + @Deprecated(since = "1.11.2") @Nullable public Entity getPassenger(); @@ -333,7 +333,7 @@ public interface Entity extends Metadatable, CommandSender, Nameable, Persistent * @deprecated entities may have multiple passengers, use * {@link #addPassenger(org.bukkit.entity.Entity)} */ - @Deprecated + @Deprecated(since = "1.11.2") public boolean setPassenger(@NotNull Entity passenger); /** @@ -397,7 +397,7 @@ public interface Entity extends Metadatable, CommandSender, Nameable, Persistent * @param event a {@link EntityDamageEvent} * @deprecated method is for internal use only and will be removed */ - @Deprecated(forRemoval = true) + @Deprecated(since = "1.20.4", forRemoval = true) public void setLastDamageCause(@Nullable EntityDamageEvent event); /** diff --git a/paper-api/src/main/java/org/bukkit/entity/EntityType.java b/paper-api/src/main/java/org/bukkit/entity/EntityType.java index 17d9669be0..10c957a6bb 100644 --- a/paper-api/src/main/java/org/bukkit/entity/EntityType.java +++ b/paper-api/src/main/java/org/bukkit/entity/EntityType.java @@ -393,7 +393,7 @@ public enum EntityType implements Keyed, Translatable { * @return the entity type's name * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Nullable public String getName() { return name; @@ -418,7 +418,7 @@ public enum EntityType implements Keyed, Translatable { * @return the raw type id * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public short getTypeId() { return typeId; } @@ -430,7 +430,7 @@ public enum EntityType implements Keyed, Translatable { * @return the matching entity type or null * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Contract("null -> null") @Nullable public static EntityType fromName(@Nullable String name) { @@ -447,7 +447,7 @@ public enum EntityType implements Keyed, Translatable { * @return the matching entity type or null * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Nullable public static EntityType fromId(int id) { if (id > Short.MAX_VALUE) { diff --git a/paper-api/src/main/java/org/bukkit/entity/Evoker.java b/paper-api/src/main/java/org/bukkit/entity/Evoker.java index f8d173adc0..e9fffd8967 100644 --- a/paper-api/src/main/java/org/bukkit/entity/Evoker.java +++ b/paper-api/src/main/java/org/bukkit/entity/Evoker.java @@ -14,7 +14,7 @@ public interface Evoker extends Spellcaster { * @deprecated future versions of Minecraft have additional spell casting * entities. */ - @Deprecated + @Deprecated(since = "1.11.2") public enum Spell { /** @@ -51,7 +51,7 @@ public interface Evoker extends Spellcaster { * entities. * */ - @Deprecated + @Deprecated(since = "1.11.2") @NotNull Spell getCurrentSpell(); @@ -62,6 +62,6 @@ public interface Evoker extends Spellcaster { * @deprecated future versions of Minecraft have additional spell casting * entities. */ - @Deprecated + @Deprecated(since = "1.11.2") void setCurrentSpell(@Nullable Spell spell); } diff --git a/paper-api/src/main/java/org/bukkit/entity/FallingBlock.java b/paper-api/src/main/java/org/bukkit/entity/FallingBlock.java index d96fd494b5..5d7d940cda 100644 --- a/paper-api/src/main/java/org/bukkit/entity/FallingBlock.java +++ b/paper-api/src/main/java/org/bukkit/entity/FallingBlock.java @@ -15,7 +15,7 @@ public interface FallingBlock extends Entity { * @return Material of the block * @deprecated use {@link #getBlockData()} */ - @Deprecated + @Deprecated(since = "1.6.2") @NotNull Material getMaterial(); diff --git a/paper-api/src/main/java/org/bukkit/entity/FishHook.java b/paper-api/src/main/java/org/bukkit/entity/FishHook.java index 94e1a30ea1..e178512555 100644 --- a/paper-api/src/main/java/org/bukkit/entity/FishHook.java +++ b/paper-api/src/main/java/org/bukkit/entity/FishHook.java @@ -208,7 +208,7 @@ public interface FishHook extends Projectile { * @return chance the bite chance * @deprecated has no effect in newer Minecraft versions */ - @Deprecated + @Deprecated(since = "1.9.2") public double getBiteChance(); /** @@ -222,7 +222,7 @@ public interface FishHook extends Projectile { * and 1 * @deprecated has no effect in newer Minecraft versions */ - @Deprecated + @Deprecated(since = "1.9.2") public void setBiteChance(double chance) throws IllegalArgumentException; /** diff --git a/paper-api/src/main/java/org/bukkit/entity/Guardian.java b/paper-api/src/main/java/org/bukkit/entity/Guardian.java index 1e7d997dc5..0bb903a35c 100644 --- a/paper-api/src/main/java/org/bukkit/entity/Guardian.java +++ b/paper-api/src/main/java/org/bukkit/entity/Guardian.java @@ -63,14 +63,14 @@ public interface Guardian extends Monster { * @return true if the Guardian is an Elder Guardian, false if not * @deprecated should check if instance of {@link ElderGuardian}. */ - @Deprecated + @Deprecated(since = "1.10.2") public boolean isElder(); /** * @param shouldBeElder shouldBeElder * @deprecated Must spawn a new {@link ElderGuardian}. */ - @Deprecated + @Deprecated(since = "1.10.2") public void setElder(boolean shouldBeElder); /** diff --git a/paper-api/src/main/java/org/bukkit/entity/Horse.java b/paper-api/src/main/java/org/bukkit/entity/Horse.java index 48453875e6..ea2df61444 100644 --- a/paper-api/src/main/java/org/bukkit/entity/Horse.java +++ b/paper-api/src/main/java/org/bukkit/entity/Horse.java @@ -11,7 +11,7 @@ public interface Horse extends AbstractHorse { /** * @deprecated different variants are differing classes */ - @Deprecated + @Deprecated(since = "1.11") public enum Variant { /** * A normal horse @@ -154,14 +154,14 @@ public interface Horse extends AbstractHorse { * @return carrying chest status * @deprecated see {@link ChestedHorse} */ - @Deprecated + @Deprecated(since = "1.11") public boolean isCarryingChest(); /** * @param chest chest * @deprecated see {@link ChestedHorse} */ - @Deprecated + @Deprecated(since = "1.11") public void setCarryingChest(boolean chest); @NotNull diff --git a/paper-api/src/main/java/org/bukkit/entity/HumanEntity.java b/paper-api/src/main/java/org/bukkit/entity/HumanEntity.java index 29f9b380dd..b21f42e653 100644 --- a/paper-api/src/main/java/org/bukkit/entity/HumanEntity.java +++ b/paper-api/src/main/java/org/bukkit/entity/HumanEntity.java @@ -189,7 +189,7 @@ public interface HumanEntity extends LivingEntity, AnimalTamer, InventoryHolder * @deprecated Humans may now dual wield in their off hand, use explicit * methods in {@link PlayerInventory}. */ - @Deprecated + @Deprecated(since = "1.9") @NotNull public ItemStack getItemInHand(); @@ -201,7 +201,7 @@ public interface HumanEntity extends LivingEntity, AnimalTamer, InventoryHolder * @deprecated Humans may now dual wield in their off hand, use explicit * methods in {@link PlayerInventory}. */ - @Deprecated + @Deprecated(since = "1.9") public void setItemInHand(@Nullable ItemStack item); /** @@ -461,7 +461,7 @@ public interface HumanEntity extends LivingEntity, AnimalTamer, InventoryHolder * @deprecated There are currently no well defined semantics regarding * serialized entities in Bukkit. Use with care. */ - @Deprecated + @Deprecated(since = "1.12") @Nullable public Entity getShoulderEntityLeft(); @@ -479,7 +479,7 @@ public interface HumanEntity extends LivingEntity, AnimalTamer, InventoryHolder * @deprecated There are currently no well defined semantics regarding * serialized entities in Bukkit. Use with care. */ - @Deprecated + @Deprecated(since = "1.12") public void setShoulderEntityLeft(@Nullable Entity entity); /** @@ -493,7 +493,7 @@ public interface HumanEntity extends LivingEntity, AnimalTamer, InventoryHolder * @deprecated There are currently no well defined semantics regarding * serialized entities in Bukkit. Use with care. */ - @Deprecated + @Deprecated(since = "1.12") @Nullable public Entity getShoulderEntityRight(); @@ -511,7 +511,7 @@ public interface HumanEntity extends LivingEntity, AnimalTamer, InventoryHolder * @deprecated There are currently no well defined semantics regarding * serialized entities in Bukkit. Use with care. */ - @Deprecated + @Deprecated(since = "1.12") public void setShoulderEntityRight(@Nullable Entity entity); /** diff --git a/paper-api/src/main/java/org/bukkit/entity/LingeringPotion.java b/paper-api/src/main/java/org/bukkit/entity/LingeringPotion.java index bafef53c1d..949ba8410c 100644 --- a/paper-api/src/main/java/org/bukkit/entity/LingeringPotion.java +++ b/paper-api/src/main/java/org/bukkit/entity/LingeringPotion.java @@ -5,5 +5,5 @@ package org.bukkit.entity; * * @deprecated lingering status depends on only on the potion item. */ -@Deprecated +@Deprecated(since = "1.20.5") public interface LingeringPotion extends ThrownPotion { } diff --git a/paper-api/src/main/java/org/bukkit/entity/LivingEntity.java b/paper-api/src/main/java/org/bukkit/entity/LivingEntity.java index b5a302ba91..7afa4674a7 100644 --- a/paper-api/src/main/java/org/bukkit/entity/LivingEntity.java +++ b/paper-api/src/main/java/org/bukkit/entity/LivingEntity.java @@ -353,7 +353,7 @@ public interface LivingEntity extends Attributable, Damageable, ProjectileSource * @deprecated no need to force since multiple effects of the same type are * now supported. */ - @Deprecated + @Deprecated(since = "1.15.2") public boolean addPotionEffect(@NotNull PotionEffect effect, boolean force); /** @@ -771,7 +771,7 @@ public interface LivingEntity extends Attributable, Damageable, ProjectileSource * @deprecated entity groupings are now managed by tags, not categories */ @NotNull - @Deprecated + @Deprecated(since = "1.20.5") public EntityCategory getCategory(); /** diff --git a/paper-api/src/main/java/org/bukkit/entity/Ocelot.java b/paper-api/src/main/java/org/bukkit/entity/Ocelot.java index 35f970ca47..ce22fa2606 100644 --- a/paper-api/src/main/java/org/bukkit/entity/Ocelot.java +++ b/paper-api/src/main/java/org/bukkit/entity/Ocelot.java @@ -30,7 +30,7 @@ public interface Ocelot extends Animals { * @deprecated Cats are now a separate entity. */ @NotNull - @Deprecated + @Deprecated(since = "1.19.4") public Type getCatType(); /** @@ -39,7 +39,7 @@ public interface Ocelot extends Animals { * @param type New type of this cat. * @deprecated Cats are now a separate entity. */ - @Deprecated + @Deprecated(since = "1.19.4") public void setCatType(@NotNull Type type); /** @@ -47,7 +47,7 @@ public interface Ocelot extends Animals { * * @deprecated Cats are now a separate entity. */ - @Deprecated + @Deprecated(since = "1.14") public enum Type { WILD_OCELOT(0), BLACK_CAT(1), @@ -73,7 +73,7 @@ public interface Ocelot extends Animals { * @return Type ID. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public int getId() { return id; } @@ -85,7 +85,7 @@ public interface Ocelot extends Animals { * @return Resulting type, or null if not found. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Nullable public static Type getType(int id) { return (id >= types.length) ? null : types[id]; diff --git a/paper-api/src/main/java/org/bukkit/entity/PiglinAbstract.java b/paper-api/src/main/java/org/bukkit/entity/PiglinAbstract.java index 87f4b7ad7c..9c4c1a4ab3 100644 --- a/paper-api/src/main/java/org/bukkit/entity/PiglinAbstract.java +++ b/paper-api/src/main/java/org/bukkit/entity/PiglinAbstract.java @@ -55,7 +55,7 @@ public interface PiglinAbstract extends Monster, Ageable { * @return Whether the piglin is a baby * @deprecated see {@link Ageable#isAdult()} */ - @Deprecated + @Deprecated(since = "1.16.2") public boolean isBaby(); /** @@ -64,6 +64,6 @@ public interface PiglinAbstract extends Monster, Ageable { * @param flag Whether the piglin is a baby * @deprecated see {@link Ageable#setBaby()} and {@link Ageable#setAdult()} */ - @Deprecated + @Deprecated(since = "1.16.2") public void setBaby(boolean flag); } diff --git a/paper-api/src/main/java/org/bukkit/entity/Player.java b/paper-api/src/main/java/org/bukkit/entity/Player.java index 90c9424eab..3e044e1b48 100644 --- a/paper-api/src/main/java/org/bukkit/entity/Player.java +++ b/paper-api/src/main/java/org/bukkit/entity/Player.java @@ -360,7 +360,7 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM * context/time which it is accessed */ @Override - @Deprecated + @Deprecated(since = "1.16.1") public boolean isOnGround(); /** @@ -437,7 +437,7 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM */ @Nullable @Override - @Deprecated + @Deprecated(since = "1.20.4") public Location getBedSpawnLocation(); /** @@ -459,7 +459,7 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM * @deprecated Misleading name. This method sets the player's respawn * location more generally and is not limited to beds. */ - @Deprecated + @Deprecated(since = "1.20.4") public void setBedSpawnLocation(@Nullable Location location); /** @@ -480,7 +480,7 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM * @deprecated Misleading name. This method sets the player's respawn * location more generally and is not limited to beds. */ - @Deprecated + @Deprecated(since = "1.20.4") public void setBedSpawnLocation(@Nullable Location location, boolean force); /** @@ -525,7 +525,7 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM * @param note The note ID. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public void playNote(@NotNull Location loc, byte instrument, byte note); /** @@ -756,7 +756,7 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM * @param data a data bit needed for some effects * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public void playEffect(@NotNull Location loc, @NotNull Effect effect, int data); /** @@ -802,7 +802,7 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM * @param data The block data * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public void sendBlockChange(@NotNull Location loc, @NotNull Material material, byte data); /** @@ -856,7 +856,7 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM * @deprecated suppressLightUpdates is not functional in versions greater * than 1.19.4 */ - @Deprecated + @Deprecated(since = "1.20") public void sendBlockChanges(@NotNull Collection blocks, boolean suppressLightUpdates); /** @@ -1316,7 +1316,7 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM * @param player Player to hide * @deprecated see {@link #hidePlayer(Plugin, Player)} */ - @Deprecated + @Deprecated(since = "1.12.2") public void hidePlayer(@NotNull Player player); /** @@ -1333,7 +1333,7 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM * @param player Player to show * @deprecated see {@link #showPlayer(Plugin, Player)} */ - @Deprecated + @Deprecated(since = "1.12.2") public void showPlayer(@NotNull Player player); /** @@ -1463,7 +1463,7 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM * @deprecated Minecraft no longer uses textures packs. Instead you * should use {@link #setResourcePack(String)}. */ - @Deprecated + @Deprecated(since = "1.7.2") public void setTexturePack(@NotNull String url); /** @@ -1918,7 +1918,7 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM * @param subtitle Subtitle text * @deprecated API behavior subject to change */ - @Deprecated + @Deprecated(since = "1.8.7") public void sendTitle(@Nullable String title, @Nullable String subtitle); /** diff --git a/paper-api/src/main/java/org/bukkit/entity/Projectile.java b/paper-api/src/main/java/org/bukkit/entity/Projectile.java index 906b33b756..22d6dfdd8a 100644 --- a/paper-api/src/main/java/org/bukkit/entity/Projectile.java +++ b/paper-api/src/main/java/org/bukkit/entity/Projectile.java @@ -29,7 +29,7 @@ public interface Projectile extends Entity { * @return true if it should bounce. * @deprecated does not do anything */ - @Deprecated + @Deprecated(since = "1.20.2") public boolean doesBounce(); /** @@ -39,6 +39,6 @@ public interface Projectile extends Entity { * @param doesBounce whether or not it should bounce. * @deprecated does not do anything */ - @Deprecated + @Deprecated(since = "1.20.2") public void setBounce(boolean doesBounce); } diff --git a/paper-api/src/main/java/org/bukkit/entity/Skeleton.java b/paper-api/src/main/java/org/bukkit/entity/Skeleton.java index e0ccc090a0..0944d92030 100644 --- a/paper-api/src/main/java/org/bukkit/entity/Skeleton.java +++ b/paper-api/src/main/java/org/bukkit/entity/Skeleton.java @@ -48,7 +48,7 @@ public interface Skeleton extends AbstractSkeleton { * @deprecated classes are different types. This interface only remains in * the Skeleton interface to preserve backwards compatibility. */ - @Deprecated + @Deprecated(since = "1.11") public enum SkeletonType { /** diff --git a/paper-api/src/main/java/org/bukkit/entity/SplashPotion.java b/paper-api/src/main/java/org/bukkit/entity/SplashPotion.java index 9cb08fe720..e706a78e3a 100644 --- a/paper-api/src/main/java/org/bukkit/entity/SplashPotion.java +++ b/paper-api/src/main/java/org/bukkit/entity/SplashPotion.java @@ -5,5 +5,5 @@ package org.bukkit.entity; * * @deprecated splash status depends on only on the potion item. */ -@Deprecated +@Deprecated(since = "1.14") public interface SplashPotion extends ThrownPotion { } diff --git a/paper-api/src/main/java/org/bukkit/entity/TippedArrow.java b/paper-api/src/main/java/org/bukkit/entity/TippedArrow.java index 3193cc8a04..34bf641cbf 100644 --- a/paper-api/src/main/java/org/bukkit/entity/TippedArrow.java +++ b/paper-api/src/main/java/org/bukkit/entity/TippedArrow.java @@ -4,5 +4,5 @@ package org.bukkit.entity; * @deprecated tipped status depends only on base potion type not being * UNCRAFTABLE and effects being empty. */ -@Deprecated +@Deprecated(since = "1.14") public interface TippedArrow extends Arrow { } diff --git a/paper-api/src/main/java/org/bukkit/entity/Zoglin.java b/paper-api/src/main/java/org/bukkit/entity/Zoglin.java index ebf4ffac77..1db066d3ce 100644 --- a/paper-api/src/main/java/org/bukkit/entity/Zoglin.java +++ b/paper-api/src/main/java/org/bukkit/entity/Zoglin.java @@ -11,7 +11,7 @@ public interface Zoglin extends Monster, Ageable { * @return Whether the zoglin is a baby * @deprecated see {@link Ageable#isAdult()} */ - @Deprecated + @Deprecated(since = "1.6.2") public boolean isBaby(); /** @@ -20,6 +20,6 @@ public interface Zoglin extends Monster, Ageable { * @param flag Whether the zoglin is a baby * @deprecated see {@link Ageable#setBaby()} and {@link Ageable#setAdult()} */ - @Deprecated + @Deprecated(since = "1.16.2") public void setBaby(boolean flag); } diff --git a/paper-api/src/main/java/org/bukkit/entity/Zombie.java b/paper-api/src/main/java/org/bukkit/entity/Zombie.java index 336b3efaf0..c69eaf2ff5 100644 --- a/paper-api/src/main/java/org/bukkit/entity/Zombie.java +++ b/paper-api/src/main/java/org/bukkit/entity/Zombie.java @@ -14,7 +14,7 @@ public interface Zombie extends Monster, Ageable { * @return Whether the zombie is a baby * @deprecated see {@link Ageable#isAdult()} */ - @Deprecated + @Deprecated(since = "1.16.2") public boolean isBaby(); /** @@ -23,7 +23,7 @@ public interface Zombie extends Monster, Ageable { * @param flag Whether the zombie is a baby * @deprecated see {@link Ageable#setBaby()} and {@link Ageable#setAdult()} */ - @Deprecated + @Deprecated(since = "1.16.2") public void setBaby(boolean flag); /** @@ -32,14 +32,14 @@ public interface Zombie extends Monster, Ageable { * @return Whether the zombie is a villager * @deprecated check if instanceof {@link ZombieVillager}. */ - @Deprecated + @Deprecated(since = "1.10.2") public boolean isVillager(); /** * @param flag flag * @deprecated must spawn {@link ZombieVillager}. */ - @Deprecated + @Deprecated(since = "1.9") @Contract("_ -> fail") public void setVillager(boolean flag); @@ -47,7 +47,7 @@ public interface Zombie extends Monster, Ageable { * @param profession profession * @see ZombieVillager#getVillagerProfession() */ - @Deprecated + @Deprecated(since = "1.10.2") @Contract("_ -> fail") public void setVillagerProfession(Villager.Profession profession); @@ -55,7 +55,7 @@ public interface Zombie extends Monster, Ageable { * @return profession * @see ZombieVillager#getVillagerProfession() */ - @Deprecated + @Deprecated(since = "1.10.2") @Nullable @Contract("-> null") public Villager.Profession getVillagerProfession(); diff --git a/paper-api/src/main/java/org/bukkit/event/block/BlockBurnEvent.java b/paper-api/src/main/java/org/bukkit/event/block/BlockBurnEvent.java index c0c38df368..0b1737bcc5 100644 --- a/paper-api/src/main/java/org/bukkit/event/block/BlockBurnEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/block/BlockBurnEvent.java @@ -17,7 +17,7 @@ public class BlockBurnEvent extends BlockEvent implements Cancellable { private boolean cancelled; private final Block ignitingBlock; - @Deprecated + @Deprecated(since = "1.11.2") public BlockBurnEvent(@NotNull final Block block) { this(block, null); } diff --git a/paper-api/src/main/java/org/bukkit/event/block/BlockCanBuildEvent.java b/paper-api/src/main/java/org/bukkit/event/block/BlockCanBuildEvent.java index a1350c0f74..7d25012788 100644 --- a/paper-api/src/main/java/org/bukkit/event/block/BlockCanBuildEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/block/BlockCanBuildEvent.java @@ -26,7 +26,7 @@ public class BlockCanBuildEvent extends BlockEvent { protected BlockData blockData; private final Player player; - @Deprecated + @Deprecated(since = "1.13.2") public BlockCanBuildEvent(@NotNull final Block block, @NotNull final BlockData type, final boolean canBuild) { this(block, null, type, canBuild); } diff --git a/paper-api/src/main/java/org/bukkit/event/block/BlockPistonExtendEvent.java b/paper-api/src/main/java/org/bukkit/event/block/BlockPistonExtendEvent.java index 40ddc36497..6caecd53d9 100644 --- a/paper-api/src/main/java/org/bukkit/event/block/BlockPistonExtendEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/block/BlockPistonExtendEvent.java @@ -16,7 +16,7 @@ public class BlockPistonExtendEvent extends BlockPistonEvent { private final int length; private List blocks; - @Deprecated + @Deprecated(since = "1.8") public BlockPistonExtendEvent(@NotNull final Block block, final int length, @NotNull final BlockFace direction) { super(block, direction); @@ -37,7 +37,7 @@ public class BlockPistonExtendEvent extends BlockPistonEvent { * @deprecated slime blocks make the value of this method * inaccurate due to blocks being pushed at the side */ - @Deprecated + @Deprecated(since = "1.8") public int getLength() { return this.length; } diff --git a/paper-api/src/main/java/org/bukkit/event/block/BlockPistonRetractEvent.java b/paper-api/src/main/java/org/bukkit/event/block/BlockPistonRetractEvent.java index 340fa397e6..0392cc3a00 100644 --- a/paper-api/src/main/java/org/bukkit/event/block/BlockPistonRetractEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/block/BlockPistonRetractEvent.java @@ -26,7 +26,7 @@ public class BlockPistonRetractEvent extends BlockPistonEvent { * * @return The possible location of the possibly moving block. */ - @Deprecated + @Deprecated(since = "1.8") @NotNull public Location getRetractLocation() { return getBlock().getRelative(getDirection(), 2).getLocation(); diff --git a/paper-api/src/main/java/org/bukkit/event/block/BlockPlaceEvent.java b/paper-api/src/main/java/org/bukkit/event/block/BlockPlaceEvent.java index be0a2d1f23..77215c1dd2 100644 --- a/paper-api/src/main/java/org/bukkit/event/block/BlockPlaceEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/block/BlockPlaceEvent.java @@ -24,7 +24,7 @@ public class BlockPlaceEvent extends BlockEvent implements Cancellable { protected Player player; protected EquipmentSlot hand; - @Deprecated + @Deprecated(since = "1.9") public BlockPlaceEvent(@NotNull final Block placedBlock, @NotNull final BlockState replacedBlockState, @NotNull final Block placedAgainst, @NotNull final ItemStack itemInHand, @NotNull final Player thePlayer, final boolean canBuild) { this(placedBlock, replacedBlockState, placedAgainst, itemInHand, thePlayer, canBuild, EquipmentSlot.HAND); } diff --git a/paper-api/src/main/java/org/bukkit/event/block/CauldronLevelChangeEvent.java b/paper-api/src/main/java/org/bukkit/event/block/CauldronLevelChangeEvent.java index 891f3d250b..2b7d9b1e9e 100644 --- a/paper-api/src/main/java/org/bukkit/event/block/CauldronLevelChangeEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/block/CauldronLevelChangeEvent.java @@ -60,7 +60,7 @@ public class CauldronLevelChangeEvent extends BlockEvent implements Cancellable * @see #getBlock() * @deprecated not all cauldron contents are Levelled */ - @Deprecated + @Deprecated(since = "1.17") public int getOldLevel() { BlockData oldBlock = getBlock().getBlockData(); return (oldBlock instanceof Levelled) ? ((Levelled) oldBlock).getLevel() : ((oldBlock.getMaterial() == Material.CAULDRON) ? 0 : 3); @@ -73,7 +73,7 @@ public class CauldronLevelChangeEvent extends BlockEvent implements Cancellable * @see #getNewState() * @deprecated not all cauldron contents are Levelled */ - @Deprecated + @Deprecated(since = "1.17") public int getNewLevel() { BlockData newBlock = newState.getBlockData(); return (newBlock instanceof Levelled) ? ((Levelled) newBlock).getLevel() : ((newBlock.getMaterial() == Material.CAULDRON) ? 0 : 3); @@ -86,7 +86,7 @@ public class CauldronLevelChangeEvent extends BlockEvent implements Cancellable * @see #getNewState() * @deprecated not all cauldron contents are Levelled */ - @Deprecated + @Deprecated(since = "1.17") public void setNewLevel(int newLevel) { Preconditions.checkArgument(0 <= newLevel && newLevel <= 3, "Cauldron level out of bounds 0 <= %s <= 3", newLevel); if (newLevel == 0) { diff --git a/paper-api/src/main/java/org/bukkit/event/block/NotePlayEvent.java b/paper-api/src/main/java/org/bukkit/event/block/NotePlayEvent.java index a3887067d1..c9ecbebbc2 100644 --- a/paper-api/src/main/java/org/bukkit/event/block/NotePlayEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/block/NotePlayEvent.java @@ -60,7 +60,7 @@ public class NotePlayEvent extends BlockEvent implements Cancellable { * @param instrument the Instrument. Has no effect if null. * @deprecated no effect on newer Minecraft versions */ - @Deprecated + @Deprecated(since = "1.13") public void setInstrument(@NotNull Instrument instrument) { if (instrument != null) { this.instrument = instrument; @@ -73,7 +73,7 @@ public class NotePlayEvent extends BlockEvent implements Cancellable { * @param note the Note. Has no effect if null. * @deprecated no effect on newer Minecraft versions */ - @Deprecated + @Deprecated(since = "1.13") public void setNote(@NotNull Note note) { if (note != null) { this.note = note; diff --git a/paper-api/src/main/java/org/bukkit/event/block/SignChangeEvent.java b/paper-api/src/main/java/org/bukkit/event/block/SignChangeEvent.java index f4ac033ff8..5cf3a7890f 100644 --- a/paper-api/src/main/java/org/bukkit/event/block/SignChangeEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/block/SignChangeEvent.java @@ -20,7 +20,7 @@ public class SignChangeEvent extends BlockEvent implements Cancellable { private final String[] lines; private final Side side; - @Deprecated + @Deprecated(since = "1.19.4") public SignChangeEvent(@NotNull final Block theBlock, @NotNull final Player thePlayer, @NotNull final String[] theLines) { this(theBlock, thePlayer, theLines, Side.FRONT); } diff --git a/paper-api/src/main/java/org/bukkit/event/enchantment/PrepareItemEnchantEvent.java b/paper-api/src/main/java/org/bukkit/event/enchantment/PrepareItemEnchantEvent.java index 035c647f4d..a722e090e7 100644 --- a/paper-api/src/main/java/org/bukkit/event/enchantment/PrepareItemEnchantEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/enchantment/PrepareItemEnchantEvent.java @@ -69,7 +69,7 @@ public class PrepareItemEnchantEvent extends InventoryEvent implements Cancellab * @deprecated Use {@link #getOffers()} instead of this method */ @NotNull - @Deprecated + @Deprecated(since = "1.20.5") public int[] getExpLevelCostsOffered() { int[] levelOffers = new int[offers.length]; for (int i = 0; i < offers.length; i++) { diff --git a/paper-api/src/main/java/org/bukkit/event/entity/CreatureSpawnEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/CreatureSpawnEvent.java index d3f93163fb..c746c2e73a 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/CreatureSpawnEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/CreatureSpawnEvent.java @@ -57,7 +57,7 @@ public class CreatureSpawnEvent extends EntitySpawnEvent { * {@link ChunkLoadEvent#isNewChunk()} and {@link Chunk#getEntities()} * for similar effect. */ - @Deprecated + @Deprecated(since = "1.14") CHUNK_GEN, /** * When a creature spawns from a spawner diff --git a/paper-api/src/main/java/org/bukkit/event/entity/EntityCombustByBlockEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/EntityCombustByBlockEvent.java index 5baa058a00..3ef5b4254b 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/EntityCombustByBlockEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/EntityCombustByBlockEvent.java @@ -11,7 +11,7 @@ import org.jetbrains.annotations.Nullable; public class EntityCombustByBlockEvent extends EntityCombustEvent { private final Block combuster; - @Deprecated + @Deprecated(since = "1.21") public EntityCombustByBlockEvent(@Nullable final Block combuster, @NotNull final Entity combustee, final int duration) { this(combuster, combustee, (float) duration); } diff --git a/paper-api/src/main/java/org/bukkit/event/entity/EntityCombustByEntityEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/EntityCombustByEntityEvent.java index 46292ca9ea..eef8ab889b 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/EntityCombustByEntityEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/EntityCombustByEntityEvent.java @@ -9,7 +9,7 @@ import org.jetbrains.annotations.NotNull; public class EntityCombustByEntityEvent extends EntityCombustEvent { private final Entity combuster; - @Deprecated + @Deprecated(since = "1.21") public EntityCombustByEntityEvent(@NotNull final Entity combuster, @NotNull final Entity combustee, final int duration) { this(combuster, combustee, (float) duration); } diff --git a/paper-api/src/main/java/org/bukkit/event/entity/EntityCombustEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/EntityCombustEvent.java index 0cf765564b..1f0f09bcf5 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/EntityCombustEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/EntityCombustEvent.java @@ -15,7 +15,7 @@ public class EntityCombustEvent extends EntityEvent implements Cancellable { private float duration; private boolean cancel; - @Deprecated + @Deprecated(since = "1.21") public EntityCombustEvent(@NotNull final Entity combustee, final int duration) { this(combustee, (float) duration); } @@ -66,7 +66,7 @@ public class EntityCombustEvent extends EntityEvent implements Cancellable { * @see #setDuration(float) * @deprecated duration is now a float */ - @Deprecated(forRemoval = true) + @Deprecated(since = "1.21", forRemoval = true) public void setDuration(int duration) { this.duration = duration; } diff --git a/paper-api/src/main/java/org/bukkit/event/entity/EntityCreatePortalEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/EntityCreatePortalEvent.java index 397baaefd2..cdfecdc98c 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/EntityCreatePortalEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/EntityCreatePortalEvent.java @@ -14,7 +14,7 @@ import org.jetbrains.annotations.NotNull; * * @deprecated Use {@link PortalCreateEvent} */ -@Deprecated +@Deprecated(since = "1.14.1") public class EntityCreatePortalEvent extends EntityEvent implements Cancellable { private static final HandlerList handlers = new HandlerList(); private final List blocks; diff --git a/paper-api/src/main/java/org/bukkit/event/entity/EntityDamageByBlockEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/EntityDamageByBlockEvent.java index 573165ddf3..0a3699226b 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/EntityDamageByBlockEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/EntityDamageByBlockEvent.java @@ -17,7 +17,7 @@ public class EntityDamageByBlockEvent extends EntityDamageEvent { private final Block damager; private final BlockState damagerState; - @Deprecated(forRemoval = true) + @Deprecated(since = "1.20.4", forRemoval = true) public EntityDamageByBlockEvent(@Nullable final Block damager, @NotNull final Entity damagee, @NotNull final DamageCause cause, final double damage) { this(damager, (damager != null) ? damager.getState() : null, damagee, cause, (damager != null) ? DamageSource.builder(DamageType.GENERIC).withDamageLocation(damager.getLocation()).build() : DamageSource.builder(DamageType.GENERIC).build(), damage); } @@ -28,7 +28,7 @@ public class EntityDamageByBlockEvent extends EntityDamageEvent { this.damagerState = damagerState; } - @Deprecated(forRemoval = true) + @Deprecated(since = "1.20.4", forRemoval = true) public EntityDamageByBlockEvent(@Nullable final Block damager, @NotNull final Entity damagee, @NotNull final DamageCause cause, @NotNull final Map modifiers, @NotNull final Map> modifierFunctions) { this(damager, (damager != null) ? damager.getState() : null, damagee, cause, (damager != null) ? DamageSource.builder(DamageType.GENERIC).withDamageLocation(damager.getLocation()).build() : DamageSource.builder(DamageType.GENERIC).build(), modifiers, modifierFunctions); } diff --git a/paper-api/src/main/java/org/bukkit/event/entity/EntityDamageByEntityEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/EntityDamageByEntityEvent.java index 04449ef55c..ca6f0fa51f 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/EntityDamageByEntityEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/EntityDamageByEntityEvent.java @@ -13,7 +13,7 @@ import org.jetbrains.annotations.NotNull; public class EntityDamageByEntityEvent extends EntityDamageEvent { private final Entity damager; - @Deprecated(forRemoval = true) + @Deprecated(since = "1.20.4", forRemoval = true) public EntityDamageByEntityEvent(@NotNull final Entity damager, @NotNull final Entity damagee, @NotNull final DamageCause cause, final double damage) { this(damager, damagee, cause, DamageSource.builder(DamageType.GENERIC).withCausingEntity(damager).withDirectEntity(damager).build(), damage); } @@ -23,7 +23,7 @@ public class EntityDamageByEntityEvent extends EntityDamageEvent { this.damager = damager; } - @Deprecated(forRemoval = true) + @Deprecated(since = "1.20.4", forRemoval = true) public EntityDamageByEntityEvent(@NotNull final Entity damager, @NotNull final Entity damagee, @NotNull final DamageCause cause, @NotNull final Map modifiers, @NotNull final Map> modifierFunctions) { this(damager, damagee, cause, DamageSource.builder(DamageType.GENERIC).withCausingEntity(damager).withDirectEntity(damager).build(), modifiers, modifierFunctions); } diff --git a/paper-api/src/main/java/org/bukkit/event/entity/EntityDamageEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/EntityDamageEvent.java index ef5b2a0f18..4e6b1c2639 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/EntityDamageEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/EntityDamageEvent.java @@ -31,7 +31,7 @@ public class EntityDamageEvent extends EntityEvent implements Cancellable { private final DamageCause cause; private final DamageSource damageSource; - @Deprecated(forRemoval = true) + @Deprecated(since = "1.20.4", forRemoval = true) public EntityDamageEvent(@NotNull final Entity damagee, @NotNull final DamageCause cause, final double damage) { this(damagee, cause, DamageSource.builder(DamageType.GENERIC).build(), damage); } @@ -40,7 +40,7 @@ public class EntityDamageEvent extends EntityEvent implements Cancellable { this(damagee, cause, damageSource, new EnumMap(ImmutableMap.of(DamageModifier.BASE, damage)), new EnumMap>(ImmutableMap.of(DamageModifier.BASE, ZERO))); } - @Deprecated(forRemoval = true) + @Deprecated(since = "1.20.4", forRemoval = true) public EntityDamageEvent(@NotNull final Entity damagee, @NotNull final DamageCause cause, @NotNull final Map modifiers, @NotNull final Map> modifierFunctions) { this(damagee, cause, DamageSource.builder(DamageType.GENERIC).build(), modifiers, modifierFunctions); } @@ -240,7 +240,7 @@ public class EntityDamageEvent extends EntityEvent implements Cancellable { * removed very soon in a subsequent release. Please see * this thread for more information. */ - @Deprecated + @Deprecated(since = "1.12") public enum DamageModifier { /** * This represents the amount of damage being done, also known as the diff --git a/paper-api/src/main/java/org/bukkit/event/entity/EntityPlaceEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/EntityPlaceEvent.java index 327876e0ad..4f11695607 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/EntityPlaceEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/EntityPlaceEvent.java @@ -34,7 +34,7 @@ public class EntityPlaceEvent extends EntityEvent implements Cancellable { this.hand = hand; } - @Deprecated + @Deprecated(since = "1.19.2") public EntityPlaceEvent(@NotNull final Entity entity, @Nullable final Player player, @NotNull final Block block, @NotNull final BlockFace blockFace) { this(entity, player, block, blockFace, EquipmentSlot.HAND); } diff --git a/paper-api/src/main/java/org/bukkit/event/entity/EntityResurrectEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/EntityResurrectEvent.java index 2f6ad5c2fc..372825dc8a 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/EntityResurrectEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/EntityResurrectEvent.java @@ -25,7 +25,7 @@ public class EntityResurrectEvent extends EntityEvent implements Cancellable { this.hand = hand; } - @Deprecated + @Deprecated(since = "1.19.2") public EntityResurrectEvent(@NotNull LivingEntity what) { this(what, null); } diff --git a/paper-api/src/main/java/org/bukkit/event/entity/EntityShootBowEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/EntityShootBowEvent.java index 1a8366f675..8200ac4e29 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/EntityShootBowEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/EntityShootBowEvent.java @@ -114,7 +114,7 @@ public class EntityShootBowEvent extends EntityEvent implements Cancellable { * @param consumeItem whether or not to consume the item * @deprecated not currently functional */ - @Deprecated + @Deprecated(since = "1.20.5") public void setConsumeItem(boolean consumeItem) { this.consumeItem = consumeItem; } diff --git a/paper-api/src/main/java/org/bukkit/event/entity/EntityTargetEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/EntityTargetEvent.java index dee186e994..842cfd3e98 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/EntityTargetEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/EntityTargetEvent.java @@ -105,7 +105,7 @@ public class EntityTargetEvent extends EntityEvent implements Cancellable { * * @deprecated obsoleted by {@link #TARGET_ATTACKED_NEARBY_ENTITY} */ - @Deprecated + @Deprecated(since = "1.13") PIG_ZOMBIE_TARGET, /** * When the target is forgotten for whatever reason. diff --git a/paper-api/src/main/java/org/bukkit/event/entity/ExpBottleEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/ExpBottleEvent.java index 997c86b032..7e7132a065 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/ExpBottleEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/ExpBottleEvent.java @@ -16,7 +16,7 @@ public class ExpBottleEvent extends ProjectileHitEvent { private int exp; private boolean showEffect = true; - @Deprecated + @Deprecated(since = "1.20.2") public ExpBottleEvent(@NotNull final ThrownExpBottle bottle, final int exp) { this(bottle, null, null, null, exp); } diff --git a/paper-api/src/main/java/org/bukkit/event/entity/HorseJumpEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/HorseJumpEvent.java index 65b1ddb2b2..e8b060d1a8 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/HorseJumpEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/HorseJumpEvent.java @@ -27,7 +27,7 @@ public class HorseJumpEvent extends EntityEvent implements Cancellable { * @deprecated horse jumping was moved client side. */ @Override - @Deprecated + @Deprecated(since = "1.9") public void setCancelled(boolean cancel) { cancelled = cancel; } @@ -72,7 +72,7 @@ public class HorseJumpEvent extends EntityEvent implements Cancellable { * @param power power of the jump * @deprecated horse jumping was moved client side. */ - @Deprecated + @Deprecated(since = "1.9") public void setPower(float power) { this.power = power; } diff --git a/paper-api/src/main/java/org/bukkit/event/entity/ItemSpawnEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/ItemSpawnEvent.java index faf98bb59a..b38e27605a 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/ItemSpawnEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/ItemSpawnEvent.java @@ -9,7 +9,7 @@ import org.jetbrains.annotations.NotNull; */ public class ItemSpawnEvent extends EntitySpawnEvent { - @Deprecated + @Deprecated(since = "1.13.2") public ItemSpawnEvent(@NotNull final Item spawnee, final Location loc) { this(spawnee); } diff --git a/paper-api/src/main/java/org/bukkit/event/entity/LingeringPotionSplashEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/LingeringPotionSplashEvent.java index 1584c6c41c..581241d066 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/LingeringPotionSplashEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/LingeringPotionSplashEvent.java @@ -18,7 +18,7 @@ public class LingeringPotionSplashEvent extends ProjectileHitEvent implements Ca private boolean cancelled; private final AreaEffectCloud entity; - @Deprecated + @Deprecated(since = "1.20.2") public LingeringPotionSplashEvent(@NotNull final ThrownPotion potion, @NotNull final AreaEffectCloud entity) { this(potion, null, null, null, entity); } diff --git a/paper-api/src/main/java/org/bukkit/event/entity/PigZapEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/PigZapEvent.java index 0e0ed93b56..c5aa91c68e 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/PigZapEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/PigZapEvent.java @@ -58,7 +58,7 @@ public class PigZapEvent extends EntityTransformEvent implements Cancellable { * @deprecated use {@link EntityTransformEvent#getTransformedEntity()} */ @NotNull - @Deprecated + @Deprecated(since = "1.13.2") public PigZombie getPigZombie() { return pigzombie; } diff --git a/paper-api/src/main/java/org/bukkit/event/entity/PlayerLeashEntityEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/PlayerLeashEntityEvent.java index 883d54dc0c..d7205c2b50 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/PlayerLeashEntityEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/PlayerLeashEntityEvent.java @@ -26,7 +26,7 @@ public class PlayerLeashEntityEvent extends Event implements Cancellable { this.hand = hand; } - @Deprecated + @Deprecated(since = "1.19.2") public PlayerLeashEntityEvent(@NotNull Entity what, @NotNull Entity leashHolder, @NotNull Player leasher) { this(what, leashHolder, leasher, EquipmentSlot.HAND); } diff --git a/paper-api/src/main/java/org/bukkit/event/entity/PotionSplashEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/PotionSplashEvent.java index bc6ba6c4c0..ef6b3a5f6a 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/PotionSplashEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/PotionSplashEvent.java @@ -22,7 +22,7 @@ public class PotionSplashEvent extends ProjectileHitEvent implements Cancellable private boolean cancelled; private final Map affectedEntities; - @Deprecated + @Deprecated(since = "1.20.2") public PotionSplashEvent(@NotNull final ThrownPotion potion, @NotNull final Map affectedEntities) { this(potion, null, null, null, affectedEntities); } diff --git a/paper-api/src/main/java/org/bukkit/event/entity/SheepDyeWoolEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/SheepDyeWoolEvent.java index 10d2466fb6..d93a7efd0f 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/SheepDyeWoolEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/SheepDyeWoolEvent.java @@ -17,7 +17,7 @@ public class SheepDyeWoolEvent extends EntityEvent implements Cancellable { private DyeColor color; private final Player player; - @Deprecated + @Deprecated(since = "1.17.1") public SheepDyeWoolEvent(@NotNull final Sheep sheep, @NotNull final DyeColor color) { this(sheep, color, null); } diff --git a/paper-api/src/main/java/org/bukkit/event/entity/VillagerReplenishTradeEvent.java b/paper-api/src/main/java/org/bukkit/event/entity/VillagerReplenishTradeEvent.java index c6d849af00..f1dc767ebe 100644 --- a/paper-api/src/main/java/org/bukkit/event/entity/VillagerReplenishTradeEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/entity/VillagerReplenishTradeEvent.java @@ -52,7 +52,7 @@ public class VillagerReplenishTradeEvent extends EntityEvent implements Cancella * @deprecated MC 1.14 has changed how villagers restock their trades. Use * {@link MerchantRecipe#getUses()}. */ - @Deprecated + @Deprecated(since = "1.18.1") public int getBonus() { return recipe.getUses(); } @@ -64,7 +64,7 @@ public class VillagerReplenishTradeEvent extends EntityEvent implements Cancella * @deprecated MC 1.14 has changed how villagers restock their trades. This * has no effect anymore. */ - @Deprecated + @Deprecated(since = "1.18.1") public void setBonus(int bonus) { } diff --git a/paper-api/src/main/java/org/bukkit/event/hanging/HangingPlaceEvent.java b/paper-api/src/main/java/org/bukkit/event/hanging/HangingPlaceEvent.java index cc5781f276..6bcc20ceaf 100644 --- a/paper-api/src/main/java/org/bukkit/event/hanging/HangingPlaceEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/hanging/HangingPlaceEvent.java @@ -23,7 +23,7 @@ public class HangingPlaceEvent extends HangingEvent implements Cancellable { private final EquipmentSlot hand; private final ItemStack itemStack; - @Deprecated + @Deprecated(since = "1.17.1") public HangingPlaceEvent(@NotNull final Hanging hanging, @Nullable final Player player, @NotNull final Block block, @NotNull final BlockFace blockFace, @Nullable final EquipmentSlot hand) { this(hanging, player, block, blockFace, hand, null); } diff --git a/paper-api/src/main/java/org/bukkit/event/inventory/InventoryClickEvent.java b/paper-api/src/main/java/org/bukkit/event/inventory/InventoryClickEvent.java index 79797a2be7..e1f0ae392c 100644 --- a/paper-api/src/main/java/org/bukkit/event/inventory/InventoryClickEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/inventory/InventoryClickEvent.java @@ -144,7 +144,7 @@ public class InventoryClickEvent extends InventoryInteractEvent { * create inconsistencies between the Player and the server, and to * make unexpected changes in the behavior of the clicked Inventory. */ - @Deprecated + @Deprecated(since = "1.5.2") public void setCursor(@Nullable ItemStack stack) { getView().setCursor(stack); } diff --git a/paper-api/src/main/java/org/bukkit/event/inventory/InventoryType.java b/paper-api/src/main/java/org/bukkit/event/inventory/InventoryType.java index 094963b16e..c2af9a9832 100644 --- a/paper-api/src/main/java/org/bukkit/event/inventory/InventoryType.java +++ b/paper-api/src/main/java/org/bukkit/event/inventory/InventoryType.java @@ -155,7 +155,7 @@ public enum InventoryType { * * @deprecated use {@link #SMITHING} */ - @Deprecated + @Deprecated(since = "1.20.1") SMITHING_NEW(4, "Upgrade Gear", MenuType.SMITHING), ; diff --git a/paper-api/src/main/java/org/bukkit/event/player/AsyncPlayerChatPreviewEvent.java b/paper-api/src/main/java/org/bukkit/event/player/AsyncPlayerChatPreviewEvent.java index 2ce4d3b253..ee7a99a0c9 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/AsyncPlayerChatPreviewEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/AsyncPlayerChatPreviewEvent.java @@ -13,7 +13,7 @@ import org.jetbrains.annotations.NotNull; * * @deprecated chat previews have been removed */ -@Deprecated +@Deprecated(since = "1.19.1") @Warning(false) public class AsyncPlayerChatPreviewEvent extends AsyncPlayerChatEvent { diff --git a/paper-api/src/main/java/org/bukkit/event/player/AsyncPlayerPreLoginEvent.java b/paper-api/src/main/java/org/bukkit/event/player/AsyncPlayerPreLoginEvent.java index 7ca90f318a..23257ae395 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/AsyncPlayerPreLoginEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/AsyncPlayerPreLoginEvent.java @@ -20,12 +20,12 @@ public class AsyncPlayerPreLoginEvent extends Event { private final UUID uniqueId; private final boolean transferred; - @Deprecated + @Deprecated(since = "1.7.5") public AsyncPlayerPreLoginEvent(@NotNull final String name, @NotNull final InetAddress ipAddress) { this(name, ipAddress, null); } - @Deprecated + @Deprecated(since = "1.20.5") public AsyncPlayerPreLoginEvent(@NotNull final String name, @NotNull final InetAddress ipAddress, @NotNull final UUID uniqueId) { this(name, ipAddress, uniqueId, false); } @@ -58,7 +58,7 @@ public class AsyncPlayerPreLoginEvent extends Event { * @deprecated This method uses a deprecated enum from {@link * PlayerPreLoginEvent} */ - @Deprecated + @Deprecated(since = "1.3.2") @NotNull public PlayerPreLoginEvent.Result getResult() { return result == null ? null : result.old(); @@ -81,7 +81,7 @@ public class AsyncPlayerPreLoginEvent extends Event { * @deprecated This method uses a deprecated enum from {@link * PlayerPreLoginEvent} */ - @Deprecated + @Deprecated(since = "1.3.2") public void setResult(@NotNull final PlayerPreLoginEvent.Result result) { this.result = result == null ? null : Result.valueOf(result.name()); } @@ -134,7 +134,7 @@ public class AsyncPlayerPreLoginEvent extends Event { * @deprecated This method uses a deprecated enum from {@link * PlayerPreLoginEvent} */ - @Deprecated + @Deprecated(since = "1.3.2") public void disallow(@NotNull final PlayerPreLoginEvent.Result result, @NotNull final String message) { this.result = result == null ? null : Result.valueOf(result.name()); this.message = message; @@ -217,7 +217,7 @@ public class AsyncPlayerPreLoginEvent extends Event { */ KICK_OTHER; - @Deprecated + @Deprecated(since = "1.3.2") @NotNull private PlayerPreLoginEvent.Result old() { return PlayerPreLoginEvent.Result.valueOf(name()); diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerAnimationEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerAnimationEvent.java index eb722a1e3b..1f2d3b3e97 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/PlayerAnimationEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerAnimationEvent.java @@ -13,7 +13,7 @@ public class PlayerAnimationEvent extends PlayerEvent implements Cancellable { private final PlayerAnimationType animationType; private boolean isCancelled = false; - @Deprecated + @Deprecated(since = "1.19") public PlayerAnimationEvent(@NotNull final Player player) { this(player, PlayerAnimationType.ARM_SWING); } diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerArmorStandManipulateEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerArmorStandManipulateEvent.java index f1391d834b..75154912b0 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/PlayerArmorStandManipulateEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerArmorStandManipulateEvent.java @@ -26,7 +26,7 @@ public class PlayerArmorStandManipulateEvent extends PlayerInteractEntityEvent { this.slot = slot; } - @Deprecated + @Deprecated(since = "1.19.2") public PlayerArmorStandManipulateEvent(@NotNull final Player who, @NotNull final ArmorStand clickedEntity, @NotNull final ItemStack playerItem, @NotNull final ItemStack armorStandItem, @NotNull final EquipmentSlot slot) { this(who, clickedEntity, playerItem, armorStandItem, slot, EquipmentSlot.HAND); } diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerBedEnterEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerBedEnterEvent.java index fd6b83f1f9..567e331f6c 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/PlayerBedEnterEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerBedEnterEvent.java @@ -63,7 +63,7 @@ public class PlayerBedEnterEvent extends PlayerEvent implements Cancellable { this.bedEnterResult = bedEnterResult; } - @Deprecated + @Deprecated(since = "1.13.2") public PlayerBedEnterEvent(@NotNull Player who, @NotNull Block bed) { this(who, bed, BedEnterResult.OK); } diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerBucketEmptyEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerBucketEmptyEvent.java index 5cd2dc9d7b..bea5b52f6b 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/PlayerBucketEmptyEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerBucketEmptyEvent.java @@ -15,12 +15,12 @@ import org.jetbrains.annotations.NotNull; public class PlayerBucketEmptyEvent extends PlayerBucketEvent { private static final HandlerList handlers = new HandlerList(); - @Deprecated + @Deprecated(since = "1.14.4") public PlayerBucketEmptyEvent(@NotNull final Player who, @NotNull final Block blockClicked, @NotNull final BlockFace blockFace, @NotNull final Material bucket, @NotNull final ItemStack itemInHand) { super(who, blockClicked, blockFace, bucket, itemInHand); } - @Deprecated + @Deprecated(since = "1.19.2") public PlayerBucketEmptyEvent(@NotNull final Player who, @NotNull final Block block, @NotNull final Block blockClicked, @NotNull final BlockFace blockFace, @NotNull final Material bucket, @NotNull final ItemStack itemInHand) { super(who, block, blockClicked, blockFace, bucket, itemInHand); } diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerBucketEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerBucketEvent.java index ab045b73ef..71f18c2b4d 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/PlayerBucketEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerBucketEvent.java @@ -24,12 +24,12 @@ public abstract class PlayerBucketEvent extends PlayerEvent implements Cancellab private final Material bucket; private final EquipmentSlot hand; - @Deprecated + @Deprecated(since = "1.14.4") public PlayerBucketEvent(@NotNull final Player who, @NotNull final Block blockClicked, @NotNull final BlockFace blockFace, @NotNull final Material bucket, @NotNull final ItemStack itemInHand) { this(who, null, blockClicked.getRelative(blockFace), blockFace, bucket, itemInHand, EquipmentSlot.HAND); } - @Deprecated + @Deprecated(since = "1.19.2") public PlayerBucketEvent(@NotNull final Player who, @NotNull final Block block, @NotNull final Block blockClicked, @NotNull final BlockFace blockFace, @NotNull final Material bucket, @NotNull final ItemStack itemInHand) { this(who, block, blockClicked, blockFace, bucket, itemInHand, EquipmentSlot.HAND); } diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerBucketFillEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerBucketFillEvent.java index 987a51c1da..3789b1a56f 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/PlayerBucketFillEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerBucketFillEvent.java @@ -15,12 +15,12 @@ import org.jetbrains.annotations.NotNull; public class PlayerBucketFillEvent extends PlayerBucketEvent { private static final HandlerList handlers = new HandlerList(); - @Deprecated + @Deprecated(since = "1.14.4") public PlayerBucketFillEvent(@NotNull final Player who, @NotNull final Block blockClicked, @NotNull final BlockFace blockFace, @NotNull final Material bucket, @NotNull final ItemStack itemInHand) { super(who, blockClicked, blockFace, bucket, itemInHand); } - @Deprecated + @Deprecated(since = "1.19.2") public PlayerBucketFillEvent(@NotNull final Player who, @NotNull final Block block, @NotNull final Block blockClicked, @NotNull final BlockFace blockFace, @NotNull final Material bucket, @NotNull final ItemStack itemInHand) { super(who, block, blockClicked, blockFace, bucket, itemInHand); } diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerBucketFishEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerBucketFishEvent.java index 5f1fbb82d4..2821347fcc 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/PlayerBucketFishEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerBucketFishEvent.java @@ -13,7 +13,7 @@ import org.jetbrains.annotations.NotNull; * * @deprecated Use the more generic {@link PlayerBucketEntityEvent} */ -@Deprecated +@Deprecated(since = "1.16.5") @Warning(false) public class PlayerBucketFishEvent extends PlayerBucketEntityEvent { @@ -41,7 +41,7 @@ public class PlayerBucketFishEvent extends PlayerBucketEntityEvent { * @deprecated Use {@link #getOriginalBucket()} */ @NotNull - @Deprecated + @Deprecated(since = "1.16.5") public ItemStack getWaterBucket() { return getOriginalBucket(); } @@ -56,7 +56,7 @@ public class PlayerBucketFishEvent extends PlayerBucketEntityEvent { * @deprecated Use {@link #getEntityBucket()} */ @NotNull - @Deprecated + @Deprecated(since = "1.16.5") public ItemStack getFishBucket() { return getEntityBucket(); } diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerChatEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerChatEvent.java index a1f4261eaa..eb1018a84a 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/PlayerChatEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerChatEvent.java @@ -19,7 +19,7 @@ import org.jetbrains.annotations.NotNull; * causes delays for chat. {@link AsyncPlayerChatEvent} is the encouraged * alternative for thread safe implementations. */ -@Deprecated +@Deprecated(since = "1.3.1") @Warning(reason = "Listening to this event forces chat to wait for the main thread, delaying chat messages.") public class PlayerChatEvent extends PlayerEvent implements Cancellable { private static final HandlerList handlers = new HandlerList(); diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerChatTabCompleteEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerChatTabCompleteEvent.java index 93191b7e32..b13394e427 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/PlayerChatTabCompleteEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerChatTabCompleteEvent.java @@ -12,7 +12,7 @@ import org.jetbrains.annotations.NotNull; * * @deprecated This event is no longer fired due to client changes */ -@Deprecated +@Deprecated(since = "1.13") @Warning(reason = "This event is no longer fired due to client changes") public class PlayerChatTabCompleteEvent extends PlayerEvent { private static final HandlerList handlers = new HandlerList(); diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerCommandPreprocessEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerCommandPreprocessEvent.java index 48a00fb50f..c3eb020498 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/PlayerCommandPreprocessEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerCommandPreprocessEvent.java @@ -127,7 +127,7 @@ public class PlayerCommandPreprocessEvent extends PlayerEvent implements Cancell * guarantee to the effect of viewing or modifying the set. */ @NotNull - @Deprecated + @Deprecated(since = "1.3.1") public Set getRecipients() { return recipients; } diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerEditBookEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerEditBookEvent.java index 8c5f1f5892..d716a9df07 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/PlayerEditBookEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerEditBookEvent.java @@ -74,7 +74,7 @@ public class PlayerEditBookEvent extends PlayerEvent implements Cancellable { * @return the inventory slot number that the book item occupies * @deprecated books may be signed from off hand */ - @Deprecated + @Deprecated(since = "1.13.1") public int getSlot() { return slot; } diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerHarvestBlockEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerHarvestBlockEvent.java index 5cd4b1311b..805aa20105 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/PlayerHarvestBlockEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerHarvestBlockEvent.java @@ -34,7 +34,7 @@ public class PlayerHarvestBlockEvent extends PlayerEvent implements Cancellable this.itemsHarvested = itemsHarvested; } - @Deprecated + @Deprecated(since = "1.19.2") public PlayerHarvestBlockEvent(@NotNull Player player, @NotNull Block harvestedBlock, @NotNull List itemsHarvested) { this(player, harvestedBlock, EquipmentSlot.HAND, itemsHarvested); } diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerInteractEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerInteractEvent.java index ed72095b5c..35e0df9fc0 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/PlayerInteractEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerInteractEvent.java @@ -79,7 +79,7 @@ public class PlayerInteractEvent extends PlayerEvent implements Cancellable { * the case of using a firework whilst gliding. Callers should check the * relevant methods individually. */ - @Deprecated + @Deprecated(since = "1.14") @Override public boolean isCancelled() { return useInteractedBlock() == Result.DENY; diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerItemConsumeEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerItemConsumeEvent.java index 5c054eb531..36b16b6076 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/PlayerItemConsumeEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerItemConsumeEvent.java @@ -42,7 +42,7 @@ public class PlayerItemConsumeEvent extends PlayerEvent implements Cancellable { * @param item the ItemStack being consumed * @deprecated use {@link #PlayerItemConsumeEvent(Player, ItemStack, EquipmentSlot)} */ - @Deprecated + @Deprecated(since = "1.19.2") public PlayerItemConsumeEvent(@NotNull final Player player, @NotNull final ItemStack item) { this(player, item, EquipmentSlot.HAND); } diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerItemMendEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerItemMendEvent.java index 5b2415c2c9..cfbd0b42ae 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/PlayerItemMendEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerItemMendEvent.java @@ -32,7 +32,7 @@ public class PlayerItemMendEvent extends PlayerEvent implements Cancellable { this.repairAmount = repairAmount; } - @Deprecated + @Deprecated(since = "1.19.2") public PlayerItemMendEvent(@NotNull Player who, @NotNull ItemStack item, @NotNull ExperienceOrb experienceOrb, int repairAmount) { this(who, item, null, experienceOrb, repairAmount); } diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerPickupItemEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerPickupItemEvent.java index 951ea2cc76..a73d1b9717 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/PlayerPickupItemEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerPickupItemEvent.java @@ -12,7 +12,7 @@ import org.jetbrains.annotations.NotNull; * Thrown when a player picks an item up from the ground * @deprecated {@link EntityPickupItemEvent} */ -@Deprecated +@Deprecated(since = "1.12") @Warning(false) public class PlayerPickupItemEvent extends PlayerEvent implements Cancellable { private static final HandlerList handlers = new HandlerList(); diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerPreLoginEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerPreLoginEvent.java index fb066251f7..203d030dbb 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/PlayerPreLoginEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerPreLoginEvent.java @@ -14,7 +14,7 @@ import org.jetbrains.annotations.NotNull; * AsyncPlayerPreLoginEvent} is preferred to keep the secondary threads * asynchronous. */ -@Deprecated +@Deprecated(since = "1.3.2") @Warning(reason = "This event causes a login thread to synchronize with the main thread") public class PlayerPreLoginEvent extends Event { private static final HandlerList handlers = new HandlerList(); @@ -24,7 +24,7 @@ public class PlayerPreLoginEvent extends Event { private final InetAddress ipAddress; private final UUID uniqueId; - @Deprecated + @Deprecated(since = "1.7.5") public PlayerPreLoginEvent(@NotNull final String name, @NotNull final InetAddress ipAddress) { this(name, ipAddress, null); } diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerRespawnEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerRespawnEvent.java index c3d9d95be5..d6b4c81ef5 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/PlayerRespawnEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerRespawnEvent.java @@ -16,12 +16,12 @@ public class PlayerRespawnEvent extends PlayerEvent { private final boolean isAnchorSpawn; private final RespawnReason respawnReason; - @Deprecated + @Deprecated(since = "1.16.1") public PlayerRespawnEvent(@NotNull final Player respawnPlayer, @NotNull final Location respawnLocation, final boolean isBedSpawn) { this(respawnPlayer, respawnLocation, isBedSpawn, false); } - @Deprecated + @Deprecated(since = "1.19.4") public PlayerRespawnEvent(@NotNull final Player respawnPlayer, @NotNull final Location respawnLocation, final boolean isBedSpawn, final boolean isAnchorSpawn) { this(respawnPlayer, respawnLocation, isBedSpawn, false, RespawnReason.PLUGIN); } diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerRiptideEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerRiptideEvent.java index b16fd4433d..a3f63b908a 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/PlayerRiptideEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerRiptideEvent.java @@ -25,7 +25,7 @@ public class PlayerRiptideEvent extends PlayerEvent { this.velocity = velocity; } - @Deprecated + @Deprecated(since = "1.20.4") public PlayerRiptideEvent(@NotNull final Player who, @NotNull final ItemStack item) { this(who, item, new Vector()); } diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerShearEntityEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerShearEntityEvent.java index 04b3dce008..2616943d29 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/PlayerShearEntityEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerShearEntityEvent.java @@ -26,7 +26,7 @@ public class PlayerShearEntityEvent extends PlayerEvent implements Cancellable { this.hand = hand; } - @Deprecated + @Deprecated(since = "1.15.2") public PlayerShearEntityEvent(@NotNull final Player who, @NotNull final Entity what) { this(who, what, new ItemStack(Material.SHEARS), EquipmentSlot.HAND); } diff --git a/paper-api/src/main/java/org/bukkit/event/player/PlayerUnleashEntityEvent.java b/paper-api/src/main/java/org/bukkit/event/player/PlayerUnleashEntityEvent.java index 075af9c1c1..e6b4ffea88 100644 --- a/paper-api/src/main/java/org/bukkit/event/player/PlayerUnleashEntityEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/player/PlayerUnleashEntityEvent.java @@ -23,7 +23,7 @@ public class PlayerUnleashEntityEvent extends EntityUnleashEvent implements Canc this.hand = hand; } - @Deprecated + @Deprecated(since = "1.19.2") public PlayerUnleashEntityEvent(@NotNull Entity entity, @NotNull Player player) { this(entity, player, EquipmentSlot.HAND); } diff --git a/paper-api/src/main/java/org/bukkit/event/server/BroadcastMessageEvent.java b/paper-api/src/main/java/org/bukkit/event/server/BroadcastMessageEvent.java index 03bfca9d36..24d57cf176 100644 --- a/paper-api/src/main/java/org/bukkit/event/server/BroadcastMessageEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/server/BroadcastMessageEvent.java @@ -22,7 +22,7 @@ public class BroadcastMessageEvent extends ServerEvent implements Cancellable { private final Set recipients; private boolean cancelled = false; - @Deprecated + @Deprecated(since = "1.14") public BroadcastMessageEvent(@NotNull String message, @NotNull Set recipients) { this(false, message, recipients); } diff --git a/paper-api/src/main/java/org/bukkit/event/server/ServerListPingEvent.java b/paper-api/src/main/java/org/bukkit/event/server/ServerListPingEvent.java index 5adbe05141..689e533a61 100644 --- a/paper-api/src/main/java/org/bukkit/event/server/ServerListPingEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/server/ServerListPingEvent.java @@ -127,7 +127,7 @@ public class ServerListPingEvent extends ServerEvent implements Iterable * @return true if chat preview is enabled, false otherwise * @deprecated chat previews have been removed */ - @Deprecated + @Deprecated(since = "1.19.3") public boolean shouldSendChatPreviews() { return false; } diff --git a/paper-api/src/main/java/org/bukkit/event/weather/LightningStrikeEvent.java b/paper-api/src/main/java/org/bukkit/event/weather/LightningStrikeEvent.java index c854600f99..ca97efaaab 100644 --- a/paper-api/src/main/java/org/bukkit/event/weather/LightningStrikeEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/weather/LightningStrikeEvent.java @@ -15,7 +15,7 @@ public class LightningStrikeEvent extends WeatherEvent implements Cancellable { private final LightningStrike bolt; private final Cause cause; - @Deprecated + @Deprecated(since = "1.13.1") public LightningStrikeEvent(@NotNull final World world, @NotNull final LightningStrike bolt) { this(world, bolt, Cause.UNKNOWN); } diff --git a/paper-api/src/main/java/org/bukkit/event/world/PortalCreateEvent.java b/paper-api/src/main/java/org/bukkit/event/world/PortalCreateEvent.java index 579f017474..a7acc3ab37 100644 --- a/paper-api/src/main/java/org/bukkit/event/world/PortalCreateEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/world/PortalCreateEvent.java @@ -19,7 +19,7 @@ public class PortalCreateEvent extends WorldEvent implements Cancellable { private final Entity entity; private final CreateReason reason; - @Deprecated + @Deprecated(since = "1.14.1") public PortalCreateEvent(@NotNull final List blocks, @NotNull final World world, @NotNull CreateReason reason) { this(blocks, world, null, reason); } diff --git a/paper-api/src/main/java/org/bukkit/generator/BlockPopulator.java b/paper-api/src/main/java/org/bukkit/generator/BlockPopulator.java index 4704ea919b..7e4be4ebfe 100644 --- a/paper-api/src/main/java/org/bukkit/generator/BlockPopulator.java +++ b/paper-api/src/main/java/org/bukkit/generator/BlockPopulator.java @@ -35,7 +35,7 @@ public abstract class BlockPopulator { * @param source The chunk to generate for * @deprecated Use {@link #populate(WorldInfo, Random, int, int, LimitedRegion)} */ - @Deprecated + @Deprecated(since = "1.17.1") public void populate(@NotNull World world, @NotNull Random random, @NotNull Chunk source) { } diff --git a/paper-api/src/main/java/org/bukkit/generator/ChunkGenerator.java b/paper-api/src/main/java/org/bukkit/generator/ChunkGenerator.java index 0cc6e29a5a..4b952b0178 100644 --- a/paper-api/src/main/java/org/bukkit/generator/ChunkGenerator.java +++ b/paper-api/src/main/java/org/bukkit/generator/ChunkGenerator.java @@ -215,7 +215,7 @@ public abstract class ChunkGenerator { * generateBlockSections() or generateExtBlockSections(). * @deprecated Biomes are now set with {@link BiomeProvider} */ - @Deprecated + @Deprecated(since = "1.17.1") public interface BiomeGrid { /** @@ -227,7 +227,7 @@ public abstract class ChunkGenerator { * @deprecated biomes are now 3-dimensional */ @NotNull - @Deprecated + @Deprecated(since = "1.15") Biome getBiome(int x, int z); /** @@ -249,7 +249,7 @@ public abstract class ChunkGenerator { * @param bio - Biome value * @deprecated biomes are now 3-dimensional */ - @Deprecated + @Deprecated(since = "1.15") void setBiome(int x, int z, @NotNull Biome bio); /** @@ -289,7 +289,7 @@ public abstract class ChunkGenerator { * @deprecated The generation is now split up and the new methods should be used, see {@link ChunkGenerator} */ @NotNull - @Deprecated + @Deprecated(since = "1.17.1") public ChunkData generateChunkData(@NotNull World world, @NotNull Random random, int x, int z, @NotNull BiomeGrid biome) { throw new UnsupportedOperationException("Not implemented, no longer needed"); } @@ -301,7 +301,7 @@ public abstract class ChunkGenerator { * @deprecated {@link ChunkData} are now directly provided */ @NotNull - @Deprecated + @Deprecated(since = "1.17.1") protected final ChunkData createChunkData(@NotNull World world) { return Bukkit.getServer().createChunkData(world); } @@ -363,7 +363,7 @@ public abstract class ChunkGenerator { * @return parallel capable status * @deprecated the chunk generation code should be thread safe */ - @Deprecated + @Deprecated(since = "1.17.1") public boolean isParallelCapable() { return false; } @@ -452,7 +452,7 @@ public abstract class ChunkGenerator { * @return true if the server should generate Vanilla bedrock * @deprecated has no effect, bedrock generation is part of the surface step, see {@link #shouldGenerateSurface()} */ - @Deprecated + @Deprecated(since = "1.19.2") public boolean shouldGenerateBedrock() { return false; } @@ -769,7 +769,7 @@ public abstract class ChunkGenerator { * @return the block data value or air if x, y or z are outside the chunk's bounds * @deprecated Uses magic values */ - @Deprecated + @Deprecated(since = "1.8.8") public byte getData(int x, int y, int z); } } diff --git a/paper-api/src/main/java/org/bukkit/inventory/EntityEquipment.java b/paper-api/src/main/java/org/bukkit/inventory/EntityEquipment.java index 9adc827bc5..37298cec02 100644 --- a/paper-api/src/main/java/org/bukkit/inventory/EntityEquipment.java +++ b/paper-api/src/main/java/org/bukkit/inventory/EntityEquipment.java @@ -93,7 +93,7 @@ public interface EntityEquipment { * @deprecated entities can duel wield now use the methods for the * specific hand instead */ - @Deprecated + @Deprecated(since = "1.9") @NotNull ItemStack getItemInHand(); @@ -106,7 +106,7 @@ public interface EntityEquipment { * @deprecated entities can duel wield now use the methods for the * specific hand instead */ - @Deprecated + @Deprecated(since = "1.9") void setItemInHand(@Nullable ItemStack stack); /** @@ -230,7 +230,7 @@ public interface EntityEquipment { * @deprecated entities can duel wield now use the methods for the specific * hand instead */ - @Deprecated + @Deprecated(since = "1.9") float getItemInHandDropChance(); /** @@ -240,7 +240,7 @@ public interface EntityEquipment { * @deprecated entities can duel wield now use the methods for the specific * hand instead */ - @Deprecated + @Deprecated(since = "1.9") void setItemInHandDropChance(float chance); /** diff --git a/paper-api/src/main/java/org/bukkit/inventory/EquipmentSlotGroup.java b/paper-api/src/main/java/org/bukkit/inventory/EquipmentSlotGroup.java index 0019c8d91e..1a272fec57 100644 --- a/paper-api/src/main/java/org/bukkit/inventory/EquipmentSlotGroup.java +++ b/paper-api/src/main/java/org/bukkit/inventory/EquipmentSlotGroup.java @@ -57,7 +57,7 @@ public final class EquipmentSlotGroup implements Predicate { * @deprecated for internal compatibility use only */ @NotNull - @Deprecated + @Deprecated(since = "1.20.5") @ApiStatus.Internal public EquipmentSlot getExample() { return example; diff --git a/paper-api/src/main/java/org/bukkit/inventory/FurnaceRecipe.java b/paper-api/src/main/java/org/bukkit/inventory/FurnaceRecipe.java index 1d442dc16c..82d4d0329a 100644 --- a/paper-api/src/main/java/org/bukkit/inventory/FurnaceRecipe.java +++ b/paper-api/src/main/java/org/bukkit/inventory/FurnaceRecipe.java @@ -11,22 +11,22 @@ import org.jetbrains.annotations.NotNull; */ public class FurnaceRecipe extends CookingRecipe { - @Deprecated + @Deprecated(since = "1.13") public FurnaceRecipe(@NotNull ItemStack result, @NotNull Material source) { this(NamespacedKey.randomKey(), result, source, 0, 0, 200); } - @Deprecated + @Deprecated(since = "1.13") public FurnaceRecipe(@NotNull ItemStack result, @NotNull MaterialData source) { this(NamespacedKey.randomKey(), result, source.getItemType(), source.getData(), 0, 200); } - @Deprecated + @Deprecated(since = "1.13") public FurnaceRecipe(@NotNull ItemStack result, @NotNull MaterialData source, float experience) { this(NamespacedKey.randomKey(), result, source.getItemType(), source.getData(), experience, 200); } - @Deprecated + @Deprecated(since = "1.6.2") public FurnaceRecipe(@NotNull ItemStack result, @NotNull Material source, int data) { this(NamespacedKey.randomKey(), result, source, data, 0, 200); } @@ -44,7 +44,7 @@ public class FurnaceRecipe extends CookingRecipe { this(key, result, source, 0, experience, cookingTime); } - @Deprecated + @Deprecated(since = "1.9") public FurnaceRecipe(@NotNull NamespacedKey key, @NotNull ItemStack result, @NotNull Material source, int data, float experience, int cookingTime) { this(key, result, new RecipeChoice.MaterialChoice(Collections.singletonList(source)), experience, cookingTime); } @@ -88,7 +88,7 @@ public class FurnaceRecipe extends CookingRecipe { * @return The changed recipe, so you can chain calls. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public FurnaceRecipe setInput(@NotNull Material input, int data) { return setInputChoice(new RecipeChoice.MaterialChoice(Collections.singletonList(input))); } diff --git a/paper-api/src/main/java/org/bukkit/inventory/InventoryView.java b/paper-api/src/main/java/org/bukkit/inventory/InventoryView.java index 278259e211..021d9491d0 100644 --- a/paper-api/src/main/java/org/bukkit/inventory/InventoryView.java +++ b/paper-api/src/main/java/org/bukkit/inventory/InventoryView.java @@ -125,7 +125,7 @@ public interface InventoryView { * @return the id of this view * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public int getId() { return id; } diff --git a/paper-api/src/main/java/org/bukkit/inventory/ItemStack.java b/paper-api/src/main/java/org/bukkit/inventory/ItemStack.java index eade623288..8d9c309067 100644 --- a/paper-api/src/main/java/org/bukkit/inventory/ItemStack.java +++ b/paper-api/src/main/java/org/bukkit/inventory/ItemStack.java @@ -70,7 +70,7 @@ public class ItemStack implements Cloneable, ConfigurationSerializable, Translat * @param damage durability / damage * @deprecated see {@link #setDurability(short)} */ - @Deprecated + @Deprecated(since = "1.20.5") public ItemStack(@NotNull final Material type, final int amount, final short damage) { this(type, amount, damage, null); } @@ -82,7 +82,7 @@ public class ItemStack implements Cloneable, ConfigurationSerializable, Translat * @param data the data value or null * @deprecated this method uses an ambiguous data byte object */ - @Deprecated + @Deprecated(since = "1.4.5") public ItemStack(@NotNull Material type, final int amount, final short damage, @Nullable final Byte data) { Preconditions.checkArgument(type != null, "Material cannot be null"); if (type.isLegacy()) { @@ -219,7 +219,7 @@ public class ItemStack implements Cloneable, ConfigurationSerializable, Translat * any call to this method will be overwritten by subsequent setting of * ItemMeta which was created before this call. */ - @Deprecated + @Deprecated(since = "1.13") public void setDurability(final short durability) { ItemMeta meta = getItemMeta(); if (meta != null) { @@ -234,7 +234,7 @@ public class ItemStack implements Cloneable, ConfigurationSerializable, Translat * @return Durability of this item * @deprecated see {@link #setDurability(short)} */ - @Deprecated + @Deprecated(since = "1.13") public short getDurability() { ItemMeta meta = getItemMeta(); return (meta == null) ? 0 : (short) ((Damageable) meta).getDamage(); diff --git a/paper-api/src/main/java/org/bukkit/inventory/ItemType.java b/paper-api/src/main/java/org/bukkit/inventory/ItemType.java index 9a28c9dfe8..ad423abaed 100644 --- a/paper-api/src/main/java/org/bukkit/inventory/ItemType.java +++ b/paper-api/src/main/java/org/bukkit/inventory/ItemType.java @@ -2428,7 +2428,7 @@ public interface ItemType extends Keyed, Translatable { * @deprecated creative categories no longer exist on the server */ @Nullable - @Deprecated + @Deprecated(since = "1.20.6") CreativeCategory getCreativeCategory(); /** @@ -2446,6 +2446,6 @@ public interface ItemType extends Keyed, Translatable { * @deprecated only for internal use */ @Nullable - @Deprecated + @Deprecated(since = "1.20.6") Material asMaterial(); } diff --git a/paper-api/src/main/java/org/bukkit/inventory/PlayerInventory.java b/paper-api/src/main/java/org/bukkit/inventory/PlayerInventory.java index f1918027c3..6933fb24ea 100644 --- a/paper-api/src/main/java/org/bukkit/inventory/PlayerInventory.java +++ b/paper-api/src/main/java/org/bukkit/inventory/PlayerInventory.java @@ -200,7 +200,7 @@ public interface PlayerInventory extends Inventory { * @deprecated players can duel wield now use the methods for the * specific hand instead */ - @Deprecated + @Deprecated(since = "1.9") @NotNull public ItemStack getItemInHand(); @@ -213,7 +213,7 @@ public interface PlayerInventory extends Inventory { * @deprecated players can duel wield now use the methods for the * specific hand instead */ - @Deprecated + @Deprecated(since = "1.9") public void setItemInHand(@Nullable ItemStack stack); /** diff --git a/paper-api/src/main/java/org/bukkit/inventory/RecipeChoice.java b/paper-api/src/main/java/org/bukkit/inventory/RecipeChoice.java index a98fc2ffda..9ef4221742 100644 --- a/paper-api/src/main/java/org/bukkit/inventory/RecipeChoice.java +++ b/paper-api/src/main/java/org/bukkit/inventory/RecipeChoice.java @@ -28,7 +28,7 @@ public interface RecipeChoice extends Predicate, Cloneable { * @return a single representative item * @deprecated for compatibility only */ - @Deprecated + @Deprecated(since = "1.13.1") @NotNull ItemStack getItemStack(); diff --git a/paper-api/src/main/java/org/bukkit/inventory/ShapedRecipe.java b/paper-api/src/main/java/org/bukkit/inventory/ShapedRecipe.java index 16c10d75dd..83b08fa8a4 100644 --- a/paper-api/src/main/java/org/bukkit/inventory/ShapedRecipe.java +++ b/paper-api/src/main/java/org/bukkit/inventory/ShapedRecipe.java @@ -30,7 +30,7 @@ public class ShapedRecipe extends CraftingRecipe { * @deprecated Recipes must have keys. Use {@link #ShapedRecipe(NamespacedKey, ItemStack)} * instead. */ - @Deprecated + @Deprecated(since = "1.12") public ShapedRecipe(@NotNull ItemStack result) { this(NamespacedKey.randomKey(), result); } @@ -147,7 +147,7 @@ public class ShapedRecipe extends CraftingRecipe { * @throws IllegalArgumentException if the {@code key} does not appear in the shape. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @NotNull public ShapedRecipe setIngredient(char key, @NotNull Material ingredient, int raw) { Preconditions.checkArgument(key != ' ', "Space in recipe shape must represent no ingredient"); diff --git a/paper-api/src/main/java/org/bukkit/inventory/ShapelessRecipe.java b/paper-api/src/main/java/org/bukkit/inventory/ShapelessRecipe.java index bc924ae23f..969710cc69 100644 --- a/paper-api/src/main/java/org/bukkit/inventory/ShapelessRecipe.java +++ b/paper-api/src/main/java/org/bukkit/inventory/ShapelessRecipe.java @@ -17,7 +17,7 @@ import org.jetbrains.annotations.NotNull; public class ShapelessRecipe extends CraftingRecipe { private final List ingredients = new ArrayList<>(); - @Deprecated + @Deprecated(since = "1.12") public ShapelessRecipe(@NotNull ItemStack result) { this(NamespacedKey.randomKey(), result); } @@ -71,7 +71,7 @@ public class ShapelessRecipe extends CraftingRecipe { * @return The changed recipe, so you can chain calls. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @NotNull public ShapelessRecipe addIngredient(@NotNull Material ingredient, int rawdata) { return addIngredient(1, ingredient, rawdata); @@ -110,7 +110,7 @@ public class ShapelessRecipe extends CraftingRecipe { * @return The changed recipe, so you can chain calls. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @NotNull public ShapelessRecipe addIngredient(int count, @NotNull Material ingredient, int rawdata) { Preconditions.checkArgument(ingredients.size() + count <= 9, "Shapeless recipes cannot have more than 9 ingredients"); @@ -211,7 +211,7 @@ public class ShapelessRecipe extends CraftingRecipe { * @return The changed recipe. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @NotNull public ShapelessRecipe removeIngredient(@NotNull Material ingredient, int rawdata) { return removeIngredient(1, ingredient, rawdata); @@ -228,7 +228,7 @@ public class ShapelessRecipe extends CraftingRecipe { * @return The changed recipe. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @NotNull public ShapelessRecipe removeIngredient(int count, @NotNull Material ingredient, int rawdata) { Iterator iterator = ingredients.iterator(); diff --git a/paper-api/src/main/java/org/bukkit/inventory/SmithingRecipe.java b/paper-api/src/main/java/org/bukkit/inventory/SmithingRecipe.java index 717878019a..6ad1f37372 100644 --- a/paper-api/src/main/java/org/bukkit/inventory/SmithingRecipe.java +++ b/paper-api/src/main/java/org/bukkit/inventory/SmithingRecipe.java @@ -27,7 +27,7 @@ public class SmithingRecipe implements Recipe, Keyed { * This class now acts as a base class to these two classes and will do nothing when * added to the server. */ - @Deprecated + @Deprecated(since = "1.20.1") public SmithingRecipe(@NotNull NamespacedKey key, @NotNull ItemStack result, @Nullable RecipeChoice base, @Nullable RecipeChoice addition) { this.key = key; this.result = result; diff --git a/paper-api/src/main/java/org/bukkit/inventory/meta/ItemMeta.java b/paper-api/src/main/java/org/bukkit/inventory/meta/ItemMeta.java index 1d81004265..a3515201dc 100644 --- a/paper-api/src/main/java/org/bukkit/inventory/meta/ItemMeta.java +++ b/paper-api/src/main/java/org/bukkit/inventory/meta/ItemMeta.java @@ -102,7 +102,7 @@ public interface ItemMeta extends Cloneable, ConfigurationSerializable, Persiste * @return true if this has a localized name * @deprecated meta no longer exists */ - @Deprecated(forRemoval = true) + @Deprecated(since = "1.20.5", forRemoval = true) boolean hasLocalizedName(); /** @@ -115,7 +115,7 @@ public interface ItemMeta extends Cloneable, ConfigurationSerializable, Persiste * @deprecated meta no longer exists */ @NotNull - @Deprecated(forRemoval = true) + @Deprecated(since = "1.20.5", forRemoval = true) String getLocalizedName(); /** @@ -124,7 +124,7 @@ public interface ItemMeta extends Cloneable, ConfigurationSerializable, Persiste * @param name the name to set * @deprecated meta no longer exists */ - @Deprecated(forRemoval = true) + @Deprecated(since = "1.20.5", forRemoval = true) void setLocalizedName(@Nullable String name); /** @@ -432,7 +432,7 @@ public interface ItemMeta extends Cloneable, ConfigurationSerializable, Persiste * @deprecated use {@link #getDamageResistant()} and * {@link DamageTypeTags#IS_FIRE} */ - @Deprecated + @Deprecated(since = "1.21.2") boolean isFireResistant(); /** @@ -443,7 +443,7 @@ public interface ItemMeta extends Cloneable, ConfigurationSerializable, Persiste * @deprecated use {@link #setDamageResistant(org.bukkit.Tag)} and * {@link DamageTypeTags#IS_FIRE} */ - @Deprecated + @Deprecated(since = "1.21.2") void setFireResistant(boolean fireResistant); /** @@ -869,7 +869,7 @@ public interface ItemMeta extends Cloneable, ConfigurationSerializable, Persiste * Please use {@link PersistentDataHolder#getPersistentDataContainer()} instead of this. */ @NotNull - @Deprecated + @Deprecated(since = "1.14") CustomItemTagContainer getCustomTagContainer(); /** diff --git a/paper-api/src/main/java/org/bukkit/inventory/meta/MapMeta.java b/paper-api/src/main/java/org/bukkit/inventory/meta/MapMeta.java index 32055a8890..8b0b36cd2e 100644 --- a/paper-api/src/main/java/org/bukkit/inventory/meta/MapMeta.java +++ b/paper-api/src/main/java/org/bukkit/inventory/meta/MapMeta.java @@ -22,7 +22,7 @@ public interface MapMeta extends ItemMeta { * for example will generate a new map with a different ID). The xxxMapView * family of methods should be used instead. */ - @Deprecated + @Deprecated(since = "1.13.2") boolean hasMapId(); /** @@ -40,7 +40,7 @@ public interface MapMeta extends ItemMeta { * for example will generate a new map with a different ID). The xxxMapView * family of methods should be used instead. */ - @Deprecated + @Deprecated(since = "1.13.2") int getMapId(); /** @@ -54,7 +54,7 @@ public interface MapMeta extends ItemMeta { * for example will generate a new map with a different ID). The xxxMapView * family of methods should be used instead. */ - @Deprecated + @Deprecated(since = "1.13.2") void setMapId(int id); /** @@ -110,7 +110,7 @@ public interface MapMeta extends ItemMeta { * @deprecated This method does not have the expected effect and is * actually an alias for {@link ItemMeta#hasLocalizedName()}. */ - @Deprecated + @Deprecated(since = "1.19.4") boolean hasLocationName(); /** @@ -123,7 +123,7 @@ public interface MapMeta extends ItemMeta { * @deprecated This method does not have the expected effect and is * actually an alias for {@link ItemMeta#getLocalizedName()}. */ - @Deprecated + @Deprecated(since = "1.19.4") @Nullable String getLocationName(); @@ -134,7 +134,7 @@ public interface MapMeta extends ItemMeta { * @deprecated This method does not have the expected effect and is * actually an alias for {@link ItemMeta#setLocalizedName(String)}. */ - @Deprecated + @Deprecated(since = "1.19.4") void setLocationName(@Nullable String name); /** diff --git a/paper-api/src/main/java/org/bukkit/inventory/meta/PotionMeta.java b/paper-api/src/main/java/org/bukkit/inventory/meta/PotionMeta.java index 6a70b79f3c..b61d2e322f 100644 --- a/paper-api/src/main/java/org/bukkit/inventory/meta/PotionMeta.java +++ b/paper-api/src/main/java/org/bukkit/inventory/meta/PotionMeta.java @@ -20,7 +20,7 @@ public interface PotionMeta extends ItemMeta { * @param data PotionData to set the base potion state to * @deprecated Upgraded / extended potions are now their own {@link PotionType} use {@link #setBasePotionType} instead. */ - @Deprecated + @Deprecated(since = "1.20.6") void setBasePotionData(@Nullable PotionData data); /** @@ -30,7 +30,7 @@ public interface PotionMeta extends ItemMeta { * @deprecated Upgraded / extended potions are now their own {@link PotionType} use {@link #getBasePotionType()} instead. */ @Nullable - @Deprecated + @Deprecated(since = "1.20.6") PotionData getBasePotionData(); /** @@ -109,7 +109,7 @@ public interface PotionMeta extends ItemMeta { * @return true if the potion meta changed as a result of this call * @deprecated use {@link #setBasePotionType(org.bukkit.potion.PotionType)} */ - @Deprecated + @Deprecated(since = "1.9") boolean setMainEffect(@NotNull PotionEffectType type); /** diff --git a/paper-api/src/main/java/org/bukkit/inventory/meta/SkullMeta.java b/paper-api/src/main/java/org/bukkit/inventory/meta/SkullMeta.java index 5a18a66a0b..5af814d3cf 100644 --- a/paper-api/src/main/java/org/bukkit/inventory/meta/SkullMeta.java +++ b/paper-api/src/main/java/org/bukkit/inventory/meta/SkullMeta.java @@ -17,7 +17,7 @@ public interface SkullMeta extends ItemMeta { * @return the owner if the skull * @deprecated see {@link #getOwningPlayer()}. */ - @Deprecated + @Deprecated(since = "1.12.1") @Nullable String getOwner(); @@ -35,7 +35,7 @@ public interface SkullMeta extends ItemMeta { * @return true if the owner was successfully set * @deprecated see {@link #setOwningPlayer(org.bukkit.OfflinePlayer)}. */ - @Deprecated + @Deprecated(since = "1.12.1") boolean setOwner(@Nullable String owner); /** diff --git a/paper-api/src/main/java/org/bukkit/inventory/meta/SpawnEggMeta.java b/paper-api/src/main/java/org/bukkit/inventory/meta/SpawnEggMeta.java index b3447e22ab..2151946cf7 100644 --- a/paper-api/src/main/java/org/bukkit/inventory/meta/SpawnEggMeta.java +++ b/paper-api/src/main/java/org/bukkit/inventory/meta/SpawnEggMeta.java @@ -17,7 +17,7 @@ public interface SpawnEggMeta extends ItemMeta { * @return The entity type. May be null for implementation specific default. * @deprecated different types are different items */ - @Deprecated + @Deprecated(since = "1.13") @Contract("-> fail") EntityType getSpawnedType(); @@ -28,7 +28,7 @@ public interface SpawnEggMeta extends ItemMeta { * default. * @deprecated different types are different items */ - @Deprecated + @Deprecated(since = "1.13") @Contract("_ -> fail") void setSpawnedType(EntityType type); diff --git a/paper-api/src/main/java/org/bukkit/inventory/meta/tags/CustomItemTagContainer.java b/paper-api/src/main/java/org/bukkit/inventory/meta/tags/CustomItemTagContainer.java index f46e2978bd..edf8698b6b 100644 --- a/paper-api/src/main/java/org/bukkit/inventory/meta/tags/CustomItemTagContainer.java +++ b/paper-api/src/main/java/org/bukkit/inventory/meta/tags/CustomItemTagContainer.java @@ -13,7 +13,7 @@ import org.jetbrains.annotations.Nullable; * {@link org.bukkit.persistence.PersistentDataHolder} API. Please use * {@link org.bukkit.persistence.PersistentDataHolder} instead of this. */ -@Deprecated +@Deprecated(since = "1.14") public interface CustomItemTagContainer { /** diff --git a/paper-api/src/main/java/org/bukkit/inventory/meta/tags/ItemTagAdapterContext.java b/paper-api/src/main/java/org/bukkit/inventory/meta/tags/ItemTagAdapterContext.java index 97e6c96efe..fae160e1cb 100644 --- a/paper-api/src/main/java/org/bukkit/inventory/meta/tags/ItemTagAdapterContext.java +++ b/paper-api/src/main/java/org/bukkit/inventory/meta/tags/ItemTagAdapterContext.java @@ -11,7 +11,7 @@ import org.jetbrains.annotations.NotNull; * @deprecated this API part has been replaced by {@link PersistentDataHolder}. * Please use {@link PersistentDataAdapterContext} instead of this. */ -@Deprecated +@Deprecated(since = "1.14") public interface ItemTagAdapterContext { /** diff --git a/paper-api/src/main/java/org/bukkit/inventory/meta/tags/ItemTagType.java b/paper-api/src/main/java/org/bukkit/inventory/meta/tags/ItemTagType.java index 09082d4813..6288f6a093 100644 --- a/paper-api/src/main/java/org/bukkit/inventory/meta/tags/ItemTagType.java +++ b/paper-api/src/main/java/org/bukkit/inventory/meta/tags/ItemTagType.java @@ -46,7 +46,7 @@ import org.jetbrains.annotations.NotNull; * * @deprecated please use {@link PersistentDataType} as this part of the api is being replaced */ -@Deprecated +@Deprecated(since = "1.14") public interface ItemTagType { /* diff --git a/paper-api/src/main/java/org/bukkit/loot/LootContext.java b/paper-api/src/main/java/org/bukkit/loot/LootContext.java index 9c1ccaed72..4a8b2538a8 100644 --- a/paper-api/src/main/java/org/bukkit/loot/LootContext.java +++ b/paper-api/src/main/java/org/bukkit/loot/LootContext.java @@ -64,7 +64,7 @@ public final class LootContext { * @return the looting level * @deprecated no longer functional */ - @Deprecated + @Deprecated(since = "1.21") public int getLootingModifier() { return lootingModifier; } @@ -136,7 +136,7 @@ public final class LootContext { * @deprecated no longer functional */ @NotNull - @Deprecated + @Deprecated(since = "1.21") public Builder lootingModifier(int modifier) { this.lootingModifier = modifier; return this; diff --git a/paper-api/src/main/java/org/bukkit/map/MapCanvas.java b/paper-api/src/main/java/org/bukkit/map/MapCanvas.java index edef478786..fcad167c03 100644 --- a/paper-api/src/main/java/org/bukkit/map/MapCanvas.java +++ b/paper-api/src/main/java/org/bukkit/map/MapCanvas.java @@ -86,7 +86,7 @@ public interface MapCanvas { * @param color The color. See {@link MapPalette}. * @deprecated Magic value, use {@link #setPixelColor(int, int, Color)} */ - @Deprecated + @Deprecated(since = "1.20.5") public void setPixel(int x, int y, byte color); /** @@ -97,7 +97,7 @@ public interface MapCanvas { * @return The color. See {@link MapPalette}. * @deprecated Magic value, use {@link #getPixelColor(int, int)} */ - @Deprecated + @Deprecated(since = "1.19") public byte getPixel(int x, int y); /** @@ -108,7 +108,7 @@ public interface MapCanvas { * @return The color. See {@link MapPalette}. * @deprecated Magic value, use {@link #getBasePixelColor(int, int)} */ - @Deprecated + @Deprecated(since = "1.19") public byte getBasePixel(int x, int y); /** diff --git a/paper-api/src/main/java/org/bukkit/map/MapCursor.java b/paper-api/src/main/java/org/bukkit/map/MapCursor.java index a37e6419fc..3ca6d94e99 100644 --- a/paper-api/src/main/java/org/bukkit/map/MapCursor.java +++ b/paper-api/src/main/java/org/bukkit/map/MapCursor.java @@ -30,7 +30,7 @@ public final class MapCursor { * @param visible Whether the cursor is visible by default. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public MapCursor(byte x, byte y, byte direction, byte type, boolean visible) { this(x, y, direction, type, visible, null); } @@ -59,7 +59,7 @@ public final class MapCursor { * @param caption cursor caption * @deprecated Magic value, use {@link #MapCursor(byte, byte, byte, Type, boolean, String)} */ - @Deprecated + @Deprecated(since = "1.13") public MapCursor(byte x, byte y, byte direction, byte type, boolean visible, @Nullable String caption) { this.x = x; this.y = y; @@ -131,7 +131,7 @@ public final class MapCursor { * @return The type (color/style) of the map cursor. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public byte getRawType() { return type.getValue(); } @@ -188,7 +188,7 @@ public final class MapCursor { * @param type The type (color/style) of the map cursor. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public void setRawType(byte type) { Type enumType = Type.byValue(type); Preconditions.checkArgument(enumType != null, "Unknown type by id %s", type); @@ -278,7 +278,7 @@ public final class MapCursor { * @return the value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") byte getValue(); /** @@ -288,7 +288,7 @@ public final class MapCursor { * @return the matching type * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Nullable static Type byValue(byte value) { for (Type t : values()) { diff --git a/paper-api/src/main/java/org/bukkit/map/MapCursorCollection.java b/paper-api/src/main/java/org/bukkit/map/MapCursorCollection.java index 4dba721aef..986f9c8a65 100644 --- a/paper-api/src/main/java/org/bukkit/map/MapCursorCollection.java +++ b/paper-api/src/main/java/org/bukkit/map/MapCursorCollection.java @@ -77,7 +77,7 @@ public final class MapCursorCollection { * @return The newly added MapCursor. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @NotNull public MapCursor addCursor(int x, int y, byte direction, byte type) { return addCursor(x, y, direction, type, true); @@ -94,7 +94,7 @@ public final class MapCursorCollection { * @return The newly added MapCursor. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @NotNull public MapCursor addCursor(int x, int y, byte direction, byte type, boolean visible) { return addCursor(new MapCursor((byte) x, (byte) y, direction, type, visible)); @@ -112,7 +112,7 @@ public final class MapCursorCollection { * @return The newly added MapCursor. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.13") @NotNull public MapCursor addCursor(int x, int y, byte direction, byte type, boolean visible, @Nullable String caption) { return addCursor(new MapCursor((byte) x, (byte) y, direction, type, visible, caption)); diff --git a/paper-api/src/main/java/org/bukkit/map/MapPalette.java b/paper-api/src/main/java/org/bukkit/map/MapPalette.java index 3a9aaca2e7..13000c247e 100644 --- a/paper-api/src/main/java/org/bukkit/map/MapPalette.java +++ b/paper-api/src/main/java/org/bukkit/map/MapPalette.java @@ -109,72 +109,72 @@ public final class MapPalette { /** * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public static final byte TRANSPARENT = 0; /** * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public static final byte LIGHT_GREEN = 4; /** * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public static final byte LIGHT_BROWN = 8; /** * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public static final byte GRAY_1 = 12; /** * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public static final byte RED = 16; /** * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public static final byte PALE_BLUE = 20; /** * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public static final byte GRAY_2 = 24; /** * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public static final byte DARK_GREEN = 28; /** * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public static final byte WHITE = 32; /** * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public static final byte LIGHT_GRAY = 36; /** * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public static final byte BROWN = 40; /** * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public static final byte DARK_GRAY = 44; /** * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public static final byte BLUE = 48; /** * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public static final byte DARK_BROWN = 52; /** @@ -199,7 +199,7 @@ public final class MapPalette { * @return A byte[] containing the pixels of the image. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @NotNull public static byte[] imageToBytes(@NotNull Image image) { BufferedImage temp = new BufferedImage(image.getWidth(null), image.getHeight(null), BufferedImage.TYPE_INT_ARGB); @@ -227,7 +227,7 @@ public final class MapPalette { * @return The index in the palette. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public static byte matchColor(int r, int g, int b) { return matchColor(new Color(r, g, b)); } @@ -240,7 +240,7 @@ public final class MapPalette { * @return The index in the palette. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public static byte matchColor(@NotNull Color color) { if (color.getAlpha() < 128) return 0; @@ -270,7 +270,7 @@ public final class MapPalette { * @return The Color of the palette entry. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @NotNull public static Color getColor(byte index) { // Minecraft has 143 colors, some of which have negative byte representations @@ -313,7 +313,7 @@ public final class MapPalette { * @throws IllegalStateException if {@link #isCached()} returns false * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.19") byte matchColor(@NotNull Color color); } } diff --git a/paper-api/src/main/java/org/bukkit/map/MapView.java b/paper-api/src/main/java/org/bukkit/map/MapView.java index 9b8b68b66d..73bca3d371 100644 --- a/paper-api/src/main/java/org/bukkit/map/MapView.java +++ b/paper-api/src/main/java/org/bukkit/map/MapView.java @@ -34,7 +34,7 @@ public interface MapView { * @return The enum scale, or null for an invalid input * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Nullable public static Scale valueOf(byte value) { switch (value) { @@ -53,7 +53,7 @@ public interface MapView { * @return The scale value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public byte getValue() { return value; } diff --git a/paper-api/src/main/java/org/bukkit/material/Banner.java b/paper-api/src/main/java/org/bukkit/material/Banner.java index 08ce9d8bc6..cd78e2c35d 100644 --- a/paper-api/src/main/java/org/bukkit/material/Banner.java +++ b/paper-api/src/main/java/org/bukkit/material/Banner.java @@ -7,7 +7,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Banner extends MaterialData implements Attachable { public Banner() { @@ -23,7 +23,7 @@ public class Banner extends MaterialData implements Attachable { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.8") public Banner(Material type, byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Bed.java b/paper-api/src/main/java/org/bukkit/material/Bed.java index c5256129e0..ff49e6e5b5 100644 --- a/paper-api/src/main/java/org/bukkit/material/Bed.java +++ b/paper-api/src/main/java/org/bukkit/material/Bed.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Bed extends MaterialData implements Directional { /** @@ -38,7 +38,7 @@ public class Bed extends MaterialData implements Directional { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Bed(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Button.java b/paper-api/src/main/java/org/bukkit/material/Button.java index da7d016cf1..794dc81d0b 100644 --- a/paper-api/src/main/java/org/bukkit/material/Button.java +++ b/paper-api/src/main/java/org/bukkit/material/Button.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Button extends SimpleAttachableMaterialData implements Redstone { public Button() { super(Material.LEGACY_STONE_BUTTON); @@ -24,7 +24,7 @@ public class Button extends SimpleAttachableMaterialData implements Redstone { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Button(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Cake.java b/paper-api/src/main/java/org/bukkit/material/Cake.java index d39dd49162..5fd7b198e8 100644 --- a/paper-api/src/main/java/org/bukkit/material/Cake.java +++ b/paper-api/src/main/java/org/bukkit/material/Cake.java @@ -6,7 +6,7 @@ import org.bukkit.Material; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Cake extends MaterialData { public Cake() { super(Material.LEGACY_CAKE_BLOCK); @@ -21,7 +21,7 @@ public class Cake extends MaterialData { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Cake(Material type, byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Cauldron.java b/paper-api/src/main/java/org/bukkit/material/Cauldron.java index b331b4c27e..a72c74400a 100644 --- a/paper-api/src/main/java/org/bukkit/material/Cauldron.java +++ b/paper-api/src/main/java/org/bukkit/material/Cauldron.java @@ -8,7 +8,7 @@ import org.bukkit.Material; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Cauldron extends MaterialData { private static final int CAULDRON_FULL = 3; private static final int CAULDRON_EMPTY = 0; @@ -22,7 +22,7 @@ public class Cauldron extends MaterialData { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Cauldron(final Material type, final byte data) { super(type, data); } @@ -31,7 +31,7 @@ public class Cauldron extends MaterialData { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Cauldron(byte data) { super(Material.LEGACY_CAULDRON, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Chest.java b/paper-api/src/main/java/org/bukkit/material/Chest.java index 4d120d3c33..302bf01e8b 100644 --- a/paper-api/src/main/java/org/bukkit/material/Chest.java +++ b/paper-api/src/main/java/org/bukkit/material/Chest.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Chest extends DirectionalContainer { public Chest() { @@ -35,7 +35,7 @@ public class Chest extends DirectionalContainer { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Chest(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Coal.java b/paper-api/src/main/java/org/bukkit/material/Coal.java index fb842cfa7b..bc60ab8bda 100644 --- a/paper-api/src/main/java/org/bukkit/material/Coal.java +++ b/paper-api/src/main/java/org/bukkit/material/Coal.java @@ -9,7 +9,7 @@ import org.bukkit.Material; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Coal extends MaterialData { public Coal() { super(Material.LEGACY_COAL); @@ -29,7 +29,7 @@ public class Coal extends MaterialData { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Coal(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/CocoaPlant.java b/paper-api/src/main/java/org/bukkit/material/CocoaPlant.java index b1b1c729d1..db1cdd8e26 100644 --- a/paper-api/src/main/java/org/bukkit/material/CocoaPlant.java +++ b/paper-api/src/main/java/org/bukkit/material/CocoaPlant.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class CocoaPlant extends MaterialData implements Directional, Attachable { public enum CocoaPlantSize { @@ -27,7 +27,7 @@ public class CocoaPlant extends MaterialData implements Directional, Attachable * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public CocoaPlant(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Command.java b/paper-api/src/main/java/org/bukkit/material/Command.java index bcac1b0829..c83abea1a8 100644 --- a/paper-api/src/main/java/org/bukkit/material/Command.java +++ b/paper-api/src/main/java/org/bukkit/material/Command.java @@ -8,7 +8,7 @@ import org.bukkit.Material; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Command extends MaterialData implements Redstone { public Command() { super(Material.LEGACY_COMMAND); @@ -23,7 +23,7 @@ public class Command extends MaterialData implements Redstone { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Command(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Comparator.java b/paper-api/src/main/java/org/bukkit/material/Comparator.java index 49d32d5443..047f571be3 100644 --- a/paper-api/src/main/java/org/bukkit/material/Comparator.java +++ b/paper-api/src/main/java/org/bukkit/material/Comparator.java @@ -12,7 +12,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Comparator extends MaterialData implements Directional, Redstone { protected static final BlockFace DEFAULT_DIRECTION = BlockFace.NORTH; protected static final boolean DEFAULT_SUBTRACTION_MODE = false; @@ -72,7 +72,7 @@ public class Comparator extends MaterialData implements Directional, Redstone { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.9") public Comparator(Material type, byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Crops.java b/paper-api/src/main/java/org/bukkit/material/Crops.java index 4cf3de5fbb..b76c144f44 100644 --- a/paper-api/src/main/java/org/bukkit/material/Crops.java +++ b/paper-api/src/main/java/org/bukkit/material/Crops.java @@ -15,7 +15,7 @@ import org.bukkit.Material; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Crops extends MaterialData { protected static final Material DEFAULT_TYPE = Material.LEGACY_CROPS; protected static final CropState DEFAULT_STATE = CropState.SEEDED; @@ -62,7 +62,7 @@ public class Crops extends MaterialData { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Crops(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/DetectorRail.java b/paper-api/src/main/java/org/bukkit/material/DetectorRail.java index e8ab290421..3a46eea912 100644 --- a/paper-api/src/main/java/org/bukkit/material/DetectorRail.java +++ b/paper-api/src/main/java/org/bukkit/material/DetectorRail.java @@ -8,7 +8,7 @@ import org.bukkit.Material; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class DetectorRail extends ExtendedRails implements PressureSensor { public DetectorRail() { super(Material.LEGACY_DETECTOR_RAIL); @@ -23,7 +23,7 @@ public class DetectorRail extends ExtendedRails implements PressureSensor { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public DetectorRail(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Diode.java b/paper-api/src/main/java/org/bukkit/material/Diode.java index 36a62258bc..1576aaab7f 100644 --- a/paper-api/src/main/java/org/bukkit/material/Diode.java +++ b/paper-api/src/main/java/org/bukkit/material/Diode.java @@ -13,7 +13,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Diode extends MaterialData implements Directional, Redstone { protected static final BlockFace DEFAULT_DIRECTION = BlockFace.NORTH; @@ -83,7 +83,7 @@ public class Diode extends MaterialData implements Directional, Redstone { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Diode(Material type, byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/DirectionalContainer.java b/paper-api/src/main/java/org/bukkit/material/DirectionalContainer.java index 0190e5f3df..c862d36ff2 100644 --- a/paper-api/src/main/java/org/bukkit/material/DirectionalContainer.java +++ b/paper-api/src/main/java/org/bukkit/material/DirectionalContainer.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class DirectionalContainer extends MaterialData implements Directional { public DirectionalContainer(final Material type) { @@ -21,7 +21,7 @@ public class DirectionalContainer extends MaterialData implements Directional { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public DirectionalContainer(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Dispenser.java b/paper-api/src/main/java/org/bukkit/material/Dispenser.java index b12993a937..340f372a92 100644 --- a/paper-api/src/main/java/org/bukkit/material/Dispenser.java +++ b/paper-api/src/main/java/org/bukkit/material/Dispenser.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Dispenser extends FurnaceAndDispenser { public Dispenser() { @@ -30,7 +30,7 @@ public class Dispenser extends FurnaceAndDispenser { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Dispenser(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Door.java b/paper-api/src/main/java/org/bukkit/material/Door.java index d04ece5aba..a92da22234 100644 --- a/paper-api/src/main/java/org/bukkit/material/Door.java +++ b/paper-api/src/main/java/org/bukkit/material/Door.java @@ -22,7 +22,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Door extends MaterialData implements Directional, Openable { // This class breaks API contracts on Directional and Openable because @@ -31,7 +31,7 @@ public class Door extends MaterialData implements Directional, Openable { /** * @deprecated Artifact of old API, equivalent to new Door(Material.LEGACY_WOODEN_DOOR); */ - @Deprecated + @Deprecated(since = "1.8.7") public Door() { super(Material.LEGACY_WOODEN_DOOR); } @@ -165,7 +165,7 @@ public class Door extends MaterialData implements Directional, Openable { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Door(final Material type, final byte data) { super(type, data); } @@ -237,7 +237,7 @@ public class Door extends MaterialData implements Directional, Openable { * @return BlockFace.SELF * @deprecated This method should not be used; use hinge and facing accessors instead. */ - @Deprecated + @Deprecated(since = "1.4.5") public BlockFace getHingeCorner() { return BlockFace.SELF; } diff --git a/paper-api/src/main/java/org/bukkit/material/Dye.java b/paper-api/src/main/java/org/bukkit/material/Dye.java index f34f23da74..72d494631a 100644 --- a/paper-api/src/main/java/org/bukkit/material/Dye.java +++ b/paper-api/src/main/java/org/bukkit/material/Dye.java @@ -9,7 +9,7 @@ import org.bukkit.Material; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Dye extends MaterialData implements Colorable { public Dye() { super(Material.LEGACY_INK_SACK); @@ -24,7 +24,7 @@ public class Dye extends MaterialData implements Colorable { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Dye(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/EnderChest.java b/paper-api/src/main/java/org/bukkit/material/EnderChest.java index ad232cacd9..65f286a7ca 100644 --- a/paper-api/src/main/java/org/bukkit/material/EnderChest.java +++ b/paper-api/src/main/java/org/bukkit/material/EnderChest.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class EnderChest extends DirectionalContainer { public EnderChest() { @@ -35,7 +35,7 @@ public class EnderChest extends DirectionalContainer { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public EnderChest(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/ExtendedRails.java b/paper-api/src/main/java/org/bukkit/material/ExtendedRails.java index 9b2577f7b5..cbbf953b74 100644 --- a/paper-api/src/main/java/org/bukkit/material/ExtendedRails.java +++ b/paper-api/src/main/java/org/bukkit/material/ExtendedRails.java @@ -10,7 +10,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class ExtendedRails extends Rails { public ExtendedRails(final Material type) { @@ -22,7 +22,7 @@ public class ExtendedRails extends Rails { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public ExtendedRails(final Material type, final byte data) { super(type, data); } @@ -37,7 +37,7 @@ public class ExtendedRails extends Rails { * * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Override protected byte getConvertedData() { return (byte) (getData() & 0x7); diff --git a/paper-api/src/main/java/org/bukkit/material/FlowerPot.java b/paper-api/src/main/java/org/bukkit/material/FlowerPot.java index 6101e33288..45ebe2671b 100644 --- a/paper-api/src/main/java/org/bukkit/material/FlowerPot.java +++ b/paper-api/src/main/java/org/bukkit/material/FlowerPot.java @@ -10,7 +10,7 @@ import org.bukkit.TreeSpecies; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.9.4") public class FlowerPot extends MaterialData { /** @@ -29,7 +29,7 @@ public class FlowerPot extends MaterialData { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public FlowerPot(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Furnace.java b/paper-api/src/main/java/org/bukkit/material/Furnace.java index 380f7f4b1f..7bfc7c6edb 100644 --- a/paper-api/src/main/java/org/bukkit/material/Furnace.java +++ b/paper-api/src/main/java/org/bukkit/material/Furnace.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Furnace extends FurnaceAndDispenser { public Furnace() { @@ -35,7 +35,7 @@ public class Furnace extends FurnaceAndDispenser { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Furnace(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/FurnaceAndDispenser.java b/paper-api/src/main/java/org/bukkit/material/FurnaceAndDispenser.java index effa0d8a95..b7fb6cf424 100644 --- a/paper-api/src/main/java/org/bukkit/material/FurnaceAndDispenser.java +++ b/paper-api/src/main/java/org/bukkit/material/FurnaceAndDispenser.java @@ -8,7 +8,7 @@ import org.bukkit.Material; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class FurnaceAndDispenser extends DirectionalContainer { public FurnaceAndDispenser(final Material type) { @@ -20,7 +20,7 @@ public class FurnaceAndDispenser extends DirectionalContainer { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public FurnaceAndDispenser(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Gate.java b/paper-api/src/main/java/org/bukkit/material/Gate.java index fc67fc59a7..10c259338f 100644 --- a/paper-api/src/main/java/org/bukkit/material/Gate.java +++ b/paper-api/src/main/java/org/bukkit/material/Gate.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Gate extends MaterialData implements Directional, Openable { private static final byte OPEN_BIT = 0x4; private static final byte DIR_BIT = 0x3; @@ -27,7 +27,7 @@ public class Gate extends MaterialData implements Directional, Openable { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.13") public Gate(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Hopper.java b/paper-api/src/main/java/org/bukkit/material/Hopper.java index cfd32666c2..b5fc3746c8 100644 --- a/paper-api/src/main/java/org/bukkit/material/Hopper.java +++ b/paper-api/src/main/java/org/bukkit/material/Hopper.java @@ -12,7 +12,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Hopper extends MaterialData implements Directional, Redstone { protected static final BlockFace DEFAULT_DIRECTION = BlockFace.DOWN; @@ -62,7 +62,7 @@ public class Hopper extends MaterialData implements Directional, Redstone { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.9") public Hopper(Material type, byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Ladder.java b/paper-api/src/main/java/org/bukkit/material/Ladder.java index de26353082..ab607ae626 100644 --- a/paper-api/src/main/java/org/bukkit/material/Ladder.java +++ b/paper-api/src/main/java/org/bukkit/material/Ladder.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Ladder extends SimpleAttachableMaterialData { public Ladder() { super(Material.LEGACY_LADDER); @@ -24,7 +24,7 @@ public class Ladder extends SimpleAttachableMaterialData { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Ladder(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Leaves.java b/paper-api/src/main/java/org/bukkit/material/Leaves.java index 923a794ac1..69f47d00f1 100644 --- a/paper-api/src/main/java/org/bukkit/material/Leaves.java +++ b/paper-api/src/main/java/org/bukkit/material/Leaves.java @@ -13,7 +13,7 @@ import org.bukkit.TreeSpecies; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Leaves extends Wood { protected static final Material DEFAULT_TYPE = Material.LEGACY_LEAVES; protected static final boolean DEFAULT_DECAYABLE = true; @@ -82,7 +82,7 @@ public class Leaves extends Wood { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Leaves(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Lever.java b/paper-api/src/main/java/org/bukkit/material/Lever.java index 09f290f889..e2add49ce3 100644 --- a/paper-api/src/main/java/org/bukkit/material/Lever.java +++ b/paper-api/src/main/java/org/bukkit/material/Lever.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Lever extends SimpleAttachableMaterialData implements Redstone { public Lever() { super(Material.LEGACY_LEVER); @@ -24,7 +24,7 @@ public class Lever extends SimpleAttachableMaterialData implements Redstone { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Lever(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/LongGrass.java b/paper-api/src/main/java/org/bukkit/material/LongGrass.java index 497857ec37..5b7f21fff6 100644 --- a/paper-api/src/main/java/org/bukkit/material/LongGrass.java +++ b/paper-api/src/main/java/org/bukkit/material/LongGrass.java @@ -9,7 +9,7 @@ import org.bukkit.Material; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class LongGrass extends MaterialData { public LongGrass() { super(Material.LEGACY_LONG_GRASS); @@ -29,7 +29,7 @@ public class LongGrass extends MaterialData { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public LongGrass(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/MaterialData.java b/paper-api/src/main/java/org/bukkit/material/MaterialData.java index ccaddb8792..4b778e828f 100644 --- a/paper-api/src/main/java/org/bukkit/material/MaterialData.java +++ b/paper-api/src/main/java/org/bukkit/material/MaterialData.java @@ -9,7 +9,7 @@ import org.bukkit.inventory.ItemStack; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.13") public class MaterialData implements Cloneable { private final Material type; private byte data = 0; @@ -23,7 +23,7 @@ public class MaterialData implements Cloneable { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public MaterialData(final Material type, final byte data) { this.type = type; this.data = data; @@ -35,7 +35,7 @@ public class MaterialData implements Cloneable { * @return Raw data * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public byte getData() { return data; } @@ -46,7 +46,7 @@ public class MaterialData implements Cloneable { * @param data New raw data * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public void setData(byte data) { this.data = data; } @@ -67,7 +67,7 @@ public class MaterialData implements Cloneable { * @deprecated this method creates an ItemStack of size 0 which is not * generally useful. Consider {@link #toItemStack(int)}. */ - @Deprecated + @Deprecated(since = "1.12") public ItemStack toItemStack() { return new ItemStack(type, 0, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/MonsterEggs.java b/paper-api/src/main/java/org/bukkit/material/MonsterEggs.java index 2fac218f1e..3c25dd940e 100644 --- a/paper-api/src/main/java/org/bukkit/material/MonsterEggs.java +++ b/paper-api/src/main/java/org/bukkit/material/MonsterEggs.java @@ -10,7 +10,7 @@ import org.bukkit.Material; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class MonsterEggs extends TexturedMaterial { private static final List textures = new ArrayList(); @@ -36,7 +36,7 @@ public class MonsterEggs extends TexturedMaterial { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public MonsterEggs(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Mushroom.java b/paper-api/src/main/java/org/bukkit/material/Mushroom.java index 8927b307ad..6e41bddacb 100644 --- a/paper-api/src/main/java/org/bukkit/material/Mushroom.java +++ b/paper-api/src/main/java/org/bukkit/material/Mushroom.java @@ -17,7 +17,7 @@ import org.bukkit.material.types.MushroomBlockTexture; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Mushroom extends MaterialData { private static final byte NORTH_LIMIT = 4; private static final byte SOUTH_LIMIT = 6; @@ -79,7 +79,7 @@ public class Mushroom extends MaterialData { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Mushroom(Material shroom, byte data) { super(shroom, data); Preconditions.checkArgument(shroom == Material.LEGACY_HUGE_MUSHROOM_1 || shroom == Material.LEGACY_HUGE_MUSHROOM_2, "Not a mushroom!"); @@ -103,7 +103,7 @@ public class Mushroom extends MaterialData { * with {@link MushroomBlockTexture#STEM_SIDES } or * {@link MushroomBlockTexture#ALL_STEM} */ - @Deprecated + @Deprecated(since = "1.9") public void setStem() { setData((byte) MushroomBlockTexture.STEM_SIDES.getData()); } @@ -170,7 +170,7 @@ public class Mushroom extends MaterialData { * * @deprecated Use MushroomBlockType cap options */ - @Deprecated + @Deprecated(since = "1.9") public void setFacePainted(BlockFace face, boolean painted) { if (painted == isFacePainted(face)) { return; diff --git a/paper-api/src/main/java/org/bukkit/material/NetherWarts.java b/paper-api/src/main/java/org/bukkit/material/NetherWarts.java index 1fed8b937a..1e6f4c6cc4 100644 --- a/paper-api/src/main/java/org/bukkit/material/NetherWarts.java +++ b/paper-api/src/main/java/org/bukkit/material/NetherWarts.java @@ -9,7 +9,7 @@ import org.bukkit.NetherWartsState; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class NetherWarts extends MaterialData { public NetherWarts() { super(Material.LEGACY_NETHER_WARTS); @@ -29,7 +29,7 @@ public class NetherWarts extends MaterialData { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public NetherWarts(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Observer.java b/paper-api/src/main/java/org/bukkit/material/Observer.java index 843790b331..e7ade2dd22 100644 --- a/paper-api/src/main/java/org/bukkit/material/Observer.java +++ b/paper-api/src/main/java/org/bukkit/material/Observer.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Observer extends MaterialData implements Directional, Redstone { public Observer() { @@ -30,7 +30,7 @@ public class Observer extends MaterialData implements Directional, Redstone { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.11.2") public Observer(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/PistonBaseMaterial.java b/paper-api/src/main/java/org/bukkit/material/PistonBaseMaterial.java index 8165e94339..a0fe943735 100644 --- a/paper-api/src/main/java/org/bukkit/material/PistonBaseMaterial.java +++ b/paper-api/src/main/java/org/bukkit/material/PistonBaseMaterial.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class PistonBaseMaterial extends MaterialData implements Directional, Redstone { public PistonBaseMaterial(final Material type) { @@ -23,7 +23,7 @@ public class PistonBaseMaterial extends MaterialData implements Directional, Red * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public PistonBaseMaterial(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/PistonExtensionMaterial.java b/paper-api/src/main/java/org/bukkit/material/PistonExtensionMaterial.java index e7cfc7158b..19dfe68e33 100644 --- a/paper-api/src/main/java/org/bukkit/material/PistonExtensionMaterial.java +++ b/paper-api/src/main/java/org/bukkit/material/PistonExtensionMaterial.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class PistonExtensionMaterial extends MaterialData implements Attachable { public PistonExtensionMaterial(final Material type) { @@ -21,7 +21,7 @@ public class PistonExtensionMaterial extends MaterialData implements Attachable * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public PistonExtensionMaterial(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/PoweredRail.java b/paper-api/src/main/java/org/bukkit/material/PoweredRail.java index feebc5c735..e563c8e53a 100644 --- a/paper-api/src/main/java/org/bukkit/material/PoweredRail.java +++ b/paper-api/src/main/java/org/bukkit/material/PoweredRail.java @@ -8,7 +8,7 @@ import org.bukkit.Material; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class PoweredRail extends ExtendedRails implements Redstone { public PoweredRail() { super(Material.LEGACY_POWERED_RAIL); @@ -23,7 +23,7 @@ public class PoweredRail extends ExtendedRails implements Redstone { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public PoweredRail(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/PressurePlate.java b/paper-api/src/main/java/org/bukkit/material/PressurePlate.java index ffababbc1b..8827062fcd 100644 --- a/paper-api/src/main/java/org/bukkit/material/PressurePlate.java +++ b/paper-api/src/main/java/org/bukkit/material/PressurePlate.java @@ -8,7 +8,7 @@ import org.bukkit.Material; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class PressurePlate extends MaterialData implements PressureSensor { public PressurePlate() { super(Material.LEGACY_WOOD_PLATE); @@ -23,7 +23,7 @@ public class PressurePlate extends MaterialData implements PressureSensor { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public PressurePlate(Material type, byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Pumpkin.java b/paper-api/src/main/java/org/bukkit/material/Pumpkin.java index 7c1b5eea0a..55b0ade2cb 100644 --- a/paper-api/src/main/java/org/bukkit/material/Pumpkin.java +++ b/paper-api/src/main/java/org/bukkit/material/Pumpkin.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Pumpkin extends MaterialData implements Directional { public Pumpkin() { @@ -35,7 +35,7 @@ public class Pumpkin extends MaterialData implements Directional { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Pumpkin(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Rails.java b/paper-api/src/main/java/org/bukkit/material/Rails.java index 0b041ee66c..8b6b0139da 100644 --- a/paper-api/src/main/java/org/bukkit/material/Rails.java +++ b/paper-api/src/main/java/org/bukkit/material/Rails.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Rails extends MaterialData { public Rails() { @@ -25,7 +25,7 @@ public class Rails extends MaterialData { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Rails(final Material type, final byte data) { super(type, data); } @@ -105,7 +105,7 @@ public class Rails extends MaterialData { * @return the data without the extended part * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") protected byte getConvertedData() { return getData(); } diff --git a/paper-api/src/main/java/org/bukkit/material/RedstoneTorch.java b/paper-api/src/main/java/org/bukkit/material/RedstoneTorch.java index 4095691436..369f1826ec 100644 --- a/paper-api/src/main/java/org/bukkit/material/RedstoneTorch.java +++ b/paper-api/src/main/java/org/bukkit/material/RedstoneTorch.java @@ -8,7 +8,7 @@ import org.bukkit.Material; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class RedstoneTorch extends Torch implements Redstone { public RedstoneTorch() { super(Material.LEGACY_REDSTONE_TORCH_ON); @@ -23,7 +23,7 @@ public class RedstoneTorch extends Torch implements Redstone { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public RedstoneTorch(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/RedstoneWire.java b/paper-api/src/main/java/org/bukkit/material/RedstoneWire.java index 8877ef48eb..01f93fbacc 100644 --- a/paper-api/src/main/java/org/bukkit/material/RedstoneWire.java +++ b/paper-api/src/main/java/org/bukkit/material/RedstoneWire.java @@ -8,7 +8,7 @@ import org.bukkit.Material; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class RedstoneWire extends MaterialData implements Redstone { public RedstoneWire() { super(Material.LEGACY_REDSTONE_WIRE); @@ -23,7 +23,7 @@ public class RedstoneWire extends MaterialData implements Redstone { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public RedstoneWire(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Sandstone.java b/paper-api/src/main/java/org/bukkit/material/Sandstone.java index 8d8673edcd..6bab43f68a 100644 --- a/paper-api/src/main/java/org/bukkit/material/Sandstone.java +++ b/paper-api/src/main/java/org/bukkit/material/Sandstone.java @@ -9,7 +9,7 @@ import org.bukkit.SandstoneType; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Sandstone extends MaterialData { public Sandstone() { super(Material.LEGACY_SANDSTONE); @@ -29,7 +29,7 @@ public class Sandstone extends MaterialData { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Sandstone(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Sapling.java b/paper-api/src/main/java/org/bukkit/material/Sapling.java index c615a00222..84daf0d756 100644 --- a/paper-api/src/main/java/org/bukkit/material/Sapling.java +++ b/paper-api/src/main/java/org/bukkit/material/Sapling.java @@ -11,7 +11,7 @@ import org.bukkit.TreeSpecies; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Sapling extends Wood { /** @@ -79,7 +79,7 @@ public class Sapling extends Wood { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.9") public Sapling(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Sign.java b/paper-api/src/main/java/org/bukkit/material/Sign.java index 3b32679b4a..48cd4599b7 100644 --- a/paper-api/src/main/java/org/bukkit/material/Sign.java +++ b/paper-api/src/main/java/org/bukkit/material/Sign.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Sign extends MaterialData implements Attachable { public Sign() { super(Material.LEGACY_SIGN_POST); @@ -24,7 +24,7 @@ public class Sign extends MaterialData implements Attachable { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Sign(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/SimpleAttachableMaterialData.java b/paper-api/src/main/java/org/bukkit/material/SimpleAttachableMaterialData.java index 6267d81ba2..d9527c6f78 100644 --- a/paper-api/src/main/java/org/bukkit/material/SimpleAttachableMaterialData.java +++ b/paper-api/src/main/java/org/bukkit/material/SimpleAttachableMaterialData.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public abstract class SimpleAttachableMaterialData extends MaterialData implements Attachable { public SimpleAttachableMaterialData(Material type, BlockFace direction) { @@ -26,7 +26,7 @@ public abstract class SimpleAttachableMaterialData extends MaterialData implemen * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public SimpleAttachableMaterialData(Material type, byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Skull.java b/paper-api/src/main/java/org/bukkit/material/Skull.java index a73ad62468..8339519118 100644 --- a/paper-api/src/main/java/org/bukkit/material/Skull.java +++ b/paper-api/src/main/java/org/bukkit/material/Skull.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Skull extends MaterialData implements Directional { public Skull() { super(Material.LEGACY_SKULL); @@ -34,7 +34,7 @@ public class Skull extends MaterialData implements Directional { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Skull(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/SmoothBrick.java b/paper-api/src/main/java/org/bukkit/material/SmoothBrick.java index e4812b7cef..0dfbe2891f 100644 --- a/paper-api/src/main/java/org/bukkit/material/SmoothBrick.java +++ b/paper-api/src/main/java/org/bukkit/material/SmoothBrick.java @@ -10,7 +10,7 @@ import org.bukkit.Material; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class SmoothBrick extends TexturedMaterial { private static final List textures = new ArrayList(); @@ -37,7 +37,7 @@ public class SmoothBrick extends TexturedMaterial { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public SmoothBrick(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/SpawnEgg.java b/paper-api/src/main/java/org/bukkit/material/SpawnEgg.java index a177021d25..601bd3cfd3 100644 --- a/paper-api/src/main/java/org/bukkit/material/SpawnEgg.java +++ b/paper-api/src/main/java/org/bukkit/material/SpawnEgg.java @@ -8,7 +8,7 @@ import org.bukkit.inventory.meta.SpawnEggMeta; * Represents a spawn egg that can be used to spawn mobs * @deprecated use {@link SpawnEggMeta} */ -@Deprecated +@Deprecated(since = "1.11") public class SpawnEgg extends MaterialData { public SpawnEgg() { @@ -20,7 +20,7 @@ public class SpawnEgg extends MaterialData { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public SpawnEgg(final Material type, final byte data) { super(type, data); } @@ -29,7 +29,7 @@ public class SpawnEgg extends MaterialData { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public SpawnEgg(byte data) { super(Material.LEGACY_MONSTER_EGG, data); } @@ -45,7 +45,7 @@ public class SpawnEgg extends MaterialData { * @return The entity type. * @deprecated This is now stored in {@link SpawnEggMeta}. */ - @Deprecated + @Deprecated(since = "1.9") public EntityType getSpawnedType() { return EntityType.fromId(getData()); } @@ -56,7 +56,7 @@ public class SpawnEgg extends MaterialData { * @param type The entity type. * @deprecated This is now stored in {@link SpawnEggMeta}. */ - @Deprecated + @Deprecated(since = "1.9") public void setSpawnedType(EntityType type) { setData((byte) type.getTypeId()); } diff --git a/paper-api/src/main/java/org/bukkit/material/Stairs.java b/paper-api/src/main/java/org/bukkit/material/Stairs.java index e5db60bd0d..c68a7045b9 100644 --- a/paper-api/src/main/java/org/bukkit/material/Stairs.java +++ b/paper-api/src/main/java/org/bukkit/material/Stairs.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Stairs extends MaterialData implements Directional { public Stairs(final Material type) { @@ -21,7 +21,7 @@ public class Stairs extends MaterialData implements Directional { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Stairs(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Step.java b/paper-api/src/main/java/org/bukkit/material/Step.java index ea94222120..dc5eedb278 100644 --- a/paper-api/src/main/java/org/bukkit/material/Step.java +++ b/paper-api/src/main/java/org/bukkit/material/Step.java @@ -10,7 +10,7 @@ import org.bukkit.Material; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Step extends TexturedMaterial { private static final List textures = new ArrayList(); static { @@ -40,7 +40,7 @@ public class Step extends TexturedMaterial { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Step(final Material type, final byte data) { super(type, data); } @@ -79,7 +79,7 @@ public class Step extends TexturedMaterial { * @deprecated Magic value */ @Override - @Deprecated + @Deprecated(since = "1.20.5") protected int getTextureIndex() { return getData() & 0x7; } @@ -89,7 +89,7 @@ public class Step extends TexturedMaterial { * * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Override protected void setTextureIndex(int idx) { setData((byte) ((getData() & 0x8) | idx)); diff --git a/paper-api/src/main/java/org/bukkit/material/TexturedMaterial.java b/paper-api/src/main/java/org/bukkit/material/TexturedMaterial.java index 6e0a834794..39adc75f7f 100644 --- a/paper-api/src/main/java/org/bukkit/material/TexturedMaterial.java +++ b/paper-api/src/main/java/org/bukkit/material/TexturedMaterial.java @@ -9,7 +9,7 @@ import org.bukkit.Material; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public abstract class TexturedMaterial extends MaterialData { public TexturedMaterial(Material m) { @@ -21,7 +21,7 @@ public abstract class TexturedMaterial extends MaterialData { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public TexturedMaterial(final Material type, final byte data) { super(type, data); } @@ -68,7 +68,7 @@ public abstract class TexturedMaterial extends MaterialData { * @return index of data in textures list * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") protected int getTextureIndex() { return getData(); // Default to using all bits - override for other mappings } @@ -79,7 +79,7 @@ public abstract class TexturedMaterial extends MaterialData { * @param idx - index of data in textures list * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") protected void setTextureIndex(int idx) { setData((byte) idx); // Default to using all bits - override for other mappings } diff --git a/paper-api/src/main/java/org/bukkit/material/Torch.java b/paper-api/src/main/java/org/bukkit/material/Torch.java index a4f0c62dcd..194cd64622 100644 --- a/paper-api/src/main/java/org/bukkit/material/Torch.java +++ b/paper-api/src/main/java/org/bukkit/material/Torch.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Torch extends SimpleAttachableMaterialData { public Torch() { super(Material.LEGACY_TORCH); @@ -24,7 +24,7 @@ public class Torch extends SimpleAttachableMaterialData { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Torch(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/TrapDoor.java b/paper-api/src/main/java/org/bukkit/material/TrapDoor.java index effedfc714..24b4391a91 100644 --- a/paper-api/src/main/java/org/bukkit/material/TrapDoor.java +++ b/paper-api/src/main/java/org/bukkit/material/TrapDoor.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class TrapDoor extends SimpleAttachableMaterialData implements Openable { public TrapDoor() { super(Material.LEGACY_TRAP_DOOR); @@ -24,7 +24,7 @@ public class TrapDoor extends SimpleAttachableMaterialData implements Openable { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public TrapDoor(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Tree.java b/paper-api/src/main/java/org/bukkit/material/Tree.java index e759f50339..5c733a3363 100644 --- a/paper-api/src/main/java/org/bukkit/material/Tree.java +++ b/paper-api/src/main/java/org/bukkit/material/Tree.java @@ -13,7 +13,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Tree extends Wood { protected static final Material DEFAULT_TYPE = Material.LEGACY_LOG; protected static final BlockFace DEFAULT_DIRECTION = BlockFace.UP; @@ -82,7 +82,7 @@ public class Tree extends Wood { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Tree(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Tripwire.java b/paper-api/src/main/java/org/bukkit/material/Tripwire.java index e5ffa4db87..4378b2992b 100644 --- a/paper-api/src/main/java/org/bukkit/material/Tripwire.java +++ b/paper-api/src/main/java/org/bukkit/material/Tripwire.java @@ -8,7 +8,7 @@ import org.bukkit.Material; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Tripwire extends MaterialData { public Tripwire() { @@ -20,7 +20,7 @@ public class Tripwire extends MaterialData { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Tripwire(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/TripwireHook.java b/paper-api/src/main/java/org/bukkit/material/TripwireHook.java index 80aa1c7bc7..458a3e9fc2 100644 --- a/paper-api/src/main/java/org/bukkit/material/TripwireHook.java +++ b/paper-api/src/main/java/org/bukkit/material/TripwireHook.java @@ -9,7 +9,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class TripwireHook extends SimpleAttachableMaterialData implements Redstone { public TripwireHook() { @@ -21,7 +21,7 @@ public class TripwireHook extends SimpleAttachableMaterialData implements Redsto * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public TripwireHook(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Vine.java b/paper-api/src/main/java/org/bukkit/material/Vine.java index 07a4f3b151..784ea52519 100644 --- a/paper-api/src/main/java/org/bukkit/material/Vine.java +++ b/paper-api/src/main/java/org/bukkit/material/Vine.java @@ -11,7 +11,7 @@ import org.bukkit.block.BlockFace; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Vine extends MaterialData { private static final int VINE_NORTH = 0x4; private static final int VINE_EAST = 0x8; @@ -28,7 +28,7 @@ public class Vine extends MaterialData { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Vine(final Material type, final byte data) { super(type, data); } @@ -37,7 +37,7 @@ public class Vine extends MaterialData { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Vine(byte data) { super(Material.LEGACY_VINE, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Wood.java b/paper-api/src/main/java/org/bukkit/material/Wood.java index 5d51c9286d..62253cfc84 100644 --- a/paper-api/src/main/java/org/bukkit/material/Wood.java +++ b/paper-api/src/main/java/org/bukkit/material/Wood.java @@ -13,7 +13,7 @@ import org.bukkit.TreeSpecies; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Wood extends MaterialData { protected static final Material DEFAULT_TYPE = Material.LEGACY_WOOD; protected static final TreeSpecies DEFAULT_SPECIES = TreeSpecies.GENERIC; @@ -60,7 +60,7 @@ public class Wood extends MaterialData { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.9") public Wood(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/WoodenStep.java b/paper-api/src/main/java/org/bukkit/material/WoodenStep.java index b99a9a304d..24990ed257 100644 --- a/paper-api/src/main/java/org/bukkit/material/WoodenStep.java +++ b/paper-api/src/main/java/org/bukkit/material/WoodenStep.java @@ -11,7 +11,7 @@ import org.bukkit.TreeSpecies; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class WoodenStep extends Wood { protected static final Material DEFAULT_TYPE = Material.LEGACY_WOOD_STEP; protected static final boolean DEFAULT_INVERTED = false; @@ -49,7 +49,7 @@ public class WoodenStep extends Wood { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public WoodenStep(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/Wool.java b/paper-api/src/main/java/org/bukkit/material/Wool.java index 3b17409a98..5ad1f9f199 100644 --- a/paper-api/src/main/java/org/bukkit/material/Wool.java +++ b/paper-api/src/main/java/org/bukkit/material/Wool.java @@ -8,7 +8,7 @@ import org.bukkit.Material; * @deprecated all usage of MaterialData is deprecated and subject to removal. * Use {@link org.bukkit.block.data.BlockData}. */ -@Deprecated +@Deprecated(since = "1.14.1") public class Wool extends MaterialData implements Colorable { public Wool() { super(Material.LEGACY_WOOL); @@ -28,7 +28,7 @@ public class Wool extends MaterialData implements Colorable { * @param data the raw data value * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public Wool(final Material type, final byte data) { super(type, data); } diff --git a/paper-api/src/main/java/org/bukkit/material/types/MushroomBlockTexture.java b/paper-api/src/main/java/org/bukkit/material/types/MushroomBlockTexture.java index 0ea9c6b242..0044381b8a 100644 --- a/paper-api/src/main/java/org/bukkit/material/types/MushroomBlockTexture.java +++ b/paper-api/src/main/java/org/bukkit/material/types/MushroomBlockTexture.java @@ -80,7 +80,7 @@ public enum MushroomBlockTexture { * @return A byte containing the data value of this mushroom block face * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.9") public byte getData() { return data; } @@ -103,7 +103,7 @@ public enum MushroomBlockTexture { * null if it doesn't exist * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.9") @Nullable public static MushroomBlockTexture getByData(final byte data) { return BY_DATA.get(data); diff --git a/paper-api/src/main/java/org/bukkit/persistence/PersistentDataType.java b/paper-api/src/main/java/org/bukkit/persistence/PersistentDataType.java index 30dca64980..709e0eb08f 100644 --- a/paper-api/src/main/java/org/bukkit/persistence/PersistentDataType.java +++ b/paper-api/src/main/java/org/bukkit/persistence/PersistentDataType.java @@ -90,7 +90,7 @@ public interface PersistentDataType { * {@link ListPersistentDataType}s offer full support for primitive types, such as the * {@link PersistentDataContainer}. */ - @Deprecated + @Deprecated(since = "1.20.4") PersistentDataType TAG_CONTAINER_ARRAY = new PrimitivePersistentDataType<>(PersistentDataContainer[].class); /* diff --git a/paper-api/src/main/java/org/bukkit/plugin/PluginAwareness.java b/paper-api/src/main/java/org/bukkit/plugin/PluginAwareness.java index 3f535ed5d4..2fb458372c 100644 --- a/paper-api/src/main/java/org/bukkit/plugin/PluginAwareness.java +++ b/paper-api/src/main/java/org/bukkit/plugin/PluginAwareness.java @@ -21,7 +21,7 @@ public interface PluginAwareness { * * @deprecated all plugins are now assumed to be UTF-8 aware. */ - @Deprecated + @Deprecated(since = "1.9") UTF8, ; } diff --git a/paper-api/src/main/java/org/bukkit/plugin/PluginDescriptionFile.java b/paper-api/src/main/java/org/bukkit/plugin/PluginDescriptionFile.java index 8e44f7eaf9..4d444ed5bc 100644 --- a/paper-api/src/main/java/org/bukkit/plugin/PluginDescriptionFile.java +++ b/paper-api/src/main/java/org/bukkit/plugin/PluginDescriptionFile.java @@ -990,7 +990,7 @@ public final class PluginDescriptionFile { * @return unused * @deprecated unused */ - @Deprecated + @Deprecated(since = "1.7.2") @Nullable public String getClassLoaderOf() { return classLoaderOf; diff --git a/paper-api/src/main/java/org/bukkit/plugin/SimplePluginManager.java b/paper-api/src/main/java/org/bukkit/plugin/SimplePluginManager.java index 04dda4d227..04f797ce2b 100644 --- a/paper-api/src/main/java/org/bukkit/plugin/SimplePluginManager.java +++ b/paper-api/src/main/java/org/bukkit/plugin/SimplePluginManager.java @@ -707,7 +707,7 @@ public final class SimplePluginManager implements PluginManager { addPermission(perm, true); } - @Deprecated + @Deprecated(since = "1.12") public void addPermission(@NotNull Permission perm, boolean dirty) { String name = perm.getName().toLowerCase(Locale.ROOT); @@ -760,7 +760,7 @@ public final class SimplePluginManager implements PluginManager { } } - @Deprecated + @Deprecated(since = "1.12") public void dirtyPermissibles() { dirtyPermissibles(true); dirtyPermissibles(false); diff --git a/paper-api/src/main/java/org/bukkit/plugin/java/JavaPluginLoader.java b/paper-api/src/main/java/org/bukkit/plugin/java/JavaPluginLoader.java index 39b991ff7e..ef913c6ecc 100644 --- a/paper-api/src/main/java/org/bukkit/plugin/java/JavaPluginLoader.java +++ b/paper-api/src/main/java/org/bukkit/plugin/java/JavaPluginLoader.java @@ -59,7 +59,7 @@ public final class JavaPluginLoader implements PluginLoader { * * @param instance the server instance */ - @Deprecated + @Deprecated(since = "1.4.5") public JavaPluginLoader(@NotNull Server instance) { Preconditions.checkArgument(instance != null, "Server cannot be null"); server = instance; diff --git a/paper-api/src/main/java/org/bukkit/plugin/messaging/StandardMessenger.java b/paper-api/src/main/java/org/bukkit/plugin/messaging/StandardMessenger.java index 1d061412cd..ed39f5116b 100644 --- a/paper-api/src/main/java/org/bukkit/plugin/messaging/StandardMessenger.java +++ b/paper-api/src/main/java/org/bukkit/plugin/messaging/StandardMessenger.java @@ -468,7 +468,7 @@ public class StandardMessenger implements Messenger { * @param channel Channel name to validate. * @deprecated not an API method */ - @Deprecated + @Deprecated(since = "1.13") public static void validateChannel(@NotNull String channel) { validateAndCorrectChannel(channel); } @@ -480,7 +480,7 @@ public class StandardMessenger implements Messenger { * @return corrected channel name * @deprecated not an API method */ - @Deprecated + @Deprecated(since = "1.13") @NotNull public static String validateAndCorrectChannel(@NotNull String channel) { if (channel == null) { diff --git a/paper-api/src/main/java/org/bukkit/potion/PotionBrewer.java b/paper-api/src/main/java/org/bukkit/potion/PotionBrewer.java index 2072f048e1..a90a979014 100644 --- a/paper-api/src/main/java/org/bukkit/potion/PotionBrewer.java +++ b/paper-api/src/main/java/org/bukkit/potion/PotionBrewer.java @@ -28,7 +28,7 @@ public interface PotionBrewer { * @return The list of effects * @deprecated Non-Functional */ - @Deprecated + @Deprecated(since = "1.6.2") @NotNull public Collection getEffectsFromDamage(int damage); @@ -43,6 +43,6 @@ public interface PotionBrewer { * @deprecated Upgraded / extended potions are now their own {@link PotionType} use {@link PotionType#getPotionEffects()} instead */ @NotNull - @Deprecated + @Deprecated(since = "1.20.2") public Collection getEffects(@NotNull PotionType type, boolean upgraded, boolean extended); } diff --git a/paper-api/src/main/java/org/bukkit/potion/PotionData.java b/paper-api/src/main/java/org/bukkit/potion/PotionData.java index ee6d07fb3e..11d97e6d94 100644 --- a/paper-api/src/main/java/org/bukkit/potion/PotionData.java +++ b/paper-api/src/main/java/org/bukkit/potion/PotionData.java @@ -6,7 +6,7 @@ import org.jetbrains.annotations.NotNull; /** * @deprecated Upgraded / extended potions are now their own {@link PotionType} use them instead. */ -@Deprecated(forRemoval = true) +@Deprecated(since = "1.20.6", forRemoval = true) public final class PotionData { private final PotionType type; diff --git a/paper-api/src/main/java/org/bukkit/potion/PotionEffect.java b/paper-api/src/main/java/org/bukkit/potion/PotionEffect.java index 89d49ce1e9..6478faee91 100644 --- a/paper-api/src/main/java/org/bukkit/potion/PotionEffect.java +++ b/paper-api/src/main/java/org/bukkit/potion/PotionEffect.java @@ -256,9 +256,9 @@ public class PotionEffect implements ConfigurationSerializable { * @return color of this potion's particles. May be null if the potion has no particles or defined color. * @deprecated color is not part of potion effects */ - @Deprecated - @Nullable - @Contract("-> null") + @Deprecated(since = "1.13") + @Nullable + @Contract("-> null") public Color getColor() { return null; } diff --git a/paper-api/src/main/java/org/bukkit/potion/PotionEffectType.java b/paper-api/src/main/java/org/bukkit/potion/PotionEffectType.java index bd9ea2fe16..7fbcb12516 100644 --- a/paper-api/src/main/java/org/bukkit/potion/PotionEffectType.java +++ b/paper-api/src/main/java/org/bukkit/potion/PotionEffectType.java @@ -271,7 +271,7 @@ public abstract class PotionEffectType implements Keyed, Translatable { * @return duration modifier * @deprecated unused, always 1.0 */ - @Deprecated + @Deprecated(since = "1.14") public abstract double getDurationModifier(); /** @@ -280,7 +280,7 @@ public abstract class PotionEffectType implements Keyed, Translatable { * @return Unique ID * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") public abstract int getId(); /** @@ -290,7 +290,7 @@ public abstract class PotionEffectType implements Keyed, Translatable { * @deprecated only for backwards compatibility, use {@link #getKey()} instead. */ @NotNull - @Deprecated + @Deprecated(since = "1.20.3") public abstract String getName(); /** @@ -302,7 +302,7 @@ public abstract class PotionEffectType implements Keyed, Translatable { */ @Contract("null -> null") @Nullable - @Deprecated + @Deprecated(since = "1.20.3") public static PotionEffectType getByKey(@Nullable NamespacedKey key) { if (key == null) { return null; @@ -318,7 +318,7 @@ public abstract class PotionEffectType implements Keyed, Translatable { * @return Resulting type, or null if not found. * @deprecated Magic value */ - @Deprecated + @Deprecated(since = "1.6.2") @Nullable public static PotionEffectType getById(int id) { PotionEffectType type = ID_MAP.get(id); @@ -345,7 +345,7 @@ public abstract class PotionEffectType implements Keyed, Translatable { * @deprecated only for backwards compatibility, use {@link Registry#get(NamespacedKey)} instead. */ @Nullable - @Deprecated + @Deprecated(since = "1.20.3") public static PotionEffectType getByName(@NotNull String name) { Preconditions.checkArgument(name != null, "name cannot be null"); return Registry.EFFECT.get(NamespacedKey.fromString(name.toLowerCase(Locale.ROOT))); @@ -356,7 +356,7 @@ public abstract class PotionEffectType implements Keyed, Translatable { * @deprecated use {@link Registry#iterator()}. */ @NotNull - @Deprecated + @Deprecated(since = "1.20.3") public static PotionEffectType[] values() { return Lists.newArrayList(Registry.EFFECT).toArray(new PotionEffectType[0]); } diff --git a/paper-api/src/main/java/org/bukkit/potion/PotionEffectTypeWrapper.java b/paper-api/src/main/java/org/bukkit/potion/PotionEffectTypeWrapper.java index a613debb03..6861d1cfce 100644 --- a/paper-api/src/main/java/org/bukkit/potion/PotionEffectTypeWrapper.java +++ b/paper-api/src/main/java/org/bukkit/potion/PotionEffectTypeWrapper.java @@ -5,7 +5,7 @@ import org.jetbrains.annotations.NotNull; /** * @deprecated only for backwards compatibility, PotionEffectTypeWrapper is no longer used. */ -@Deprecated +@Deprecated(since = "1.20.3") public abstract class PotionEffectTypeWrapper extends PotionEffectType { protected PotionEffectTypeWrapper() { } diff --git a/paper-api/src/main/java/org/bukkit/potion/PotionType.java b/paper-api/src/main/java/org/bukkit/potion/PotionType.java index 453c626092..ca79f97be6 100644 --- a/paper-api/src/main/java/org/bukkit/potion/PotionType.java +++ b/paper-api/src/main/java/org/bukkit/potion/PotionType.java @@ -76,7 +76,7 @@ public enum PotionType implements Keyed { * @deprecated Potions can have multiple effects use {@link #getPotionEffects()} */ @Nullable - @Deprecated + @Deprecated(since = "1.20.2") public PotionEffectType getEffectType() { return internalPotionDataSupplier.get().getEffectType(); } @@ -94,7 +94,7 @@ public enum PotionType implements Keyed { * @deprecated PotionType can have multiple effects, some of which can be instant and others not. * Use {@link PotionEffectType#isInstant()} in combination with {@link #getPotionEffects()} and {@link PotionEffect#getType()} */ - @Deprecated + @Deprecated(since = "1.20.2") public boolean isInstant() { return internalPotionDataSupplier.get().isInstant(); } @@ -129,7 +129,7 @@ public enum PotionType implements Keyed { * @return the matching potion type * @deprecated Misleading */ - @Deprecated + @Deprecated(since = "1.9") @Nullable public static PotionType getByEffect(@Nullable PotionEffectType effectType) { if (effectType == null) @@ -150,7 +150,7 @@ public enum PotionType implements Keyed { /** * @deprecated Do not use, interface will get removed, and the plugin won't run */ - @Deprecated + @Deprecated(since = "1.20.2") @ApiStatus.Internal public interface InternalPotionData { diff --git a/paper-api/src/main/java/org/bukkit/scheduler/BukkitScheduler.java b/paper-api/src/main/java/org/bukkit/scheduler/BukkitScheduler.java index 0368e9125e..0a0e946190 100644 --- a/paper-api/src/main/java/org/bukkit/scheduler/BukkitScheduler.java +++ b/paper-api/src/main/java/org/bukkit/scheduler/BukkitScheduler.java @@ -28,7 +28,7 @@ public interface BukkitScheduler { * @return Task id number (-1 if scheduling failed) * @deprecated Use {@link BukkitRunnable#runTaskLater(Plugin, long)} */ - @Deprecated + @Deprecated(since = "1.7.10") public int scheduleSyncDelayedTask(@NotNull Plugin plugin, @NotNull BukkitRunnable task, long delay); /** @@ -48,7 +48,7 @@ public interface BukkitScheduler { * @return Task id number (-1 if scheduling failed) * @deprecated Use {@link BukkitRunnable#runTask(Plugin)} */ - @Deprecated + @Deprecated(since = "1.7.10") public int scheduleSyncDelayedTask(@NotNull Plugin plugin, @NotNull BukkitRunnable task); /** @@ -72,7 +72,7 @@ public interface BukkitScheduler { * @return Task id number (-1 if scheduling failed) * @deprecated Use {@link BukkitRunnable#runTaskTimer(Plugin, long, long)} */ - @Deprecated + @Deprecated(since = "1.7.10") public int scheduleSyncRepeatingTask(@NotNull Plugin plugin, @NotNull BukkitRunnable task, long delay, long period); /** @@ -89,7 +89,7 @@ public interface BukkitScheduler { * @deprecated This name is misleading, as it does not schedule "a sync" * task, but rather, "an async" task */ - @Deprecated + @Deprecated(since = "1.4.5") public int scheduleAsyncDelayedTask(@NotNull Plugin plugin, @NotNull Runnable task, long delay); /** @@ -105,7 +105,7 @@ public interface BukkitScheduler { * @deprecated This name is misleading, as it does not schedule "a sync" * task, but rather, "an async" task */ - @Deprecated + @Deprecated(since = "1.4.5") public int scheduleAsyncDelayedTask(@NotNull Plugin plugin, @NotNull Runnable task); /** @@ -123,7 +123,7 @@ public interface BukkitScheduler { * @deprecated This name is misleading, as it does not schedule "a sync" * task, but rather, "an async" task */ - @Deprecated + @Deprecated(since = "1.4.5") public int scheduleAsyncRepeatingTask(@NotNull Plugin plugin, @NotNull Runnable task, long delay, long period); /** @@ -237,7 +237,7 @@ public interface BukkitScheduler { * @throws IllegalArgumentException if task is null * @deprecated Use {@link BukkitRunnable#runTask(Plugin)} */ - @Deprecated + @Deprecated(since = "1.7.10") @NotNull public BukkitTask runTask(@NotNull Plugin plugin, @NotNull BukkitRunnable task) throws IllegalArgumentException; @@ -277,7 +277,7 @@ public interface BukkitScheduler { * @throws IllegalArgumentException if task is null * @deprecated Use {@link BukkitRunnable#runTaskAsynchronously(Plugin)} */ - @Deprecated + @Deprecated(since = "1.7.10") @NotNull public BukkitTask runTaskAsynchronously(@NotNull Plugin plugin, @NotNull BukkitRunnable task) throws IllegalArgumentException; @@ -316,7 +316,7 @@ public interface BukkitScheduler { * @throws IllegalArgumentException if task is null * @deprecated Use {@link BukkitRunnable#runTaskLater(Plugin, long)} */ - @Deprecated + @Deprecated(since = "1.7.10") @NotNull public BukkitTask runTaskLater(@NotNull Plugin plugin, @NotNull BukkitRunnable task, long delay) throws IllegalArgumentException; @@ -361,7 +361,7 @@ public interface BukkitScheduler { * @throws IllegalArgumentException if task is null * @deprecated Use {@link BukkitRunnable#runTaskLaterAsynchronously(Plugin, long)} */ - @Deprecated + @Deprecated(since = "1.7.10") @NotNull public BukkitTask runTaskLaterAsynchronously(@NotNull Plugin plugin, @NotNull BukkitRunnable task, long delay) throws IllegalArgumentException; @@ -403,7 +403,7 @@ public interface BukkitScheduler { * @throws IllegalArgumentException if task is null * @deprecated Use {@link BukkitRunnable#runTaskTimer(Plugin, long, long)} */ - @Deprecated + @Deprecated(since = "1.7.10") @NotNull public BukkitTask runTaskTimer(@NotNull Plugin plugin, @NotNull BukkitRunnable task, long delay, long period) throws IllegalArgumentException; @@ -454,7 +454,7 @@ public interface BukkitScheduler { * @throws IllegalArgumentException if task is null * @deprecated Use {@link BukkitRunnable#runTaskTimerAsynchronously(Plugin, long, long)} */ - @Deprecated + @Deprecated(since = "1.7.10") @NotNull public BukkitTask runTaskTimerAsynchronously(@NotNull Plugin plugin, @NotNull BukkitRunnable task, long delay, long period) throws IllegalArgumentException; } diff --git a/paper-api/src/main/java/org/bukkit/scoreboard/Criterias.java b/paper-api/src/main/java/org/bukkit/scoreboard/Criterias.java index 66f05a87bd..25bf2f94b5 100644 --- a/paper-api/src/main/java/org/bukkit/scoreboard/Criterias.java +++ b/paper-api/src/main/java/org/bukkit/scoreboard/Criterias.java @@ -5,7 +5,7 @@ package org.bukkit.scoreboard; * * @deprecated use the constants declared in {@link Criteria} instead */ -@Deprecated +@Deprecated(since = "1.19.2") public final class Criterias { public static final String HEALTH = "health"; diff --git a/paper-api/src/main/java/org/bukkit/scoreboard/NameTagVisibility.java b/paper-api/src/main/java/org/bukkit/scoreboard/NameTagVisibility.java index d9e9ae1a97..26e25cf87d 100644 --- a/paper-api/src/main/java/org/bukkit/scoreboard/NameTagVisibility.java +++ b/paper-api/src/main/java/org/bukkit/scoreboard/NameTagVisibility.java @@ -3,7 +3,7 @@ package org.bukkit.scoreboard; /** * @deprecated replaced by {@link Team.OptionStatus} */ -@Deprecated +@Deprecated(since = "1.9") public enum NameTagVisibility { /** diff --git a/paper-api/src/main/java/org/bukkit/scoreboard/Objective.java b/paper-api/src/main/java/org/bukkit/scoreboard/Objective.java index 78fd35e611..c15e056e76 100644 --- a/paper-api/src/main/java/org/bukkit/scoreboard/Objective.java +++ b/paper-api/src/main/java/org/bukkit/scoreboard/Objective.java @@ -44,7 +44,7 @@ public interface Objective { * @throws IllegalStateException if this objective has been unregistered * @deprecated use {@link #getTrackedCriteria()} */ - @Deprecated + @Deprecated(since = "1.19.2") @NotNull String getCriteria(); @@ -126,7 +126,7 @@ public interface Objective { * @see #getScore(String) * @deprecated Scoreboards can contain entries that aren't players */ - @Deprecated + @Deprecated(since = "1.7.8") @NotNull Score getScore(@NotNull OfflinePlayer player); diff --git a/paper-api/src/main/java/org/bukkit/scoreboard/Score.java b/paper-api/src/main/java/org/bukkit/scoreboard/Score.java index 8579c4f5e8..787bb91b48 100644 --- a/paper-api/src/main/java/org/bukkit/scoreboard/Score.java +++ b/paper-api/src/main/java/org/bukkit/scoreboard/Score.java @@ -18,7 +18,7 @@ public interface Score { * @see #getEntry() * @deprecated Scoreboards can contain entries that aren't players */ - @Deprecated + @Deprecated(since = "1.7.8") @NotNull OfflinePlayer getPlayer(); diff --git a/paper-api/src/main/java/org/bukkit/scoreboard/Scoreboard.java b/paper-api/src/main/java/org/bukkit/scoreboard/Scoreboard.java index bf52375e9e..a55188ec3e 100644 --- a/paper-api/src/main/java/org/bukkit/scoreboard/Scoreboard.java +++ b/paper-api/src/main/java/org/bukkit/scoreboard/Scoreboard.java @@ -22,7 +22,7 @@ public interface Scoreboard { * exists * @deprecated a displayName should be explicitly specified */ - @Deprecated + @Deprecated(since = "1.13") @NotNull Objective registerNewObjective(@NotNull String name, @NotNull String criteria); @@ -39,7 +39,7 @@ public interface Scoreboard { * exists * @deprecated use {@link #registerNewObjective(String, Criteria, String)} */ - @Deprecated + @Deprecated(since = "1.20.5") @NotNull Objective registerNewObjective(@NotNull String name, @NotNull String criteria, @NotNull String displayName); @@ -57,7 +57,7 @@ public interface Scoreboard { * exists * @deprecated use {@link #registerNewObjective(String, Criteria, String, RenderType)} */ - @Deprecated + @Deprecated(since = "1.20.5") @NotNull Objective registerNewObjective(@NotNull String name, @NotNull String criteria, @NotNull String displayName, @NotNull RenderType renderType); @@ -108,7 +108,7 @@ public interface Scoreboard { * @return an immutable set of Objectives using the specified Criteria * @deprecated use {@link #getObjectivesByCriteria(Criteria)} */ - @Deprecated + @Deprecated(since = "1.19.2") @NotNull Set getObjectivesByCriteria(@NotNull String criteria); @@ -148,7 +148,7 @@ public interface Scoreboard { * @see #getScores(String) * @deprecated Scoreboards can contain entries that aren't players */ - @Deprecated + @Deprecated(since = "1.7.8") @NotNull Set getScores(@NotNull OfflinePlayer player); @@ -168,7 +168,7 @@ public interface Scoreboard { * @see #resetScores(String) * @deprecated Scoreboards can contain entries that aren't players */ - @Deprecated + @Deprecated(since = "1.7.8") void resetScores(@NotNull OfflinePlayer player); /** @@ -186,7 +186,7 @@ public interface Scoreboard { * @see #getEntryTeam(String) * @deprecated Scoreboards can contain entries that aren't players */ - @Deprecated + @Deprecated(since = "1.8.6") @Nullable Team getPlayerTeam(@NotNull OfflinePlayer player); @@ -233,7 +233,7 @@ public interface Scoreboard { * @see #getEntries() * @deprecated Scoreboards can contain entries that aren't players */ - @Deprecated + @Deprecated(since = "1.7.8") @NotNull Set getPlayers(); diff --git a/paper-api/src/main/java/org/bukkit/scoreboard/Team.java b/paper-api/src/main/java/org/bukkit/scoreboard/Team.java index 7b9a7890b2..f6e684853f 100644 --- a/paper-api/src/main/java/org/bukkit/scoreboard/Team.java +++ b/paper-api/src/main/java/org/bukkit/scoreboard/Team.java @@ -138,7 +138,7 @@ public interface Team { * @throws IllegalArgumentException if this team has been unregistered * @deprecated see {@link #getOption(Team.Option)} */ - @Deprecated + @Deprecated(since = "1.9") @NotNull NameTagVisibility getNameTagVisibility(); @@ -149,7 +149,7 @@ public interface Team { * @throws IllegalArgumentException if this team has been unregistered * @deprecated see {@link #setOption(Team.Option, Team.OptionStatus)} */ - @Deprecated + @Deprecated(since = "1.9") void setNameTagVisibility(@NotNull NameTagVisibility visibility); /** @@ -160,7 +160,7 @@ public interface Team { * @see #getEntries() * @deprecated Teams can contain entries that aren't players */ - @Deprecated + @Deprecated(since = "1.8.6") @NotNull Set getPlayers(); @@ -200,7 +200,7 @@ public interface Team { * @see #addEntry(String) * @deprecated Teams can contain entries that aren't players */ - @Deprecated + @Deprecated(since = "1.8.6") void addPlayer(@NotNull OfflinePlayer player); /** @@ -222,7 +222,7 @@ public interface Team { * @see #removeEntry(String) * @deprecated Teams can contain entries that aren't players */ - @Deprecated + @Deprecated(since = "1.8.6") boolean removePlayer(@NotNull OfflinePlayer player); /** @@ -250,7 +250,7 @@ public interface Team { * @see #hasEntry(String) * @deprecated Teams can contain entries that aren't players */ - @Deprecated + @Deprecated(since = "1.8.6") boolean hasPlayer(@NotNull OfflinePlayer player); /** * Checks to see if the specified entry is a member of this team. diff --git a/paper-api/src/main/java/org/bukkit/util/Consumer.java b/paper-api/src/main/java/org/bukkit/util/Consumer.java index dd6bfbc439..37deda46fe 100644 --- a/paper-api/src/main/java/org/bukkit/util/Consumer.java +++ b/paper-api/src/main/java/org/bukkit/util/Consumer.java @@ -10,7 +10,7 @@ package org.bukkit.util; // Bukkit developer note (NOT plugin developers): // NEVER use this consumer in the API. // API methods which use this consumer will be remapped to Java's consumer at runtime, resulting in an error. -@Deprecated +@Deprecated(since = "1.20.2") public interface Consumer extends java.util.function.Consumer { /** diff --git a/paper-api/src/test/java/org/bukkit/DeprecatedTest.java b/paper-api/src/test/java/org/bukkit/DeprecatedTest.java new file mode 100644 index 0000000000..dd3b241c7b --- /dev/null +++ b/paper-api/src/test/java/org/bukkit/DeprecatedTest.java @@ -0,0 +1,147 @@ +package org.bukkit; + +import static org.junit.jupiter.api.Assertions.*; +import com.google.common.base.Joiner; +import java.util.ArrayList; +import java.util.List; +import org.bukkit.support.test.ClassNodeTest; +import org.objectweb.asm.Type; +import org.objectweb.asm.tree.AnnotationNode; +import org.objectweb.asm.tree.ClassNode; +import org.objectweb.asm.tree.FieldNode; +import org.objectweb.asm.tree.MethodNode; +import org.objectweb.asm.tree.RecordComponentNode; + +public class DeprecatedTest { + + private static final String DEPRECATED_DESC = Type.getDescriptor(Deprecated.class); + + @ClassNodeTest + public void testIfSinceIsPresent(ClassNode classNode) { + List missingReason = new ArrayList<>(); + + // Check class annotation + checkAnnotation(missingReason, classNode.invisibleAnnotations, "Class"); + checkAnnotation(missingReason, classNode.visibleAnnotations, "Class"); + checkAnnotation(missingReason, classNode.invisibleTypeAnnotations, "Class"); + checkAnnotation(missingReason, classNode.visibleTypeAnnotations, "Class"); + + if (classNode.recordComponents != null) { + for (RecordComponentNode recordComponentNode : classNode.recordComponents) { + checkAnnotation(missingReason, recordComponentNode.invisibleAnnotations, "RecordComponent '%s'".formatted(recordComponentNode.name)); + checkAnnotation(missingReason, recordComponentNode.visibleAnnotations, "RecordComponent '%s'".formatted(recordComponentNode.name)); + checkAnnotation(missingReason, recordComponentNode.invisibleTypeAnnotations, "RecordComponent '%s'".formatted(recordComponentNode.name)); + checkAnnotation(missingReason, recordComponentNode.visibleTypeAnnotations, "RecordComponent '%s'".formatted(recordComponentNode.name)); + } + } + + if (classNode.fields != null) { + for (FieldNode fieldNode : classNode.fields) { + checkAnnotation(missingReason, fieldNode.invisibleAnnotations, "Field '%s'".formatted(fieldNode.name)); + checkAnnotation(missingReason, fieldNode.visibleAnnotations, "Field '%s'".formatted(fieldNode.name)); + checkAnnotation(missingReason, fieldNode.invisibleTypeAnnotations, "Field '%s'".formatted(fieldNode.name)); + checkAnnotation(missingReason, fieldNode.visibleTypeAnnotations, "Field '%s'".formatted(fieldNode.name)); + } + } + + if (classNode.methods != null) { + for (MethodNode methodNode : classNode.methods) { + checkAnnotation(missingReason, methodNode.invisibleAnnotations, "Method '%s'".formatted(methodNode.name)); + checkAnnotation(missingReason, methodNode.visibleAnnotations, "Method '%s'".formatted(methodNode.name)); + checkAnnotation(missingReason, methodNode.invisibleTypeAnnotations, "Method '%s'".formatted(methodNode.name)); + checkAnnotation(missingReason, methodNode.visibleTypeAnnotations, "Method '%s'".formatted(methodNode.name)); + + if (methodNode.visibleParameterAnnotations != null) { + for (int i = 0; i < methodNode.visibleParameterAnnotations.length; i++) { + checkAnnotation(missingReason, methodNode.visibleParameterAnnotations[i], "Method Parameter '%d' for Method '%s'".formatted(i, methodNode.name)); + } + } + + if (methodNode.invisibleParameterAnnotations != null) { + for (int i = 0; i < methodNode.invisibleParameterAnnotations.length; i++) { + checkAnnotation(missingReason, methodNode.invisibleParameterAnnotations[i], "Method Parameter '%d' for Method '%s'".formatted(i, methodNode.name)); + } + } + + checkAnnotation(missingReason, methodNode.visibleLocalVariableAnnotations, "Local variable in Method '%s'".formatted(methodNode.name)); + checkAnnotation(missingReason, methodNode.invisibleLocalVariableAnnotations, "Local variable in Method '%s'".formatted(methodNode.name)); + } + } + + assertTrue(missingReason.isEmpty(), """ + Missing or wrongly formatted (only format 'number.number[.number]' is supported) 'since' value in 'Deprecated' annotation found. + In Class '%s'. + + Following places where found: + %s""".formatted(classNode.name, Joiner.on('\n').join(missingReason))); + } + + private void checkAnnotation(List missingReason, List annotationNodes, String where) { + if (annotationNodes == null || annotationNodes.isEmpty()) { + return; + } + + for (AnnotationNode annotationNode : annotationNodes) { + if (!annotationNode.desc.equals(DEPRECATED_DESC)) { + continue; + } + + if (!hasSince(annotationNode)) { + missingReason.add(where); + } + } + } + + private boolean hasSince(AnnotationNode annotationNode) { + if (annotationNode.values == null || annotationNode.values.isEmpty()) { + return false; + } + + for (int i = 0; i < annotationNode.values.size(); i = i + 2) { + if ("since".equals(annotationNode.values.get(i))) { + String other = (String) annotationNode.values.get(i + 1); + + if (other == null || other.isEmpty()) { + return false; + } + + if (!isValidVersion(other)) { + return false; + } + + return true; + } + } + + return false; + } + + private boolean isValidVersion(String version) { + String[] versionParts = version.split("\\."); + + if (versionParts.length != 2 && versionParts.length != 3) { + return false; + } + + if (!isNumber(versionParts[0])) { + return false; + } + if (!isNumber(versionParts[1])) { + return false; + } + if (versionParts.length == 3 && !isNumber(versionParts[2])) { + return false; + } + + return true; + } + + private boolean isNumber(String number) { + try { + Integer.parseInt(number); + } catch (NumberFormatException e) { + return false; + } + return true; + } +} diff --git a/paper-api/src/test/java/org/bukkit/support/provider/ClassNodeArgumentProvider.java b/paper-api/src/test/java/org/bukkit/support/provider/ClassNodeArgumentProvider.java new file mode 100644 index 0000000000..dabc7acce4 --- /dev/null +++ b/paper-api/src/test/java/org/bukkit/support/provider/ClassNodeArgumentProvider.java @@ -0,0 +1,53 @@ +package org.bukkit.support.provider; + +import java.lang.annotation.Annotation; +import java.util.stream.Stream; +import org.bukkit.support.test.ClassNodeTest; +import org.bukkit.support.test.ClassReaderTest; +import org.junit.jupiter.api.extension.ExtensionContext; +import org.junit.jupiter.params.provider.Arguments; +import org.junit.jupiter.params.provider.ArgumentsProvider; +import org.junit.jupiter.params.support.AnnotationConsumer; +import org.objectweb.asm.ClassReader; +import org.objectweb.asm.Opcodes; +import org.objectweb.asm.tree.ClassNode; + +public class ClassNodeArgumentProvider implements ArgumentsProvider, AnnotationConsumer { + + private Class[] excludedClasses; + private String[] excludedPackages; + + @Override + public void accept(ClassNodeTest classNodeTest) { + this.excludedClasses = classNodeTest.excludedClasses(); + this.excludedPackages = classNodeTest.excludedPackages(); + + for (int i = 0; i < excludedPackages.length; i++) { + this.excludedPackages[i] = this.excludedPackages[i].replace('.', '/'); + } + } + + @Override + public Stream provideArguments(ExtensionContext extensionContext) throws Exception { + ClassReaderArgumentProvider classReaderArgumentProvider = new ClassReaderArgumentProvider(); + classReaderArgumentProvider.accept(new ClassReaderArguments(excludedClasses, excludedPackages)); + + return classReaderArgumentProvider.getClassReaders().map(this::toClassNode).map(Arguments::of); + } + + private ClassNode toClassNode(ClassReader classReader) { + ClassNode classNode = new ClassNode(Opcodes.ASM9); + + classReader.accept(classNode, Opcodes.ASM9); + + return classNode; + } + + private record ClassReaderArguments(Class[] excludedClasses, String[] excludedPackages) implements ClassReaderTest { + + @Override + public Class annotationType() { + return null; + } + } +} diff --git a/paper-api/src/test/java/org/bukkit/support/provider/ClassReaderArgumentProvider.java b/paper-api/src/test/java/org/bukkit/support/provider/ClassReaderArgumentProvider.java new file mode 100644 index 0000000000..cba9e535e0 --- /dev/null +++ b/paper-api/src/test/java/org/bukkit/support/provider/ClassReaderArgumentProvider.java @@ -0,0 +1,107 @@ +package org.bukkit.support.provider; + +import java.io.File; +import java.io.FileInputStream; +import java.io.FileNotFoundException; +import java.io.IOException; +import java.io.InputStream; +import java.net.URI; +import java.net.URISyntaxException; +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.stream.Stream; +import org.bukkit.Bukkit; +import org.bukkit.support.test.ClassReaderTest; +import org.junit.jupiter.api.extension.ExtensionContext; +import org.junit.jupiter.params.provider.Arguments; +import org.junit.jupiter.params.provider.ArgumentsProvider; +import org.junit.jupiter.params.support.AnnotationConsumer; +import org.objectweb.asm.ClassReader; + +public class ClassReaderArgumentProvider implements ArgumentsProvider, AnnotationConsumer { + + // Needs to be a class, which is from the bukkit package and not a CraftBukkit class + private static final URI BUKKIT_CLASSES; + + static { + try { + BUKKIT_CLASSES = Bukkit.class.getProtectionDomain().getCodeSource().getLocation().toURI(); + } catch (URISyntaxException e) { + throw new RuntimeException(e); + } + } + + private Class[] excludedClasses; + private String[] excludedPackages; + + @Override + public void accept(ClassReaderTest classReaderTest) { + this.excludedClasses = classReaderTest.excludedClasses(); + this.excludedPackages = classReaderTest.excludedPackages(); + + for (int i = 0; i < excludedPackages.length; i++) { + this.excludedPackages[i] = this.excludedPackages[i].replace('.', '/'); + } + } + + @Override + public Stream provideArguments(ExtensionContext extensionContext) throws Exception { + return getClassReaders().map(Arguments::of); + } + + public Stream getClassReaders() { + return readBukkitClasses().map(this::toClassReader); + } + + private ClassReader toClassReader(InputStream stream) { + try (stream) { + return new ClassReader(stream); + } catch (IOException e) { + throw new RuntimeException(e); + } + } + + private Stream readBukkitClasses() { + try { + return Files.walk(Path.of(BUKKIT_CLASSES)) + .map(Path::toFile) + .filter(File::isFile) + .filter(file -> file.getName().endsWith(".class")) + .filter(file -> filterPackageNames(removeHomeDirectory(file))) + .filter(file -> filterClass(removeHomeDirectory(file))) + .map(file -> { + try { + return new FileInputStream(file); + } catch (FileNotFoundException e) { + throw new RuntimeException(e); + } + }); + } catch (IOException e) { + throw new RuntimeException(e); + } + } + + private String removeHomeDirectory(File file) { + return file.getAbsolutePath().substring(BUKKIT_CLASSES.getPath().length()); + } + + private boolean filterPackageNames(String name) { + for (String packageName : excludedPackages) { + if (name.startsWith(packageName)) { + return false; + } + } + + return true; + } + + private boolean filterClass(String name) { + for (Class clazz : excludedClasses) { + if (name.equals(clazz.getName().replace('.', '/') + ".class")) { + return false; + } + } + + return true; + } +} diff --git a/paper-api/src/test/java/org/bukkit/support/test/ClassNodeTest.java b/paper-api/src/test/java/org/bukkit/support/test/ClassNodeTest.java new file mode 100644 index 0000000000..c68f03effd --- /dev/null +++ b/paper-api/src/test/java/org/bukkit/support/test/ClassNodeTest.java @@ -0,0 +1,20 @@ +package org.bukkit.support.test; + +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; +import org.bukkit.support.provider.ClassNodeArgumentProvider; +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.ArgumentsSource; + +@Target({ElementType.METHOD, ElementType.ANNOTATION_TYPE}) +@Retention(RetentionPolicy.RUNTIME) +@ArgumentsSource(ClassNodeArgumentProvider.class) +@ParameterizedTest +public @interface ClassNodeTest { + + Class[] excludedClasses() default {}; + + String[] excludedPackages() default {}; +} diff --git a/paper-api/src/test/java/org/bukkit/support/test/ClassReaderTest.java b/paper-api/src/test/java/org/bukkit/support/test/ClassReaderTest.java new file mode 100644 index 0000000000..2dd13583f9 --- /dev/null +++ b/paper-api/src/test/java/org/bukkit/support/test/ClassReaderTest.java @@ -0,0 +1,20 @@ +package org.bukkit.support.test; + +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; +import org.bukkit.support.provider.ClassReaderArgumentProvider; +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.ArgumentsSource; + +@Target({ElementType.METHOD, ElementType.ANNOTATION_TYPE}) +@Retention(RetentionPolicy.RUNTIME) +@ArgumentsSource(ClassReaderArgumentProvider.class) +@ParameterizedTest +public @interface ClassReaderTest { + + Class[] excludedClasses() default {}; + + String[] excludedPackages() default {}; +}