Deprecate some methods which are likely to require changes in the future

Ref http://mojang.com/2016/08/minecraft-snapshot-16w32a/

4 files changed, 21 insertions, 1 deletions

diff --git a/src/main/java/org/bukkit/entity/Guardian.java b/src/main/java/org/bukkit/entity/Guardian.java
index 31f3c6a7..39d8a892 100644
--- a/src/main/java/org/bukkit/entity/Guardian.java
+++ b/src/main/java/org/bukkit/entity/Guardian.java
@@ -6,13 +6,17 @@ public interface Guardian extends Monster {
      * Check if the Guardian is an elder Guardian
      * 
      * @return true if the Guardian is an Elder Guardian, false if not
+     * @deprecated Entity subtypes will be separate entities in a future Minecraft release
      */
+    @Deprecated
     public boolean isElder();
 
     /**
      * Set the Guardian to an elder Guardian or not
      *
      * @param shouldBeElder True if this Guardian should be a elder Guardian, false if not
+     * @deprecated Entity subtypes will be separate entities in a future Minecraft release
      */
+    @Deprecated
     public void setElder(boolean shouldBeElder);
 }
diff --git a/src/main/java/org/bukkit/entity/Horse.java b/src/main/java/org/bukkit/entity/Horse.java
index e90d318a..1c6b2815 100644
--- a/src/main/java/org/bukkit/entity/Horse.java
+++ b/src/main/java/org/bukkit/entity/Horse.java
@@ -5,7 +5,9 @@ import org.bukkit.inventory.InventoryHolder;
 
 /**
  * Represents a Horse.
+ * @deprecated Entity subtypes will be separate entities in a future Minecraft release
  */
+@Deprecated
 public interface Horse extends Animals, Vehicle, InventoryHolder, Tameable {
 
     /**
@@ -105,7 +107,9 @@ public interface Horse extends Animals, Vehicle, InventoryHolder, Tameable {
      * horse is determined using the variant.
      *
      * @return a {@link Variant} representing the horse's variant
+     * @deprecated Entity subtypes will be separate entities in a future Minecraft release
      */
+    @Deprecated
     public Variant getVariant();
 
     /**
@@ -121,7 +125,9 @@ public interface Horse extends Animals, Vehicle, InventoryHolder, Tameable {
      * will remove the chest and its contents.
      *
      * @param variant a {@link Variant} for this horse
+     * @deprecated Entity subtypes will be separate entities in a future Minecraft release
      */
+    @Deprecated
     public void setVariant(Variant variant);
 
     /**
diff --git a/src/main/java/org/bukkit/entity/Skeleton.java b/src/main/java/org/bukkit/entity/Skeleton.java
index bea790ec..4f6e36b9 100644
--- a/src/main/java/org/bukkit/entity/Skeleton.java
+++ b/src/main/java/org/bukkit/entity/Skeleton.java
@@ -9,14 +9,18 @@ public interface Skeleton extends Monster {
      * Gets the current type of this skeleton.
      *
      * @return Current type
+     * @deprecated Entity subtypes will be separate entities in a future Minecraft release
      */
+    @Deprecated
     public SkeletonType getSkeletonType();
 
     /**
      * Sets the new type of this skeleton.
      *
      * @param type New type
+     * @deprecated Entity subtypes will be separate entities in a future Minecraft release
      */
+    @Deprecated
     public void setSkeletonType(SkeletonType type);
 
     /*
diff --git a/src/main/java/org/bukkit/entity/Zombie.java b/src/main/java/org/bukkit/entity/Zombie.java
index a897d434..420eaa43 100644
--- a/src/main/java/org/bukkit/entity/Zombie.java
+++ b/src/main/java/org/bukkit/entity/Zombie.java
@@ -23,14 +23,16 @@ public interface Zombie extends Monster {
      * Gets whether the zombie is a villager
      *
      * @return Whether the zombie is a villager
+     * @deprecated Entity subtypes will be separate entities in a future Minecraft release
      */
+    @Deprecated
     public boolean isVillager();
 
     /**
      * Sets whether the zombie is a villager
      *
      * @param flag Whether the zombie is a villager
-     * @deprecated Defaults to a {@link Villager.Profession#NORMAL}
+     * @deprecated Entity subtypes will be separate entities in a future Minecraft release
      */
     @Deprecated
     public void setVillager(boolean flag);
@@ -39,7 +41,9 @@ public interface Zombie extends Monster {
      * Sets whether the zombie is a villager
      *
      * @param profession the profession of the villager or null to clear
+     * @deprecated Entity subtypes will be separate entities in a future Minecraft release
      */
+    @Deprecated
     public void setVillagerProfession(Villager.Profession profession);
 
     /**
@@ -47,6 +51,8 @@ public interface Zombie extends Monster {
      * zombie is a villager
      *
      * @return the profession or null
+     * @deprecated Entity subtypes will be separate entities in a future Minecraft release
      */
+    @Deprecated
     public Villager.Profession getVillagerProfession();
 }