From 6d0589dfbf9adf148de0bff70911502a1c8f8a0c Mon Sep 17 00:00:00 2001
From: Paint_Ninja <PaintNinja@users.noreply.github.com>
Date: Fri, 21 Jun 2024 19:33:23 +0100
Subject: [PATCH] Add `IEventBus#fire` to return the posted event object (#57)

---
 .../minecraftforge/eventbus/api/IEventBus.java   | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/src/main/java/net/minecraftforge/eventbus/api/IEventBus.java b/src/main/java/net/minecraftforge/eventbus/api/IEventBus.java
index 00f2235..0ccf368 100644
--- a/src/main/java/net/minecraftforge/eventbus/api/IEventBus.java
+++ b/src/main/java/net/minecraftforge/eventbus/api/IEventBus.java
@@ -160,6 +160,22 @@ public interface IEventBus {
      */
     boolean post(Event event, IEventBusInvokeDispatcher wrapper);
 
+    /**
+     * Submit the event for dispatch to appropriate listeners and return the (possibly mutated) event
+     *
+     * @param event The event to dispatch to listeners
+     * @return The event object that was dispatched
+     */
+    default <T extends Event> T fire(T event) {
+        post(event);
+        return event;
+    }
+
+    default <T extends Event> T fire(T event, IEventBusInvokeDispatcher wrapper) {
+        post(event, wrapper);
+        return event;
+    }
+
     /**
      * Shuts down this event bus.
      *