本帖最后由 lulu456u 于 2017-7-1 13:13 编辑

所有标题可点,并连接到原wiki网站。



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.
Citizens 2是一个用于CraftBukkit服务端的先进的NPC插件。与原本的Citizens 1不同,Citizens 2允许开发者开拓基本的npc的用途,添加性状(职业特征),来提供不同的玩法和乐趣。






Installing Citizens 2.0 is easy. It is like installing any other Bukkit plugin. If you don't know how to do that, see below.
你当然可以像其他插件一样轻松地安装Citizens 2.0。如果你不知道该怎么做,那就继续往下看吧。
Download Citizens.
下载Citizens 2.0插件。
Place the Citizens 2.0 jar in your /plugins directory.
将Citizens2.0的jar文件放到你的plugins文件夹中。
Download any desired Trait plugins and place these in the /plugins directory as well.
Reload or restart your server. Citizens 2 will create a plugins/Citizens folder and a config.yml file.
下载所有需要的性状(职业)附属插件并把它们也放到plugins文件夹中。重新加载或重新打开你的服务器。Citizens 2将会创建plugins/Citizens文件夹和config.yml文件。
Configure Citizens to your liking with config.yml. See the Configuration page for more help.
Config.yml中把Citizens配置你喜欢的样子。请看“配置”部分来获得更多你需要的帮助。
Reload or restart your server.
重载或重新打开你的服务器。
Start creating and editing NPCs!
开始创建和编辑NPC吧!
Be sure to set Permissions so your players can interact with NPCs.
一定要设置权限,这样你的玩家才能和NPC们互动。
Note that players need the citizens.npc.talk permission to hear NPCs!
值得注意的是,玩家需要citizens.npc.talk权限才能听到NPC的话!



Citizens 2.0 is NOT compatible with Citizens 1.2
注意:Citizens 2.0并不支持Citizens 1.2
Can I keep my old NPCs?
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 .
Before you do any downloading and configuring of Citizens2, you must delete all of your previous Citizens files. They will not work with Citizens v2.0 or higher. It is recommended to backup these files just in case you decide to downgrade.
Once you have removed all Citizens 1.x files, follow the steps above.
我可以保留我的旧NPC吗?
首先你需要转换原本的npc-profiles.yml文件。转换器可以在这里被找到(原帖转换器已蹦)。当你得到了转换出的saves.yml,请把它放在/plugins/Citizens/saves.yml
在你下载和配置Citizens 2之前,你必须删除所有你以前的Citizens文件。它们将不会在Citizens 2.0或更高的版本上运行。建议你备份它们以防你决定降级插件。







Read below for detailed command documentation. For more info on per-type commands and permissions, see its corresponding page.
请阅读下面详细的指令文档。如果你想要了解每种指令的详细信息和权限,请参阅其对应的页面。
[] ——必需条件
() ——可选条件
Command - command's syntax
Args Description - description of the command's arguments
Require Selected - whether the command requires an NPC to be selected
Require Ownership - whether the commands requires you to be the owner of the NPC
Require Mob Types - whether the command requires an NPC to be a certain mob type(s)
Permission - command's permission node
Description - short description of the command
指令 —— 命令语法
参数描述 —— 命令中参数的详细描述
选择需求 —— 命令是否需要选择NPC
所有权需求 —— 命令是否需要你是NPC的所有者
NPC类型需求 —— 命令是否需要NPC为特定类型
权限 —— 命令节点
描述 —— 命令的简短描述


                      指令:




Editors are used to further edit NPCs in easy ways. These are things considered too complex to require just commands to edit. In all editors, you must type the associated command once to enter the editor, and again to exit it. You can only be in one editor at a time.
编辑器用于简单地进一步编辑NPC。只用命令来编辑这些东西过于复杂。所有的编辑器都需要特定的指令进入,并重复该指令退出。你只能同时在一个编辑器里。
文本编辑器
Editing a NPC's text is simple. Follow the in-game directions to add, edit, and remove text from NPCs. A NPC being a "random-talker" means that it will repeat random phrases from its list of text. If "random" is false, it will loop through the text linearly. Changing its close-talker setting by typing "close" will toggle whether a NPC talks when a player comes within 5 blocks. If close is false, the NPC will only talk when it is clicked with the configurable talk-item. If close is true, it will only talk when a player comes near.
编辑NPC的文本很简单。跟随游戏中的指示来添加、编辑和删除NPC的文本。一个NPC是“随机谈话者”意味着他会在文本列表中随机选择文本来说。如果“随机”是关闭的,他们将会依次说出文本列表中的文本。通过键入“close”改变close-talker设置,调整NPC是否会在玩家接近到5个方块以内时交流。如果close是关闭状态的话,NPC会在被点击时交流;如果close是开启状态的话,NPC会在玩家靠近时交流。
注意:与NPC对话需要citizens.npc.talk权限!

路径编辑器
NPCs can be given Waypoints to dictate their motion.
Waypoints are created by a Waypoint Provider. You can change providers using the /waypoint provider [provider] command.
The current Providers are:
Linear (default) - Sends the NPC to each stored waypoint in sequence.
Wander - The NPC wanders around randomly.
Guided - The waypoints are split into destination waypoints and guide waypoints. Destination waypoints are chosen randomly and pathed to using a combination of the guide waypoints.
NPC可以通过被给予路径点来支配他们的路径。
路径点被路径提供者创建。你可以改变路径提供者,通过/waypoint provider [provider]指令。
当前拥有的路径提供者分为:
线性(默认) - 让NPC沿路径点运动。
徘徊 - NPC在周围随机徘徊。
导向 - 路径点被分为目的地路径点和导向路径点。NPC将随机通过导向路径点前往目的地路径点。
触发路径点
For the linear waypoint provider, triggers can be added to pause the NPC at certain waypoints, change their speed or say something at a waypoint. More information can be found by typing 'triggers' in the waypoint editor.
对于线性路径点,触发器可以被添加以在特定的路径点处使NPC暂停,改变他们的速度或者让他们在路径点处说点什么。更多的信息可以在路径点编辑器中输入“triggers”来观看。

装备编辑器
Equipment is things like armor, held-items, and other visible features on NPCs. Only some NPC types can have their equipment edited.
装备就是像护甲、手持物品或其他的NPC身上可见的特征。只有一些类型的NPC可以被编辑装备。
通用
With the new mob equipment updating in 1.4.5, any mobs not listed here will default to the Human equipping style. Note that the equipment may not display properly on all mobs as some do not support it.
随着新的装备编辑器1.4.5的更新,所有没在这里列出的实体都将会默认使用人的装备编辑风格。需要注意的是装备不一定会被在所有实体身上显示,因为有些不支持装备。

人类(普通的NPC)
Human NPCs can have their armor and held item modified. To give armor to a NPC, right-click one with armor in your hand. The armor is placed on the NPC's body. Any item or armor that was previously on a NPC will be removed and dropped to the ground. To place armor in a NPC's hand, crouch and right-click. To clear all items, right-click the NPC with no items in your hand.
人类NPC可以编辑他们的护甲和手持物品。手持一个护甲并右键他们来给他们装备。这个护甲将直接被穿在他们的身上。之前在他们身上的装备将被移除并掉在地面上。蹲下并右键单击NPC来把装备放在他的手上。什么都不拿并右键NPC可以清除他身上的所有装备。

末影人
Enderman NPCs can have their carried material modified. The only valid materials that an enderman can hold are blocks - most items do not appear on the client. Note that certain "utility" blocks such as sign posts, silverfish blocks, etc. do not appear on the client either. Click with no items in your hand to remove blocks from the enderman NPC.
末影人NPC拿在手里的物品可以被改变。它们只可以拿方块——大多数物品不会出现在客户端。注意某些“效用”方块例如路标、鱼块也不会出现在客户端。什么都不拿并点击它可以移除它手中的方块。

Sheep NPCs can have their wool color and sheared status modified. To shear, right-click with shears like your normally would. To un-shear a sheep NPC, click it with the shears again. To change the wool color, click the sheep NPC with dye. Clicking with anything but dye in your hand will turn the sheep NPC white and drop the dye on the ground.
羊NPC的毛色和剪毛状态是可以被改变的。像你剪羊毛一样用剪刀右键单击可以移除它身上的毛。再次用剪刀右键单击可以恢复它身上的毛。手持染料右键它可以改变它的毛色。手持除了染料的任何东西右键它将会把它的毛色变成白色。染料将会掉在地上。

Pig NPCs can have saddles added and removed from them. Simply right-click the pig NPC with a saddle in hand. Clicking with any other item in your hand will remove the saddle from the pig NPC.
猪NPC可以被添加/移除鞍。拿着鞍右键它可以给它添加鞍。拿着除了鞍以外的任何东西右键它可以移除鞍。

客户端问题
There are known clientside issues with some equipment editors. If you are experiencing an issue, it is likely clientside. Try relogging and if necessary restarting your server.
有些编辑器有已知的客户端问题。如果你发现了一个问题,那么……它很可能来自你的客户端。如果必要的话,尝试一下重新登陆或重启你的服务器吧。




性状(职业)

Characters are complex traits that use the Citizens API to add functionality to existing NPCs. To get characters on your server, simply follow the links to their respective wiki pages and find the download link. Install the characters' JAR file into the /plugins or /plugins/Citizens/plugins directory.
Citizens NPCs can be multiple traits at the same time. See Multiple Traits
性状是通过CitizensAPI给NPC添加的能力。想要从你的服务器上获得性状,只需要按照他们各自的wiki链接并找到下载地址。把性状的JAR文件放在/plugins目录或/plugins/citizens/plugins目录。
NPC可以同时拥有多个性状。请看更多性状。

Multiple Traits更多性状All Citizens 2.0 behavior is dictated by Traits.
Traits can be applied to the NPCs and will handle events and interaction in specific ways.
The cool thing is a NPC can have multiple traits assigned to it. Including multiple Character Traits.
An example is the Wallet Trait. This trait allows the NPC to have and use economy money. This Trait is useless by itself but works when the NPC is also assigned the Denizen or Trader trait.
Characters are really just complicated Traits.
Assigning multiple Characters traits can lead to powerful results, but also potential conflicts.
NPCs with the Denizen trait should use the commands for that trait to turn on and off specific interactions that may cause conflict.
For example if you want to make a Blacksmith that wanders throughout the town using Denizen Activities to dictate his movement, you would want to turn off Click Triggers in the Denizen Trait so that right-clicking the Blacksmith would perform the proper Blacksmith commands and not trigger any Denizen scripts.

所有的Citizens 2.0的行为都是由性状决定的。
性状可以被应用于NPC,将用于处理事件和以特定的方式相互作用。
最酷的事情就是NPC可以被分配很多性状。包括很多性格特点。
钱包性状就是一个例子。这个性状允许NPC拥有和使用货币。这对它自己来说没什么使用价值,但是在NPC也被分配了商人或居民性状时工作。
人物是复杂的性状。
分配多个人物性状可能会有很大的用处,但也有可能具有潜在的冲突。
具有居民性状的NPC应该被使用指令来打开或关闭可能造成冲突的特定的相互作用。
例如如果你想要制作一个在城镇中通过居民来支配运动路径的铁匠,你可能想要关闭点击触发的居民性状以便右键铁匠出发适当的铁匠命令而并不触发任何的居民脚本。
通过使用指令/trait [traitname]来从NPC身上打开或关闭某个特定的性状。


  
Characters人物
  
Name名称
Developer创作者
Description简介
Alchemist炼金师
可定制的药剂配方。
在很大程度上可定制的工具和装甲重铸。
Builder建筑者
一块一块的建筑。
Denizen居民
脚本化、交互式的NPC。
DtlTraders交易者
dandielo
另一个交易人物。
Quests探索者
Various
链接到Citizens 2的探索选项。
Sentry哨兵
警卫和战斗NPC。 他们可以守卫某个地方或成为保镖。他们可以是近战也可以是远距攻击。
Postal邮政
这是一个使用NPC为邮递员的成熟的邮政系统。
一个定制的MoxieSkills技能插件的商店NPC。
HyperConomy商店的一个商人 NPC's 和 GUI。
tenowg
交易者。


配置信息
默认配置



Configuration syntax in Citizens is simple. Nodes within arrow brackets -- <> -- will be parsed and replaced if possible. Below are the available nodes that you can use.
在Citizens中配置语法是简单的。在箭头括号——<>——中的节点将会被试着替换——如果它们被支持的话。下面是可用的节点。

字体颜色
请将颜色代码放在<>里,例如<a>为绿色

0 -- BLACK 黑色
1 -- DARK BLUE 墨蓝
2 -- DARK GREEN 墨绿
3 -- CYAN 青色
4 -- DARK RED 深红
5 -- PURPLE 紫色
6 -- GOLD 金色
7 -- LIGHT GRAY 亮灰
8 -- GRAY 灰色
9 -- BLUE 蓝色
a -- GREEN 绿色
b -- AQUA 浅绿(水绿)
c -- ROSE RED 玫瑰红
d -- LIGHT PURPLE 亮紫(粉色?)
e -- YELLOW 黄色
f -- WHITE 白色


其他

npc -- NPC's name NPC的名字

id -- NPC's ID NPC的ID
owner -- NPC's owner NPC的所有者
player -- Player's name 玩家名

world -- Player's world 玩家所在世界






Data storage in Citizens2 is handled in one of two ways: YAML flatfile or a NBT file.
在Citizens 2中储存数据有两种格式:YAML文件和NBT文件。

saves.yml
saves.yml is used by default to store all data on created NPCs.
saves.yml默认被用于存储所有创建的NPC的数据。
结构格式:


结束语

嗨呀完成了还真是很高兴呢
如果有翻译错误的地方请各位dalao提出以下修改意见~谢谢啦
为毛读着这么像机翻

[groupid=1330]PluginsCDTribe[/groupid]