# 8.x 版本 自定义附魔配置可以在 `plugins/EcoEnchants/customenchants.yml` 中找到，它的一般配置如下： ``` enchants: - <第一个自定义附魔> - <第二个自定义附魔> ``` 其中，`enchants` 为一个 **List** 类型的自定义附魔的键，所有自定义附魔的一半配置如下： ``` - id: escape type: normal name: "逃避" description: 在受到伤害后获得短时间的加速效果 obtaining: table: true villager: true loot: true rarity: epic general-config: flags: [ ] targets: - boots grindstoneable: true disabled-in-worlds: [ ] requirements: list: [ ] not-met-lore: [ ] conflicts: [ ] levels: - effects: - id: potion_effect args: effect: speed level: 1 duration: 30 apply_to_player: true triggers: - take_damage conditions: [ ] - effects: - id: potion_effect args: effect: speed level: 2 duration: 30 apply_to_player: true triggers: - take_damage conditions: [ ] ``` 我们可以看出它由以下部分组成： * **id**：自定义附魔的 ID，只能由小写字母组成，如果有下划线在游戏中会被自动省略。 * **type**：附魔的类型，在正常情况下我们直接填写 **normal** 即可。 另有：**curse**（负面附魔，插件内的作用是无论该负面附魔是什么稀有度，其自定义颜色都将会是红色）、**special**（特殊附魔，插件内的作用是每个物品最多只能有一个特殊附魔）。 * **name**：附魔的名称，玩家能够看到的。 * **description**: 附魔的描述，玩家可以通过 **/enchantinfo** 指令查询到，也可以通过开启 `plugins/EcoEnchants/config.yml` 中的 `describe.enabled` 选项，将其修改为 `true` 即可。 {% hint style="info" %} 本教程将引用一种新的描述格式，以上文的 `describe.enabled` 为例，它在配置中实际显示如下： {% endhint %} ``` describe: before-lines: 5 at-bottom: false only-on-books: false wrap: 30 enabled: true # <----- enabled 为 describe 下的子选项 ``` * **obtaining.table** * **obtaining.villager** * **obtaining.loot** 获得该附魔的方式，从上到下分别是：附魔台、村民、宝箱 {% hint style="info" %} 如果您的服务器还使用了其他自定义村民交易插件、自定义宝箱战利品插件等，我们建议您花费一些时间自行地为这些附魔加入到这些插件的配置中，并关闭这里的获得方法，以减少插件冲突的可能性，这会导致实质生成概率与所配置的理想状态严重不符，严重的还会进一步导致其他问题！ 同时，笔者也非常建议你参照原版附魔的获得方式，而不是一股脑地所有方式都可以获得，你应该保留一些特别稀有的附魔，只能通过村民交易，并设置较低的概率，以增加游戏趣味性。 {% endhint %} * **obtaining.rarity：**获得该附魔的稀有度。 请打开 `plugins/EcoEnchants/rarity.yml` 文件，该选项与该文件有直接关联。 打开后我们可以看到如下内容： ``` rarities: common: table-probability: 30 minimum-level: 1 villager-probability: 10.5 loot-probability: 12 custom-color: enabled: false color: "&7" uncommon: table-probability: 20 minimum-level: 5 villager-probability: 9 loot-probability: 16 custom-color: enabled: false color: "&a" rare: table-probability: 20 minimum-level: 15 villager-probability: 7.5 loot-probability: 18 custom-color: enabled: false color: "&9" epic: table-probability: 10 minimum-level: 16 villager-probability: 6 loot-probability: 20 custom-color: enabled: false color: "&5" legendary: table-probability: 8 minimum-level: 20 villager-probability: 4.5 loot-probability: 15 custom-color: enabled: false color: "&6" special: table-probability: 2 minimum-level: 30 villager-probability: 3 loot-probability: 5 custom-color: enabled: false color: "&d" veryspecial: table-probability: 1 minimum-level: 30 villager-probability: 1.5 loot-probability: 2 custom-color: enabled: false color: "&4" artifact: table-probability: 5 minimum-level: 1 villager-probability: 9 loot-probability: 5 custom-color: enabled: false color: "&8" ``` 按照 **Yaml 语法学习** 一节的内容，我们可知 `common、 uncommon、rare、epic、legendary、special、veryspecial、artifact` 均为 `rarities` 下的子键（子选项），这也是我们需要在 `obtaining.raitiy` 中将会填写的内容，如所给示例即为 `epic`。 稀有度不仅可以显示在附魔上，它更重要功能是决定玩家能够获得这个附魔的概率。 各个稀有度下又有以下子选项： * **table-probability：**附魔台获得此稀有度附魔的概率。 * **minimum-level：**附魔台获得此稀有度附魔的最低等级。 * **villager-probability：**村民交易中含有此稀有度附魔的概率。 * **loot-probability：**宝箱中含有此稀有度附魔书的概率。 * **custom-color.enabled：**是否开启稀有度附魔自定义颜色。 * **custom-color.color：**自定义颜色的代码。 我们继续挖掘一般自定义附魔配置： * **general-config.targets：**可以拥有该附魔的物品，如何填写请见下一节。 * **general-config.flags：**附魔的标签，值按 **List** 格式填写。 有如下几个标签可以设置： * **hard-cap-ignore：**无视附魔上限。 * **no-cooldown-message：**不显示附魔冷却提示。（仅限卷轴类型附魔） * **no-use-message：**不显示附魔使用提示。（仅限卷轴类型附魔） 继续一般自定义附魔配置： * **general-config.grindstoneable：**是否可以使用砂轮将该附魔祛除并获得经验值。 * **general-config.disabled-in-worlds：**附魔禁用的世界，值按 **List** 格式填写。 * **general-config.requirements：**附魔的使用条件，具体如下： ``` general-config: requirements: list: - 'placeholder-greater-than:%ecoskills_enchanting%:20' not-met-lore: - "" - "&c你必须达到 &e附魔 XX" - "&c才能使用 &d狂怒&c 附魔" ``` 其中： * **general-config.requirements.list：**具体的条件列表，以 **List** 格式填写，其中各个值中又按照 `'条件类型:条件内容'` 填写。 {% hint style="info" %} 想一想，为什么前后要加 **'** 符号，如果你不知道，请再次阅读 **Yaml 语法格式** 一节。 {% endhint %} * **general-config.requirements.not-met-lore：**条件未满足时给附魔物品自动加的 **Lore**。 {% hint style="info" %} 如果你不需要这个选项，还记得我们在 **Yaml 语法学习** 所讲的吗，试试填写 **not-met-lore: \[]**，这样无论条件是否满足，附魔物品都不会被自动加上 **Lore**。 {% endhint %} 条件类型有如下几种： * **has-permission：**是否拥有条件内容的权限节点，条件内容填写权限节点即可。 * **placeholder-equals：**变量符（Placeholders）是否等于某个值，条件内容按照 `变量符:要求的值` 格式填写。例如 `%ecoskills_enchanting%:20` 即代表 `%ecoskills_enchanting%` 变量符的值必须为 **20** 时条件才会被满足。 * **placeholder-greater-than：**大于等于，详见上。 * **placeholder-less-than：**小于等于，详见上。 继续一般自定义附魔配置： * **levels：**各个等级的附魔的效果，以 **List** 格式填写。 我们再次阅读开头所给的示例： ``` levels: - effects: - id: potion_effect args: effect: speed level: 1 duration: 30 apply_to_player: true triggers: - take_damage conditions: [ ] - effects: - id: potion_effect args: effect: speed level: 2 duration: 30 apply_to_player: true triggers: - take_damage conditions: [ ] ``` {% hint style="info" %} 想一想，为什么各个 **effect** 前会有一个 **-** 符号，如果你不知道，请再次阅读 **Yaml 语法学习** 一节。 {% endhint %} 以上铺垫了这么多，这里才是这个关卡最终 **Boss** 的存在，我们在 简绍 一节已经提及，所有 **EcoX** 都是围绕自定义技能（The Effect System）的，这里就是设置拥有该附魔的物品将会触发的技能了，我们这里暂时不揭露这个神秘的内容，阅读第二章，我们将会一一揭晓它神秘的面纱。 --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.superiormc.cn/ecox-doc/yi-ban-pei-zhi-ge-shi/zi-ding-yi-fu-mo/8.x-ban-ben.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.