Citizens Wiki: Difference between revisions

From Citizens Wiki

No edit summary
No edit summary
Line 5: Line 5:


==Key Features==
==Key Features==
* Walk and talk. NPCs can stand in place or walk paths at adjustable speed. The can talk to players when clicked or when players walk nearby.
* New and improved [[API]] for developers. This allows for brand new [[Characters]] to be made that can enhance your NPC experience.
* New and improved [[API]] for developers. This allows for brand new [[Characters]] to be made that can enhance your NPC experience.
* [[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|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.
* Ridable and controllable NPCs.
* 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.
* Robust text editing. The new text-editing interface allows for adding, removing, and editing NPC text.
* Ridable NPCs. 'nuff said.
* Player- and server-owned NPCS. Server-owned NPCs can be edited by anyone with the ''citizens.admin'' permission.
* Charge for NPC creation and limit NPCs per player.
* Admins can optionally charge for NPC creation and limit the number of NPCs per player.
* A new [[Scripting|scripting engine]] makes Citizens perhaps the most powerful plugin you have ever used.
* A built-in [[Scripting|scripting engine]] allows NPCs to run external scripts (javascript, lua, python, etc.)
* And much more!


{{FNavBox}}
{{FNavBox}}

Revision as of 19:30, 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

Citizens2 is an advanced NPC plugin for CraftBukkit. Unlike the original Citizens, Citizens2 allows developers to extend basic NPCs to provide varied gameplay and functionality.

Key Features

  • Walk and talk. NPCs can stand in place or walk paths at adjustable speed. The can talk to players when clicked or when players walk nearby.
  • 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.
  • Ridable and controllable NPCs.
  • Robust text editing. The new text-editing interface allows for adding, removing, and editing NPC text.
  • Player- and server-owned NPCS. Server-owned NPCs can be edited by anyone with the citizens.admin permission.
  • Admins can optionally charge for NPC creation and limit the number of NPCs per player.
  • A built-in scripting engine allows NPCs to run external scripts (javascript, lua, python, etc.)
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

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
jrbudda - Trait programmer, wiki editor
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!