Minecraft plugin CommandNPC

🔌 About the plugin CommandNPC

CommandNPC — is a Minecraft server plugin that lets Citizens2 NPCs run configured commands when a player interacts with them (click). CommandNPC focuses on adding configurable command behaviour to Citizens2 NPCs so servers can attach commands, permissions and simple economy hooks to NPC interactions.

🎯 Purpose

CommandNPC solves the need to bind server commands to NPC interactions without custom coding. It allows server admins to create interactive NPCs that execute commands (as player, op or console), charge players, and apply cooldowns or click‑type rules.

CommandNPC is specifically an add‑on for Citizens2; it does not replace Citizens2.

⚙ Main features

• Add commands to Citizens2 NPCs that execute when clicked.
• Flags to run commands as console or op, randomize commands, set delays and cooldowns.
• Support for placeholders: use %name% to reference the clicking player.
• Optional charge per execution (economy hooks) via command flags.
• Supports PlaceholderAPI (integration) and reports metrics via bStats.
• BungeeCord support for server teleport command through NPCs.

(Confirmed features are taken from official plugin listings and repository information.)

🧩 Who it's for

CommandNPC fits servers that use Citizens2 and want clickable NPC interactions: survival servers, hub/lobby servers, minigame networks (for basic server teleports), and any setup where admins need lightweight NPC‑bound commands.

🏗 Usage examples

• Create a hub NPC that teleports players to another server using a Bungee 'server' command bound to the NPC.
• Use /npc cmdadd to add multiple possible commands and set them to run randomly with -r.
• Charge players a small fee when they use a special NPC via the --v price flag.

⌨️ Commands

Note: players execute commands by clicking NPCs; the above commands are used by server staff to configure those NPC bindings.

🔐 Permissions

⚙ Installation

📥 Install

• Download the plugin .jar from the official resource.
• Place the .jar into your server plugins/ folder.
• Fully restart the server (do not use /reload).

📦 Dependencies

• Citizens2 — REQUIRED (CommandNPC is an add‑on for Citizens2).
• PlaceholderAPI — supported (optional) for expanded placeholders.
• bStats — used for plugin metrics (enabled by default unless configured otherwise).
• Java 8 was indicated as required in the official resource.

🧾 Configuration

• The plugin generates a config.yml on first run (configuration is available via that file).
• Configuration options include global click type defaults, cooldowns and economy behaviour.
• No official documentation or settings indicate MySQL/SQLite database support; no database is required for the confirmed features.

🧠 Additional information

Known limitations and notes

• CommandNPC is an add‑on and requires a working Citizens2 installation.
• The plugin's official releases date back to 2017; community feedback shows it still works on newer server builds for many users, but official tested versions listed are older — test on a staging server before production use.
• Some users have reported occasional issues with saved commands being removed; test backups or staging deployments are recommended.

Metrics & integrations

• Uses bStats for anonymous usage metrics (confirmed).
• Supports PlaceholderAPI for placeholder expansion (confirmed).
• Has a GitHub repository and an issues tracker for bugs and pull requests.

FAQ

Q: Do I need Citizens2? A: Yes — CommandNPC is an add‑on for Citizens2 and requires Citizens2 to create and manage NPCs.

Q: Can NPCs run console commands or as op? A: Yes — use flags like -c (console) and -o (op) when adding or setting commands.

Q: Can I charge players for using an NPC? A: Yes — the --v price flag can charge a numeric amount when the NPC command runs (economy provider required on server if external economy used).

Q: Does CommandNPC collect metrics? A: Yes, the plugin reports to bStats (anonymous metrics).

Q: Is there an official Discord support server? A: No official Discord is listed in the plugin's official resource pages.

Keywords: CommandNPC, minecraft plugin, spigot plugin, paper plugin, minecraft server, plugin commands, plugin permissions, Citizens2, PlaceholderAPI, bStats

(Verified against official plugin resource and repository information.)