Citizens Wiki: Difference between revisions

From Citizens Wiki

m (Inline links are easier and look better :P)
(Get rid of the nasty coding from the homepage! Also, may want to implement on multiple pages later.)
Line 1: Line 1:
<div class="infobox" style="width: 295; font-size: 12px; background: #FFFFFF; float: right; border: 1px solid #CCCCCC; margin-left:0.5em; padding: 9px;">
{{InfoBox}}
{{Box|
BORDER = #ccc|
BACKGROUND = #aaa|
WIDTH = 275|
ALIGN = RIGHT|
ICON = |
HEADING = ''' ''' |
CONTENT = [[image:wordmark.png|center]]
<div class="padded" style="padding: 19px">Human NPCs for Bukkit.
 
'''Citizens''' is a Minecraft server plugin that utilizes the [http://www.bukkit.org Bukkit API]. It adds various Non-Player Character (NPC) functionalities, from basic NPCs that talk to lively, active Guards. Originally featuring only one type of NPC, Citizens now contains 7 toggleable types and 1 creature type. With the Citizens [[API]], plugins developers can make their plugins compatible with NPCs. Server admins are even able to choose which types that they want on their server.
 
'''Current Version:''' {{Version}} on {{Download}}
 
'''Developers:''' fullwall and aPunch
 
'''API:''' on [http://jd.citizensnpcs.net Citizens JavaDocs]
 
'''Source:''' [https://github.com/CitizensDev/Citizens on Github]
 
'''Latest build:''' [http://citizens.us1.creeperhost.net:8080/job/Citizens/lastSuccessfulBuild/artifact/*zip*/archive.zip on Citizens Jenkins]
 
'''Support tickets:''' [https://github.com/CitizensDev/Citizens/issues Issues on Github], but please see [[Troubleshooting]] first.
 
'''Donate: [https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=LXJKS2C8KREEG&lc=US&item_name=Halfcraft%20SMP%20Donations&currency_code=USD&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHosted aPunch] and [https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=CEQD6UNQHUG3C&lc=US&currency_code=USD&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHosted fullwall]
<br>
 
}}  
</div>
</div>
{{FNavBox}}
{{FNavBox}}
<div class="padded" style="font-size: 12px; padding: 5px">
<div class="padded" style="font-size: 12px; padding: 5px">

Revision as of 23:23, 14 February 2012

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

Latest News

  • Feb 13, 2012: 1.1.6 has been released. Several bugs fixed, new KillNPC quest objective added.
  • Jan 30, 2012: Our Jenkins site is currently not uploading the most recent builds. You must use our BukkitDev page to get the 1.1.5 download.
  • Jan 30, 2012: 1.1.5 has been released for use with the new RB 1.1 R3.


Setting up Citizens

Detailed information on setting up and upgrading Citizens can be found on the Installing page.

Creating your first NPC

It is important to read the Commands page for an in-depth look at all of the commands you can use to customize your NPCs. For now, here is a basic guide on how to setup an NPC.


Type /npc create [name]. Replace [name] with the name of your NPC. Optionally, you can add text to your NPC. To do this, simply add words after the name of the NPC. Example:

/npc create Notch I like cookies!

That's it! Of course there are various other things that you can do with basic NPCs as shown in Commands.


Characters

Having a basic NPC is cool, but you may want to make it another type. To change an NPC's type, use the command /toggle [type]. Replace [type] with the NPC type that you want to toggle your NPC to become. It is imperative that you have the NPC type's .jar file in your plugins/Citizens/types directory. If not, you won't be able to toggle an NPC to become that type.

/toggle healer

Formerly called NPC Types. Here and further known as just Characters, as they will be called in Citizens 2.

Toggleable Types (These types can be toggled):

Blacksmiths
Guards
Healers
Questers
Traders
Wizards

Mob Types (These types can automatically spawn):

Evil NPCs.

Credits

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

fullwall - original programmer
aPunch - programmer
Paul_T - citizensnpcs.net server host
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!