[娱乐][角色]Citizens v2.0.14 —— NPC与RPG插件Wiki翻译[1.4.5-1.8.1] - Minecraft(我的世界)中文论坛

写在前面

大家好，我是一个服务器的技术管理，目前在策划我们服务器第三周目的事情，由于这次的策划比较大，需要深度定制一些规则，所以需要寻找和了解一些适合的插件。因为很多插件只有一些简单的翻译，甚至有些只是一些简单的介绍，所以抱着边翻译边学习的想法，我打算把需要用到的插件一个个地翻译搬运到MCBBS上，也方便我们服的管理和我查阅学习，并且方便MCBBS上的其他服主。希望大家能更好地定制自己的服务器 :P

有标记颜色的地方是这次编辑修改的部分，一般是经过测试后发现翻译时的理解错误的地方。

简介

基本功能

主要特点

如何安装

安装Citizens 2.0非常容易。像许多其他的Bukkit插件一样，如果你不知道怎么做，请往下看。

FAQ（这部分就不翻译了）

指令

[] - 强制参数

() - 可选参数

帮助指令

NPC指令

命令	参数说明	是否需要选中	是否需要是所有者	需要的生物类型	权限	描述
/npc	无	是	是	无	无	显示选中的NPC的基础信息
/npc age	[adult, baby, integer, -l] - adult设置为成人, baby设置为小孩, integer指定一个确切的年龄, -l切换年龄是否被锁定	是	是	牛,羊,鸡, 猪,村民,豹猫,狼	citizens.npc.age	修改NPC的年龄
/npc anchor	anchor (--save [name], --assume [name], --remove [name]) (-a)(-c) - 保存一个地点为“锚”，使得能通过assumed[name]指令被假设(?)	是	是	无	citizens.npc.anchor	改变/保存NPC的地点锚或者显示其锚的列表
/npc behaviour	behaviour [scripts] (-r) -- scripts是一串由逗号分割的脚本名称，这些脚本定义在脚本文件里。-r标示用于将这些脚本从该NPC上移除。	是	是	无	citizens.npc.behaviour	添加和删除NPC的行为。一个行为是一个脚本文件，它在每个tick时都被执行并添加“目标”到NPC上。它可以实现你的任何设定和想法！
/npc controllable	无	是	是	无	citizens.npc.controllable.[NPC类型]	切换NPC的可控制状态。可控制的NPC可以通过右键点击来进行骑乘，并通过WASD键来控制。恶魂、烈焰人和末影龙在骑乘时可以通过左键单击来控制是否暂停飞行。
/npc copy	(--name NewName) -- NewName是你复制的NPC的新名称。	是	是	无	citizens.npc.copy	从你当前选中的NPC复制一个新的NPC，保留其全部的特性。
/npc create	[NPC Name] - 要创建的NPC的名字(--type [type]) - type为要创建的生物类型 --trait [trait1] [trait2] ... - 一个应用到NPC上的特性列表	是	是	无	citizens.npc.create.mobtype or citizens.npc.create.*	创建一个新的NPC. 举个栗子 : /npc create Jimbo Stevenson --type PIG （创建一个名字叫Jimbo Stevenson的猪= =!）
/npc despawn	(id) 需要删除实体的NPC的ID（如果没写的话就是当前选中的NPC）	是	是	否	citizens.npc.despawn	将一个NPC消灭（可以通过spawn命令重新召唤）
/npc gamemode	[gamemode] - 要使用的游戏模式	是	是	玩家	citizens.npc.gamemode	设置一个玩家NPC的游戏模式
/npc gravity	无	是	是	否	citizens.npc.gravity	切换NPC的重力
/npc equip	无	是	是	玩家，猪，羊，末影人	citizens.npc.edit.equip	切换装备编辑器。玩家为装甲，末影人为搬运的方块，羊为羊毛的颜色或者剪过羊毛的样子，猪为鞍。具体的查看装备编辑器(Equipment Editor)
/npc list	(-a) -所有的NPC (--owner (owner)) - 某个玩家拥有的NPC (--type (type)) - 某个类型的NPC (--char (character)) - 某个角色的NPC	否	否	无	citizens.npc.list	列出指定条件（至少选择一个）的NPC列表
/npc lookclose	无	是	是	无	citizens.npc.lookclose	切换当玩家靠近NPC时它是否会看向玩家
/npc moveto	--x [x] --y [y] --z [z] --world [world]	是	是	无	citizens.npc.moveto	NPC的当前位置由基础位置决定，这些参数用于修改这个基础位置
/npc mount	无	是	是	无	citizens.npc.mount	如果选中的NPC是可控制的，就骑乘它
/npc owner	(name) - 新所有者的名字,设置为"server"的话将设置Citizens管理员（拥有"citizens.admin"权限的玩家）为所有者	是	是	无	citizens.npc.owner	设置NPC的所有者
/npc path	无	是	是	无	citizens.npc.edit.path	切换路径编辑器。左键点击添加一个路径点，右键点击删除，鼠标滚轮或者数字键可以选择某个路径点。
/npc pathrange	[range] - NPC新的范围	是	是	无	citizens.npc.pathfindingrange	设置NPC可以在多大的范围内寻找路径（单位为方块）
/npc playerlist	无	是	是	玩家	citizens.npc.playerlist	切换一个NPC为一个“真实”的玩家，因此可以被其他插件所识别，并且能保持当前区块加载及农作物生长。
/npc pose	(-a) - 设置NPC的头朝向当前玩家的头所在的位置，可以用来设定NPC来看向特殊的位置。 ''(--save [name]\|--load [name]\|--remove [name)''	是	是	玩家	citizens.pose	根据玩家当前所在的位置更改或保存NPC头的方向。
/npc power	无	是	是	苦力怕	citizens.npc.power	切换苦力怕NPC是否带电
/npc profession	BLACKSMITH, LIBRARIAN, BUTCHER, FARMER, or PRIEST 分别对应铁匠、图书管理员、屠夫、农民、牧师	是	是	村民	citizens.npc.profession	改变村民NPC的职业
/npc remove	(all) - 将会移除全部的NPC（不写只会移除选中的NPC）	是	是	无	citizens.npc.remove, (citizens.admin.remove.all)	彻底删除一个NPC
/npc rename	[name] - 新的名字	是	是	无	citizens.npc.rename	重命名一个NPC
/npc select	[id] - NPC的ID	否	是	无	citizens.npc.select	选中指定的NPC
/npc size	[size] - 史莱姆的大小（整数）	是	是	史莱姆	citizens.npc.size	设置史莱姆NPC的大小
/npc skeletontype	[type]-0或者NORMAL为普通类型, 1或者WITHER为凋零骷髅	是	是	骷髅	citizens.npc.skeletontype	修改骷髅NPC的类型（目前只有普通和凋零）
/npc spawn	[id] - 你希望生成的NPC的ID	是	是	无	citizens.npc.spawn	生成一个已存在的NPC
/npc speed	[multiplier] - 倍数	是	是	无	citizens.npc.speed	成倍改变NPC的速度，例如：2为两倍于普通速度
/npc text	无	是	是	无	citizens.npc.edit.text	切换文本编辑器。要注意的是玩家必须要有 citizens.npc.talk的权限才能看到NPC的对话。
/npc tphere	无	是	是	无	Citizens.npc.tphere	传送选中的NPC到你所在的位置
/npc tp	无	是	是	无	citizens.npc.tp	传送到选中的NPC所在的位置
/npc type	[type] - 新的实体类型	是	是	无	citizens.npc.type	改变NPC的生物类型
/npc vulnerable	无	是	是	无	citizens.npc.vulnerable	切换NPC是否会受到伤害或死亡。或者当NPC在玩家列表时怪物是否会攻击他。
/npc zombiemod	(-b, -v) - -b为小孩僵尸, -v为僵尸村民	是	是	僵尸	citizens.npc.zombiemodifier	改变僵尸NPC的类型
/trait	[trait1] [trait2] ... [traitN] - 一个应用于NPC的特性列表	是	是	否	citizens.npc.trait.* 或者 citizens.npc.trait.<特性名称>	添加NPC的特性类型，NPC可拥有多个特性。如：/trait sentry （添加守卫特性）

路径点指令

命令	参数说明	权限	描述
/waypoints disableteleport	无	citizens.waypoints.disableteleport	停止当NPC被卡住时会自动传送到路径终点的功能(注: 在某些点可能会被移除(?)).
/waypoints provider	[provider name] (-a) - provider name为可用的provider（目前为:linear(直线), guided(导航) and wander（漫游）), 使用-a来获取所有provider的列表	citizens.waypoints.provider	当使用路径点编辑器时设置路径点provider

模板命令

编辑器

编辑器可以通过简单的方法对NPC进行进一步的编辑。很多情况下只用命令来实现一系列功能太过复杂，在所有的编辑器中，你可以一次性将所有相关的命令键入编辑器，然后退出编辑。你同一时间只能在一个编辑器里。

文本编辑器（指令: /npc text）

编辑NPC的文本很简单。可以按照游戏中的指示添加，编辑和删除NPC的文本。一个"random-talker"NPC意味着它会不断地从文本列表中随机抽取语句来说话。如果"random"是false的话，它会按文本列表顺序不断循环抽取语句。通过输入"close"设置close-talker可以切换当玩家接近NPC5个方块距离时，NPC是否说话。如果值为false，该NPC只会在设置了相应的点击行为时才会说话。如果值为true，则该NPC只会在玩家接近时才会说话。

需要注意的是玩家需要citizens.npc.talk权限才能听到的NPC的对话！

重要提示：在输入框中输入’exit’来关闭编辑器！

详见“文本语法”页面（稍后翻译）

路径点编辑器（指令：/npc path）

详见“路径点”页面（稍后翻译）

装备编辑器（指令：/npc equip）

“装备”是一些类似装甲、手上拿着的物品，以及NPC身上一些可见的特征。只有一部分类型的NPC可以编辑它们特有的“装备”。

一般的：随着1.4.5版本生物“装备”的更新，所有没有在这里列出的生物将默认使用人类的装备风格。需要注意的是装备可能无法在所有的生物上正确显示，特别是一些不支持它的生物。

人类 (标准NPC)：人类NPC可以修改自己的装甲和手持物品。你可以通过手持一个装甲右击一个NPC来将这个装甲给予它，这个装甲将会穿着在NPC身上，而之前在NPC上的物品或装甲将会被移除或掉在地上。你还可以通过按住潜行键右击NPC将你手上的装甲放置到NPC的手中。当你空手右击NPC时将会清空它身上的所有物品。

末影人：末影人NPC可以修改它们手中搬运的物品。末影人只能持有“方块” - 大多数的物品不会出现在客户端上。需要注意的是某些实体方块，如公告牌,蠹虫方块等等也不会出现在客户端上。空手点击末影人NPC将移除它手中的方块。

羊：羊NPC可以修改它们的毛色或者剪毛之后的样子。手拿着剪刀，像你平时剪羊毛那样右键它，可以设置该NPC为剪毛后的样子。拿着剪刀再次右键，则会恢复成剪毛前的样子。拿着染料点击NPC，可以修改它们的毛色。拿着任何一个不是染料的物品点击NPC，将会使它变回白色，并且染料会掉到地上。

猪：猪NPC可以添加和删除他们的马鞍。手拿马鞍右键NPC就可以添加马鞍，拿着其他任意东西点击则会移除它的马鞍。

兼容性

API（主要是用于制作插件的，我这里就不翻译了）

教程（这里都是视频，也不翻译了）

写在最后

首先感谢各位看官看完了之前的教程。这里放上的是Wiki上的使用帮助(Usage)部分，随后我会慢慢把Wiki的其他部分搬运过来，请继续关注。

角色

角色是使用Citizens API将功能添加到现有NPC上的复杂特性。要添加角色到您的服务器上，只需要点击进入角色各自的Wiki页面，找到下载链接，安装角色的jar文件到/plugins 或者/plugins/Citizens/plugins目录下。Citizens的NPC可以同时拥有多个特性，详见“多种特性”页面。

炼金术士

炼金术士是Citizens 2.0的一个角色特性，它赋予NPC以下的能力：

根据预先定义的配方制作药水。
收费提供服务。

下载地址：http://ci.citizensnpcs.co/view/Add-ons/job/Alchemist/

如何使用

基本信息

炼金术士提供创造药水配方的能力。你可以在配置文件中自定义这些配方。一个默认的配方已经提供给您做为参考。

请记住，没有方法可以使用这个插件来查看一个炼金术士当前配方的成分。这是故意这么设置的，因为你，做为服务器的管理员，应该可以完全自由地来决定如何显示配方，你可以使用告示牌、其他插件，或者根本不显示成分。

互动

手持适当的成分右键炼金术士将会把成分递给他，一旦配方的成分集齐了，炼金术士会将药水掉落在他周围。如果玩家走得太远，炼金术士会停止炼药，并且给予他的物品也会消失。

指令

在只用指令之前，您应该先选中一个NPC，并且是它的拥有者。这些指令不需要任何权限。

指令	描述
/alchemist help	显示帮助菜单
/alchemist recipe	显示这个炼金术士当前的配方（只是名称？）
/alchemist recipe [name]	设置这个炼金术士当前的配方

权限

要使用炼金术士，你只需要一个权限：alchemist.interact，用来允许玩家与炼金术士互动。

配置文件

你可以在以下位置找到炼金术士的配置文件：/plugins/Alchemist/config.yml，如果不存在的话将会自动创建一个。

默认的配置文件如下：

# Alchemist Configuration

recipes:

default: # 配方的名字

result: # 制作出药水的效果

effect: fire-resistance # 效果类型

duration: 60 # 持续时间

amplifier: 1 # 效果强度

splash: false # 是否是喷溅型

ingredients: # 需要的成分

'0': # 大概是序号

amount: 1 # 所需的数量

'1':

amount: 1

'2':

amount: 1

data: 6

messages: # 不同情况下炼金术士说的话

initialization-message: <e>Hello there, <player>. Give me what I need and I will brew you a potion!

success-message: <e>I have combined the ingredients to concoct a potion of <a><potion><e>.

cooldown-not-expired: You've already had your turn. Come back later!

cooldown-in-seconds: 60 # 炼药的冷却时间（秒）

可用的效果

speed - 加快移动速度。

slow - 减慢移动速度。

fast-digging - 加快挖掘速度。

slow-digging - 减慢挖掘速度。

increase-damage - 增加造成的伤害。

heal - 瞬间治疗。

harm - 瞬间伤害。

jump - 增加跳跃高度。

confusion - 反胃。

regeneration - 生命回复。

damage-resistance - 保护。

fire-resistance - 火焰保护。

water-breathing - 水下呼吸。

blindness - 致盲。

hunger - 饥饿。

weakness - 虚弱。

poision - 中毒。

铁匠
铁匠是Citizens 2.0的一个角色特性，可以赋予NPC以下能力：
§ 付费修理武器、工具和装甲
请注意，这个插件从2013年年中开始就没有更新过了，而且也不太可能有太大的更新（关于这一点我刚刚看了一下，发现在2014年9月份有更新过了），但是它应该能在现有版本中使用。
最新的源代码地址：https://github.com/jrbudda/blacksmith
下载地址：http://ci.citizensnpcs.co/view/Add-ons/job/Blacksmith/

更新日志
v1.3 8/5/2013
§ 修复了铁匠不会返回物品的问题。
v1.2 8/15/2012
§ 在每个物品的基础上增加了每个耐久度需要的价格。
§ 增加了在玩家询问价格时如果超时的时候，不会再制造物品（不明白啥意思）。
§ 修复了随机附魔的算法。
v1.1 8/8/2012
§ 兼容了Citizens 2的构建版本1.3.1。

如何使用

安装

安装Citizens 2
将Blacksmith.jar文件放进/plugins文件夹。
启动服务器。
创建NPC，然后给予它铁匠特性（trait）。

/npc create Smithy --trait blacksmith

或者

/npc create Smithy
/trait blacksmith

基础信息
铁匠可以为单个或全部的NPC进行多种的设置。在配置文件的"defaults"下面的设置是默认设置，它将会在一个铁匠被创建时赋予它。你可以通过下面指令部分列出的指令来重写这些设置（我找过了，根本没有这个章节，坑爹）。你甚至可以配置铁匠可以使用命令在游戏中制造哪些物品。默认情况下，一个铁匠能够制造所有的物品。

互动
与铁匠交互十分简单：
§ 手里拿着一个工具或者装甲右键这个NPC，它会告诉你制造它需要多少钱。
§ 再次右键按住10秒，铁匠就会开始制造这个物品。
§ 根据你的配置，制造一个东西的时候有几率附魔或者损坏。
（这里有点奇怪，没说清楚修理和制造的区别）

价格
价格是通过一个物品的损坏程度、附魔的种类和数量、以及在配置文件中设置的价格来决定的。一般说来，制造一个物品的价格 = 基础价格 + 回复的耐久度 + 附魔。

基础价格
制造一个物品的默认基础价格是定义在配置文件中的base-prices.default字段的值。要为每个单独的物品添加新的基础价格，你需要添加这个物品到配置文件的base-prices下。

耐久度
耐久度是一个物品损坏的情况。通常制造一个损坏度越高的物品就越便宜。如果你试图制造一个没有任何损坏的物品，那将会更加得昂贵。每一点耐久度需要的费用定义在配置文件的price-per-durability-point.default字段中。每个物品的价值可以通过添加进这个部分来设置。
下面是用于自定义基础价格和每一点耐久度需要的费用的物品的名称。

有效的物品：
wood-pickaxe       木镐
wood-spade          木铲
wood-hoe             木锄
wood-sword          木剑
wood-axe             木斧
stone-pickaxe       石镐
stone-spade          石铲
stone-hoe          石锄
stone-sword          石剑
stone-axe          石斧
gold-pickaxe       金镐
gold-spade          金铲
gold-hoe             金锄
gold-sword          金剑
gold-axe             金斧
iron-pickaxe       铁镐
iron-spade          铁铲
iron-hoe             铁锄
iron-sword          铁剑
iron-axe             铁斧
diamond-pickaxe    钻石镐
diamond-spade       钻石铲
diamond-hoe          钻石锄
diamond-axe          钻石斧
bow                弓
flint-and-steel    打火石
fishing-rod          钓鱼竿
shears             剪刀
leather-helmet       皮盔
leather-chestplate 皮甲
leather-leggings    皮护腿
leather-boots       皮靴
chainmail-helmet    锁链盔
chainmail-chestplate  锁链甲
chainmail-leggings 锁链护腿
chainmail-boots    锁链靴
gold-helmet          金盔
gold-chestplate    金甲
gold-leggings       金护腿
gold-boots          金靴
iron-helmet          铁盔
iron-chestplate    铁甲
iron-leggings       铁护腿
iron-boots          铁靴
diamond-helmet       钻石盔
diamond-chestplate 钻石甲
diamond-leggings    钻石护腿
diamond-boots       钻石靴

举个栗子：

base-prices:       # 这个是基础价格配置
  default: 10          # 默认所有的物品基础价是10
  diamond-sword: 45    # 钻石剑的基础价格自定义为45，其他物品以此类推
price-per-durability-point: # 这个是每点耐久的费用配置
  default: 1                      # 默认所有物品每点耐久的费用是1
  diamond-sword: 3                # 钻石剑的每点耐久自定义为3

附魔
制造一个附魔物品的价格比普通物品贵得多。对于每一个附魔来说，需要付出的总费用是基于"enchantment-modifier（附魔修改器）"和附魔等级的。附魔修改器可以通过在配置文件的enchantment-modifiers部分中添加附魔的名称和价格来配置。默认的修改器（enchantment-modifiers.default）会在附魔的名称没有找到时默认使用。
下面是在附魔修改器中有效的名称（区分大小写）：

·  arrow-damage - 力量
·  arrow-fire - 火矢
·  arrow-infinite - 无限
·  arrow-knockback - 冲击
·  damage-all - 锋利
·  damage-arthropods - 节肢杀手
·  damage-undead - 亡灵杀手
·  dig-speed - 效率
·  durability - 耐久
·  fire-aspect - 火焰攻击
·  knockback - 击退
·  loot-bonus-blocks -时运
·  loot-bonus-mobs - 掠夺
·  oxygen - 水下呼吸
·  protection-environmental - 保护
·  protection-explosions - 爆炸保护
·  protection-fall - 摔落保护
·  protection-fire - 火焰保护
·  protection-projectile - 弹射物保护
·  silk-touch - 精准采集
·  water-worker - 水下速掘

权限
如果你希望让玩家使用铁匠，需要给他们blacksmith.reforge permission权限。

配置文件
铁匠的配置文件的路径如下：/plugins/Blacksmith/config.yml。如果不存在的话会自动生成一个。

默认配置
铁匠的配置文件（config.yml）包含了为新创建的铁匠准备的默认设置。已经存在的铁匠的所有这些选项都可以通过Citizens/saves.yml文件来修改。所有默认配置下的设置都可以通过Citizens 2的存档文件（saves.yml）来重写修改每一个单独的铁匠设置。
完整的默认配置如下：

# Blacksmith Configuration
base-prices:             # 基础价格配置
default: 10
price-per-durability-point: # 每点耐久费用配置
default: 1
defaults: # 以下为新创建的铁匠的默认设置，大多数可以为每个单独的NPC修改
messages:    # 与铁匠交互时铁匠说的话
busy-with-player: <c>I'm busy at the moment. Come back later! # 正忙
busy-with-reforge: <c>I'm working on it. Be patient!  # 正在帮你制造物品
cooldown-not-expired: <c>You've already had your chance! Give me a break! # 休息中（冷却中）
cost: <e>It will cost <a><price> <e>to reforge that <a><item><e>! Click again to reforge!    # 玩家要制造东西前的确认信息（再次点击就表示确认制造）
fail-reforge: <c>Whoops! Didn't mean to do that! Maybe next time? # 制造失败
insufficient-funds: <c>You don't have enough money to reforge that item! # 金钱不足
invalid-item: <c>I'm sorry, but I don't know how to reforge that! # 无效物品
start-reforge: <e>Ok, let's see what I can do... # 开始制造
successful-reforge: <a>There you go! All better! # 制造成功
drop-item: true # 是否将物品丢在地上而不是直接给玩家
percent-chance-to-fail-reforge: 10 # 失败的概率（百分比）
percent-chance-for-extra-enchantments: 5 # 制造出额外附魔的概率（百分比）
maximum-enchantments: 3    # 最大的附魔种类
delays-in-seconds:    # 设置时间
maximum: 30             # 制造一个物品的最长时间
minimum: 5             # 制造一个物品的最短时间
reforge-cooldown: 60    # 再次制造物品前的休息时间（冷却时间）
enchantment-modifiers: # 附魔修改器（就是设置附魔时需要的钱吧）
default: 5                # 默认一个附魔的价格是5（可以单独配置）

建造者
建造者是Citizens 2.0的一个角色特性，能赋予NPC以下能力：
一个个方块地建造MCEdit或Worldedit的图纸（schematics文件）。
修复一个区域，将一切被改变的东西回复回来。
在建造之前会从玩家那里收集需要的材料。
下载地址：http://ci.citizensnpcs.co/job/Builder/

更新日志（超级多，懒得翻译了，反正也没人看。。）

安装

安装Citizens 2。
将Builder.jar文件放进/plugins文件夹。
将.schematic文件放进/plugins/Builder/schematics文件夹。
启动服务器。
创建NPC并且给予它建造者特性（Builder trait）。

/npc create Bob --trait builder

或者

/npc create Bob
/trait builder

权限
builder.* 给予全部Builder权限
builder.[command] 给予[command]指令的权限。
builder.donate 允许玩家捐助一个在供应模式（Supply Mode）下的建造者 (对于锁定了创造模式的玩家来说很有用)。

配置文件
当您第一次加载建造者插件时，/Builder/config.yml文件会被自动创建（每次加载时，如果该文件不存在时也会自动创建）。此文件可以用于调整创造者的全局设置。当你改变了这个文件后可以输入/builder reload指令来重新加载它。
在安装新版本的建造者插件时，如果配置文件已经存在，将不会再创建一个新的。所以请多关注建造者插件的Wiki页面来获知更多被添加和修改的选项。（意思就是当你从旧版本升级到新版本时，要注意配置文件选项的变化）

#Builder configuration
#存放schematics文件的目录
SchematicsFolder: plugins/Builder/schematics/
#供应模式下是否需要不能获取的方块或者他们的掉落物
RequireUnobtainableBlocks: false
#对于地块标记（plot marking）中允许的材料，默认选择列表中的第一个。
  #使用编号或名称。应该只使用基本块，而不是一些在放置时会被破坏的东西（如火把）。
MarkMaterials:
- GLASS
- GLOWSTONE
- BEDROCK
#自定义建造者插件发送的信息，可以使用<NPC>、<SCHEMATIC>、<AMOUNT>、<PLAYER>与<ITEM>这些占位符。
DefaultTexts:
BuildStarted: "&a<NPC> has started to build &f<SCHEMATIC>!"
BuildComplete: "&a<NPC> has completed build of &f<SCHEMATIC>!"
BuildCanceled: "&c<NPC>'s build of &f<SCHEMATIC>&c has been canceled!"
BuildCollecting: "&6<NPC> needs &f<AMOUNT> &6more blocks to start building &f<SCHEMATIC>."
Mark: "&a<NPC> is marking the corners of &f<SCHEMATIC>"
Survey: "&a<NPC> needs these materials to build &f<SCHEMATIC> &aat this location."
Supply_List: "&f<NPC> says: &6I still need the following items to build &f<SCHEMATIC>, &6<PLAYER>:"
Supply_Need_Item: "&f<NPC> says: &aI still need &f<AMOUNT> <ITEM> &afor &f<SCHEMATIC>&9. Right-click again to donate."
Supply_Dont_Need_Item: "&f<NPC> says: &6I don't need any &f<ITEM>&6. Thanks anyway."
Supply_Item_Taken: "&f<NPC> says: &aThanks for the &f<AMOUNT> <ITEM>, <PLAYER>!"
DefaultOptions: # 这一部分没有说明，我只能靠猜的，等测试过之后再修改
MoveTimeoutSeconds: 2.0  # 这里不知道什么意思
IgnoreProtection: false # 是否忽略保护，是指领地吗？这里有备注说不能使用。
HoldItems: true        # 是否显示手里拿着的物品？
RequireMaterials: false   # 可能是建造之前是否需要准备好材料（生存和创造的区别？）。

指令
以下所有的指令可以在选中一个NPC时（/npc select [NPC的ID]）直接执行（/builder [指令]），或者通过/builder [NPC的ID] [指令] 来对指定的某个NPC执行。
/builder list - 列出在配置的schematics文件夹下所有可用的.schematic文件。此命令不需要选中NPC。
/builder load [schematic] - 加载一个.schematic文件。只要简单地使用schematic文件的名称即可。例如：

/builder load house

/builder origin - 设置建造者工程的原点为建造者当前所在的位置。允许你在相同的点重建。如果没有设置的话建造者将总是从当前所在的位置开始建造。
/builder origin clear - 清除已保存的建造原点。
/builder origin schematic - 设置建造者工程的原点为当前加载的schematic文件的原点。最适用于从建造者的世界中使用WorldEdit创建的schematics。（不是很明白，需测试）
/builder origin me - 设置建造者工程的原点为玩家所在的位置。该命令无法从控制台输入。
/builder origin current - 设置建造者工程的原点为当前正在建设的工程的原点。用于在开始建造之前你忘记设置原点，又需要取消工程稍后重建的。（需测试才好理解）
/builder origin x,y,z - 设置建造者工程的原点为建造者当前所在的世界的x,y,z坐标。
/builder mark (item)- 在工程的覆盖区域的四个角各放置一个方块，然后回到原点，这样你就可以知道将会建造在什么位置上。你可以指定使用一个定义在config.yml中的物品（大概是指MarkMaterials）。如果没有指定物品的话，将使用config.yml中定义的第一个物品。如果config.yml中没有定义的话将使用玻璃。
/builder timeout [value] - 设置在方块中的最大时间（秒）。有效值在0.1 - 2000000.0之间。默认是2.0。默认值可以在config.yml中修改（就是那个不明白什么意思的MoveTimeoutSeconds吧）。
/builder build (option1) (option2) ... etc - 开始根据schematic文件建造。这个指令有几个可选的参数。没有顺序要求。你可以添加如下参数：
·  linear - 从北向南建造。
·  reverselinear - 从南向北建造。
·  sprial - 由内向外建造（这是默认选项所以不用特别指定）。
·  reversespiral - 由外向内建造。
·  excavate - 建造者在开始建造之前会先把这个区域的方块清理掉。
·  layers:# - 建造者一次会建造#层，这个值默认是1。
·  yoffset:# - y坐标上的偏移量（就是在原来的位置向上或向下移#格）。
·  groupall - 建造者将会一次性将一组材料建造完成，而不是一层一层地建。
·  ignoreair - 建造者将不会放置空气方块。（用于在现有的结构中建造，如果和excavate模式一起将会没有意义）
·  ignoreliquid - 建造者将不会放置岩浆或水方块。（用于在这个图纸（schematic）的底部有流动的水）
·  onstart:Task - 建造者将会在开始建造之前（收集材料之后）执行居民的任务脚本，详见“进阶用法页面”（Advanced Usage）。
·  oncomplete:Task - 建造者将会在建造结束之后执行居民的任务脚本，详见“进阶用法页面”（Advanced Usage）。
·  oncancel:Task - 建造者将会在取消建造的时候执行居民的任务脚本，详见“进阶用法页面”（Advanced Usage）。
·  silent - 建造者将不会发送完成或者错误的消息。
以下是例子：

/builder build
/builder build excavate reverselinear yoffset:-3
/builder build ignoreair ignoreliquid oncomplete:Celebrate
/builder build groupall layers:3

/builder cancel - 取消当前的建造工作。
/builder info - 查看一个建造者已加载的schematic的名称和大小，同时查看建造者的选项（option）和状态。
/builder survey (excavate) - 显示在当前位置上建造需要的方块类型和数量。加上excavate参数的话显示如果使用excavate模式需要的材料。不会显示水和岩浆。
/builder supply true|false 设置建造者在开始建造之前是否需要给予材料详见“供给模式”（Supply Mode）。
/builder hold true|false 设置建造者在放置时手上是否要拿着对应的方块。（设置为false只有在需要兼容别的插件的情况下，如哨兵插件）
/builder reload - 重新加载config.yml里的选项。
/builder help - 显示帮助。

使用方法
·  .schematic文件应该被放入/plugins/Builder/schematics/文件夹。这个文件夹可以在config.yml里配置。
·  在你执行build指令之前，放置好建造者的位置，或者设置好它的原点，最好位于你要建造的覆盖面的中心。图纸（schematic）的大小在加载时会显示。
·  当你设置了原点之后，你可以取消一个建造过程并在之后可以继续它。如果你忘记设置原点，可以在建造开始之后使用/builder origin current指令来设置它。
·  不要试图恢复一个使用了excavate参数的建造过程！（估计会把之前造的都清空了）
·  建造者将会忽略图纸（schematic）下方的任何空的空间，所以它总是会停留在开始时的地面上。如果你希望建造在原点上面或者下面的话，在执行build指令时使用yoffset:参数。
·  建造者不会视图去替换一个摆放正确的方块，这意味着你可以使用建造者快速地“恢复”一个它之前建造过的东西。
要让一个建造者来维护一个现有的建筑可以按照以下步骤：
使用Worldedit来选择一个建筑物然后将它保存成schematic文件。
将该schematic文件复制到建造者的schematics文件夹。
将这个schematic加载到一个建造者上然后执行/builder origin schematic指令。
执行/builder build指令，建造者将会放置所有缺失的方块或者摧毁新放置的方块。
·  铁轨和发射器可能无法被正确放置。（嘿，这是个建筑物，而不是一个工程）
·  默认情况下，NPC会在他们所在的区块unload时despawn。这个行为可以在Citizens2的config.yml文件中修改。如果你希望建造者在无人看管的情况下继续建造的话推荐你这么做。

供应模式（Supply Mode）

如果建造者被设置为需要材料进行建设（/builder supply true），那么当/builder build指令被执行的时候，它将会使用供应模式。当供应模式启动的时候，建造者会调查并列出需要的材料清单。玩家必须提供这些材料建造者才会开始建造。

在供应模式中：

空手右键建造者可以查看还需要哪些材料。

手持任意方块或者物品右键建造者可以知道它是否需要。如果需要，它会告诉你还需要多少个。

当手持所需材料点击过建造者之后，再次按住右键几秒可以把材料递给它。

在收到材料后建造者会说它总共还需要多少方块才能开始建造，如果材料已经收集全了他将会开始建造。

需要什么材料：

默认情况下所有的方块都需要它们的普通掉落形态（比如蜘蛛网需要的是线）。

这个行为可以通过\Builder文件夹里的'supply.txt'文件来覆盖。

每一行包含在schematic中定义的物品ID和实际需要的物品ID。

您还可以指定每一个所需的建筑方块需要的物品数量。

设置需要的物品ID为0的话，这个建筑方块就不会出现在需要的材料列表里了。

（简单总结一下就是说你可以自定义盖房子的某个材料要由哪些物品组成，并且需要多少，比如你可以设置要建造者放置一个蜘蛛网，你必须给它2个线这样的规则）

默认的供应模式配置

建筑方块ID:需要的物品ID:需要的物品数量(可选)

设置需要的物品ID为0的话将永远不需要准备这个材料。方块没有指定的话将默认需要他们的普通掉落物。

90:0

97:0

95:54

78:0

34:0

119:0

80:80

92:354

43:44:2

125:126:2

20:20

102:102

47:47

103:362

130:130

134:53

135:53

136:53

128:67

109:67

108:67

79:332

51:0

59:295

72:70

71:330:0.5

26:335:0.5

所有的方块目前只与物品ID匹配。这意味着：

所有的羊毛都是羊毛，建造列表中会忽略颜色，并且所有颜色的羊毛都可以当作羊毛给建造者。
树苗、半砖、原木以及木板也和羊毛一样。
楼梯也是同样。所有的木楼梯都被计算为“橡木”。所有的石头/砖头楼梯都计算为“石头”,除了地狱转楼梯。
如果建造过程中途取消，那么所有已收集的材料将丢失。

进阶用法
建造者可以在建造过程的开始时、完成时或者取消时执行居民任务脚本。
该NPC必须同时具有建造者及居民特性。
在执行/builder build指令时带上以下选项。
onstart:任务名称
oncomplete:任务名称
oncancel:任务名称
举个栗子：

/builder build oncomplete:DespawnTask oncancel:AnnounceTask

建造者同样可以运行居民的行动（Actions）事件（居民部分还没有看，看完之后再修正翻译）。添加以下文字到该NPC的actions中：
"Build Start"
"Build Complete"
"Build Cancel"
举个栗子：

BuilderAssignment:
  type: assignment
  actions:
on Build Start:
   - ANNOUNCE "Let's do this!"
on Build Complete:
   - ANNOUNCE "I have finished!"

以下是居民与建造者联合的一些例子（其实只有一个）。
继续重建
如果你希望让一个建造者看起来很忙碌，按照图纸不断地重建与破坏，你可以像下面这样设置。
在居民的脚本文件夹里用任意一个yml文件创建如下的一个任务脚本。

---- script.yml ----
Rebuild:
Type: Task
Script:
- execute as_npc "builder <npc.id> build excavate oncomplete:Rebuild"

现在创建一个建造者，加载一个你想要的schematic文件，设置一个原点，然后执行如下指令：/builder build oncomplete:Rebuild。
这个建造者将会建造这个schematic文件，然后执行这个任务，又继续重新建造，在excavate这个的选项下，它将会先把造好的建筑拆掉，这样就会永远循环下去。
你可以使用这个脚本来创建尽可能多的建造者和图纸，但是不会改变任何东西。

FAQ
Q: 如何能让多个建造者一起建造一个东西？
A: 你通过给最多4个建造者同样的schematic和原点，但是不同的建造模板来让他们共同建造（不太清楚建造模板是什么）。你同样可以用WorldEdit或者MCEdit将schematic文件手工分割成多个部分。
Q: 怎样才能让建造者盖得快一些？
A: 使用/builder timeout指令来设置他在方块间的最大时间。你同样可以使用"/npc speed"指令来让它走得快一点。