CommandNPC: Transform Your Minecraft Server with Interactive NPCs
Every server owner knows that standing out in the crowded world of Minecraft multiplayer takes more than just a few custom blocks. You need mechanics that surprise and delight your players. That’s exactly where CommandNPC comes in. Inspired by the legendary Mineplex server, this plugin lets you turn ordinary Citizens NPCs into powerful command hubs that respond to a simple right-click. Whether you want to open a shop, teleport players, grant ranks, or run a random event, CommandNPC handles it all with a clean, permission-driven system.
What Exactly Is CommandNPC?
CommandNPC is a Spigot plugin that extends the functionality of Citizens 2 NPCs. Instead of just standing around as decoration, your NPCs can execute any command you can dream up — as the player, as console, or even as a temporary operator. The plugin is lightweight, actively maintained by Bradydawg, and completely free. It works with Java 8 and fully supports PlaceholderAPI, so you can weave player names and other dynamic values right into your commands. If you’ve ever wanted an NPC that sells items, opens a GUI, sends a message, or even transfers players across BungeeCord servers, this is your tool.
Key Features That Make CommandNPC Shine
The real magic lies in the flags you can attach to each command. Instead of a rigid “click to run” setup, you get fine-grained control over every interaction. Here’s a quick look at what you can tweak:
- Execution context: Use -c to run the command from the console, -o to run it with OP privileges, or leave both off to execute as the clicking player.
- Randomized actions: The -r flag picks one command at random from the NPC’s list, perfect for lottery or mystery reward systems.
- Cost and permissions: Charge players with --v (supports decimals) and lock commands behind custom permission nodes using --p.
- Cooldowns and delays: Set a tick delay with --d and a cooldown with --cd (20 ticks = 1 second). You can even customize the cooldown message via -m.
- Click type filtering: Restrict commands to left-click, right-click, or both with --t.
- Message suppression: Flags -i and -l let you hide the default “no permission” or “insufficient funds” messages for a cleaner experience.
All of this is saved per NPC, so you can build a whole team of interactive characters without any conflicts. The plugin also tracks command IDs, letting you inspect or remove specific commands later with /npc cmdinfo and /npc cmdremove.
Getting Started with CommandNPC
Setup is refreshingly straightforward. First, make sure you have Citizens 2 installed and running on your server. Then drop the CommandNPC JAR into your plugins folder, restart, and edit the config.yml to suit your preferences. Select the NPC you want to modify with the Citizens selection wand, and you’re ready to add commands.
The core command is /npc cmdadd. A typical setup might look like this: /npc cmdadd -c -o --v 100.0 --cd 40 --t right say Welcome, %name!. This would make the NPC greet the player by name, run the command from the console with OP, charge 100 units of your economy, enforce a 2-second cooldown, and only trigger on right-click. You can stack multiple commands on the same NPC, each with its own unique combination of flags.
If you ever need to wipe all commands from an NPC, /npc cmdreset does the job instantly. The plugin also works beautifully with BungeeCord — just add server <serverName> as a command to teleport players across your network. For those who enjoy experimenting with both server plugins and client-side mods, the foxygame.net launcher provides a clean, modern interface where you can browse and install mods directly from the menu, making it a handy companion for your overall Minecraft toolkit.
Commands and Permissions at a Glance
To manage an NPC’s commands, you need the commandnpc.admin permission. Here are the main commands you’ll use daily:
- /npc cmdadd [flags] <command...> – Attach a new command to the selected NPC.
- /npc cmdinfo [id] – Display all commands on the NPC, or details for a specific ID.
- /npc cmdremove <id> – Delete a single command by its ID.
- /npc cmdset [flags] [command | cdMsg...] – Modify an existing command’s flags or cooldown message.
- /npc cmdreset – Remove every command from the selected NPC.
Remember that flags requiring additional input, like --v or --cd, need two dashes. The placeholder %name will always be replaced with the clicking player’s username, and with PlaceholderAPI installed, you can pull in countless other values.
Why CommandNPC Deserves a Spot on Your Server
CommandNPC bridges the gap between static NPCs and fully scripted game mechanics without demanding any programming knowledge. It’s actively maintained, meaning you won’t be left with a broken plugin after a Minecraft update. The flexibility of per-command flags lets you build everything from simple teleporters to complex quest givers, all while keeping your server’s performance in check. The fact that it’s free and open-source (check the GitHub repository for the latest builds) is just icing on the cake.
Server owners who value deep customization and player engagement will find CommandNPC indispensable. It turns the humble right-click into a gateway for endless creativity. Give it a try, and watch your NPCs come alive.