Blacksmith

From Citizens Wiki

Revision as of 21:55, 21 February 2012 by APunch (talk | contribs) (→‎How to Use)

Template:OfficialType Template:OCharacterType

How to Use

General Information

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.

Interaction

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. Generally, the more enchantments and durability remaining that an item has, the more expensive it will be. For more information, see that Prices section below.

Prices

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.

Base Price

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.

For example, adding "diamond-sword: 45" to the base-prices section will make the base price for diamond swords 45. Here are valid, case-sensitive names for items:

wood-pickaxe
wood-spade
wood-hoe
wood-sword
wood-axe
stone-pickaxe
stone-spade
stone-hoe
stone-sword
stone-axe
gold-pickaxe
gold-spade
gold-hoe
gold-sword
gold-axe
iron-pickaxe
iron-spade
iron-hoe
iron-sword
iron-axe
diamond-pickaxe
diamond-spade
diamond-hoe
diamond-axe
bow
flint-and-steel
fishing-rod
shears
leather-helmet
leather-chestplate
leather-leggings
leather-boots
chainmail-helmet
chainmail-chestplate
chainmail-leggings
chainmail-boots
gold-helmet
gold-chestplate
gold-leggings
gold-boots
iron-helmet
iron-chestplate
iron-leggings
iron-boots
diamond-helmet
diamond-chestplate
diamond-leggings
diamond-boots

Durability

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.

Enchantments

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
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

Commands

Configuration

The configuration file for Blacksmiths is found in /plugins/Blacksmith/config.yml and is generated automatically when not present.

Default Configuration

Mouseover each section to view it's description.

# Blacksmith Configuration
base-prices:
 default: 10
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!
 percent-chance-to-fail-reforge: 10
 delays-in-seconds:
   maximum: 30
   minimum: 5
   reforge-cooldown: 60
enchantment-modifiers:
 default: 5