查看“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
*Compatible with 1.3.1 builds of C2

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

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

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

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

===基础价格===
The default base price for a reforge is the ''base-prices.default'' value in the configuration file. To add new base prices for each individual item, add the item to the config file under ''base-prices''

===耐久度===
Durability is the amount of damage that an item has taken. Generally, the more damaged an item is, the cheaper it will be to reforge. Trying to reforge an item with no damage will be significantly more expensive. The price per durability point is ''price-per-durability-point.default'' in the configuration. Per-item values may be set by adding to this section.

These are the items names to use with custom base and per-durability-point prices.

<div class="toccolours mw-collapsible mw-collapsed" style="width:150px">
'''Valid Items'''
<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''
===默认配置===
The blacksmith config.yml contains the default settings for '''new''' blacksmiths. All of these options can be changed on existing blacksmiths in the Citizens/saves.yml.
Mouseover each section to view it's description. All settings under ''defaults'' can be overriden by individual blacksmiths in the Citizens 2 saves.yml.
 <nowiki></nowiki># Blacksmith Configuration
 <nowiki></nowiki>{{H:title|Base-prices block|base-prices:}}
  {{H:title|Default base price. This will be used if per-item base prices are not specified.|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|Message sent to the player(s) when the blacksmith is already working on something|busy-with-player: <c>I'm busy at the moment. Come back later!}}
    {{H:title|Message sent to the player who gave the blacksmith the item it is working on|busy-with-reforge: <c>I'm working on it. Be patient!}}
    {{H:title|Message sent to the player during the cool down period|cooldown-not-expired: <c>You've already had your chance! Give me a break!}}
    {{H:title|Message sent to the player to confirm they want to reforge the item|cost: <nowiki><e>It will cost <a><price> <e>to reforge that <a><item><e></nowiki>! Click again to reforge!}}
    {{H:title|Message sent to the player when the reforge fails|fail-reforge: <nowiki><c></nowiki>Whoops! Didn't mean to do that! Maybe next time?}}
    {{H:title|Message sent to the player when they don't have enough money to complete the reforge|insufficient-funds: <nowiki><c></nowiki>You don't have enough money to reforge that item!}}
    {{H:title|Message sent to the player when they try to reforge an invalid item|invalid-item: <nowiki><c></nowiki>I'm sorry, but I don't know how to reforge that!}}
    {{H:title|Message sent to the player when the reforge starts|start-reforge: <nowiki><e></nowiki>Ok, let's see what I can do...}}
    {{H:title|Message sent to the player when the reforge is successful|successful-reforge: <nowiki><a></nowiki>There you go! All better!}}
  {{H:title|Drops the reforged item on the ground instead of giving it to the player|drop-item: true}}
  {{H:title|The percent chance of the reforge failing|percent-chance-to-fail-reforge: 10}}
  {{H:title|The percent chance of the reforge adding extra enchantments|percent-chance-for-extra-enchantments: 5}}
  {{H:title|Maximum amount of enchantments that an item can have|maximum-enchantments: 3}}
  {{H:title|Delays block. Determines delays for blacksmith usage|delays-in-seconds:}}
    {{H:title|Maximum time it will take to reforge an item|maximum: 30}}
    {{H:title|Minimum time it will take to reforge an item|minimum: 5}}
    {{H:title|Time the player has to wait after reforging something before trying again|reforge-cooldown: 60}}
 <nowiki></nowiki>{{H:title|Enchantment modifiers block|enchantment-modifiers:}}
  {{H:title|Default enchantment modifier. This will be used if per-enchantment modifiers are not specified.|default: 5}}

[[Category:Characters]]

{{NavBox}}