MagmaCore/com.magmaguy.magmacore.util/TemporaryBlockManager

TemporaryBlockManager

public final class TemporaryBlockManager implements Listener

Manages temporary block placements that automatically revert after a set duration. Blocks placed through this manager are tracked to prevent item drops on break and are restored to their original state when the timer expires.

Types

OwnedBlock

public final class OwnedBlock implements AutoCloseable

Optional conditional restoration, shared across shaded consumers through Bukkit metadata.

Functions

addTemporaryBlock

public static void addTemporaryBlock(Block block, int ticks, Material replacementMaterial)

Places a temporary block that reverts after the given number of ticks.

public static void addTemporaryBlock(Block block, int ticks, Material replacementMaterial, boolean requireAir)

Places a temporary block, optionally only if the target block is air.

canOwn

public static boolean canOwn(Block block)

Preflight without loading chunks.

initialize

public static void initialize(JavaPlugin plugin)

Registers the block break and world unload listeners.

isTemporaryBlock

public static boolean isTemporaryBlock(Block block)

onBlockBreak

public void onBlockBreak(BlockBreakEvent event)

onBlockPlace

public void onBlockPlace(BlockPlaceEvent event)

onChunkUnload

public void onChunkUnload(ChunkUnloadEvent event)

onWorldUnload

public void onWorldUnload(WorldUnloadEvent event)

removeTemporaryBlock

public static void removeTemporaryBlock(Block block)

replaceOwned

public static TemporaryBlockManager.OwnedBlock replaceOwned(Block block, BlockData replacement, Plugin owner)

shutdown

public static void shutdown()

Restores still-owned temporary blocks and clears tracking.