Citizens Wiki

Citizens is a Minecraft server plugin that utilizes the Bukkit API. It adds various Non-Player Character (NPC) functionality. Citizens also features an easy-to-use API for plugin developers. Downloads: Downloads Spigot Page: Spigot Developers: fullwall Source: Github Support tickets: Ask on Discord in the '#citizens' channel, or post an issue on Github, but please see Troubleshooting first. Discord: Discord Donate: fullwall

What's New?

After months of waiting, Citizens 2.0 is finally here! You can download it here. For instructions on how to install it, check out the Installation page.

Key Features

• New and improved API for developers. This allows for brand new Characters to be made that can enhance your Minecraft experience.
• Database support. When the settings first generate, the default save method is YML. You can change storage.type in the config.yml to database if you wish to use a database. There are also database settings that you must configure before you can begin using the database.
• Mob NPCs. No longer are you confined to human NPCs. Now you can create intimidating blazes around a Nether portal, welcoming sheep near the spawn, and helpful villagers in your villages. See the Commands page to see how to create a mob NPC.
• Improved text editing. The new text-editing interface allows for easier NPC text adding, removing, and changing. There are also a few new text-related Configuration settings.
• Ability to set the server as the owner of an NPC. This makes it so only those with the "citizens.admin" permission can use and edit the NPC.
• Ridable NPCs. 'nuff said.
• A new scripting engine makes Citizens perhaps the most powerful plugin you have ever used.
• New Characters!
• And much more!

Can I keep my old NPCs?

You'll have to convert your old npc-profiles.yml files first. A converter can be found here on the site. Once you get the saves.yml file, place it in ./plugins/Citizens/saves.yml .

Still using Citizens 1.2? The old documentation, while no longer updated or supported, can be found here.

News

• Oct 4, 2012: Wiki updated from 1.19.1 to 1.19.2
• Sep 1, 2012: Citizens 2.0 has been released.
• Aug 24, 2012: CitizensNPCs.net has moved to CitizensNPCs.com, and the Converter now supports CitiTraders.
• Aug 6, 2012: Citizens2 now has Scripting support!

Changelog

2.0.2 - September 17th, 2012 - DL Misc bug fixes Flyable NPCs Players editing NPCs they don't own fixed Save immediately on shutdown Add /npc vulnerable command Fix to Age Cancel navigation target if npc despawns Added NPC speed limits 2.0.1 - September 6th, 2012 - DL Fix stationary ticks Changes to navigator Doesn't overwrite saves file if it failed to load Refactor CancelReason event firing, NPCs should teleport if no path can be found Compatible with 1.3.x 2.0 - September 2nd, 2012 - DL Complete and total rewrite.

Credits

Citizens would not be where it is today without the contributions of these people:

fullwall and aPunch - creators of the Citizens plugin
Paul_T - citizensnpcs.com server host
AgentK - Wiki editor, converter programmer, and script repo programmer.
aufdemrand - Wiki editor, graphic designer, and trait programmer
NeonMaster - Server and web maintenance, website developer
All character/trait authors, including those not mentioned here - talk to us on IRC!
You, for trying out and using Citizens!

Also, a special thanks to all of those in IRC who have tested and to all of those who have donated! We would be nowhere without you!