Minecraft plugin CitizensCMD

🔌 About CitizensCMD

CitizensCMD — is a Minecraft plugin that allows attaching commands, chat messages, server commands, and sounds to Citizens NPCs so actions run when players interact with NPCs. CitizensCMD requires the Citizens plugin to function.

🎯 Purpose

CitizensCMD solves the need to make Citizens NPCs perform actions (execute console commands, send player messages, play sounds, run server-side commands, require permissions or costs) without writing custom scripts. It is aimed at server administrators who want clickable NPC interactions without heavy scripting. CitizensCMD works alongside the Citizens plugin and targets Spigot/Paper server environments where Citizens is supported. ()

⚙ Core features

• Attach commands (console, player, server) to NPC left/right click
• Display configurable chat messages when NPCs are used
• Play sounds when interacting with NPCs
• Set cooldowns and price requirements for NPC actions
• Permission checks per attached action
• Admin commands for listing, adding, editing and removing NPC commands

🧩 Who is it for

• Server admins who use Citizens and need clickable NPC actions
• Survival, mini‑game and network servers that use NPCs for menus, shops, or teleports
• Teams that prefer configuration via commands and config files over scripting

🏗 Usage examples

• Create a shop NPC that charges a price and runs a console command to give items when clicked.
• Make a teleport NPC that runs a server command and shows a message to the player.
• Configure cooldowns on role‑selection NPCs so players cannot spam selections.

⌨️ Commands

If the plugin presents different commands in your version, consult the plugin wiki or Spigot resource for the exact syntax. ()

🔐 Permissions

(Official sources list the permission nodes but do not consistently declare the default values for each node; defaults may be 'op' or unset depending on the plugin version.) ()

⚙ Installation

📥 Installing

• Download the CitizensCMD .jar from the official Spigot resource or the plugin's GitHub releases.
• Place the .jar into your server's plugins/ folder.
• Ensure the Citizens plugin is installed (Citizens is required).
• Fully restart the server (do not use /reload).
• Check console on startup for CitizensCMD messages and errors. ()

📦 Dependencies

• Citizens — REQUIRED (CitizensCMD is an add‑on for Citizens). ()
• bStats — CitizensCMD reports metrics to bStats (metrics presence confirmed). ()
• PlaceholderAPI / Vault — integration mentions appear in community translations/configs, but official dependency requirements for these are not documented in the primary pages; treat them as optional if you require placeholders or economy features. (Information partially present in community resources.)

🧾 Configuration

• CitizensCMD generates a plugin folder and configuration files on first run (see GitHub wiki/config page for parameters).
• The plugin uses config files for messages, cooldowns, price and behavior; check plugins/CitizensCMD/ after startup for config.yml or message files. ()
• Database support (MySQL/SQLite): Not documented in the official resources; assume local YAML config unless specific documentation says otherwise. (Information absent in official sources.)

🧠 Additional information

⚠ Known conflicts and limitations

• CitizensCMD requires Citizens; it will not function without it. ()
• Some server setups reported permission registration warnings (permission already registered) when multiple plugins define identical nodes — this can cause startup warnings. Administrators should check console logs. ()
• Compatibility with the latest Minecraft/Paper builds depends on both Citizens and CitizensCMD being updated; verify plugin versions before upgrading your server core. (See plugin pages for version tags.)

FAQ

Q: Does CitizensCMD require Citizens?
A: Yes — CitizensCMD is an add‑on and requires Citizens installed. ()

Q: Does the plugin collect metrics?
A: Yes, CitizensCMD is listed on bStats and reports usage metrics. ()

Q: Is there a GUI for configuring commands?
A: Configuration and command management are performed via plugin commands and config files; no official GUI is documented in the primary sources. ()

Q: Can NPCs run console/server commands or only player commands?
A: Both console (server) and player/message/sound actions are supported via the /npcmd add types documented. ()

Q: Is there built‑in economy support?
A: CitizensCMD supports a price parameter for actions; whether an external economy plugin (Vault) is required is not consistently documented. Check your version's docs if you need economy integration. (Partial information in community resources.)

🤝 When to use CitizensCMD

Use CitizensCMD when you run a Spigot/Paper Minecraft server with Citizens and need to attach configured commands, messages or sounds to NPCs without heavy scripting. It is a lightweight way to manage NPC interactions with plugin commands and config files. ()