条件与槽位

condition 用来决定执行 true-action 还是 false-action。条件列表全部通过时，才会执行 true-action。

条件写法

写法	说明
papi:{表达式}	使用 PAPI 变量和公式判断。
permission:{权限}	玩家必须拥有权限。
nopermission:{权限}	玩家必须没有权限。
roll:{概率}	概率判断，范围 0 到 1。
check_equals_name:{槽位#名称}	指定槽位物品名完整匹配。
check_contain_name:{槽位#文本}	指定槽位物品名包含文本。
check_equals_lore:{槽位#文本}	指定槽位存在一整行相同 Lore。
check_contain_lore:{槽位#文本}	指定槽位存在包含文本的 Lore。

示例：

condition:
  - "papi:{%player_level% * 1 >= 30}"
  - "permission:{vip.1}"
  - "roll:{0.25}"

可用槽位

槽位格式一般为 来源#参数。不同来源需要的参数不同。

写法	说明
DragonCore#槽位名	DragonCore 槽位。
GermPlugin#槽位名	萌芽槽位。
Minecraft#槽位ID	原版背包槽位，范围通常为 0-36。
APInventory#分页ID#槽位ID	梦星桐背包槽位。
LyInventory#背包ID#类型	离渊背包旧版槽位。
LyInventoryReload#背包ID#类型	离渊背包重置版槽位。
Origin#MainHand	主手。
Origin#OffHand	副手。
Origin#Helmet	头盔。
Origin#ChestPlate	胸甲。
Origin#Legging	护腿。
Origin#Boots	鞋子。

物品名判断

condition:
  - "check_equals_name:{Origin#MainHand#&a钥匙}"

这个条件要求玩家主手物品名完整等于 &a钥匙。颜色符号会按 & 转换。

如果只需要包含某段文本，用：

condition:
  - "check_contain_name:{Origin#MainHand#钥匙}"

Lore 判断

condition:
  - "check_equals_lore:{Origin#MainHand#&7古代遗物}"

完整匹配要求某一行 Lore 完全相同。包含判断则适合只检查关键词：

condition:
  - "check_contain_lore:{Origin#MainHand#古代}"

条件失败动作

false-action 可以给玩家提示，也可以直接中断：

false-action:
  - "message:&c你需要手持钥匙才能打开。"
  - "return"

如果不写 false-action，条件失败时不会执行任何动作，但后续事件仍会继续按顺序检测。