查看“Citizens/角色/铁匠”的源代码

{{Trait
| PICTURE      = Blacksmith.png
| AUTHOR      = aPunch
| NAME         = Blacksmith
| VERSION    = ???
| CITIZENSBUILD  = 2.0.x
| DEVSTATUS    = InDev
| DEPENDS = 以Vault为前置的经济系统
| DOWNLOADLINK  = http://ci.citizensnpcs.co/view/Add-ons/job/Blacksmith/
| DESCRIPTION  = 高度自定义装备锻造
}}

Blacksmith 是 Citizens 2.0 的一个角色特性，可以给予NPC以下能力:
*付费修复武器、工具和装备.

最新插件源码在这里: https://github.com/mcmonkey4eva/Blacksmith

==更新记录==
v1.13 10/12/2018
* HurricanKai已失联, 所以 mcmonkey 更新了这款插件, 你可以在这里看到新版本： https://github.com/mcmonkey4eva/Blacksmith

??? ?/?/2017
* 现在这款插件由 HurricanKai维护, 兼容1.12. 请查看 github 日志. https://github.com/HurricanKai/Blacksmith

??? 2/17/2015
* 更新到最新内容.

v1.3 8/5/2013
* 修复铁匠不归还物品的漏洞.

v1.2 8/15/2012
*添加每点耐久所需价格选项.
*添加如果玩家询问价格而不锻造物品的过期时间.
*修复随机附魔算法。

v1.1 8/8/2012
*兼容 1.3.1的Citizens2版本

==如何使用==
==安装==
# 安装Citizens 2
# 将Blacksmith.jar文件放进/plugins文件夹。
# 启动服务器。
# 创建NPC，然后给予它铁匠特性。
输入
 /npc create Smithy --trait blacksmith 
或
 /npc create Smithy
 /trait blacksmith 

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

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

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

===基础价格===
再次锻造所需的基础价格在配置内的数值为 ''base-prices.default''.想要给每个物品添加新的基础价格，请在配置内''base-prices''下面修改.

===耐久度===
耐久度就是物品损耗的程度.一般来说，程度越深，再次锻造所需的价格也就越便宜. 重新锻造没有损坏的物品将会特别昂贵. 价格可在配置内设置 ''price-per-durability-point.default''. 每个物品的价值也可在这里单独设置.

以下物品可用于自定义基础价格和锻造价格.

<div class="toccolours mw-collapsible mw-collapsed" style="width:250px">
'''有效物品'''
<div class="mw-collapsible-content">
wood-pickaxe 木镐
<br>wood-spade 木铲
<br>wood-hoe 木锄
<br>wood-sword 木剑
<br>wood-axe 木斧
<br>stone-pickaxe 石镐
<br>stone-spade 石铲
<br>stone-hoe 石锄
<br>stone-sword 石剑
<br>stone-axe 石斧
<br>gold-pickaxe 金镐
<br>gold-spade 金铲
<br>gold-hoe 金锄
<br>gold-sword 金剑
<br>gold-axe 金斧
<br>iron-pickaxe 铁镐
<br>iron-spade 铁铲
<br>iron-hoe 铁锄
<br>iron-sword 铁剑
<br>iron-axe 铁斧
<br>diamond-pickaxe 钻石镐
<br>diamond-spade 钻石铲
<br>diamond-hoe 钻石锄
<br>diamond-axe 钻石斧
<br>bow 弓
<br>flint-and-steel 打火石
<br>fishing-rod 钓鱼竿
<br>shears 剪刀
<br>leather-helmet 皮革帽子
<br>leather-chestplate  皮革胸甲
<br>leather-leggings 皮革护腿
<br>leather-boots 皮革鞋子
<br>chainmail-helmet 锁链头盔
<br>chainmail-chestplate 锁链胸甲
<br>chainmail-leggings 锁链护腿
<br>chainmail-boots 锁链鞋子
<br>gold-helmet 金头盔
<br>gold-chestplate 金胸甲
<br>gold-leggings 金护腿
<br>gold-boots 金鞋子
<br>iron-helmet 铁头盔
<br>iron-chestplate 铁胸甲
<br>iron-leggings 铁护腿
<br>iron-boots 铁鞋
<br>diamond-helmet 钻石头盔
<br>diamond-chestplate 钻石胸甲
<br>diamond-leggings 钻石护腿
diamond-boots 钻石鞋子</div></div>

示例:
<pre>
base-prices:
  default: 10
  diamond-sword: 45
price-per-durability-point:
  default: 1
  diamond-sword: 3
</pre>

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

* ·  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''
===默认配置===
这些选项可以在Citizens/saves.yml 内的铁匠配置更改.
悬浮到每条消息上查看详细信息. 所有 ''defaults''下面的配置都可被Citizens 2 saves.yml 覆盖.
 <nowiki></nowiki># Blacksmith铁匠配置
 <nowiki></nowiki>{{H:title|方块基础价格|base-prices:}}
  {{H:title|基础价格.未设置物品基础价格时使用.|default: 10}}
 <nowiki></nowiki>{{H:title|price-per-durability-point block|price-per-durability-point:}}
  {{H:title|Default price-per-durability-point. This will be used if per-item price-per-durability-point is not specified.|default: 1}}
 <nowiki></nowiki>{{H:title|Default settings block, most can be changed per-NPC|defaults:}}
  {{H:title|Messages block. All messages that are sent to the player involving the blacksmith|messages:}}
    {{H:title|铁匠工作时发送给玩家的消息|busy-with-player: <c>我现在很忙. 待会再来!}}
    {{H:title|Message sent to the player who gave the blacksmith the item it is working on|busy-with-reforge: <c>我正在锻造呢!}}
    {{H:title|Message sent to the player during the cool down period|cooldown-not-expired: <c>你刚才已经锻造过了! 让我休息会儿!}}
    {{H:title|Message sent to the player to confirm they want to reforge the item|cost: <nowiki><e>需消耗 <a><price> <e>才能锻造 <a><item><e></nowiki>! 点击锻造!}}
    {{H:title|Message sent to the player when the reforge fails|fail-reforge: <nowiki><c></nowiki> 你的装备锻造失败! 再来一次吧?}}
    {{H:title|Message sent to the player when they don't have enough money to complete the reforge|insufficient-funds: <nowiki><c></nowiki>你没有足够的钱来修复这件物品!}}
    {{H:title|Message sent to the player when they try to reforge an invalid item|invalid-item: <nowiki><c></nowiki>抱歉,我不知道怎么锻造这个东西!}}
    {{H:title|Message sent to the player when the reforge starts|start-reforge: <nowiki><e></nowiki>好吧, 让我看看我能为你做什么...}}
    {{H:title|Message sent to the player when the reforge is successful|successful-reforge: <nowiki><a></nowiki>拿好你的装备! 祝你一路顺风!}}
  {{H:title|Drops the reforged item on the ground instead of giving it to the player|drop-item: true}}
  {{H:title|锻造失败率|percent-chance-to-fail-reforge: 10}}
  {{H:title|添加额外附魔的几率|percent-chance-for-extra-enchantments: 5}}
  {{H:title|物品可拥有的附魔上限|maximum-enchantments: 3}}
  {{H:title|锻造冷却.|delays-in-seconds:}}
    {{H:title|锻造物品所需最大时间|maximum: 30}}
    {{H:title|锻造物品所需最小时间|minimum: 5}}
    {{H:title|再次锻造所需时间|reforge-cooldown: 60}}
 <nowiki></nowiki>{{H:title|Enchantment modifiers block|enchantment-modifiers:}}
  {{H:title|默认附魔调节器.|default: 5}}

[[Category:Characters]]

{{NavBox}}