Add SpawnReason and method

src/main/java/net/citizensnpcs/api/event/NPCSpawnEvent.java

@@ -1,22 +1,23 @@
 package net.citizensnpcs.api.event;
 
-import net.citizensnpcs.api.npc.NPC;
-
 import org.bukkit.Location;
 import org.bukkit.event.Cancellable;
 import org.bukkit.event.HandlerList;
 
+import net.citizensnpcs.api.npc.NPC;
+
 /**
  * Called when an NPC spawns.
  */
 public class NPCSpawnEvent extends NPCEvent implements Cancellable {
     private boolean cancelled = false;
-
     private final Location location;
+    private final SpawnReason reason;
 
-    public NPCSpawnEvent(NPC npc, Location location) {
+    public NPCSpawnEvent(NPC npc, Location location, SpawnReason reason) {
         super(npc);
         this.location = location;
+        this.reason = reason;
     }
 
     @Override
@@ -26,13 +27,22 @@ public HandlerList getHandlers() {
 
     /**
      * Gets the location where the NPC was spawned.
-     * 
+     *
      * @return Location where the NPC was spawned
      */
     public Location getLocation() {
         return location;
     }
 
+    /**
+     * Gets the reason for spawning the NPC.
+     *
+     * @return Reason for spawning the NPC
+     */
+    public SpawnReason getReason() {
+        return reason;
+    }
+
     @Override
     public boolean isCancelled() {
         return cancelled;
@@ -43,9 +53,9 @@ public void setCancelled(boolean cancelled) {
         this.cancelled = cancelled;
     }
 
-    private static final HandlerList handlers = new HandlerList();
-
     public static HandlerList getHandlerList() {
         return handlers;
     }
+
+    private static final HandlerList handlers = new HandlerList();
 }

src/main/java/net/citizensnpcs/api/event/SpawnReason.java

@@ -0,0 +1,9 @@
+package net.citizensnpcs.api.event;
+
+public enum SpawnReason {
+    COMMAND,
+    CREATE,
+    PLUGIN,
+    RESPAWN,
+    TIMED_RESPAWN;
+}

src/main/java/net/citizensnpcs/api/npc/NPC.java

@@ -14,6 +14,7 @@
 import net.citizensnpcs.api.astar.Agent;
 import net.citizensnpcs.api.event.DespawnReason;
 import net.citizensnpcs.api.event.NPCDespawnEvent;
+import net.citizensnpcs.api.event.SpawnReason;
 import net.citizensnpcs.api.npc.BlockBreaker.BlockBreakerConfiguration;
 import net.citizensnpcs.api.trait.Trait;
 import net.citizensnpcs.api.trait.TraitFactory;
@@ -266,6 +267,17 @@ public interface NPC extends Agent, Cloneable {
      */
     public boolean spawn(Location location);
 
+    /**
+     * Attempts to spawn this NPC.
+     *
+     * @param location
+     *            Location to spawn this NPC
+     * @param reason
+     *            Reason for spawning
+     * @return Whether this NPC was able to spawn at the location
+     */
+    public boolean spawn(Location location, SpawnReason reason);
+
     /**
      * An alternative to {{@link #getBukkitEntity().getLocation()} that teleports passengers as well.
      *