# 创建一个自定义物品

## 示例配置

示例配置如下：

<pre class="language-yaml"><code class="lang-yaml"># 物品的ID就是 .yml 文件的名称
# 例如 hardened_netherite_sword.yml 的物品ID就是 hardened_netherite_sword
# 你可以将物品的配置文件放置到 items 文件夹下的任意位置
# 包括放置到子文件夹里面
# _example.yml 文件不会加载

item:
  item: iron_sword hide_attributes # 物品语句
  display-name: "&#x3C;g:#f953c6>熔炼剑&#x3C;/g:#b91d73>" # 物品的显示名称
  lore: # 物品Lore
    - "&#x26;7伤害: &#x26;c12❤"
    - "&#x26;7攻击速度: &#x26;c1.5"
    - ""
    - "&#x3C;g:#f953c6>熔炼增益&#x3C;/g:#b91d73>"
    - "&#x26;8» &#x26;#f953c6在下界造成额外 50% 的伤害"
  craftable: true # 该物品是否可以合成
  recipe: # 合成配方
    - ""
    - ecoitems:mithril 2
    - ""
    - ""
    - ecoitems:mithril 2
    - ""
    - ""
    - stick
    - ""
  recipe-give-amount: 1 # 可选，该物品合成配方合成后所给的数量
<strong>  permission: test # 可选，该物品合成配方所需要的权限
</strong>
  # 实际上物品的耐久并没有改变，我们只是更改物品耐久消耗的速率
  # 例如你在这里设置了700，而物品实际耐久是350，那么物品耐久消耗速率将会为原来的一半

  effective-durability: 1024 # 可选，设置物品耐久效率

# 物品激活效果时需要物品所在的槽位
# 支持填写 mainhand, offhand, hands, helmet, chestplate,
# leggings, boots, armor, any, 0-40的数字（以代表具体格子）,
# 或者多个槽位写在一起 "9, 10, 11, mainhand"
# 利用此选项以让这个物品变成武器、盔甲、饰品等
# 如果这个选项没有设置，则默认为 mainhand
slot: mainhand

base-damage: 12 # 可选，物品的基础伤害
base-attack-speed: 1.5 # 可选，物品的攻击速度

# 物品的效果
effects:
  - id: damage_multiplier
    args:
      multiplier: 1.5
    triggers:
      - melee_attack
<strong>
</strong><strong># 物品效果能够激活的条件
</strong>conditions:
  - id: in_world
    args:
      world: world_the_nether
</code></pre>

## 如何添加物品

所有的物品的配置文件都储存在 `plugins/EcoItems/items` 文件夹，你可以在这个文件夹添加或者删除物品的配置文件，同时这里有一个 `_example.yml` 的示例配置文件供你参考。

## 如何添加配方

和物品类似，所有的配方的配置文件都储存在 `plugins/EcoItems/recipes` 文件夹，你可以在这个文件夹添加或者删除配方的配置文件，同时这里有一个 `_example.yml` 的示例配置文件供你参考。
