Citizens Wiki: Difference between revisions

From Citizens Wiki

No edit summary
 
(255 intermediate revisions by 9 users not shown)
Line 1: Line 1:
= Citizens =
__NOTOC__
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.


Citizens is a Minecraft server plugin that utilizes the Bukkit API. It adds various Non-Player Character (NPC) functionalities, from simple NPCs that talk to lively, active Guards. Since its release in early March 2011, it has grown to become the best (and most functional) public NPC plugin in Minecraft. Originally featuring only one type of NPC, Citizens now contains 7 toggleable types and 1 creature type. Server admins are even able to choose which types that they want on their server.
{{FNavBox}}


'''Current Version:''' 1.1
==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.
See below for information on types, commands, permission nodes, and more!
* [[Types|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.
== Getting started ==
* [[Controllable NPCs|Ridable NPCs]].
Follow the directions below to set up Citizens to your liking.
* Text editing.
 
* Basic GUI shops.
* Go to the download page [http://www.citizensnpcs.net/download here].
* Pathing.
* Follow instructions on the download page.
* Much more.
* Drag the generated Citizens.jar and /Citizens directory into the /plugins directory of your server files.
* Start and stop your server.
* Configure the files in the /plugins/Citizens. Use the [[Configuration]] page for reference.
* Give your players permissions. See the [[Permissions]] page for detailed node information.
* Start your server again. Enjoy!
 
== 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.
 
 
1. 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 Bob Hi, my name is Bob!''. If you want your NPC to have a skin, then give it a name of a player who has a skin. For example, typing ''/npc create Notch'' will create an NPC with Notch's skin.
 
2. If you didn't set the text of your NPC with the above command, you can type ''/npc add This is a sentence.'' to add text to it. Additionally, you can replace all of the current text with just one line by doing ''/npc set This text replaces all of the current text.'' Lastly, you can reset your NPC's text by typing ''/npc reset''.
 
3. If you want your NPC to have a colored nameplate, then type ''/npc color &<color-code>''. Replace ''<color-code>'' with the ID of the color you want the nameplate to be. Example: ''/npc color &6'' will give your NPC a gold nameplate. '''WARNING: Changing the color of an NPC's nameplate removes its skin.'''
 
== NPC Types ==
 
'''Creature Types (These types spawn on their own):'''
 
* [[Evil NPCs]]
 
 
'''Toggleable Types (These types can be toggled):'''
 
* [[Alchemist]]
* [[Blacksmith]]
* [[Guard]]
* [[Healer]]
* [[Quester]]
* [[Trader]]
* [[Wizard]]
 
== FAQ ==
If the above pages don't have answers to your problems, this section usually will.
 
'''Can I give my NPCs custom skins?'''
No. The NPCs created from this plugin will draw their name based on the Minecraft skin database - For example, an NPC named "Notch" will have Notch's skin. There is NO way to influence this, so just use the name of other people if you want custom skins that match theirs. This is a limitation of Minecraft, not the plugin. Go to mcskinsearch.com to find cool player skins.
 
'''I am getting errors, and none of the developers respond to my questions in the thread. What should I do?'''
To get a response from a developer, it is key that you follow the directions in the README file that is packaged in Citizens.jar. You can also view it [https://github.com/fullwall/Citizens/blob/master/README here].
 
== Citizens Team ==
'''aPunch''' - Code
 
'''fullwall''' - Code
 
'''Paul_T''' - Website

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.