Add methods for CreakingHeart

build-data/paper.at

@@ -638,6 +638,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 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 null for make this creaking heart don't have protector
+     * @throws IllegalArgumentException if the creaking passed it's 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} for protect the creaking heart or null if fails
+     * @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 of spread resin or null if it cannot 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,27 @@
 package org.bukkit.craftbukkit.block;
 
+import com.google.common.base.Preconditions;
+import net.minecraft.server.level.ServerLevel;
+import net.minecraft.sounds.SoundEvents;
+import net.minecraft.sounds.SoundSource;
 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 +34,54 @@ 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);
+        creaking.makeSound(SoundEvents.CREAKING_SPAWN);
+        serverLevel.playSound(null, this.getBlockEntity().getBlockPos(), SoundEvents.CREAKING_HEART_SPAWN, SoundSource.BLOCKS, 1.0F, 1.0F);
+
+        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);
+    }
 }