Paper/patches/api/0451-Add-BlockBreakProgressUpdateEvent.patch

From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
From: Badbird5907 <50347938+Badbird5907@users.noreply.github.com>
Date: Mon, 4 Mar 2024 22:18:33 -0500
Subject: [PATCH] Add BlockBreakProgressUpdateEvent


diff --git a/src/main/java/io/papermc/paper/event/block/BlockBreakProgressUpdateEvent.java b/src/main/java/io/papermc/paper/event/block/BlockBreakProgressUpdateEvent.java
new file mode 100644
index 0000000000000000000000000000000000000000..1820e9b12141f3798dac499e19f8337c6f89d671
--- /dev/null
+++ b/src/main/java/io/papermc/paper/event/block/BlockBreakProgressUpdateEvent.java
@@ -0,0 +1,57 @@
+package io.papermc.paper.event.block;
+
+import org.bukkit.block.Block;
+import org.bukkit.entity.Entity;
+import org.bukkit.event.HandlerList;
+import org.bukkit.event.block.BlockEvent;
+import org.jetbrains.annotations.ApiStatus;
+import org.jspecify.annotations.NullMarked;
+
+/**
+ * Called when the progress of a block break is updated.
+ */
+@NullMarked
+public class BlockBreakProgressUpdateEvent extends BlockEvent {
+
+    private static final HandlerList HANDLER_LIST = new HandlerList();
+
+    private final float progress;
+    private final Entity entity;
+
+    @ApiStatus.Internal
+    public BlockBreakProgressUpdateEvent(final Block block, final float progress, final Entity entity) {
+        super(block);
+        this.progress = progress;
+        this.entity = entity;
+    }
+
+    /**
+     * The progress of the block break
+     * <p>
+     * The progress ranges from 0.0 - 1.0, where 0 is no damage and
+     * 1.0 is the most damaged
+     *
+     * @return The progress of the block break
+     */
+    public float getProgress() {
+        return this.progress;
+    }
+
+    /**
+     * The entity breaking the block.
+     *
+     * @return The entity breaking the block
+     */
+    public Entity getEntity() {
+        return this.entity;
+    }
+
+    @Override
+    public HandlerList getHandlers() {
+        return HANDLER_LIST;
+    }
+
+    public static HandlerList getHandlerList() {
+        return HANDLER_LIST;
+    }
+}