This project is abandoned.

Whether this project is out of date or its author marked it as abandoned, this project is no longer maintained.

If you wish to take this project over, please report it and state your intentions.



Add customizable NPCs to Minecraft!
NPCWarehouse Team: jeremytrains and zsscooby

Latest Recommended BuildFiles
Development builds of this project can be acquired at the provided continuous integration server. These builds have not been approved by the BukkitDev staff. Use them at your own risk.
Jenkins Server for Dev BuildsJenkins

NPCWarehouse now has a Wiki!

NPCWarehouse is an NPC plugin designed for RolePlaying servers (Can be used on Creative and SMP servers as well, but not focused on this). NPCWarehouse will link in with other role playing plugins (ex. Factions, PermissionsEx, mcMMO, Spout/Spoutcraft) for a great npc experience. A list of NPC features is below. Currently this plugin is run and coded by jeremytrains, but if you would like to help or contribute, just post below! Help is always appreciated (If you decide to help, I will send you the source code).

Features for NPCs

  • Customize the NPC's name, messages, armor, items, and more!
  • Name an npc with a player's name and the npc will get the player's skin
  • Only the NPC's owner can edit the NPC
  • Have the NPC send messages to other NPCs on other servers or the same server! (Mailmen)
  • Have the NPC fight alongside with a faction or against mobs/players (Guardians)
  • Have the NPC sell or buy items with players (Traders)
  • Have the NPC dig tunnels for players (Miners)
  • Permissions support (Must be using Vault)
  • Set the npc's skin and cape (Spout + SpoutCraft required)
  • Customizable settings in a config.yml file
  • Create NPC's without a command (place wool on top of sand)
  • More features to come!

NPC Types

  • Guardian - fights mobs and players
  • Trader - sells and buys items with players
  • Mailman - delivers messages to players on the same server or different servers
  • Miner - digs tunnels for players

Mailmen allow you to connect two NPCs on either the same server or different servers, and send messages between the two of them. Players read their mail by going to the MailMan NPC and reading their inbox, just like a regular mailman. Note: By enabling mailmen, you agree to send information (NPC IDs, NPC names, your IP and Port, and any mail messages sent) to in order to transfer the messages between servers.

Permission Nodes
Click Here to view a list of commands and permission nodes on our wiki

Author's Channels and Streams
zsscooby's Youtube Channel
jeremytrains' Youtube Channel
zsscooby's Live Stream

Submitting A Bug
All Bugs should be submitted here

New Bukkit SafeGuard
The new Bukkit safeguard is described in detail here. NPCWarehouse does use Minecraft/CraftBukkit code outside of the API. This means that the safeguard does affect NPCWarehouse. You will need to have a new version of NPCWarehouse for every new version of Minecraft. I will do my best to get a compatible version released ASAP after an update, and add new features after a version is compatible.

Version Check
Don't know what version of the plugin your jar file is? You can use the NPCWarehouse version check by going to, uploading your file, and it will tell you which build number the jar file is from. The version check will work with all recommended versions of the plugin (downloaded here) after v0.9.3, but it will work with any version downloaded from the Jenkins server.

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of KillerBat97 KillerBat97 Jul 13, 2014 at 05:05 UTC - 1 like

    Can you update this?

  • Avatar of TheEpicButterStudios TheEpicButterStudios Jun 17, 2014 at 19:24 UTC - 0 likes

    CI Server appears to be down.


  • Avatar of Drake_Eldridge Drake_Eldridge May 23, 2014 at 06:58 UTC - 1 like

    Can you please make a pathfinding thing like citizens. where you can set a path for the npc and it will walk it. Like so set a waypoint one end of town, then walk to other end of town and set waypoint, so the npc will walk up and down the town. Citizens has it, but citizens doesnt work with MCPC plus (modpack server), and your plugin does. If you had this your plugin would pretty much replace citizens completely. Oh and if you do add it could you make it so the npc can look at you as it walks past and if within range it talks, so it walks past player and says hi, and keeps walking. Something like this would be perfect for the rpg town im making on the server.

  • Avatar of jac1975 jac1975 May 07, 2014 at 18:21 UTC - 0 likes

    i cant spawn anything keep get the same error over and over agian 07.05 13:11:58 [Server] INFO ======= End of Error Report ======= 07.05 13:11:58 [Server] INFO Vault Version: none 07.05 13:11:58 [Server] INFO Factions Version: none 07.05 13:11:58 [Server] INFO Spout Version: none 07.05 13:11:58 [Server] INFO Crafting: true 07.05 13:11:58 [Server] INFO Right Click Selecting: true 07.05 13:11:58 [Server] INFO Vault Enabled: false 07.05 13:11:58 [Server] INFO Spout Enabled: true 07.05 13:11:58 [Server] INFO Stats: 0 regular, 0 guardians, 0 miners, and 0 mailmen (0 total) 07.05 13:11:58 [Server] INFO Bukkit Version: git-Bukkit-1.7.2-R0.3-56-g3779cff-b3072jnks (MC: 1.7.9) 07.05 13:11:58 [Server] INFO Plugin Version: 1.1.3-dev 07.05 13:11:58 [Server] INFO ==== NPCWarehouse Debug Report ==== 07.05 13:11:20 [Server] INFO Emperor: [Emperor]jac_197 07.05 13:10:47 [Server] INFO ... 13 more 07.05 13:10:47 [Server] INFO at org.bukkit.command.PluginCommand.execute( [craftbukkit_dev_3072.jar:git-Bukkit-1.7.2-R0.3-56-g3779cff-b3072jnks] 07.05 13:10:47 [Server] INFO at net.npcwarehouse.util.CommandHandler.onCommand( [?:?] 07.05 13:10:47 [Server] INFO at net.npcwarehouse.NPCCommandHandler.runCommand( [?:?] 07.05 13:10:47 [Server] INFO at net.npcwarehouse.NPCCommandHandler.createNPC( [?:?] 07.05 13:10:47 [Server] INFO Caused by: java.lang.NullPointerException 07.05 13:10:47 [Server] INFO at [craftbukkit_dev_3072.jar:git-Bukkit-1.7.2-R0.3-56-g3779cff-b3072jnks] 07.05 13:10:47 [Server] INFO at [craftbukkit_dev_3072.jar:git-Bukkit-1.7.2-R0.3-56-g3779cff-b3072jnks] 07.05 13:10:47 [Server] INFO at net.minecraft.server.v1_7_R3.MinecraftServer.u( [craftbukkit_dev_3072.jar:git-Bukkit-1.7.2-R0.3-56-g3779cff-b3072jnks] 07.05 13:10:47 [Server] INFO at net.minecraft.server.v1_7_R3.DedicatedServer.v( [craftbukkit_dev_3072.jar:git-Bukkit-1.7.2-R0.3-56-g3779cff-b3072jnks] 07.05 13:10:47 [Server] INFO at net.minecraft.server.v1_7_R3.MinecraftServer.v( [craftbukkit_dev_3072.jar:git-Bukkit-1.7.2-R0.3-56-g3779cff-b3072jnks] 07.05 13:10:47 [Server] INFO at net.minecraft.server.v1_7_R3.ServerConnection.c(SourceFile:134) [craftbukkit_dev_3072.jar:git-Bukkit-1.7.2-R0.3-56-g3779cff-b3072jnks] 07.05 13:10:47 [Server] INFO at net.minecraft.server.v1_7_R3.NetworkManager.a( [craftbukkit_dev_3072.jar:git-Bukkit-1.7.2-R0.3-56-g3779cff-b3072jnks] 07.05 13:10:47 [Server] INFO at net.minecraft.server.v1_7_R3.PacketPlayInChat.handle( [craftbukkit_dev_3072.jar:git-Bukkit-1.7.2-R0.3-56-g3779cff-b3072jnks] 07.05 13:10:47 [Server] INFO at net.minecraft.server.v1_7_R3.PacketPlayInChat.a( [craftbukkit_dev_3072.jar:git-Bukkit-1.7.2-R0.3-56-g3779cff-b3072jnks] 07.05 13:10:47 [Server] INFO at net.minecraft.server.v1_7_R3.PlayerConnection.a( [craftbukkit_dev_3072.jar:git-Bukkit-1.7.2-R0.3-56-g3779cff-b3072jnks] 07.05 13:10:47 [Server] INFO at net.minecraft.server.v1_7_R3.PlayerConnection.handleCommand( [craftbukkit_dev_3072.jar:git-Bukkit-1.7.2-R0.3-56-g3779cff-b3072jnks] 07.05 13:10:47 [Server] INFO at org.bukkit.craftbukkit.v1_7_R3.CraftServer.dispatchCommand( [craftbukkit_dev_3072.jar:git-Bukkit-1.7.2-R0.3-56-g3779cff-b3072jnks] 07.05 13:10:47 [Server] INFO at org.bukkit.command.SimpleCommandMap.dispatch( [craftbukkit_dev_3072.jar:git-Bukkit-1.7.2-R0.3-56-g3779cff-b3072jnks] 07.05 13:10:47 [Server] INFO at org.bukkit.command.PluginCommand.execute( [craftbukkit_dev_3072.jar:git-Bukkit-1.7.2-R0.3-56-g3779cff-b3072jnks] 07.05 13:10:47 [Server] INFO org.bukkit.command.CommandException: Unhandled exception executing command 'npc' in plugin NPCWarehouse v1.1.3-dev

  • Avatar of MrGruffly MrGruffly Apr 29, 2014 at 00:29 UTC - 1 like

    Evey time I do the /npc create command it gives me the *an internal error occured when attempting to perform this command.

    the /npcdebug gives me just this also INFO]: ==== NPCWarehouse Debug Report ==== INFO]: Plugin Version: 1.1.2 INFO]: Bukkit Version: git-Bukkit-1.7.2-R0.3-59-g6efeddf-b3074jnks (MC

    INFO]: Stats: 0 regular, 0 guardians, 0 miners, and 0 mailmen (0 total

    INFO]: Spout Enabled: false INFO]: Vault Enabled: false INFO]: Right Click Selecting: true INFO]: Crafting: true INFO]: Spout Version: none INFO]: Factions Version: none INFO]: Vault Version: none INFO]: ======= End of Error Report =======

  • Avatar of yyyyer2 yyyyer2 Apr 20, 2014 at 02:23 UTC - 0 likes

    How can I create a NPC that fights whichever player who is close to them? And won't fight when the player is at a distance away from them? Thanks!

  • Avatar of MikeStardust MikeStardust Apr 17, 2014 at 18:25 UTC - 0 likes

    Can someone tell me if this works server side or client side?

  • Avatar of merlin2v merlin2v Apr 16, 2014 at 01:09 UTC - 0 likes

    @fflip8: Go

    my server is 1.7.2

  • Avatar of fflip8 fflip8 Apr 13, 2014 at 00:49 UTC - 0 likes

    @merlin2v: Go

    Its because the NPCwarehouse creators haven't released an update yet to support 1.7.5, or 1.7.8 If you use any of these ones then it is their issue If you are running the beta or something of 1.7.2 and this still happens, then it's a problem other than that plugin itself Otherwise you will also see MANY errors in the console, I recommend not using it until they push an update out

  • Avatar of merlin2v merlin2v Apr 12, 2014 at 19:18 UTC - 1 like

    when I reload my server my npcs are gone

Vault for Permissions?

  1. Choice:

  1. Results
  2. 0 comments


Date created
Nov 22, 2011
Last update
Jan 26, 2014
Development stage
  • enUS
NPCWarehouse License (NPCL)
Recent files
  • R: v1.1.2 for CB 1.7.2-R0.2 Jan 26, 2014
  • R: v1.1 for CB 1.7.2-R0.2 Jan 07, 2014
  • R: v1.0.2 for CB 1.6.4-R2.0 Dec 01, 2013
  • R: v1.0 for CB 1.6.2-R1.0 Sep 19, 2013
  • R: v0.9.4 for CB 1.5.2-R0.1 May 20, 2013



Optional dependency