Explicitly deprecate all MaterialData subclasses

By: md_5 <git@md-5.net>

paper-api/src/main/java/org/bukkit/material/Banner.java

@@ -3,6 +3,11 @@ package org.bukkit.material;
 import org.bukkit.Material;
 import org.bukkit.block.BlockFace;
 
+/**
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
+ */
+@Deprecated
 public class Banner extends MaterialData implements Attachable {
 
     public Banner() {

paper-api/src/main/java/org/bukkit/material/Bed.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * Represents a bed.
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Bed extends MaterialData implements Directional {
 
     /**

paper-api/src/main/java/org/bukkit/material/Button.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * Represents a button
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Button extends SimpleAttachableMaterialData implements Redstone {
     public Button() {
         super(Material.LEGACY_STONE_BUTTON);

paper-api/src/main/java/org/bukkit/material/Cake.java

@@ -2,6 +2,11 @@ package org.bukkit.material;
 
 import org.bukkit.Material;
 
+/**
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
+ */
+@Deprecated
 public class Cake extends MaterialData {
     public Cake() {
         super(Material.LEGACY_CAKE_BLOCK);

paper-api/src/main/java/org/bukkit/material/Cauldron.java

@@ -4,7 +4,11 @@ import org.bukkit.Material;
 
 /**
  * Represents a cauldron
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Cauldron extends MaterialData {
     private static final int CAULDRON_FULL = 3;
     private static final int CAULDRON_EMPTY = 0;

paper-api/src/main/java/org/bukkit/material/Chest.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * Represents a chest
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Chest extends DirectionalContainer {
 
     public Chest() {

paper-api/src/main/java/org/bukkit/material/Coal.java

@@ -5,7 +5,11 @@ import org.bukkit.Material;
 
 /**
  * Represents the different types of coals.
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Coal extends MaterialData {
     public Coal() {
         super(Material.LEGACY_COAL);

paper-api/src/main/java/org/bukkit/material/CocoaPlant.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * Represents the cocoa plant
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class CocoaPlant extends MaterialData implements Directional, Attachable {
 
     public enum CocoaPlantSize {

paper-api/src/main/java/org/bukkit/material/Command.java

@@ -4,7 +4,11 @@ import org.bukkit.Material;
 
 /**
  * Represents a command block
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Command extends MaterialData implements Redstone {
     public Command() {
         super(Material.LEGACY_COMMAND);

paper-api/src/main/java/org/bukkit/material/Comparator.java

@@ -8,7 +8,11 @@ import org.bukkit.block.BlockFace;
  *
  * @see Material#LEGACY_REDSTONE_COMPARATOR_OFF
  * @see Material#LEGACY_REDSTONE_COMPARATOR_ON
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Comparator extends MaterialData implements Directional, Redstone {
     protected static final BlockFace DEFAULT_DIRECTION = BlockFace.NORTH;
     protected static final boolean DEFAULT_SUBTRACTION_MODE = false;

paper-api/src/main/java/org/bukkit/material/Crops.java

@@ -11,7 +11,11 @@ import org.bukkit.Material;
  * @see Material#LEGACY_POTATO
  * @see Material#LEGACY_BEETROOT_BLOCK
  * @see Material#LEGACY_NETHER_WARTS
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Crops extends MaterialData {
     protected static final Material DEFAULT_TYPE = Material.LEGACY_CROPS;
     protected static final CropState DEFAULT_STATE = CropState.SEEDED;

paper-api/src/main/java/org/bukkit/material/DetectorRail.java

@@ -4,7 +4,11 @@ import org.bukkit.Material;
 
 /**
  * Represents a detector rail
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class DetectorRail extends ExtendedRails implements PressureSensor {
     public DetectorRail() {
         super(Material.LEGACY_DETECTOR_RAIL);

paper-api/src/main/java/org/bukkit/material/Diode.java

@@ -9,7 +9,11 @@ import org.bukkit.block.BlockFace;
  *
  * @see Material#LEGACY_DIODE_BLOCK_OFF
  * @see Material#LEGACY_DIODE_BLOCK_ON
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Diode extends MaterialData implements Directional, Redstone {
 
     protected static final BlockFace DEFAULT_DIRECTION = BlockFace.NORTH;

paper-api/src/main/java/org/bukkit/material/DirectionalContainer.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * Represents a furnace or a dispenser.
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class DirectionalContainer extends MaterialData implements Directional {
 
     public DirectionalContainer(final Material type) {

paper-api/src/main/java/org/bukkit/material/Dispenser.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * Represents a dispenser.
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Dispenser extends FurnaceAndDispenser {
 
     public Dispenser() {

paper-api/src/main/java/org/bukkit/material/Door.java

@@ -18,7 +18,11 @@ import org.bukkit.block.BlockFace;
  * @see Material#LEGACY_JUNGLE_DOOR
  * @see Material#LEGACY_ACACIA_DOOR
  * @see Material#LEGACY_DARK_OAK_DOOR
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Door extends MaterialData implements Directional, Openable {
 
     // This class breaks API contracts on Directional and Openable because

paper-api/src/main/java/org/bukkit/material/Dye.java

@@ -5,7 +5,11 @@ import org.bukkit.Material;
 
 /**
  * Represents dye
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Dye extends MaterialData implements Colorable {
     public Dye() {
         super(Material.LEGACY_INK_SACK);

paper-api/src/main/java/org/bukkit/material/EnderChest.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * Represents an ender chest
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class EnderChest extends DirectionalContainer {
 
     public EnderChest() {

paper-api/src/main/java/org/bukkit/material/ExtendedRails.java

@@ -6,7 +6,11 @@ import org.bukkit.block.BlockFace;
 /**
  * This is the superclass for the {@link DetectorRail} and {@link PoweredRail}
  * classes
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class ExtendedRails extends Rails {
 
     public ExtendedRails(final Material type) {

paper-api/src/main/java/org/bukkit/material/Furnace.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * Represents a furnace.
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Furnace extends FurnaceAndDispenser {
 
     public Furnace() {

paper-api/src/main/java/org/bukkit/material/FurnaceAndDispenser.java

@@ -4,7 +4,11 @@ import org.bukkit.Material;
 
 /**
  * Represents a furnace or dispenser, two types of directional containers
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class FurnaceAndDispenser extends DirectionalContainer {
 
     public FurnaceAndDispenser(final Material type) {

paper-api/src/main/java/org/bukkit/material/Gate.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * Represents a fence gate
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Gate extends MaterialData implements Directional, Openable {
     private static final byte OPEN_BIT = 0x4;
     private static final byte DIR_BIT = 0x3;

paper-api/src/main/java/org/bukkit/material/Hopper.java

@@ -8,7 +8,11 @@ import org.bukkit.block.BlockFace;
  * specific direction.
  *
  * @see Material#HOPPER
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Hopper extends MaterialData implements Directional, Redstone {
 
     protected static final BlockFace DEFAULT_DIRECTION = BlockFace.DOWN;

paper-api/src/main/java/org/bukkit/material/Ladder.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * Represents Ladder data
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Ladder extends SimpleAttachableMaterialData {
     public Ladder() {
         super(Material.LEGACY_LADDER);

paper-api/src/main/java/org/bukkit/material/Leaves.java

@@ -9,7 +9,11 @@ import org.bukkit.TreeSpecies;
  *
  * @see Material#LEGACY_LEAVES
  * @see Material#LEGACY_LEAVES_2
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Leaves extends Wood {
     protected static final Material DEFAULT_TYPE = Material.LEGACY_LEAVES;
     protected static final boolean DEFAULT_DECAYABLE = true;

paper-api/src/main/java/org/bukkit/material/Lever.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * Represents a lever
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Lever extends SimpleAttachableMaterialData implements Redstone {
     public Lever() {
         super(Material.LEGACY_LEVER);

paper-api/src/main/java/org/bukkit/material/LongGrass.java

@@ -5,7 +5,11 @@ import org.bukkit.Material;
 
 /**
  * Represents the different types of long grasses.
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class LongGrass extends MaterialData {
     public LongGrass() {
         super(Material.LEGACY_LONG_GRASS);

paper-api/src/main/java/org/bukkit/material/MaterialData.java

@@ -1,14 +1,13 @@
 package org.bukkit.material;
 
 import org.bukkit.Material;
-import org.bukkit.block.data.BlockData;
 import org.bukkit.inventory.ItemStack;
 
 /**
  * Handles specific metadata for certain items or blocks
  *
  * @deprecated all usage of MaterialData is deprecated and subject to removal.
- * Use {@link BlockData}.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
 @Deprecated
 public class MaterialData implements Cloneable {

paper-api/src/main/java/org/bukkit/material/MonsterEggs.java

@@ -6,7 +6,11 @@ import org.bukkit.Material;
 
 /**
  * Represents the different types of monster eggs
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class MonsterEggs extends TexturedMaterial {
 
     private static final List<Material> textures = new ArrayList<Material>();

paper-api/src/main/java/org/bukkit/material/Mushroom.java

@@ -13,7 +13,11 @@ import org.bukkit.material.types.MushroomBlockTexture;
  *
  * @see Material#LEGACY_HUGE_MUSHROOM_1
  * @see Material#LEGACY_HUGE_MUSHROOM_2
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Mushroom extends MaterialData {
     private static final byte NORTH_LIMIT = 4;
     private static final byte SOUTH_LIMIT = 6;

paper-api/src/main/java/org/bukkit/material/NetherWarts.java

@@ -5,7 +5,11 @@ import org.bukkit.NetherWartsState;
 
 /**
  * Represents nether wart
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class NetherWarts extends MaterialData {
     public NetherWarts() {
         super(Material.LEGACY_NETHER_WARTS);

paper-api/src/main/java/org/bukkit/material/Observer.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * Represents an observer.
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Observer extends MaterialData implements Directional, Redstone {
 
     public Observer() {

paper-api/src/main/java/org/bukkit/material/PistonBaseMaterial.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * Material data for the piston base block
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class PistonBaseMaterial extends MaterialData implements Directional, Redstone {
 
     public PistonBaseMaterial(final Material type) {

paper-api/src/main/java/org/bukkit/material/PistonExtensionMaterial.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * Material data for the piston extension block
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class PistonExtensionMaterial extends MaterialData implements Attachable {
 
     public PistonExtensionMaterial(final Material type) {

paper-api/src/main/java/org/bukkit/material/PoweredRail.java

@@ -4,7 +4,11 @@ import org.bukkit.Material;
 
 /**
  * Represents a powered rail
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class PoweredRail extends ExtendedRails implements Redstone {
     public PoweredRail() {
         super(Material.LEGACY_POWERED_RAIL);

paper-api/src/main/java/org/bukkit/material/PressurePlate.java

@@ -4,7 +4,11 @@ import org.bukkit.Material;
 
 /**
  * Represents a pressure plate
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class PressurePlate extends MaterialData implements PressureSensor {
     public PressurePlate() {
         super(Material.LEGACY_WOOD_PLATE);

paper-api/src/main/java/org/bukkit/material/Pumpkin.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * Represents a pumpkin.
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Pumpkin extends MaterialData implements Directional {
 
     public Pumpkin() {

paper-api/src/main/java/org/bukkit/material/Rails.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * Represents minecart rails.
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Rails extends MaterialData {
 
     public Rails() {

paper-api/src/main/java/org/bukkit/material/RedstoneTorch.java

@@ -4,7 +4,11 @@ import org.bukkit.Material;
 
 /**
  * Represents a redstone torch
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class RedstoneTorch extends Torch implements Redstone {
     public RedstoneTorch() {
         super(Material.LEGACY_REDSTONE_TORCH_ON);

paper-api/src/main/java/org/bukkit/material/RedstoneWire.java

@@ -4,7 +4,11 @@ import org.bukkit.Material;
 
 /**
  * Represents redstone wire
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class RedstoneWire extends MaterialData implements Redstone {
     public RedstoneWire() {
         super(Material.LEGACY_REDSTONE_WIRE);

paper-api/src/main/java/org/bukkit/material/Sandstone.java

@@ -5,7 +5,11 @@ import org.bukkit.SandstoneType;
 
 /**
  * Represents the different types of sandstone.
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Sandstone extends MaterialData {
     public Sandstone() {
         super(Material.LEGACY_SANDSTONE);

paper-api/src/main/java/org/bukkit/material/Sapling.java

@@ -7,7 +7,11 @@ import org.bukkit.TreeSpecies;
  * Represents the different types of Tree block that face a direction.
  *
  * @see Material#LEGACY_SAPLING
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Sapling extends Wood {
 
     /**

paper-api/src/main/java/org/bukkit/material/Sign.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * MaterialData for signs
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Sign extends MaterialData implements Attachable {
     public Sign() {
         super(Material.LEGACY_SIGN_POST);

paper-api/src/main/java/org/bukkit/material/SimpleAttachableMaterialData.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * Simple utility class for attachable MaterialData subclasses
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public abstract class SimpleAttachableMaterialData extends MaterialData implements Attachable {
 
     public SimpleAttachableMaterialData(Material type, BlockFace direction) {

paper-api/src/main/java/org/bukkit/material/Skull.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * Represents a skull.
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Skull extends MaterialData implements Directional {
     public Skull() {
         super(Material.LEGACY_SKULL);

paper-api/src/main/java/org/bukkit/material/SmoothBrick.java

@@ -6,7 +6,11 @@ import org.bukkit.Material;
 
 /**
  * Represents the different types of smooth bricks.
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class SmoothBrick extends TexturedMaterial {
 
     private static final List<Material> textures = new ArrayList<Material>();

paper-api/src/main/java/org/bukkit/material/Stairs.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * Represents stairs.
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Stairs extends MaterialData implements Directional {
 
     public Stairs(final Material type) {

paper-api/src/main/java/org/bukkit/material/Step.java

@@ -6,7 +6,11 @@ import org.bukkit.Material;
 
 /**
  * Represents the different types of steps.
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Step extends TexturedMaterial {
     private static final List<Material> textures = new ArrayList<Material>();
     static {

paper-api/src/main/java/org/bukkit/material/TexturedMaterial.java

@@ -5,7 +5,11 @@ import org.bukkit.Material;
 
 /**
  * Represents textured materials like steps and smooth bricks
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public abstract class TexturedMaterial extends MaterialData {
 
     public TexturedMaterial(Material m) {

paper-api/src/main/java/org/bukkit/material/Torch.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * MaterialData for torches
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Torch extends SimpleAttachableMaterialData {
     public Torch() {
         super(Material.LEGACY_TORCH);

paper-api/src/main/java/org/bukkit/material/TrapDoor.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * Represents a trap door
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class TrapDoor extends SimpleAttachableMaterialData implements Openable {
     public TrapDoor() {
         super(Material.LEGACY_TRAP_DOOR);

paper-api/src/main/java/org/bukkit/material/Tree.java

@@ -9,7 +9,11 @@ import org.bukkit.block.BlockFace;
  *
  * @see Material#LEGACY_LOG
  * @see Material#LEGACY_LOG_2
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Tree extends Wood {
     protected static final Material DEFAULT_TYPE = Material.LEGACY_LOG;
     protected static final BlockFace DEFAULT_DIRECTION = BlockFace.UP;

paper-api/src/main/java/org/bukkit/material/Tripwire.java

@@ -4,7 +4,11 @@ import org.bukkit.Material;
 
 /**
  * Represents the tripwire
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Tripwire extends MaterialData {
 
     public Tripwire() {

paper-api/src/main/java/org/bukkit/material/TripwireHook.java

@@ -5,7 +5,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * Represents the tripwire hook
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class TripwireHook extends SimpleAttachableMaterialData implements Redstone {
 
     public TripwireHook() {

paper-api/src/main/java/org/bukkit/material/Vine.java

@@ -7,7 +7,11 @@ import org.bukkit.block.BlockFace;
 
 /**
  * Represents a vine
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Vine extends MaterialData {
     private static final int VINE_NORTH = 0x4;
     private static final int VINE_EAST = 0x8;

paper-api/src/main/java/org/bukkit/material/Wood.java

@@ -9,7 +9,11 @@ import org.bukkit.TreeSpecies;
  * @see Material#LEGACY_WOOD
  * @see Material#LEGACY_SAPLING
  * @see Material#LEGACY_WOOD_DOUBLE_STEP
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Wood extends MaterialData {
     protected static final Material DEFAULT_TYPE = Material.LEGACY_WOOD;
     protected static final TreeSpecies DEFAULT_SPECIES = TreeSpecies.GENERIC;

paper-api/src/main/java/org/bukkit/material/WoodenStep.java

@@ -7,7 +7,11 @@ import org.bukkit.TreeSpecies;
  * Represents the different types of wooden steps.
  *
  * @see Material#LEGACY_WOOD_STEP
+ *
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class WoodenStep extends Wood {
     protected static final Material DEFAULT_TYPE = Material.LEGACY_WOOD_STEP;
     protected static final boolean DEFAULT_INVERTED = false;

paper-api/src/main/java/org/bukkit/material/Wool.java

@@ -5,7 +5,10 @@ import org.bukkit.Material;
 
 /**
  * Represents a Wool/Cloth block
+ * @deprecated all usage of MaterialData is deprecated and subject to removal.
+ * Use {@link org.bukkit.block.data.BlockData}.
  */
+@Deprecated
 public class Wool extends MaterialData implements Colorable {
     public Wool() {
         super(Material.LEGACY_WOOL);

paper-api/src/test/java/org/bukkit/AnnotationTest.java

@@ -132,8 +132,7 @@ public class AnnotationTest {
         }
 
         if (isSubclassOf(clazz, "org/bukkit/material/MaterialData", allClasses)) {
-            // MaterialData is deprecated and all of its subclasses are excluded
+            throw new AssertionError("Subclass of MaterialData must be deprecated: " + clazz.name);
-            return false;
         }
 
         if (isSubclassOf(clazz, "java/lang/Exception", allClasses)