查看“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以下能力:
*付费修复武器、工具和装备.

Most up-to-date source code available here: https://github.com/mcmonkey4eva/Blacksmith

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

??? ?/?/2017
* 现在这款插件由 HurricanKai维护, 兼容1.12. See github for commit logs. https://github.com/HurricanKai/Blacksmith

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

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

v1.2 8/15/2012
*Added price-per-durability-point option on a per-item basis.
*dded session timeout if player asks for price and does not reforge item.
*Fixed Random-enchant algorithm.

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 

===介绍===
Blacksmiths have a variety of settings that can be per-NPC or global. The settings under "defaults" in the configuration file are the default settings that a blacksmith will be given when it is created. You can override these settings by using the commands from the Commands section below. You can even configure which items a blacksmith is able to reforge in-game using commands. By default, a blacksmith is able to reforge all items.

===交互===
Interacting with a blacksmith is simple:
*Right click the NPC with a tool or armor in your hand. It will tell you the price that it costs to reforge it. 
*Right click again within 10 seconds and the blacksmith will begin reforging the item.
**Depending on the configuration, the reforging has a chance to enchant or damage an item.

==价格==
Prices are determined by the damage of an item, the number and type of enchantments, and the prices defined in the configuration file. Basically, the formula for determining the price of a reforge is ''basePrice + durabilityRemaining + enchantments''.

===基础价格===
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>

===附魔===
The price of reforging an item with enchantments is more expensive than one without any. For each enchantment, an amount is added to the total price based on the "enchantment-modifier" and the level of the enchantment. Enchantment modifiers can be configured in the configuration file by adding the enchantment name and a value within the ''enchantment-modifiers'' section. The default modifier, ''enchantment-modifiers.default'', is used if the enchantment name is not found. Here are valid, case-sensitive names for enchantment modifiers:

* ''arrow-damage'' - Provides extra damage when shooting arrows from bows
* ''arrow-fire'' - Sets entities on fire when hit by arrows shot from a bow
* ''arrow-infinite'' - Provides infinite arrows when shooting a bow
* ''arrow-knockback'' - Provides a knockback when an entity is hit by an arrow from a bow
* ''damage-all'' - Increases damage against all targets
* ''damage-arthropods'' - Increases damage against arthropod targets
* ''damage-undead'' - Increases damage against undead targets
* ''dig-speed'' - Increases the rate at which you mine/dig
* ''durability'' - Decreases the rate at which a tool looses durability
* ''fire-aspect'' - When attacking a target, has a chance to set them on fire
* ''knockback'' - All damage to other targets will knock them back when hit
* ''loot-bonus-blocks'' - Provides a chance of gaining extra loot when destroying blocks
* ''loot-bonus-mobs'' - Provides a chance of gaining extra loot when killing monsters
* ''oxygen'' - Decreases the rate of air loss whilst underwater
* ''protection-environmental'' - Provides protection against environmental damage
* ''protection-explosions'' - Provides protection against explosive damage
* ''protection-fall'' - Provides protection against fall damage
* ''protection-fire'' - Provides protection against fire damage
* ''protection-projectile'' - Provides protection against projectile damage
* ''silk-touch'' - Allows blocks to drop themselves instead of fragments (for example, stone instead of cobblestone)
* ''water-worker'' - Increases the speed at which a player may mine underwater

==权限==
如果你希望让玩家使用铁匠，你需要给予玩家
*''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}}