目录

角色

（翻译：kjiang MycroftCooper 版本2018-06-19 原文链接）

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

多功能的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邮递员mcfacilitatorNPC作为邮递员的邮件系统.
MoxieNPCMoxieNPCx3nec设置MoxieSkills的技能商店NPC
HyperMerchant商人Shmancelot让NPC成为商人并可以打开HyperConomy的商店菜单.

炼金术士 Alchemist

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

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

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

交互

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

指令

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

铁匠 blacksmith

创建

输入 /npc create Smithy –trait blacksmith

或

/npc create Smithy

/trait blacksmith

介绍

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

交互

与铁匠交互很简单:

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

价格

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

基础价格

重造的默认基价是配置文件中的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 钻石胸甲

示例: 

  1. base-prices:                    # 基础价格
  2.   default: 10                   # 默认 10
  3.   diamond-sword: 45             # 钻石剑45
  4. price-per-durability-point:     # 每个损坏度的价格
  5.   default: 1                    # 默认 1
  6.   diamond-sword: 3              # 钻石剑 3

附魔

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

对于每一个附魔来说，需要付出的总费用基于“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中的单个铁匠可以覆盖默认设置下的所有设置。 

  1. # Blacksmith Configuration
  2. base-prices:
  3.  default: 10
  4. price-per-durability-point:
  5.  default: 1
  6. defaults:
  7.  messages:
  8.    busy-with-player: <c>I'm busy at the moment. Come back later!
  9.    busy-with-reforge: <c>I'm working on it. Be patient!
  10.    cooldown-not-expired: <c>You've already had your chance! Give me a break!
  11.    cost: <e>It will cost <a><price> <e>to reforge that <a><item><e>! Click again to reforge!
  12.    fail-reforge: <c>Whoops! Didn't mean to do that! Maybe next time?
  13.    insufficient-funds: <c>You don't have enough money to reforge that item!
  14.    invalid-item: <c>I'm sorry, but I don't know how to reforge that!
  15.    start-reforge: <e>Ok, let's see what I can do...
  16.    successful-reforge: <a>There you go! All better!
  17.  drop-item: true
  18.  percent-chance-to-fail-reforge: 10
  19.  percent-chance-for-extra-enchantments: 5
  20.  maximum-enchantments: 3
  21.  delays-in-seconds:
  22.    maximum: 30
  23.    minimum: 5
  24.    reforge-cooldown: 60
  25. enchantment-modifiers:
  26.  default: 5

未完待续……