9.x 版本

自定义附魔配置可以在 plugins/EcoEnchants/enchants 文件夹中找到，每个附魔的配置是独立的，其文件名称就是附魔 id，其余大体仍相同。

display-name: "烈焰挖掘"
description: "&a%placeholder%% &8几率挖掘 3 x 3 范围的方块."
placeholder: "5 * %level%"
type: normal

targets:
  - pickaxe
conflicts:
  - drill
  - vein
rarity: legendary
max-level: 3

tradeable: true
discoverable: true
enchantable: true

effects:
  - effects:
      - id: create_explosion
        args:
          power: 0
          amount: 1
      - id: mine_radius
        args:
          radius: 1
          blacklisted_blocks: [ ]
          check_hardness: true
          disable_on_sneak: true
    args:
      chance: "5 * %level%"
      cooldown: 0.05
      send_cooldown_message: false
    triggers:
      - mine_block
conditions: [ ]

我们可以看出它由以下部分组成：

• display-name：附魔的显示名称。

• description: 附魔的描述，玩家可以通过 /enchantinfo 指令打开的菜单查询到，也可以通过开启 plugins/EcoEnchants/config.yml 中的 display.descriptions.enabled 选项，将其修改为 true 即可。

本教程将引用一种新的描述格式，以上文的 display.descriptions.enabled 为例，它在配置中实际显示如下：

• placeholder：变量符公式，可以在上一个选项中使用 %placeholder% 显示变量符中的内容，具体请见 数值语法学习。

effects 和这里的变量符公式不是互通的，因此如果你错误的设置这两个选项会导致附魔实际效果和现实的效果不一致。

这里所给的示例是几率类型的技能，这往往是小白的灾难区，因为你显示给玩家的是 50% 几率中的 50 数字，而实际技能配置（effects选项中），你设置的应该是 0.5 小数。

• type：附魔的类型。

请打开 plugins/EcoEnchants/types.yml 文件，该选项与该文件有直接关联。

打开后我们可以看到如下内容：

types:
  - id: normal
    format: "&7"
    limit: -1
    high-level-bias: 0

我们可以看出各个附魔类型由以下部分组成：

• id：附魔类型的 id。

• format：附魔类型的颜色代码。

• limit：一件物品拥有该附魔类型的附魔的上限，使用 -1 代表无限制。

• high-level-bias：该附魔类型高等级生成偏差。填写 0-1 之间数值。

继续：

• rarity：附魔的品质。

请打开 plugins/EcoEnchants/rarity.yml 文件，该选项与该文件有直接关联。

打开后我们可以看到如下内容：

rarities:
  - id: common
    display-name: "普通"
    table-chance: 30
    minimum-level: 1
    villager-chance: 10.5
    loot-chance: 12

稀有度不仅可以显示在附魔上，它更重要功能是决定玩家能够获得这个附魔的概率。

我们可以看出各个附魔品质由以下部分组成：

• id：附魔品质的 id。

• display-name：附魔品质的显示名称。

• table-chance：附魔台中随机到获得该附魔的概率。

• minimum-level：附魔台获得此稀有度附魔的最低等级。

• villager-chance：村民交易中含有此稀有度附魔的概率。

• loot-chance：宝箱中含有此稀有度附魔书的概率。

继续：

• max-level：该附魔的最高等级。

• tradeable：该附魔是否会被村民交易随机到。

• discoverable：该附魔是否会被宝箱随机到。

• enchantable：该附魔是否会被附魔台随机到。

• effects/conditions：The Effect System（自定义技能系统）的内容，将在后文介绍。