Install CommandNPC Reloaded for Minecraft NPC Commands

What CommandNPC Does

NPCs can make a Minecraft server feel more alive, especially when they do something useful. With the right setup, a character can teleport players, open shops, hand out items, run menus, or guide newcomers around spawn without needing a staff member to stand there forever.

CommandNPC Reloaded is an addon for Citizens2 that lets NPCs run commands when players interact with them. Citizens2 handles creating the NPCs, while CommandNPC adds the command behavior. Vault and PlaceholderAPI are commonly used alongside it for economy support and dynamic player placeholders.

The original CommandNPC project is no longer maintained, so most servers should use CommandNPC Reloaded instead. It is updated for newer Minecraft versions and is the better choice unless a specific legacy setup requires otherwise.

Download the Required Plugins

1. Open the CommandNPC Reloaded plugin page on Spigot.
2. Click the download button and save the `.jar` file somewhere easy to find.

1. Download the required dependencies as well: Citizens2, Vault, and PlaceholderAPI.
2. Keep all downloaded `.jar` files ready for upload.

Using matching versions matters. A modern Paper or Spigot server usually works well, but always check each plugin page for supported Minecraft versions before uploading files. Plugin compatibility is not a place for guesswork, unless you enjoy console errors as a hobby.

Upload CommandNPC to Your Server

1. Open your server panel and stop the server.
2. Check the selected server software and version using your panel's version selector.

1. Confirm the server is running plugin-compatible software, such as Paper or Spigot. If it is using Vanilla, switch to a plugin-supported server type first.
2. Open FTP or your server's file manager.
3. Find the `plugins` folder. If it does not exist, create it.

1. Upload CommandNPC Reloaded, Citizens2, Vault, and PlaceholderAPI into the `plugins` folder.
2. Wait until every upload reaches 100%, then return to the main server page and restart the server.

After the restart, check the console for startup errors. If one plugin fails to load, confirm that its version matches your Minecraft server version and that all dependency files are present.

Create Your First NPC

Before adding commands, create an NPC with Citizens2. Use this format:

`/npc create [name] --type [entity]`

Replace `[name]` with the NPC name and `[entity]` with the mob or entity type. For example, to create a cat named Morgana, run:

`/npc create Morgana --type cat`

Once the NPC exists, CommandNPC can attach actions to it. The basic command format is:

`/npc cmdadd [arguments] [command]`

For example, this gives the clicking player one salmon:

`/npc cmdadd -o give %name salmon 1`

The `-o` argument runs the command as if the NPC had operator permission. The `%name` placeholder targets the player who clicked the NPC. PlaceholderAPI can provide many more placeholders, which is useful for personalized messages, economy actions, ranks, or server-specific menus.

Useful Command Ideas

CommandNPC works best when the command is simple and predictable. Common uses include:

• Sending players to another area with a teleport command.
• Opening a shop, menu, or kit selector.
• Giving a starter item or reward.
• Running an economy command through Vault-supported plugins.
• Showing help text for spawn, ranks, rules, or minigames.

If a command works when typed manually in chat or console, it can usually be adapted for an NPC. Test each command with one NPC first before adding it across a busy spawn area.

Final Notes

CommandNPC Reloaded makes Citizens2 NPCs much easier to turn into interactive server tools. With Citizens2 creating the characters, PlaceholderAPI handling dynamic values, and Vault supporting economy features, you can build guides, shops, teleporters, and small server mechanics without writing a custom plugin.

Keep the setup simple at first. Create one NPC, add one command, test it, then expand from there. A few well-placed NPCs can make a server feel more polished and help players find what they need faster.