Add new registry API

src/main/java/net/citizensnpcs/api/CitizensAPI.java

@@ -34,6 +34,17 @@ public static NPCRegistry createAnonymousNPCRegistry(NPCDataStore store) {
         return getImplementation().createAnonymousNPCRegistry(store);
     }
 
+    /**
+     * Creates a new <em>anonymous</em> {@link NPCRegistry} that is "Citizens-backed" i.e. will reload and unload at the
+     * same time that Citizens reloads and unloads.
+     *
+     * @param store
+     *            The {@link NPCDataStore} to use with the registry
+     */
+    public static NPCRegistry createCitizensBackedNPCRegistry(NPCDataStore store) {
+        return getImplementation().createCitizensBackedNPCRegistry(store);
+    }
+
     /**
      * Creates a new {@link NPCRegistry} with its own set of {@link NPC}s. This is stored in memory with the Citizens
      * plugin, and can be accessed via {@link #getNamedNPCRegistry(String)}.

src/main/java/net/citizensnpcs/api/CitizensPlugin.java

@@ -18,6 +18,15 @@ public interface CitizensPlugin extends Plugin {
      */
     public NPCRegistry createAnonymousNPCRegistry(NPCDataStore store);
 
+    /**
+     * Creates a new <em>anonymous</em> {@link NPCRegistry} that is "Citizens-backed" i.e. will reload and unload at the
+     * same time that Citizens reloads and unloads.
+     *
+     * @param store
+     *            The {@link NPCDataStore} to use with the registry
+     */
+    public NPCRegistry createCitizensBackedNPCRegistry(NPCDataStore store);
+
     /**
      * @param name
      *            The plugin name

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

@@ -5,6 +5,8 @@
 import org.bukkit.entity.Entity;
 import org.bukkit.entity.EntityType;
 
+import net.citizensnpcs.api.event.DespawnReason;
+
 /**
  * Controls the registration and lookup of a set of {@link NPC}s.
  */
@@ -47,6 +49,14 @@ public interface NPCRegistry extends Iterable<NPC> {
      */
     public void deregisterAll();
 
+    /**
+     * Despawn all NPCs within the registry.
+     *
+     * @param reload
+     *            The reason to despawn
+     */
+    public void despawnNPCs(DespawnReason reason);
+
     /**
      * Gets the {@link NPC} with the given ID if it exists.
      *
@@ -97,6 +107,11 @@ public interface NPCRegistry extends Iterable<NPC> {
      */
     public boolean isNPC(Entity entity);
 
+    /**
+     * Saves the NPCs to the internal {@link NPCDataStore}
+     */
+    public void saveToStore();
+
     /**
      * Returns a <em>sorted</em> view of this registry, sorted by NPC id.
      *