Citizens Wiki: Difference between revisions

From Citizens Wiki

No edit summary
No edit summary
 
(102 intermediate revisions by 8 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{UnderConstruction}}
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.


{{InfoBox}}
{{FNavBox}}
{{FNavBox}}


 
==Features==
==Citizens2 is Here! What's New?==
* NPCs can walk, stand and talk naturally to players.
<span style="word-spacing:13;letter-spacing:12">For the past few months, we have been planning a complete rewrite of the core code and API. We believed that Citizens wasn't fully living up to its potential. There were so many things we could do and so many places we could go with it. But the code didn't allow for many of these things. So, we agreed to completely redo the system. With Citizens2 comes a better code base, better API, and shiny new features for server administrators to play with.</span>
* Easy to use [[API]] for developers that allow [[Traits]] to be built for specific functionality.
 
* [[Types|Support for all mob types]] including Players, Pigs, and even non living ones like dropped items or arrow projectiles.  
===Key Features===
* [[Commands]] Extensive commands to customise NPCs.
-New and improved [[API]] for developers. This allows for brand new [[:Category:Characters|Characters]] to be made that can enhance your Minecraft experience.
* [[Controllable NPCs|Ridable NPCs]].
<br><br>-[[Data Storage|Database support]]. When the settings first generate, the default save method is YML. You can change ''use-database'' in the ''config.yml'' to true if you wish to use a database. There are also database settings that you must configure before you can begin using the database.
* Text editing.
<br><br>-[[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.
* Basic GUI shops.
<br><br>-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.
* Pathing.
<br><br>-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.
* Much more.
<br><br>-And much more! Browse around the wiki for more information on the new features.
 
===But, what happened to my NPC types?===
NPC types are now known as "Characters". Instead of placing these JAR files into the ''/plugins/Citizens/types'' directory, all you need to do is drop the JAR in the plugins folder. '''It is important to note, however, that all of your previous NPC type files will not work'''. You need to upgrade to the new characters if you so choose to use them. You can find more information on each character at the [[Characters]] page.
 
===Well how do I get this shiny new version?===
Citizens 2 is still in development, and isn't stable enough for a production server. However, there are development builds out that can be found on [http://ci.citizensnpcs.net Jenkins]. Instructions to install the development builds can be found on the [[Installation]] page.
 
===Can I keep my old NPCs?===
You'll have to convert your old npc-profiles.yml files first. A converter can be found [http://citizensnpcs.net/convert/ here on the site]. Once you get the saves.yml file, place it in ./plugins/Citizens/saves.yml .
 
==Credits==
 
Citizens would not be where it is today without the contributions of these people:
 
<br>'''Paul_T''' - citizensnpcs.net server host
<br>'''AgentKid''' - Wiki editor, test server provider
<br>'''aufdemrand''' - Wiki editor, logo and website designer
<br>'''NeonMaster''' - Server and web maintenance, website developer
<br>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!</div>

Latest revision as of 18:17, 19 April 2023

Welcome to the Citizens Wiki!

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

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.

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

Features

  • NPCs can walk, stand and talk naturally to players.
  • Easy to use API for developers that allow Traits to be built for specific functionality.
  • Support for all mob types including Players, Pigs, and even non living ones like dropped items or arrow projectiles.
  • Commands Extensive commands to customise NPCs.
  • Ridable NPCs.
  • Text editing.
  • Basic GUI shops.
  • Pathing.
  • Much more.