Fun Login to Add Favorites
  • Minecraft
  • 41,071 Monthly Downloads
  • Supports: 1.10
  • 3,585,773 Total Downloads
  • Updated Oct 24, 2016
  • Created Aug 24, 2011
  • 222 Favorites
  • Project Site
  • Release Type: Release
  • License: Open Software License
  • Newest File: 2.0.20 (MC 1.10.2)
Support development! **

About Citizens


New releases/discussion

Citizens is the original Bukkit NPC plugin, adding everything from simple NPCs that talk to lively, active Denizens, Sentries, Traders and more. Citizens contains a variety of toggleable characters and unlimited possibilities for expansion with the new easy to use API. With advanced features such as scripting, AI and a helpful dev team, Citizens will continue to expand to make your server even better! For more information and all the gory details, see the wiki documentation and links down below.

Wiki | Issue Tracker | Commands

Source | API Repo / Docs

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.

Dev Builds

Need 1.9 compatibility? Try the dev builds for now. Make sure you are on the VERY LATEST DEV build of CraftBukkit and remember to make backups of Citizens data!

Current Version: 2.0.16 (alpha)

Authors: fullwall and aPunch


  • Basic NPCs - right click messages, items, looking around, waypoints, and much more.
  • Toggleable NPC characters with a full API -
  • Compatible with Essentials Eco, BOSEconomy, MultiCurrency, and iConomy 4, 5, & 6 through the use of the Vault plugin (required).

Issue Tracker

If you want to report a bug or request a feature, please file an issue here. Be sure to follow these guidelines before you file a ticket:

  1. Make sure the issue you are experiencing is not already posted in the "Known Caveats" section on the download page
  2. Make sure the issue is not already listed in the Issue Tracker section.
  3. Provide as much information as possible (Minecraft version, CraftBukkit version, Citizens version, and the version of any other plugin (if applicable)
  4. Make sure the Citizens Wiki doesn't already have information on your issue.

Upgrading to 2.0

  1. Convert your NPC files at
  2. Find new characters at
  3. Use the wiki for any questions you may have at
  4. Come to IRC on EsperNet #citizens for any questions you may have.

Yes, we know that this is a pretty major change. Yes, things may break. Yes, not all of the features from 1.2 are re-implemented. But, with the rewrite, new API and new features we hope to have a sustainable base for server owners and developers alike.


You can download Citizens at bukkitdev here. Look above for a link to dev builds.


This plugin utilises Hidendra's plugin metrics system, which means that the following information is collected and sent to

  • A unique identifier
  • The server's version of Java
  • Whether the server is in offline or online mode
  • The plugin's version
  • The server's version
  • The OS version/name and architecture
  • The core count for the CPU
  • The number of players online
  • The Metrics version

Opting out of this service can be done by editing plugins/Plugin Metrics/config.yml and changing opt-out to true.

2.x version info

  • Completely rewritten with a new API. Javadocs are available and new character development encouraged - developers can come to EsperNet IRC #citizens to get a wiki page.
  • Mob types
  • Scripting
  • Ridable NPCs
  • Characters/traits as the new types

Getting started with 2.x


  • bugfixes, begin work on translation system

2.0.3, 2.0.4, 2.0.5

  • translation system implemented
  • waypoint triggers
  • lots of bugfixes
  • templates
  • /npc type
  • support for generic equipping
  • more options in /npc talk
  • begin work on new A* pathfinder for greater extensibility
  • SlimeSize, SkeletonType and ZombieModifier traits
  • Works with Minecraft 1.4.5


  • Updated for Minecraft 1.4.6


  • Updated for Minecraft 1.4.7
  • Fixed some important bugs and added Command, Translation, Messaging APIs
  • Fixed some longstanding head yaw bugs and random bits depletion bugs.


  • Updated for Minecraft 1.5.x
  • Fixed many bugs
  • Added new APIs for wandering, added mob nameplates
  • Fixed Player error bug


  • Updated for Minecraft 1.6.x
  • Fixed bugs with new A* pathfinder - now the default pathfinder. Please report bugs with it! You can turn it off in the settings under use-new-pathfinder.
  • Added new APIs for cloning
  • NPC IDs are now globally unique


  • Updated for Minecraft 1.6.4


  • Updated for Minecraft 1.7.2
  • Added /npc swim
  • Added /npc flyable, and allow flying NPCs to pathfind
  • Added some API features
  • Added non-living NPC types
  • Allowed NPCs to have 64 length names except players
  • More waypoint triggers
  • Possible baby NPC moving fix
  • Added /template delete and /template list
  • Fixed packet sending bug
  • Removed database support


  • Updated for Minecraft 1.7.5
  • Added /npc skin command (may be buggy)
  • Additional fixes for the 1.7.8 protocol hack


  • Updated for Minecraft 1.7.9
  • Fixed /npc skin command


  • Updated for Minecraft 1.8.1


  • Updated for Minecraft 1.8.3


  • Updated for Minecraft 1.8.8


  • Updated for Minecraft 1.9


  • Updated for Minecraft 1.9.4


  • Updated for Minecraft 1.10
  • 1
  • 2
  • 3
  • 4
  • 5
  • Next