Add API for CreakingHeart (#12095)

Author: Doc94

build-data/paper.at

@@ -558,6 +558,10 @@ public net.minecraft.world.level.block.entity.ConduitBlockEntity effectBlocks
 public net.minecraft.world.level.block.entity.ConduitBlockEntity getDestroyRangeAABB(Lnet/minecraft/core/BlockPos;)Lnet/minecraft/world/phys/AABB;
 public net.minecraft.world.level.block.entity.ConduitBlockEntity updateDestroyTarget(Lnet/minecraft/world/entity/EntityReference;Lnet/minecraft/server/level/ServerLevel;Lnet/minecraft/core/BlockPos;Z)Lnet/minecraft/world/entity/EntityReference;
 public net.minecraft.world.level.block.entity.CrafterBlockEntity craftingTicksRemaining
+public net.minecraft.world.level.block.entity.CreakingHeartBlockEntity clearCreakingInfo()V
+public net.minecraft.world.level.block.entity.CreakingHeartBlockEntity getCreakingProtector()Ljava/util/Optional;
+public net.minecraft.world.level.block.entity.CreakingHeartBlockEntity spawnProtector(Lnet/minecraft/server/level/ServerLevel;Lnet/minecraft/world/level/block/entity/CreakingHeartBlockEntity;)Lnet/minecraft/world/entity/monster/creaking/Creaking;
+public net.minecraft.world.level.block.entity.CreakingHeartBlockEntity spreadResin(Lnet/minecraft/server/level/ServerLevel;)Ljava/util/Optional;
 public net.minecraft.world.level.block.entity.DecoratedPotBlockEntity decorations
 public net.minecraft.world.level.block.entity.EnderChestBlockEntity openersCounter
 public net.minecraft.world.level.block.entity.HopperBlockEntity cooldownTime

paper-api/src/main/java/org/bukkit/block/CreakingHeart.java

@@ -1,7 +1,46 @@
 package org.bukkit.block;
 
+import org.bukkit.Location;
+import org.bukkit.entity.Creaking;
+import org.jspecify.annotations.NullMarked;
+import org.jspecify.annotations.Nullable;
+
 /**
  * Represents a captured state of a creaking heart.
  */
+@NullMarked
 public interface CreakingHeart extends TileState {
+
+    /**
+     * Gets the creaking protecting this creaking heart.
+     *
+     * @return the creaking, or {@code null} if this creaking heart doesn't have a protector.
+     */
+    @Nullable Creaking getCreaking();
+
+    /**
+     * Sets the creaking protecting this creaking heart.
+     *
+     * @param creaking the creaking, or {@code null} to remove any existing creaking.
+     * @throws IllegalArgumentException if the creaking is in another world.
+     * @throws IllegalStateException if this block state is not placed.
+     */
+    void setCreaking(@Nullable Creaking creaking);
+
+    /**
+     * Attempts to spawn a creaking to protect this creaking heart.
+     *
+     * @return the {@link Creaking} that was spawned to protect this heart, or {@code null} if it failed.
+     * @throws IllegalStateException if this block state is not placed.
+     */
+    @Nullable Creaking spawnCreaking();
+
+    /**
+     * Attempts to spread resin to adjacent blocks.
+     *
+     * @apiNote This method triggers events related to a block being modified.
+     * @return the location resin was spread to, or {@code null} if it failed to spread.
+     * @throws IllegalStateException if this block state is not placed.
+     */
+    @Nullable Location spreadResin();
 }

paper-server/src/main/java/org/bukkit/craftbukkit/block/CraftCreakingHeart.java

@@ -1,17 +1,25 @@
 package org.bukkit.craftbukkit.block;
 
+import com.google.common.base.Preconditions;
+import net.minecraft.server.level.ServerLevel;
 import net.minecraft.world.level.block.entity.CreakingHeartBlockEntity;
 import org.bukkit.Location;
 import org.bukkit.World;
 import org.bukkit.block.CreakingHeart;
+import org.bukkit.craftbukkit.entity.CraftCreaking;
+import org.bukkit.craftbukkit.util.CraftLocation;
+import org.bukkit.entity.Creaking;
+import org.jspecify.annotations.NullMarked;
+import org.jspecify.annotations.Nullable;
 
+@NullMarked
 public class CraftCreakingHeart extends CraftBlockEntityState<CreakingHeartBlockEntity> implements CreakingHeart {
 
     public CraftCreakingHeart(World world, CreakingHeartBlockEntity blockEntity) {
         super(world, blockEntity);
     }
 
-    protected CraftCreakingHeart(CraftCreakingHeart state, Location location) {
+    protected CraftCreakingHeart(CraftCreakingHeart state, @Nullable Location location) {
         super(state, location);
     }
 
@@ -24,4 +32,52 @@ public CraftCreakingHeart copy() {
     public CraftCreakingHeart copy(Location location) {
         return new CraftCreakingHeart(this, location);
     }
+
+    @Override
+    public @Nullable Creaking getCreaking() {
+        if (!this.isPlaced()) {
+            return null;
+        }
+        return this.getBlockEntity().getCreakingProtector().map(creaking -> ((Creaking) creaking.getBukkitEntity())).orElse(null);
+    }
+
+    @Override
+    public void setCreaking(final @Nullable Creaking creaking) {
+        this.requirePlaced();
+        if (creaking == null) {
+            this.getBlockEntity().clearCreakingInfo();
+        } else {
+            Preconditions.checkArgument(this.getLocation().getWorld().equals(creaking.getLocation().getWorld()), "the location of the creaking must be in the same world as this CreakingHeart");
+            this.getBlockEntity().setCreakingInfo(((CraftCreaking) creaking).getHandle());
+        }
+    }
+
+    @Nullable
+    @Override
+    public Creaking spawnCreaking() {
+        this.requirePlaced();
+        if (!(this.getBlockEntity().getLevel() instanceof ServerLevel serverLevel)) {
+            return null;
+        }
+
+        final net.minecraft.world.entity.monster.creaking.Creaking creaking = CreakingHeartBlockEntity.spawnProtector(serverLevel, this.getBlockEntity());
+        if (creaking == null) {
+            return null;
+        }
+
+        this.getBlockEntity().setCreakingInfo(creaking);
+
+        return (Creaking) creaking.getBukkitEntity();
+    }
+
+    @Nullable
+    @Override
+    public Location spreadResin() {
+        this.requirePlaced();
+        if (!(this.getBlockEntity().getLevel() instanceof ServerLevel serverLevel)) {
+            return null;
+        }
+
+        return this.getBlockEntity().spreadResin(serverLevel).map(blockPos -> CraftLocation.toBukkit(blockPos, this.getWorld())).orElse(null);
+    }
 }