|
|
| (46 intermediate revisions by 7 users not shown) |
| Line 1: |
Line 1: |
| __NOTOC__ | | __NOTOC__ |
| {{InfoBox}} | | Welcome to the Citizens Wiki! {{InfoBox}} |
| | Citizens is a popular Minecraft server plugin that allows you to create non player characters (NPCs) to provide varied gameplay and functionality for your server such as basic statues, shopkeepers, guards, scriptable NPCs and much more. |
| | |
| {{FNavBox}} | | {{FNavBox}} |
|
| |
|
| ==About== | | ==Features== |
| Citizens2 is an advanced NPC plugin for CraftBukkit. Unlike the original Citizens, Citizens2 has a robust API for developers to extend basic NPCs to provide varied gameplay and functionality.
| | * NPCs can walk, stand and talk naturally to players. |
| | | * Easy to use [[API]] for developers that allow [[Traits]] to be built for specific functionality. |
| ===Key Features===
| | * [[Types|Support for all mob types]] including Players, Pigs, and even non living ones like dropped items or arrow projectiles. |
| * New and improved [[API]] for developers. This allows for brand new [[Characters]] to be made that can enhance your NPC experience. | | * [[Commands]] Extensive commands to customise NPCs. |
| * [[Types|Monster and animal NPCs]]. 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. | | * [[Controllable NPCs|Ridable NPCs]]. |
| * 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. | | * Text editing. |
| * 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.
| | * Basic GUI shops. |
| * Ridable NPCs. 'nuff said.
| | * Pathing. |
| * A new [[Scripting|scripting engine]] makes Citizens perhaps the most powerful plugin you have ever used. | | * Much more. |
| * And much more!
| |
| | |
| ===Can I keep my NPCs from Citizens 1?===
| |
| You'll have to convert your old npc-profiles.yml files first. A converter can be found [http://citizensnpcs.com/converter/ 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 [[1.x|here]].
| |
| | |
| ==Changelog==
| |
| {{scrollbox|
| |
| * '''2.0.6 - December 22nd, 2012 - [http://dev.bukkit.org/server-mods/citizens/files/22-2-0-6-alpha/ DL]'''
| |
| ** Works with Minecraft 1.4.6 | |
| * '''2.0.5 - December 19th, 2012 - [http://dev.bukkit.org/server-mods/citizens/files/20-2-0-5/ DL]'''
| |
| ** Works with Minecraft 1.4.5
| |
| ** Translation system implemented
| |
| ** Waypoint triggers
| |
| ** Numerous bugfixes
| |
| ** Templates
| |
| ** /npc type
| |
| ** Support for generic equipping
| |
| ** More options in /npc talk
| |
| ** Began work on new A* pathfinder for greater extensibility
| |
| ** SlimeSize, SkeletonType and ZombieModifier traits added
| |
| * '''2.0.2 - September 17th, 2012 - [http://dev.bukkit.org/server-mods/citizens/files/19-2-0-2-build-370/ 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 - [http://dev.bukkit.org/server-mods/citizens/files/16-2-0-1-build-324/ 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 - [http://dev.bukkit.org/server-mods/citizens/files/15-2-0/ DL]''' | |
| ** Complete and total rewrite. | |
| }}
| |
| | |
| ==Credits==
| |
| | |
| Citizens would not be where it is today without the contributions of these people:
| |
| | |
| <br>'''fullwall and aPunch''' - creators of the Citizens plugin
| |
| <br>'''Paul_T''' - citizensnpcs.com server host
| |
| <br>'''AgentK''' - Wiki editor, converter programmer, and script repo programmer.
| |
| <br>'''aufdemrand''' - Wiki editor, graphic designer, and [[Denizen|trait programmer]]
| |
| <br>'''NeonMaster''' - Server and web maintenance, website developer
| |
| <br>All character/trait authors, including those not mentioned here - talk to us on IRC!
| |
| <br>You, for trying out and using Citizens!
| |
| | |
| Also, a special thanks to all of those in [http://webchat.esper.net/?channels=citizens IRC] who have tested and to all of those who have donated! We would be nowhere without you!
| |
