Interface BlockData

All Superinterfaces:
Cloneable
All Known Subinterfaces:
Ageable, AmethystCluster, AnaloguePowerable, Attachable, Bamboo, Barrel, Bed, Beehive, Bell, BigDripleaf, Bisected, BrewingStand, Brushable, BubbleColumn, Cake, CalibratedSculkSensor, Campfire, Candle, CaveVines, CaveVinesPlant, Chain, Chest, ChiseledBookshelf, Cocoa, CommandBlock, Comparator, CopperBulb, CoralWallFan, Crafter, CreakingHeart, DaylightDetector, DecoratedPot, Directional, Dispenser, Door, Dripleaf, EnderChest, EndPortalFrame, FaceAttachable, Farmland, Fence, Fire, Furnace, Gate, GlassPane, GlowLichen, Grindstone, Hangable, HangingMoss, HangingSign, Hatchable, Hopper, Jigsaw, Jukebox, Ladder, Lantern, Leaves, Lectern, Levelled, Light, Lightable, LightningRod, MangrovePropagule, MossyCarpet, MultipleFacing, NoteBlock, Observer, Openable, Orientable, PinkPetals, Piston, PistonHead, PitcherCrop, PointedDripstone, Powerable, Rail, RedstoneRail, RedstoneWallTorch, RedstoneWire, Repeater, RespawnAnchor, Rotatable, Sapling, Scaffolding, SculkCatalyst, SculkSensor, SculkShrieker, SculkVein, SeaPickle, Sign, Skull, Slab, SmallDripleaf, Snow, Snowable, Stairs, StructureBlock, Switch, TechnicalPiston, TNT, TrapDoor, TrialSpawner, Tripwire, TripwireHook, TurtleEgg, Vault, Wall, WallHangingSign, WallSign, WallSkull, Waterlogged

public interface BlockData extends Cloneable
  • Method Details

    • getMaterial

      @NotNull @NotNull Material getMaterial()
      Get the Material represented by this block data.
      Returns:
      the material
    • getAsString

      @NotNull @NotNull String getAsString()
      Gets a string, which when passed into a method such as Server.createBlockData(java.lang.String) will unambiguously recreate this instance.
      Returns:
      serialized data string for this block
    • getAsString

      @NotNull @NotNull String getAsString(boolean hideUnspecified)
      Gets a string, which when passed into a method such as Server.createBlockData(java.lang.String) will recreate this or a similar instance where unspecified states (if any) may be optionally omitted. If this instance was parsed and states are omitted, this exact instance will be creatable when parsed again, else their equality cannot be guaranteed.

      This method will only take effect for BlockData instances created by methods such as Server.createBlockData(String) or any similar method whereby states are optionally defined. If otherwise, the result of getAsString() will be returned. The following behaviour would be expected:

      
       String dataString = "minecraft:chest[waterlogged=true]"
       BlockData data = Bukkit.createBlockData(dataString);
       dataString.equals(data.getAsString(true)); // This would return true
       dataString.equals(data.getAsString(false)); // This would return false as all states are present
       dataString.equals(data.getAsString()); // This is equivalent to the above, "getAsString(false)"
       
      Parameters:
      hideUnspecified - true if unspecified states should be omitted, false if they are to be shown as performed by getAsString().
      Returns:
      serialized data string for this block
    • merge

      Merges all explicitly set states from the given data with this BlockData.
      Note that the given data MUST have been created from one of the String parse methods, e.g. Server.createBlockData(java.lang.String) and not have been subsequently modified.
      Note also that the block types must match identically.
      Parameters:
      data - the data to merge from
      Returns:
      a new instance of this blockdata with the merged data
    • matches

      boolean matches(@Nullable @Nullable BlockData data)
      Checks if the specified BlockData matches this block data.
      The semantics of this method are such that for manually created or modified BlockData it has the same effect as Object.equals(java.lang.Object), whilst for parsed data (that to which merge(org.bukkit.block.data.BlockData) applies, it will return true when the type and all explicitly set states match.
      Note that these semantics mean that a.matches(b) may not be the same as b.matches(a)
      Parameters:
      data - the data to match against (normally a parsed constant)
      Returns:
      if there is a match
    • clone

      Returns a copy of this BlockData.
      Returns:
      a copy of the block data
    • getSoundGroup

      @NotNull @NotNull SoundGroup getSoundGroup()
      Gets the block's SoundGroup which can be used to get its step sound, hit sound, and others.
      Returns:
      the sound effect group
    • getLightEmission

      int getLightEmission()
      Get the amount of light emitted by this state when in the world.
      Returns:
      the light emission
    • isOccluding

      boolean isOccluding()
      Check whether or not this state will occlude other blocks.

      Block state occlusion affects visual features of other blocks (e.g. leaves and wet sponges will not spawn dripping water particles if an occluding state is below it), or whether light will pass through it.

      Returns:
      true if occluding, false otherwise
    • requiresCorrectToolForDrops

      boolean requiresCorrectToolForDrops()
      Check whether or not this state requires a specific item to be used to drop items when broken. For example, diamond ore requires an iron pickaxe and will not drop diamonds when broken with a wooden or stone pickaxe.
      Returns:
      true if a more specific item is required for drops, false if any item (or an empty hand) will drop items
    • isPreferredTool

      boolean isPreferredTool(@NotNull @NotNull ItemStack tool)
      Returns if the given item is a preferred choice to break this Block. In some cases this determines if a block will drop anything or extra loot.
      Parameters:
      tool - The tool or item used for breaking this block
      Returns:
      true if the tool is preferred for breaking this block.
    • getPistonMoveReaction

      @NotNull @NotNull PistonMoveReaction getPistonMoveReaction()
      Returns the reaction of the block when moved by a piston
      Returns:
      reaction
    • isSupported

      boolean isSupported(@NotNull @NotNull Block block)
      Checks if this state would be properly supported if it were placed at the given Block.

      This may be useful, for instance, to check whether or not a wall torch is capable of surviving on its neighbouring block states.

      Parameters:
      block - the block position at which the state would be placed
      Returns:
      true if the block is supported, false if this state would not survive the world conditions
    • isSupported

      boolean isSupported(@NotNull @NotNull Location location)
      Checks if this state would be properly supported if it were placed at the block at the given Location.

      This may be useful, for instance, to check whether or not a wall torch is capable of surviving on its neighbouring block states.

      Parameters:
      location - the location at which the state would be placed
      Returns:
      true if the block is supported, false if this state would not survive the world conditions
    • isFaceSturdy

      boolean isFaceSturdy(@NotNull @NotNull BlockFace face, @NotNull @NotNull BlockSupport support)
      Checks if a state's BlockFace is capable of providing a given level of BlockSupport for neighbouring block states.

      Any given state may support either none, one, or more than one level of block support depending on its states. A common example would be a wall's ability to support torches only on the center of the upper block face, whereas a grass block would support all levels of block support on all block faces.

      Parameters:
      face - the face to check
      support - the possible support level
      Returns:
      true if the face is sturdy and can support a block, false otherwise
    • getCollisionShape

      @NotNull VoxelShape getCollisionShape(@NotNull @NotNull Location location)
      Calculates the collision shape this block data would have at a particular location.

      This does not take into account any block updates that may occur if the block was to be actually placed in the world.

      Parameters:
      location - the location to calculate the collision shape at
      Returns:
      a VoxelShape representing the collision shape of this block data.
    • getMapColor

      @NotNull @NotNull Color getMapColor()
      Gets the color this block should appear as when rendered on a map.
      Returns:
      the color associated with this BlockData
    • getPlacementMaterial

      @NotNull @NotNull Material getPlacementMaterial()
      Gets the material that a player would use to place this block.

      For most blocks this is the same as getMaterial() but some blocks have different materials used to place them. For example:

       Material.REDSTONE_WIRE -> Material.REDSTONE
       Material.CARROTS -> Material.CARROT
       
      Returns:
      placement material or Material.AIR if it doesn't have one
    • rotate

      void rotate(@NotNull @NotNull StructureRotation rotation)
      Rotates this blockdata by the specified StructureRotation.

      This has no effect on blocks that do not have any rotatable states.

      Parameters:
      rotation - the rotation
    • mirror

      void mirror(@NotNull @NotNull Mirror mirror)
      Mirrors this blockdata using the specified Mirror.

      This has no effect on blocks that do not have any mirrorable states.

      Parameters:
      mirror - the mirror
    • copyTo

      void copyTo(@NotNull @NotNull BlockData other)
      Copies all applicable properties from this BlockData to the provided BlockData.

      Only modifies properties that both blocks share in common.

      Parameters:
      other - the BlockData to copy properties to
    • createBlockState

      Creates a new default BlockState for this type of Block, not bound to a location.
      Returns:
      a new BlockState
    • getDestroySpeed

      default float getDestroySpeed(@NotNull @NotNull ItemStack itemStack)
      Gets the speed at which this block will be destroyed by a given ItemStack

      Default value is 1.0

      Parameters:
      itemStack - ItemStack used to mine this Block
      Returns:
      the speed that this Block will be mined by the given ItemStack
      API Note:
      this method assumes default player state and hence, e.g., does not take into account changed player attributes or potion effects.
    • getDestroySpeed

      float getDestroySpeed(@NotNull @NotNull ItemStack itemStack, boolean considerEnchants)
      Gets the speed at which this block will be destroyed by a given ItemStack

      Default value is 1.0

      Parameters:
      itemStack - ItemStack used to mine this Block
      considerEnchants - true to look at enchants on the itemstack
      Returns:
      the speed that this Block will be mined by the given ItemStack
      API Note:
      this method assumes default player state and hence, e.g., does not take into account changed player attributes or potion effects.
    • isRandomlyTicked

      boolean isRandomlyTicked()
      Gets if this block is ticked randomly in the world. The blocks current state may change this value.
      Returns:
      is ticked randomly