====== 角色 ======
（翻译：kjiang MycroftCooper 版本2018-06-19 [[https://wiki.citizensnpcs.co/Characters|原文链接]]）

（为便于理解，本文档和原始英文文档有所出入）

多功能的NPC角色可以通过加装各种不同的插件实现，这些插件通过Citizens API可以为已存在的NPC添加各种不同的特性。如果你也想为你的NPC增加各种不同的角色，只需要按照相应插件的说明，把插件安装到''pluigns/''或''plugins/Citizens/plugins''文件夹即可。

同一个NPC可以同时具有多个角色。

===== 角色列表 =====

^ 名称 ^ 简介 ^ 插件作者 ^  描述  ^
|Alchemist|炼金术士|aPunch|自定义药水配方|
|Blacksmith|铁匠|aPunch|自定义装备|
|Builder|建筑者|jrbudda|根据schematics来一格一格地建筑.|
|Denizen|居民|mcmonkey|支持编辑NPC的高级脚本引擎.|
|DtlTraders|交♂易者|dandielo|另一款贸易商插件.|
|Quests|任务|Various|可以让NPC接受任务.|
|Sentinel|哨兵|mcmonkey|自定义NPC战斗.|
|Postal|邮递员|mcfacilitator|NPC作为邮递员的邮件系统.|
|MoxieNPC|MoxieNPC|x3nec|设置MoxieSkills的技能商店NPC|
|HyperMerchant|商人|Shmancelot|让NPC成为商人并可以打开HyperConomy的商店菜单.|

===== 炼金术士 Alchemist =====

炼金术士可以用来收费替玩家基于预设的配方炼制药水.

你可以在配置内自定义炼金配方. 
默认的配方即为示例.

记住,目前没有办法用这个插件查看炼金术士的炼金配方. 这一设计是故意的, 你如果是服务器管理员,你可以决定如何呈现出这些配方. 你可以用告示牌或其他插件来展示.

==== 交互 ====

带着正确的炼金材料右键炼金术士就可以把材料给炼金术士并开始炼金.
炼金完成后,炼金术士会在附近掉落药水.
如果玩家离得太远的话,炼金术士会停止炼药并且炼金材料会被炼金术士私吞.

==== 指令 ====

想要使用炼金术士指令，你需要先选择一个NPC且你是该NPC的主人. 这些指令没有权限节点.

===== 铁匠 blacksmith =====

==== 创建 ====

输入
''/npc create Smithy --trait blacksmith ''

或

''/npc create Smithy''

''/trait blacksmith ''

==== 介绍 ====

铁匠拥有多种设置，配置文件内"default"设置为默认配置。它将会在一个铁匠被创建时被应用。 你可以通过下面指令部分列出的指令来修改这些设置. 你甚至可以使用命令配置铁匠可以在游戏中锻造哪些物品。默认情况下，铁匠可以锻造所有的物品。

==== 交互 ====

与铁匠交互很简单: 
  - 手里拿着一个工具或者装备右键这个NPC，它会告诉你锻造需要多少钱。 
  - 在10秒内再次右键铁匠，他就会开始锻造这个物品。
  - 根据配置，锻造一件物品有几率会获得附魔或者损坏。

==== 价格 ====

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

==== 基础价格 ====

重造的默认基价是配置文件中的base prices.default值。
要为每个单个装备添加新的基本价格，请将该装备添加到基本价格下的配置文件中。

==== 耐久度 ====

一般来说，物品损坏越多，重造的成本就越低。
尝试在没有损坏的情况下重造一个装备将是非常昂贵的。
每个耐久度点有各自的价格，配置中的默认值。
可以自定义各个耐久度的价格。

这些是用于自定义基础和每个耐久度点价格的装备名称。
^  Valid Items  ^^^
|wood-pickaxe 木镐|wood-spade 木铲|wood-hoe 木锄|
|wood-sword 木剑|wood-axe 木斧|stone-pickaxe 石镐|
|stone-sword 石剑|stone-axe 石斧|gold-pickaxe 金镐|
|gold-sword 金剑|gold-axe 金斧|iron-pickaxe 铁镐|
|iron-sword 铁剑|iron-axe 铁斧|diamond-pickaxe 钻石镐|
|diamond-axe 钻石斧|bow 弓|flint-and-steel 燧石|
|leather-helmet 皮革帽子|leather-chestplate 皮革胸甲|leather-leggings 皮革护腿|
|chainmail-chestplate 锁链胸甲|chainmail-leggings 锁链护腿|chainmail-boots 锁链鞋子|
|gold-leggings 金护腿|gold-boots 金鞋子|iron-helmet 铁头盔|
|iron-boots 铁鞋|diamond-helmet 钻石头盔|diamond-chestplate 钻石胸甲|

示例:
<code yaml [enable_line_numbers="true"]>
base-prices:                    # 基础价格
  default: 10                   # 默认 10
  diamond-sword: 45             # 钻石剑45
price-per-durability-point:     # 每个损坏度的价格
  default: 1                    # 默认 1
  diamond-sword: 3              # 钻石剑 3
</code>

==== 附魔 ====

锻造一个附魔物品的价格比普通物品贵得多。

对于每一个附魔来说，需要付出的总费用基于"enchantment-modifier（附魔调节器）"和附魔等级。
附魔调节器可以通过在配置文件的enchantment-modifiers部分中添加附魔的名称和价格来配置。

默认的附魔调节器会在附魔的名称没有找到时默认使用。

下面是在附魔修改器中有效的名称（区分大小写）：
|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 权限.

==== 配置 ====

铁匠的配置文件在 /plugins/Blacksmith/config.yml

=== 默认配置 ===

blacksmith config.yml包含新铁匠的默认设置。所有这些选项都可以在citizes/saves.yml的现有铁匠身上更改。

鼠标悬停在每个部分以查看其说明。(译注：暂时没有用，停再久也不会有说明的)
Citizens 2 saves.yml中的单个铁匠可以覆盖默认设置下的所有设置。
<code yaml [enable_line_numbers="true"]>
# Blacksmith Configuration
base-prices:
 default: 10
price-per-durability-point:
 default: 1
defaults:
 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
</code>


----
未完待续……