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 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

  • Avatar of justinbeatdown justinbeatdown Mar 29, 2014 at 21:38 UTC - 1 like

    I keep receiving the error "An internal error occurred while attempting to perform this command" when doing /npc create

    Here's everything

    [17:35:22 INFO]: ==== NPCWarehouse Debug Report ==== [17:35:22 INFO]: Plugin Version: 1.1.3-dev [17:35:22 INFO]: Bukkit Version: git-Bukkit-1.7.2-R0.3-9-g8e87ff5-b3033jnks (MC: 1.7.5) [17:35:22 INFO]: Stats: 0 regular, 0 guardians, 0 miners, and 0 mailmen (0 total) [17:35:22 INFO]: Spout Enabled: true [17:35:22 INFO]: Vault Enabled: true [17:35:22 INFO]: Right Click Selecting: true [17:35:22 INFO]: Crafting: true [17:35:22 INFO]: Spout Version: none [17:35:22 INFO]: Factions Version: none [17:35:22 INFO]: Vault Version: Vault v1.2.31-b411 [17:35:22 INFO]: ======= End of Error Report =======

    [17:38:16 INFO]: Dethroat issued server command: /npc create hehe [17:38:16 ERROR]: null org.bukkit.command.CommandException: Unhandled exception executing command 'npc' in plugin NPCWarehouse v1.1.3-dev at org.bukkit.command.PluginCommand.execute( [craftbukkit-dev.jar:git-Bukkit-1.7.2-R0.3-9-g8e87ff5-b3033jnks] at org.bukkit.command.SimpleCommandMap.dispatch( [craftbukkit-dev.jar:git-Bukkit-1.7.2-R0.3-9-g8e87ff5-b3033jnks] at org.bukkit.craftbukkit.v1_7_R2.CraftServer.dispatchCommand( [craftbukkit-dev.jar:git-Bukkit-1.7.2-R0.3-9-g8e87ff5-b3033jnks] at net.minecraft.server.v1_7_R2.PlayerConnection.handleCommand( [craftbukkit-dev.jar:git-Bukkit-1.7.2-R0.3-9-g8e87ff5-b3033jnks] at net.minecraft.server.v1_7_R2.PlayerConnection.a( [craftbukkit-dev.jar:git-Bukkit-1.7.2-R0.3-9-g8e87ff5-b3033jnks] at net.minecraft.server.v1_7_R2.PacketPlayInChat.a( [craftbukkit-dev.jar:git-Bukkit-1.7.2-R0.3-9-g8e87ff5-b3033jnks] at net.minecraft.server.v1_7_R2.PacketPlayInChat.handle( [craftbukkit-dev.jar:git-Bukkit-1.7.2-R0.3-9-g8e87ff5-b3033jnks] at net.minecraft.server.v1_7_R2.NetworkManager.a( [craftbukkit-dev.jar:git-Bukkit-1.7.2-R0.3-9-g8e87ff5-b3033jnks] at net.minecraft.server.v1_7_R2.ServerConnection.c(SourceFile:134) [craftbukkit-dev.jar:git-Bukkit-1.7.2-R0.3-9-g8e87ff5-b3033jnks] at net.minecraft.server.v1_7_R2.MinecraftServer.v( [craftbukkit-dev.jar:git-Bukkit-1.7.2-R0.3-9-g8e87ff5-b3033jnks] at net.minecraft.server.v1_7_R2.DedicatedServer.v( [craftbukkit-dev.jar:git-Bukkit-1.7.2-R0.3-9-g8e87ff5-b3033jnks] at net.minecraft.server.v1_7_R2.MinecraftServer.u( [craftbukkit-dev.jar:git-Bukkit-1.7.2-R0.3-9-g8e87ff5-b3033jnks] at [craftbukkit-dev.jar:git-Bukkit-1.7.2-R0.3-9-g8e87ff5-b3033jnks] at [craftbukkit-dev.jar:git-Bukkit-1.7.2-R0.3-9-g8e87ff5-b3033jnks] Caused by: java.lang.NullPointerException at net.npcwarehouse.NPCCommandHandler.createNPC( [?:?] at net.npcwarehouse.NPCCommandHandler.runCommand( [?:?] at net.npcwarehouse.util.CommandHandler.onCommand( [?:?] at org.bukkit.command.PluginCommand.execute( [craftbukkit-dev.jar:git-Bukkit-1.7.2-R0.3-9-g8e87ff5-b3033jnks] ... 13 more

  • Avatar of jshiah jshiah Mar 21, 2014 at 01:44 UTC - 0 likes

    What do i do?

  • Avatar of jshiah jshiah Mar 21, 2014 at 01:42 UTC - 0 likes

    I have been fooling around with this plugin for a day or 2 now and i have 3 questions.
    1) I made the guard and made him aggro but he wont attack mobs.
    2) When i di /lookat or /move it says the comand worked but it really didnt.
    3) How do i enable the trader?

    Btw im not very tech savy.
    and the markup thing at the bottom im just gonna put something random

  • Avatar of tpfau714 tpfau714 Mar 12, 2014 at 00:21 UTC - 0 likes

    I seem to be getting an error whenever I try to use the /npc select command. The server is throwing the following:

    11.03 19:17:17 [Server] WARN Task #3 for NPCWarehouse v1.1.2 generated an exception 11.03 19:17:16 [Server] INFO at [craftbukkit_beta_2974.jar:git-Bukkit-1.7.2-R0.2-b2974jnks] 11.03 19:17:16 [Server] INFO at [craftbukkit_beta_2974.jar:git-Bukkit-1.7.2-R0.2-b2974jnks] 11.03 19:17:16 [Server] INFO at net.minecraft.server.v1_7_R1.MinecraftServer.t( [craftbukkit_beta_2974.jar:git-Bukkit-1.7.2-R0.2-b2974jnks] 11.03 19:17:16 [Server] INFO at net.minecraft.server.v1_7_R1.DedicatedServer.u( [craftbukkit_beta_2974.jar:git-Bukkit-1.7.2-R0.2-b2974jnks] 11.03 19:17:16 [Server] INFO at net.minecraft.server.v1_7_R1.MinecraftServer.u(

  • Avatar of ItzCyberPvP ItzCyberPvP Mar 09, 2014 at 13:21 UTC - 0 likes

    Hello again, i cannot figure out how to turn off the following command, once it has followed someone, it will not stop. Thanks.


  • Avatar of islandmat islandmat Mar 06, 2014 at 23:31 UTC - 0 likes

    @jeremytrains: Go

    Do you know if this is going to be fixed soon? I need one for 1.6.4 but it doesn't work, Like other people with the /npc create name

    Should I think about an alternative?

  • Avatar of jeremytrains jeremytrains Mar 03, 2014 at 15:46 UTC - 0 likes

    @pengh: Go

    This is an error with MCPC. I will try to find the problem as soon as I can.

    @ItzCyberPvP: Go

    "/[npc type] toggle" while selecting an npc. For example, /guardian toggle. Vault is only required if you want permissions or economy support. If you want to use GroupManager with NPCWarehouse, you need Vault. If you aren't using permissions or economy with NPCWarehouse, then you don't need Vault.

    @FEARcustard: Go

    What is the output of /npcdebug?


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)
Curse link
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