CONFIGURATION GUIDE

附魔配置格式

只讲一次所有附魔共用的 YAML 结构,不逐个讲解 113 个附魔。

为什么只用一个代表文件

113 个附魔共享同一种配置结构

这里使用 enchantments/melee/blazing_blade.yml 讲解所有通用字段。 创建其他附魔时复制该结构,修改唯一 ID、等级、稀有度、适用物品和 effects 即可, 不需要阅读 113 篇重复 Wiki。

先理解效果管线 →查询触发器 →查询条件 →查询效果 →
修改前先确认
  • id 必须全局唯一。
  • applicable-items 需要显式填写;ALL 必须单独使用。
  • effects 的详细写法继续查看效果管线、触发器、条件和效果页面。
当前配置文件

blazing blade

enchantments/melee/blazing_blade.yml

以下内容来自插件当前默认资源。先确定你想改变的功能,再选择配置分组;技术路径只用于在 YAML 中准确定位。

先看懂这个文件

单个附魔

一个附魔文件定义启用状态、稀有度、等级、适用物品、冲突、获取权重以及触发器/条件/效果块。

推荐阅读顺序
  1. 选择最接近你目标的配置分组。
  2. 点击字段,先看“什么时候需要修改”。
  3. 复制 YAML 片段并只替换需要的值。
本文件常用入口
  • enabled / rarity / max-level
  • targets / conflicts
  • obtain.*
  • triggers
  • conditions
  • effects
完整入门示例
enabled: true
rarity: radiant
max-level: 5
targets: [SWORD]
effects:
  - trigger: ATTACK
    type: DAMAGE_MULTIPLIER
安全修改先备份只用空格缩进一次改一个字段保存后执行 /fe reload
12 个分组 · 34 个可配置字段
03字段教程
基础配置/id
文本

内部 ID

id

这项配置控制什么

内部唯一 ID。命令、权限、其他配置引用它;发布后随意修改会让旧数据失去对应关系。

什么时候需要修改

只有默认行为不符合你的服务器需求时才修改;不确定用途时保留默认值最安全。

可以怎样填写

文本:包含 #、冒号、MiniMessage 标签或前后空格时保留引号。

当前默认值
blazing_blade
可复制的 YAML 片段
# 这是文件根级字段
id: blazing_blade
修改步骤
  1. 先在服务器中找到路径 id。
  2. 在冒号后修改内容。值中包含 #、: 或其他特殊字符时,建议保留原有引号。
  3. 保存文件并执行 /fe reload,随后查看控制台。
注意事项

其他配置、权限插件或已有数据可能引用此值,修改前先搜索所有引用位置。