All code to call events and delegate back to plugins

By: Dinnerbone <dinnerbone@dinnerbone.com>

paper-api/src/org/bukkit/event/Event.java

@@ -13,7 +13,41 @@ public abstract class Event {
         server = instance;
     }
 
+    /**
+     * Gets the Server instance that triggered this event
+     * @return Server which this event was triggered on
+     */
     public final Server getServer() {
         return server;
     }
+
+    /**
+     * Represents an events priority
+     */
+    public enum Priority {
+        /**
+         * Event is critical and must be called near-first
+         */
+        Highest,
+
+        /**
+         * Event is of high importance
+         */
+        High,
+
+        /**
+         * Event is neither important or unimportant, and may be ran normally
+         */
+        Normal,
+
+        /**
+         * Event is of low importance
+         */
+        Low,
+
+        /**
+         * Event is of extremely low importance, most likely just to monitor events, and must be run near-last
+         */
+        Lowest
+    }
 }

paper-api/src/org/bukkit/event/Listener.java

@@ -0,0 +1,9 @@
+
+package org.bukkit.event;
+
+/**
+ * Simple interface for tagging all EventListeners
+ */
+public interface Listener {
+
+}

paper-api/src/org/bukkit/event/player/PlayerEvent.java

@@ -16,7 +16,25 @@ public abstract class PlayerEvent extends Event {
         player = who;
     }
 
+    /**
+     * Returns the player involved in this event
+     * @return Player who is involved in this event
+     */
     public final Player getPlayer() {
         return player;
     }
+
+    /**
+     * Represents the different types of events
+     */
+    public enum EventType {
+        /**
+         * A player joins a server
+         */
+        Join,
+        /**
+         * A player leaves a server
+         */
+        Quit
+    }
 }

paper-api/src/org/bukkit/event/player/PlayerListener.java

@@ -1,13 +1,24 @@
 
 package org.bukkit.event.player;
 
+import org.bukkit.event.Listener;
+
 /**
  * Handles all events thrown in relation to a Player
  */
-public abstract class PlayerListener {
+public abstract class PlayerListener implements Listener {
     private PlayerListener() {
     }
 
+    /**
+     * Called when a player joins a server
+     * @param event Relevant event details
+     */
     public abstract void onPlayerJoin(PlayerJoinEvent event);
+
+    /**
+     * Called when a player leaves a server
+     * @param event Relevant event details
+     */
     public abstract void onPlayerQuit(PlayerQuitEvent event);
 }