feat(multiblock): implement dynamic multiblock event handling for formation and unformation (#69)

QiuShui1012 · web-flow · commit 1e5bfb3b8164 · 2026-07-02T19:27:23.000+08:00
diff --git a/module.multiblock/src/main/java/dev/anvilcraft/lib/v2/multiblock/dynamic/DynamicMultiblockManager.java b/module.multiblock/src/main/java/dev/anvilcraft/lib/v2/multiblock/dynamic/DynamicMultiblockManager.java
@@ -6,6 +6,7 @@
 import dev.anvilcraft.lib.v2.multiblock.dynamic.controller.ControllerRecord;
 import dev.anvilcraft.lib.v2.multiblock.dynamic.controller.IController;
 import dev.anvilcraft.lib.v2.multiblock.dynamic.definition.MultiblockDefinition;
+import dev.anvilcraft.lib.v2.multiblock.dynamic.event.DynamicMultiblockEvent;
 import dev.anvilcraft.lib.v2.multiblock.init.LibRegistries;
 import dev.anvilcraft.lib.v2.multiblock.network.MultiblockFormPacket;
 import dev.anvilcraft.lib.v2.multiblock.network.MultiblockUnformPacket;
@@ -21,6 +22,7 @@
 import net.minecraft.world.level.block.state.BlockState;
 import net.minecraft.world.level.saveddata.SavedData;
 import net.minecraft.world.level.saveddata.SavedDataType;
+import net.neoforged.neoforge.common.NeoForge;
 import net.neoforged.neoforge.network.PacketDistributor;
 import org.jetbrains.annotations.UnknownNullability;
 import org.slf4j.Logger;
@@ -174,9 +176,23 @@ public void updateFormed(Level level, MultiblockState cur, boolean formed) {
                 throw e;
             }
             if (formed) {
-                controller.onFormed(level, cur);
+                DynamicMultiblockEvent.Form event = new DynamicMultiblockEvent.Form(level, controller, cur);
+                NeoForge.EVENT_BUS.post(event);
+                if (!event.isCanceled()) {
+                    controller.onFormed(level, cur);
+                } else {
+                    cur.setFormed(false);
+                    return;
+                }
             } else {
-                controller.onUnformed(level, cur);
+                DynamicMultiblockEvent.Unform event = new DynamicMultiblockEvent.Unform(level, controller, cur);
+                NeoForge.EVENT_BUS.post(event);
+                if (!event.isCanceled()) {
+                    controller.onUnformed(level, cur);
+                } else {
+                    cur.setFormed(true);
+                    return;
+                }
             }
         }
 
diff --git a/module.multiblock/src/main/java/dev/anvilcraft/lib/v2/multiblock/dynamic/controller/IController.java b/module.multiblock/src/main/java/dev/anvilcraft/lib/v2/multiblock/dynamic/controller/IController.java
@@ -35,7 +35,6 @@ public interface IController {
     default void onFormed(Level level, MultiblockState state) {
     }
 
-
     /**
      * 多方块未成型回调
      *
diff --git a/module.multiblock/src/main/java/dev/anvilcraft/lib/v2/multiblock/dynamic/event/DynamicMultiblockEvent.java b/module.multiblock/src/main/java/dev/anvilcraft/lib/v2/multiblock/dynamic/event/DynamicMultiblockEvent.java
@@ -0,0 +1,44 @@
+package dev.anvilcraft.lib.v2.multiblock.dynamic.event;
+
+import dev.anvilcraft.lib.v2.multiblock.dynamic.MultiblockState;
+import dev.anvilcraft.lib.v2.multiblock.dynamic.controller.IController;
+import lombok.Getter;
+import net.minecraft.world.level.Level;
+import net.neoforged.bus.api.Event;
+import net.neoforged.bus.api.ICancellableEvent;
+
+/// 所有与动态多方块结构有关的事件的基类。
+@Getter
+public abstract class DynamicMultiblockEvent extends Event {
+    private final Level level;
+    private final IController controller;
+    private final MultiblockState state;
+
+    protected DynamicMultiblockEvent(Level level, IController controller, MultiblockState state) {
+        this.level = level;
+        this.controller = controller;
+        this.state = state;
+    }
+
+    /// 本事件会在多方块结构尝试形成时发出。
+    ///
+    /// 取消该事件将阻止多方块结构的形成。
+    ///
+    /// 本事件会在双端发出。
+    public static class Form extends DynamicMultiblockEvent implements ICancellableEvent {
+        public Form(Level level, IController controller, MultiblockState state) {
+            super(level, controller, state);
+        }
+    }
+
+    /// 本事件会在多方块结构尝试解散时发出。
+    ///
+    /// 取消该事件将阻止多方块结构的解散。
+    ///
+    /// 本事件会在双端发出。
+    public static class Unform extends DynamicMultiblockEvent implements ICancellableEvent {
+        public Unform(Level level, IController controller, MultiblockState state) {
+            super(level, controller, state);
+        }
+    }
+}
diff --git a/module.multiblock/src/main/java/dev/anvilcraft/lib/v2/multiblock/network/MultiblockFormPacket.java b/module.multiblock/src/main/java/dev/anvilcraft/lib/v2/multiblock/network/MultiblockFormPacket.java
@@ -4,6 +4,8 @@
 import dev.anvilcraft.lib.v2.multiblock.dynamic.DynamicMultiblockManager;
 import dev.anvilcraft.lib.v2.multiblock.dynamic.MultiblockState;
 import dev.anvilcraft.lib.v2.multiblock.dynamic.controller.ControllerRecord;
+import dev.anvilcraft.lib.v2.multiblock.dynamic.controller.IController;
+import dev.anvilcraft.lib.v2.multiblock.dynamic.event.DynamicMultiblockEvent;
 import dev.anvilcraft.lib.v2.network.packet.IClientboundPacket;
 import dev.anvilcraft.lib.v2.network.packet.IPacket;
 import lombok.extern.slf4j.Slf4j;
@@ -14,6 +16,7 @@
 import net.minecraft.world.entity.player.Player;
 import net.minecraft.world.level.Level;
 import net.minecraft.world.level.block.state.BlockState;
+import net.neoforged.neoforge.common.NeoForge;
 
 @Slf4j
 @SuppressWarnings("unused")
@@ -40,7 +43,14 @@ public void handleOnClient(Player player) {
         BlockState state = level.getBlockState(pos);
         if (!this.state.getDefinition(level.registryAccess()).value().isController(level, state, level.getBlockEntity(pos))) return;
         try {
-            ControllerRecord.get(state.getBlock(), this.state.getDefinitionKey().identifier()).onFormed(level, this.state);
+            IController controller = ControllerRecord.get(state.getBlock(), this.state.getDefinitionKey().identifier());
+            DynamicMultiblockEvent.Form event = new DynamicMultiblockEvent.Form(level, controller, this.state);
+            NeoForge.EVENT_BUS.post(event);
+            if (!event.isCanceled()) {
+                controller.onFormed(level, this.state);
+            } else {
+                this.state.setFormed(false);
+            }
         } catch (IllegalArgumentException e) {
             log.error(e.getLocalizedMessage(), e);
             throw e;
diff --git a/module.multiblock/src/main/java/dev/anvilcraft/lib/v2/multiblock/network/MultiblockUnformPacket.java b/module.multiblock/src/main/java/dev/anvilcraft/lib/v2/multiblock/network/MultiblockUnformPacket.java
@@ -4,6 +4,8 @@
 import dev.anvilcraft.lib.v2.multiblock.dynamic.DynamicMultiblockManager;
 import dev.anvilcraft.lib.v2.multiblock.dynamic.MultiblockState;
 import dev.anvilcraft.lib.v2.multiblock.dynamic.controller.ControllerRecord;
+import dev.anvilcraft.lib.v2.multiblock.dynamic.controller.IController;
+import dev.anvilcraft.lib.v2.multiblock.dynamic.event.DynamicMultiblockEvent;
 import dev.anvilcraft.lib.v2.network.packet.IClientboundPacket;
 import dev.anvilcraft.lib.v2.network.packet.IPacket;
 import lombok.extern.slf4j.Slf4j;
@@ -14,6 +16,7 @@
 import net.minecraft.world.entity.player.Player;
 import net.minecraft.world.level.Level;
 import net.minecraft.world.level.block.state.BlockState;
+import net.neoforged.neoforge.common.NeoForge;
 
 @Slf4j
 @SuppressWarnings("unused")
@@ -40,7 +43,14 @@ public void handleOnClient(Player player) {
         BlockState state = level.getBlockState(pos);
         if (!this.state.getDefinition(level.registryAccess()).value().isController(level, state, level.getBlockEntity(pos))) return;
         try {
-            ControllerRecord.get(state.getBlock(), this.state.getDefinitionKey().identifier()).onUnformed(level, this.state);
+            IController controller = ControllerRecord.get(state.getBlock(), this.state.getDefinitionKey().identifier());
+            DynamicMultiblockEvent.Unform event = new DynamicMultiblockEvent.Unform(level, controller, this.state);
+            NeoForge.EVENT_BUS.post(event);
+            if (!event.isCanceled()) {
+                controller.onUnformed(level, this.state);
+            } else {
+                this.state.setFormed(true);
+            }
         } catch (IllegalArgumentException e) {
             log.error(e.getLocalizedMessage(), e);
             throw e;

Original file line number	Diff line number	Diff line change
`@@ -35,7 +35,6 @@ public interface IController {`
`35`	`35`	`default void onFormed(Level level, MultiblockState state) {`
`36`	`36`	`}`
`37`	`37`
`38`		`-`
`39`	`38`	`/**`
`40`	`39`	`* 多方块未成型回调`
`41`	`40`	`*`