Citizens Wiki: Difference between revisions

From Citizens Wiki

No edit summary
No edit summary
Line 3: Line 3:
{{FNavBox}}
{{FNavBox}}


==What's New?==
==About==
After months of waiting, Citizens 2.0 is '''finally here!''' You can download it [http://dev.bukkit.org/server-mods/citizens/files/ here]. For instructions on how to install it, check out the [[Installation]] page.
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.


===Key Features===
===Key Features===
* New and improved [[API]] for developers. This allows for brand new [[Characters]] to be made that can enhance your Minecraft experience.
* New and improved [[API]] for developers. This allows for brand new [[Characters]] to be made that can enhance your NPC experience.
* [[Data Storage|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.
* [[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.
* [[Types|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.
* 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.
* 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.
* Ridable NPCs. 'nuff said.
* A new [[Scripting|scripting engine]] makes Citizens perhaps the most powerful plugin you have ever used.
* A new [[Scripting|scripting engine]] makes Citizens perhaps the most powerful plugin you have ever used.
* New [[Characters]]!
* And much more!
* And much more!


===Can I keep my old NPCs?===
===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 .
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 .



Revision as of 19:07, 21 January 2013

Wordmark.png

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

Quick Navigation
Usage Installation  · Frequently Asked Questions  · Commands  · Waypoints  · Shops  · Editors  · API
Configuration Data Storage  · Permissions  · Translations
Characters Denizen  · Sentinel  · DtlTraders  · Builder
Info Downloads  · Discord
Special Information Minecraft 1.8  · Cracks  · Skins  · NPC Commands

About

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.

Key Features

  • New and improved API for developers. This allows for brand new Characters to be made that can enhance your NPC experience.
  • 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.
  • 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.
  • 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 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.

Changelog

  • 2.0.6 - December 22nd, 2012 - DL
    • Works with Minecraft 1.4.6
  • 2.0.5 - December 19th, 2012 - 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 - 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!