Interface IgnisBlockStrategy

All Superinterfaces:

IgnisStrategy

All Known Implementing Classes:

AbstractIgnisBlockStrategy

public interface IgnisBlockStrategy
extends IgnisStrategy

Runtime behavior for custom block types.

Two lifecycles

Blocks have a placed lifecycle while the barrier block exists in the world, and an active lifecycle after ignition when a RuntimeBlockInstance ticks until trigger.

Placed block callbacks

• onPlaced(BlockDefinition, IgnisLocation) — after the custom block is registered at a location
• onPlacedClick(BlockDefinition, IgnisLocation, IgnisPlayer, IgnisInteraction, IgnisItem) — player click; return CustomBlockAction for core handling
• onPlacedInteract(BlockDefinition, IgnisLocation, IgnisPlayer, IgnisInteraction, IgnisItem, CustomBlockAction) — follow-up for CustomBlockAction.OPEN and similar custom actions
• onPlacedBreak(BlockDefinition, IgnisLocation) — block removed (creative break, mining complete, or ignite prep)

Active block callbacks

• onPlace(RuntimeBlockInstance) — active instance created (typically after ignite)
• onTick(RuntimeBlockInstance) — repeating scheduler tick while fuse counts down
• onTrigger(RuntimeBlockInstance, Object) — fuse elapsed or external trigger; explosion/effect logic runs here
• onBreak(RuntimeBlockInstance) / onInteract(RuntimeBlockInstance, IgnisPlayer) — optional active-instance hooks

Override profile(BlockDefinition) to declare combustibility, default click actions, and ignition materials. Click behavior is implemented in onPlacedClick(BlockDefinition, IgnisLocation, IgnisPlayer, IgnisInteraction, IgnisItem); YAML interactions is optional tuning data (sounds, particles) via BlockDefinition.getInteractionConfig().

Method Summary

Modifier and Type	Method	Description
default void	onBreak(RuntimeBlockInstance instance)
default void	onInteract(RuntimeBlockInstance instance, IgnisPlayer player)
default void	onPlace(RuntimeBlockInstance instance)
default void	onPlaced(BlockDefinition definition, IgnisLocation location)
default void	onPlaced(BlockDefinition definition, IgnisLocation location, IgnisItem placedFrom)
default void	onPlacedBreak(BlockDefinition definition, IgnisLocation location)
default void	onPlacedBreak(BlockDefinition definition, IgnisLocation location, IgnisItem droppedItem)
default CustomBlockAction	onPlacedClick(BlockDefinition definition, IgnisLocation location, IgnisPlayer player, IgnisInteraction interaction, IgnisItem heldItem)	Decide how a placed block responds to a player click.
default void	onPlacedInteract(BlockDefinition definition, IgnisLocation location, IgnisPlayer player, CustomBlockAction action)
default void	onPlacedInteract(BlockDefinition definition, IgnisLocation location, IgnisPlayer player, IgnisInteraction interaction, IgnisItem heldItem, CustomBlockAction action)
default void	onTick(RuntimeBlockInstance instance)
default void	onTrigger(RuntimeBlockInstance instance, Object context)
default StrategyProfile	profile(BlockDefinition definition)

Methods inherited from interface IgnisStrategy

descriptor

Method Details

profile

default StrategyProfile profile(BlockDefinition definition)

onPlaced

default void onPlaced(BlockDefinition definition,
 IgnisLocation location)

onPlaced

default void onPlaced(BlockDefinition definition,
 IgnisLocation location,
 IgnisItem placedFrom)

onPlacedClick

default CustomBlockAction onPlacedClick(BlockDefinition definition,
 IgnisLocation location,
 IgnisPlayer player,
 IgnisInteraction interaction,
 IgnisItem heldItem)

Decide how a placed block responds to a player click.

Returns:

CustomBlockAction.NONE to ignore; CustomBlockAction.HANDLED when this method performed custom logic; CustomBlockAction.BREAK / CustomBlockAction.IGNITE for core services; CustomBlockAction.OPEN to delegate to onPlacedInteract(BlockDefinition, IgnisLocation, IgnisPlayer, IgnisInteraction, IgnisItem, CustomBlockAction)

onPlacedInteract

default void onPlacedInteract(BlockDefinition definition,
 IgnisLocation location,
 IgnisPlayer player,
 IgnisInteraction interaction,
 IgnisItem heldItem,
 CustomBlockAction action)

onPlacedInteract

default void onPlacedInteract(BlockDefinition definition,
 IgnisLocation location,
 IgnisPlayer player,
 CustomBlockAction action)

onPlacedBreak

default void onPlacedBreak(BlockDefinition definition,
 IgnisLocation location)

onPlacedBreak

default void onPlacedBreak(BlockDefinition definition,
 IgnisLocation location,
 IgnisItem droppedItem)

onPlace

default void onPlace(RuntimeBlockInstance instance)

onTick

default void onTick(RuntimeBlockInstance instance)

onInteract

default void onInteract(RuntimeBlockInstance instance,
 IgnisPlayer player)

onBreak

default void onBreak(RuntimeBlockInstance instance)

onTrigger

default void onTrigger(RuntimeBlockInstance instance,
 Object context)