Support asynchronous events; Addresses BUKKIT-1212

By: Wesley Wolfe <weswolf@aol.com>
2012-06-13 21:28:13 -05:00
parent ca71171e8c
commit ad7045596d
10 changed files with 300 additions and 27 deletions
--- a/paper-api/src/main/java/org/bukkit/plugin/PluginManager.java
+++ b/paper-api/src/main/java/org/bukkit/plugin/PluginManager.java
@@ -92,8 +92,11 @@ public interface PluginManager {
     * Calls an event with the given details
     *
     * @param event Event details
+     * @throws IllegalStateException Thrown when an asynchronous event is fired from synchronous code.<br>
+     *          <i>Note: This is best-effort basis, and should not be used to test synchronized state. This
+     *          is an indicator for flawed flow logic.</i>
     */
-    public void callEvent(Event event);
+    public void callEvent(Event event) throws IllegalStateException;

    /**
     * Registers all the events in the given listener class