药水配置

药水文件放在 potion/ 目录。每个顶层节点是一种药水。

基础结构

"示例药水":
  name: "测试药水"
  interact-type: "all"
  take: true
  cd: "10.5"
  cd-group: "红药水"

配置	说明
顶层节点	药水 id
name	匹配物品显示名
interact-type	允许的触发方式
take	使用后是否扣除 1 个物品
cd	冷却时间，支持变量和公式
cd-group	冷却组

name 支持 contain@文本 模糊匹配和 equals@文本 完全匹配。不写前缀时按完整匹配处理。

触发方式

值	说明
all	主手和按键都可触发
hand	只允许主手右键触发
key	只允许按键触发

使用次数

take: false
take-lore: "&a右键使用药水, 药水将在&6{value}次&a后彻底销毁!"

take: true 时直接扣除 1 个物品。

take: false 时，如果物品 lore 匹配 take-lore，会读取 {value} 作为剩余次数，使用后递减；次数到 0 时销毁。

条件

condition:
  - "%player_level% > 5 <-> &c测试药水必须5级后才可以使用!!"
  - "permission:vip.use<->&c你需要权限"

条件不满足时，如果使用 <-> 写了提示，会给玩家发送提示。

条件	说明
permission:权限	玩家必须拥有权限
nopermission:权限	玩家不能拥有权限
变量表达式	PlaceholderAPI 表达式判断

Lore 取值

lore-placeholder:
  力量: "力量+<value>"

取出的值可在冷却、效果和指令中使用 {v.力量}。

离线暂停

offline-pause: true

true 表示玩家下线时暂停药水效果，上线后继续剩余效果。

false 表示下线期间时间继续流逝，上线后按剩余时间恢复或直接结束。

指令和权重指令

commands:
  - "[console]spawn %player_name%"

指令前缀支持 [console]、[op]、[player]。

weight-command 可配置多个权重组，触发后每组随机执行一条。