> For the complete documentation index, see [llms.txt](https://docs.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.superiormc.cn/auxilor-plugins/zi-ding-yi-xiao-guo/zi-ding-yi-can-shu.md).

# 自定义参数

自定义参数允许您为效果添加自己想要的参数，参数内是一系列新的子效果。如果你有重复多次使用某个效果的情况，不妨使用它。例如，为多个效果增加同样的音效以增加游戏沉浸感、某个效果执行后扣除物品耐久等，那么就可以将这个音效效果设置为一个参数，这样在各个效果之间只需要新增这个参数即可，无需添加整个效果，方便省事。

自定义参数的配置文件可以在 `/plugins/libreforge/arguments/` 目录下找到，您可以自行添加或者删除它们。

下面是一个示例文件：

```yaml
# 自定义参数的ID就是文件的名称
# 例如 named_mana.yml 的ID为 named_mana

# 查看该参数是否满足的条件
is-met:
  - id: above_magic
    args:
      type: mana
      amount: "%amount%"

# 如果条件满足，则执行的动作
if-met:
  - id: give_magic
    args:
      type: mana
      amount: "- %amount%"
  - id: send_message
    args:
      message: "-%amount% %ecoskills_mana_name% &f(%reason%)"

# 如果条件不满足，则执行的动作
if-not-met: [ ]
```

## 使用自定义变量符

可以在各个效果中的参数（args选项）中使用自定义参数，和其他正常参数类似，但是自定义参数都以 `custom_` 开头。例如，如果你有一个 ID 为 `named_mana` 的自定义参数，那么要在效果中使用它，需要像下面这个样子：

```yaml
args:
  custom_named_mana:
    amount: 10
    reason: 快速传送
```

amount 和 reason 选项是用在 `%amount%` 和 `%reason%` 中。