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.
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.
Need 1.8 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.14 (alpha)
Authors: fullwall and aPunch
- Basic NPCs - right click messages, items, looking around, waypoints, and much more.
- Toggleable NPC characters with a full API - http://wiki.citizensnpcs.co/Characters
- Compatible with Essentials Eco, BOSEconomy, MultiCurrency, and iConomy 4, 5, & 6 through the use of the Vault plugin (required).
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:
- Make sure the issue you are experiencing is not already posted in the "Known Caveats" section on the download page
- Make sure the issue is not already listed in the Issue Tracker section.
- Provide as much information as possible (Minecraft version, CraftBukkit version, Citizens version, and the version of any other plugin (if applicable)
- Make sure the Citizens Wiki doesn't already have information on your issue.
Upgrading to 2.0
- Convert your NPC files at http://citizensnpcs.co/converter
- Find new characters at http://wiki.citizensnpcs.co/Characters
- Use the wiki for any questions you may have at http://wiki.citizensnpcs.co
- 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 mcstats.org:
- 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
- Ridable NPCs
- Characters/traits as the new types
Getting started with 2.x
- See the wiki here http://wiki.citizensnpcs.co/ to get started.
- Converter for old NPC files is here - http://citizensnpcs.co/converter/
- Dev builds here - http://ci.citizensnpcs.co
- bugfixes, begin work on translation system
2.0.3, 2.0.4, 2.0.5
- translation system implemented
- waypoint triggers
- lots of bugfixes
- /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.6
|File Name||Release Type||Game Version||Downloads||Date|
|2.0.16 (alpha 2 for MC 1.8.7)||Release||1.8.1||55,148||07/07/2015|
|2.0.16 (alpha 1 for MC 1.8.6)||Release||1.8.1||33,714||06/04/2015|
|2.0.14 (alpha 1 for MC 1.8.1)||Release||1.8.1||166,432||12/19/2014|
|2.0.13 (alpha 1 for MC1.7.9)||Release||CB 1.7.9-R0.1||245,414||06/07/2014|
|2.0.12 (alpha 3 for MC 1.7.5)||Release||1.7.4||103,312||04/11/2014|
|2.0.12 (alpha 2 for MC 1.7.5)||Release||1.7.4||6,552||04/10/2014|
|2.0.12 (alpha 1 for MC 1.7.5)||Release||1.7.4||16,516||04/04/2014|
|2.0.11 (update 2 for MC 1.7.4)||Release||1.7.4||54,519||03/17/2014|
|2.0.11 (update 1 for MC 1.7.4)||Release||1.7.4||11,920||03/12/2014|
|2.0.11 (for MC 1.7.x)||Release||1.7.4||18,926||03/07/2014|
|2.0.11 (alpha 2 for MC 1.7.2)||Release||CB 1.7.2-R0.2||136,515||01/16/2014|
|2.0.11 (alpha 1 for MC 1.7.2)||Release||1.7.2||122,561||12/05/2013|
|2.0.10 (alpha 1 for MC 1.6.4)||Release||1.6.4||112,978||09/22/2013|
|2.0.9 (beta 1)||Release||CB 1.6.2-R0.1||73,821||08/14/2013|
|2.0.9 (early alpha 3)||Release||1.6.2||49,899||07/20/2013|
|2.0.9 (early alpha 2)||Release||1.6.2||23,442||07/12/2013|
|2.0.9 (early alpha 1)||Release||1.6.1||13,465||07/05/2013|
|2.0.8 (alpha 4)||Release||1.5.2||186,075||05/02/2013|
|2.0.8 (alpha 3)||Release||1.5.1||80,325||03/29/2013|
|2.0.8 (alpha 2)||Release||1.5.1||22,117||03/21/2013|
|2.0.7 (beta *update recommended*)||Release||CB 1.4.7-R1.0||25,178||02/28/2013|
|1.2.3 (legacy)||Release||CB 1.4.7-R1.0||52,211||02/10/2013|
|1.2.2 (legacy)||Release||CB 1.4.7-R1.0||15,175||02/03/2013|
|2.0.2 (Build #370)||Release||CB 1.3.2-R0.1||237,200||09/17/2012|
|2.0.1 (Build #324)||Release||CB 1.3.2-R0.1||41,194||09/06/2012|
- Fixes, General, Informational, World Editing and Management, and Admin Tools
- 452,875 Monthly Downloads
- Tinkers Construct
- Mobs, Processing, Technology, and Armor, Tools, and Weapons
- 391,975 Monthly Downloads
- World Editing and Management and Admin Tools
- 328,791 Monthly Downloads
- Server Utility, API and Library, and Map and Information
- 325,217 Monthly Downloads
- API and Library
- 305,962 Monthly Downloads