#623: Add Block#getBreakSpeed(Player)

By: konsolas <vincentyntang@gmail.com>
This commit is contained in:
Bukkit/Spigot 2021-06-14 08:27:32 +10:00
parent b29d02153d
commit 34291f36d1

View File

@ -9,6 +9,7 @@ import org.bukkit.World;
import org.bukkit.block.data.Bisected;
import org.bukkit.block.data.BlockData;
import org.bukkit.entity.Entity;
import org.bukkit.entity.Player;
import org.bukkit.inventory.ItemStack;
import org.bukkit.metadata.Metadatable;
import org.bukkit.util.BoundingBox;
@ -441,6 +442,22 @@ public interface Block extends Metadatable {
*/
boolean isPreferredTool(@NotNull ItemStack tool);
/**
* Gets the speed at which the given player would break this block, taking
* into account tools, potion effects, whether or not the player is in
* water, enchantments, etc.
*
* The returned value is the amount of progress made in breaking the block.
* When the total breaking progress reaches {@code 1.0f}, the block is
* broken. Note that the break speed can change in the course of breaking a
* block, e.g. if a potion effect is applied or expires, or the player
* jumps/enters water.
*
* @param player player breaking the block
* @return the speed at which the player breaks this block
*/
float getBreakSpeed(@NotNull Player player);
/**
* Checks if this block is passable.
* <p>