#1082: Add "since" to Deprecation annotations

By: DerFrZocker <derrieple@gmail.com>
2024-11-25 07:52:33 +11:00
parent 98f6ab9a04
commit 0023e5549a
257 changed files with 1523 additions and 1176 deletions
--- 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);

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

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

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

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

    /**
--- 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),
--- 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();
 }
--- 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);
 }
--- 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);

    /**
--- 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) {
--- 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);
 }
--- 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();

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

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

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

    /**
--- 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 { }
--- 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();

    /**
--- 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];
--- 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);
 }
--- 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<BlockState> 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);

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

        /**
--- 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 { }
--- 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 { }
--- 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);
 }
--- 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();