FOTIAPLUGIN WIKI
/
CONDITION CATALOG

条件

conditions 按顺序逐项判断。全部通过后才会执行 actions；省略 conditions 表示触发后直接执行。

155个条件 · 点击任意条目查看字段和完整示例
玩家状态基础实现

概率判定

chance

按配置的百分比概率决定本次效果链是否继续。

什么时候通过

按配置的百分比概率决定本次效果链是否继续。

判断对象

不读取玩家或目标属性，只进行一次随机数判定。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
chance

必须与本条目 ID 完全一致。

示例 chance
value通过概率必填
类型
数字或表达式
默认
无

0 到 100 的百分比；支持 {level} 等表达式变量。

示例 {level} * 10
READY TO USE

完整 YAML 示例

type: chance
value: "{level} * 10"
玩家状态基础实现

生命值低于

health_below

玩家当前生命值低于给定数值时通过。

什么时候通过

玩家当前生命值低于给定数值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
health_below

必须与本条目 ID 完全一致。

示例 health_below
value生命值上限必填
类型
数字或表达式
默认
无

按生命点计算；1 颗心等于 2 点生命值。

示例 8
READY TO USE

完整 YAML 示例

type: health_below
value: "8"
环境与区域基础实现

位于指定生物群系

in_biome

玩家脚下位置的生物群系命中指定列表时通过。

什么时候通过

玩家脚下位置的生物群系命中指定列表时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
in_biome

必须与本条目 ID 完全一致。

示例 in_biome
value生物群系必填
类型
文本或文本列表
默认
无

填写 Bukkit 生物群系 ID；可写单个值或列表。

示例 PLAINS, FOREST
READY TO USE

完整 YAML 示例

type: in_biome
value: ["PLAINS", "FOREST"]
玩家状态基础实现

白天或夜晚

time

根据玩家所在世界的时间判断白天或夜晚。

什么时候通过

根据玩家所在世界的时间判断白天或夜晚。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
time

必须与本条目 ID 完全一致。

示例 time
value时间段必填
类型
文本
默认
无

填写 day 表示白天；其他值会按夜晚处理。

示例 day
READY TO USE

完整 YAML 示例

type: time
value: "day"
玩家状态基础实现

天气匹配

weather

玩家所在世界的当前天气命中指定值时通过。

什么时候通过

玩家所在世界的当前天气命中指定值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
weather

必须与本条目 ID 完全一致。

示例 weather
value天气必填
类型
文本或文本列表
默认
无

可用 CLEAR、RAIN、THUNDER；列表中任意一个命中即可。

示例 RAIN, THUNDER
READY TO USE

完整 YAML 示例

type: weather
value: ["RAIN", "THUNDER"]
玩家状态基础实现

Y 轴高度范围

altitude

玩家当前 Y 坐标位于 min 与 max 之间时通过。

什么时候通过

玩家当前 Y 坐标位于 min 与 max 之间时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
altitude

必须与本条目 ID 完全一致。

示例 altitude
min最低高度可选
类型
数字或表达式
默认
无限制

允许通过的最低 Y 坐标，包含边界。

示例 -64
max最高高度可选
类型
数字或表达式
默认
无限制

允许通过的最高 Y 坐标，包含边界。

示例 32
READY TO USE

完整 YAML 示例

type: altitude
min: -64
max: 32
玩家状态基础实现

是否在水中

in_water

判断玩家当前位置的方块是否为水。

什么时候通过

判断玩家当前位置的方块是否为水。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
in_water

必须与本条目 ID 完全一致。

示例 in_water
value期望结果可选
类型
布尔值
默认
true

true 要求玩家在水中；false 要求玩家不在水中。

示例 true
READY TO USE

完整 YAML 示例

type: in_water
value: true
环境与区域基础实现

位于指定世界

in_world

玩家所在世界名称命中指定列表时通过。

什么时候通过

玩家所在世界名称命中指定列表时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
in_world

必须与本条目 ID 完全一致。

示例 in_world
value世界名称必填
类型
文本或文本列表
默认
无

填写世界文件夹名称；可写单个值或列表。

示例 world, resource_world
READY TO USE

完整 YAML 示例

type: in_world
value: ["world", "resource_world"]
玩家状态基础实现

是否露天

exposure_to_sky

判断玩家所在位置是否能直接看到天空。

什么时候通过

判断玩家所在位置是否能直接看到天空。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
exposure_to_sky

必须与本条目 ID 完全一致。

示例 exposure_to_sky
value期望结果可选
类型
布尔值
默认
true

true 要求露天；false 要求头顶被方块遮挡。

示例 true
READY TO USE

完整 YAML 示例

type: exposure_to_sky
value: true
玩家状态基础实现

拥有权限

permission

玩家拥有指定 Bukkit 权限节点时通过。

什么时候通过

玩家拥有指定 Bukkit 权限节点时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
permission

必须与本条目 ID 完全一致。

示例 permission
value权限节点必填
类型
文本
默认
无

填写完整权限节点。

示例 fotia.enchantment.use
READY TO USE

完整 YAML 示例

type: permission
value: "fotia.enchantment.use"
目标与战斗基础实现

目标是否为玩家

target_is_player

判断触发上下文中的目标实体是不是玩家。

什么时候通过

判断触发上下文中的目标实体是不是玩家。

判断对象

读取触发器提供的 target；没有目标时返回 false。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_is_player

必须与本条目 ID 完全一致。

示例 target_is_player
value期望结果可选
类型
布尔值
默认
true

true 要求目标是玩家；false 要求目标不是玩家。

示例 true
READY TO USE

完整 YAML 示例

type: target_is_player
value: true
目标与战斗基础实现

目标护甲值范围

target_armor_points

目标当前护甲属性位于 min 与 max 之间时通过。

什么时候通过

目标当前护甲属性位于 min 与 max 之间时通过。

判断对象

读取触发器提供的生物目标；没有目标时不通过。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_armor_points

必须与本条目 ID 完全一致。

示例 target_armor_points
min最低护甲值可选
类型
数字或表达式
默认
0

允许通过的最低护甲点数，包含边界。

示例 10
max最高护甲值可选
类型
数字或表达式
默认
无限制

允许通过的最高护甲点数，包含边界。

示例 20
READY TO USE

完整 YAML 示例

type: target_armor_points
min: 10
max: 20
目标与战斗基础实现

目标装备含自定义附魔

target_has_enchant

目标六个装备槽中至少有一件物品包含指定 FotiaEnchantment 附魔时通过。

什么时候通过

目标六个装备槽中至少有一件物品包含指定 FotiaEnchantment 附魔时通过。

判断对象

检查目标的头盔、胸甲、护腿、靴子、主手和副手。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_has_enchant

必须与本条目 ID 完全一致。

示例 target_has_enchant
value附魔 ID必填
类型
文本列表
默认
无

填写自定义附魔 ID；任意一个命中即可。

示例 lifesteal, frost_shield
READY TO USE

完整 YAML 示例

type: target_has_enchant
value: ["lifesteal", "frost_shield"]
目标与战斗基础实现

目标正在格挡

target_is_blocking

目标玩家正在用盾牌格挡时通过。

什么时候通过

目标玩家正在用盾牌格挡时通过。

判断对象

目标必须是玩家；没有目标或目标不是玩家时不通过。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_is_blocking

必须与本条目 ID 完全一致。

示例 target_is_blocking
value期望结果可选
类型
布尔值
默认
true

true 要求状态成立；false 要求状态不成立。

示例 true
READY TO USE

完整 YAML 示例

type: target_is_blocking
value: true
目标与战斗基础实现

目标正在疾跑

target_is_sprinting

目标玩家处于疾跑状态时通过。

什么时候通过

目标玩家处于疾跑状态时通过。

判断对象

目标必须是玩家；没有目标或目标不是玩家时不通过。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_is_sprinting

必须与本条目 ID 完全一致。

示例 target_is_sprinting
value期望结果可选
类型
布尔值
默认
true

true 要求状态成立；false 要求状态不成立。

示例 true
READY TO USE

完整 YAML 示例

type: target_is_sprinting
value: true
目标与战斗基础实现

目标护甲材质

target_armor_type

目标至少穿着一件指定材质前缀的护甲时通过。

什么时候通过

目标至少穿着一件指定材质前缀的护甲时通过。

判断对象

检查目标四个护甲槽；目标必须是生物。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_armor_type

必须与本条目 ID 完全一致。

示例 target_armor_type
value材质前缀必填
类型
文本或文本列表
默认
无

填写 DIAMOND、NETHERITE、IRON 等护甲材质前缀。

示例 DIAMOND, NETHERITE
READY TO USE

完整 YAML 示例

type: target_armor_type
value: ["DIAMOND", "NETHERITE"]
目标与战斗基础实现

目标拥有药水效果

target_potion_effect

目标身上存在列表中的任意药水效果时通过。

什么时候通过

目标身上存在列表中的任意药水效果时通过。

判断对象

读取触发器提供的生物目标。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_potion_effect

必须与本条目 ID 完全一致。

示例 target_potion_effect
value药水效果 ID必填
类型
文本或文本列表
默认
无

使用 Minecraft 药水效果键名，如 poison、slowness。

示例 poison, slowness
READY TO USE

完整 YAML 示例

type: target_potion_effect
value: ["poison", "slowness"]
目标与战斗基础实现

目标生命值范围

target_health

目标当前生命值位于 min 与 max 之间时通过。

什么时候通过

目标当前生命值位于 min 与 max 之间时通过。

判断对象

读取触发器提供的生物目标。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_health

必须与本条目 ID 完全一致。

示例 target_health
min最低生命值可选
类型
数字或表达式
默认
0

允许通过的最低生命点数，包含边界。

示例 1
max最高生命值可选
类型
数字或表达式
默认
100

允许通过的最高生命点数，包含边界。

示例 10
READY TO USE

完整 YAML 示例

type: target_health
min: 1
max: 10
玩家状态基础实现

连杀数达到阈值

kill_streak

玩家当前连续击杀计数达到配置值时通过。

什么时候通过

玩家当前连续击杀计数达到配置值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
kill_streak

必须与本条目 ID 完全一致。

示例 kill_streak
value最低连杀数必填
类型
数字或表达式
默认
0

支持表达式；玩家死亡后连杀计数会清零。

示例 3
READY TO USE

完整 YAML 示例

type: kill_streak
value: "3"
目标与战斗基础实现

与目标距离范围

distance_to_target

玩家与目标在同一世界且直线距离位于 min 与 max 之间时通过。

什么时候通过

玩家与目标在同一世界且直线距离位于 min 与 max 之间时通过。

判断对象

读取触发器提供的目标实体。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
distance_to_target

必须与本条目 ID 完全一致。

示例 distance_to_target
min最小距离可选
类型
数字或表达式
默认
0

允许通过的最小方块距离，包含边界。

示例 2
max最大距离可选
类型
数字或表达式
默认
无限制

允许通过的最大方块距离，包含边界。

示例 12
READY TO USE

完整 YAML 示例

type: distance_to_target
min: 2
max: 12
玩家状态基础实现

附近玩家数量

players_nearby

指定半径内的其他玩家数量位于 min 与 max 范围时通过。

什么时候通过

指定半径内的其他玩家数量位于 min 与 max 范围时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
players_nearby

必须与本条目 ID 完全一致。

示例 players_nearby
radius检测半径可选
类型
数字或表达式
默认
10

以触发玩家为中心的立方范围半径。

示例 10
min最少玩家数可选
类型
数字或表达式
默认
0

至少需要多少名其他玩家。

示例 1
max最多玩家数可选
类型
数字或表达式
默认
无限制

允许的最大玩家数；省略表示不限制。

示例 5
READY TO USE

完整 YAML 示例

type: players_nearby
radius: 10
min: 1
max: 5
玩家状态基础实现

是否处于战斗状态

in_combat

判断玩家是否被插件记录为正在战斗。

什么时候通过

判断玩家是否被插件记录为正在战斗。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
in_combat

必须与本条目 ID 完全一致。

示例 in_combat
value期望结果可选
类型
布尔值
默认
true

true 要求处于战斗；false 要求不在战斗。

示例 true
READY TO USE

完整 YAML 示例

type: in_combat
value: true
目标与战斗基础实现

距上次受伤至少多久

last_damage_interval

玩家距上次受到伤害的间隔达到指定 tick 数时通过。

什么时候通过

玩家距上次受到伤害的间隔达到指定 tick 数时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
last_damage_interval

必须与本条目 ID 完全一致。

示例 last_damage_interval
value最短间隔必填
类型
数字或表达式
默认
0

单位为 tick；20 tick 约等于 1 秒。

示例 100
READY TO USE

完整 YAML 示例

type: last_damage_interval
value: "100"
玩家状态基础实现

连续命中数达到阈值

consecutive_hits

当前目标的连续命中计数达到配置值时通过。

什么时候通过

当前目标的连续命中计数达到配置值时通过。

判断对象

读取触发玩家对当前目标的连击状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
consecutive_hits

必须与本条目 ID 完全一致。

示例 consecutive_hits
value最低连击数必填
类型
数字或表达式
默认
0

支持表达式；连续命中的具体窗口由触发器记录逻辑决定。

示例 3
READY TO USE

完整 YAML 示例

type: consecutive_hits
value: "3"
玩家状态基础实现

一段时间未受攻击

not_attacked_for

玩家连续未受攻击的时间达到指定 tick 数时通过。

什么时候通过

玩家连续未受攻击的时间达到指定 tick 数时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
not_attacked_for

必须与本条目 ID 完全一致。

示例 not_attacked_for
value未受攻击时长必填
类型
数字或表达式
默认
0

单位为 tick；20 tick 约等于 1 秒。

示例 200
READY TO USE

完整 YAML 示例

type: not_attacked_for
value: "200"
目标与战斗基础实现

位于目标背后

behind_target

根据玩家和目标朝向判断玩家是否在目标背后。

什么时候通过

根据玩家和目标朝向判断玩家是否在目标背后。

判断对象

读取触发器提供的生物目标。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
behind_target

必须与本条目 ID 完全一致。

示例 behind_target
value期望结果可选
类型
布尔值
默认
true

true 要求位于背后；false 要求不在背后。

示例 true
READY TO USE

完整 YAML 示例

type: behind_target
value: true
玩家状态基础实现

移动速度高于阈值

velocity_above

玩家当前速度向量长度高于配置值时通过。

什么时候通过

玩家当前速度向量长度高于配置值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
velocity_above

必须与本条目 ID 完全一致。

示例 velocity_above
value速度阈值必填
类型
数字或表达式
默认
0

比较 Bukkit velocity 向量的长度，不是每秒方块数。

示例 0.35
READY TO USE

完整 YAML 示例

type: velocity_above
value: "0.35"
玩家状态基础实现

是否着火

on_fire

判断玩家当前是否仍有燃烧 tick。

什么时候通过

判断玩家当前是否仍有燃烧 tick。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
on_fire

必须与本条目 ID 完全一致。

示例 on_fire
value期望结果可选
类型
布尔值
默认
true

true 要求正在燃烧；false 要求没有燃烧。

示例 true
READY TO USE

完整 YAML 示例

type: on_fire
value: true
玩家状态基础实现

饥饿值低于

food_level

玩家当前饥饿值低于指定数值时通过。

什么时候通过

玩家当前饥饿值低于指定数值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
food_level

必须与本条目 ID 完全一致。

示例 food_level
value饥饿值上限必填
类型
数字或表达式
默认
无

原版饥饿值范围为 0–20。

示例 8
READY TO USE

完整 YAML 示例

type: food_level
value: "8"
逻辑组合基础实现

独立条件冷却

cooldown_check

指定冷却键当前可用时通过，并在效果真正执行后开始计时。

什么时候通过

指定冷却键当前可用时通过，并在效果真正执行后开始计时。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
cooldown_check

必须与本条目 ID 完全一致。

示例 cooldown_check
key冷却键必填
类型
文本
默认
default

同一附魔内用于区分不同冷却条件。

示例 burst
value冷却时长必填
类型
数字或表达式
默认
0

单位为 tick，支持表达式；20 tick 约等于 1 秒。

示例 {level} * 20
READY TO USE

完整 YAML 示例

type: cooldown_check
key: "burst"
value: "{level} * 20"
玩家状态扩展实现

生命百分比高于

health_percent_above

玩家当前生命百分比高于阈值时通过。

什么时候通过

玩家当前生命百分比高于阈值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
health_percent_above

必须与本条目 ID 完全一致。

示例 health_percent_above
value最低生命百分比必填
类型
数字或表达式
默认
0

0–100 的百分比，不是生命点数。

示例 60
READY TO USE

完整 YAML 示例

type: health_percent_above
value: "60"
玩家状态扩展实现

生命百分比低于

health_percent_below

玩家当前生命百分比低于阈值时通过。

什么时候通过

玩家当前生命百分比低于阈值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
health_percent_below

必须与本条目 ID 完全一致。

示例 health_percent_below
value最高生命百分比必填
类型
数字或表达式
默认
100

0–100 的百分比，不是生命点数。

示例 30
READY TO USE

完整 YAML 示例

type: health_percent_below
value: "30"
玩家状态扩展实现

生命百分比位于范围

health_percent_between

玩家当前生命百分比位于 min 与 max 之间时通过。

什么时候通过

玩家当前生命百分比位于 min 与 max 之间时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
health_percent_between

必须与本条目 ID 完全一致。

示例 health_percent_between
min最低生命百分比可选
类型
数字或表达式
默认
0

0–100，包含边界。

示例 30
max最高生命百分比可选
类型
数字或表达式
默认
100

0–100，包含边界。

示例 70
READY TO USE

完整 YAML 示例

type: health_percent_between
min: 30
max: 70
玩家状态扩展实现

经验等级至少为

xp_level_at_least

玩家经验等级大于或等于阈值时通过。

什么时候通过

玩家经验等级大于或等于阈值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
xp_level_at_least

必须与本条目 ID 完全一致。

示例 xp_level_at_least
value最低等级必填
类型
数字或表达式
默认
0

读取玩家绿色经验等级。

示例 30
READY TO USE

完整 YAML 示例

type: xp_level_at_least
value: "30"
玩家状态扩展实现

经验等级低于

xp_level_below

玩家经验等级低于阈值时通过。

什么时候通过

玩家经验等级低于阈值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
xp_level_below

必须与本条目 ID 完全一致。

示例 xp_level_below
value最高等级必填
类型
数字或表达式
默认
0

读取玩家绿色经验等级。

示例 10
READY TO USE

完整 YAML 示例

type: xp_level_below
value: "10"
玩家状态扩展实现

饥饿百分比高于

food_percent_above

玩家饥饿值换算成百分比后高于阈值时通过。

什么时候通过

玩家饥饿值换算成百分比后高于阈值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
food_percent_above

必须与本条目 ID 完全一致。

示例 food_percent_above
value最低饥饿百分比必填
类型
数字或表达式
默认
0

20 点饥饿值等于 100%。

示例 70
READY TO USE

完整 YAML 示例

type: food_percent_above
value: "70"
玩家状态扩展实现

饥饿百分比低于

food_percent_below

玩家饥饿值换算成百分比后低于阈值时通过。

什么时候通过

玩家饥饿值换算成百分比后低于阈值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
food_percent_below

必须与本条目 ID 完全一致。

示例 food_percent_below
value最高饥饿百分比必填
类型
数字或表达式
默认
100

20 点饥饿值等于 100%。

示例 30
READY TO USE

完整 YAML 示例

type: food_percent_below
value: "30"
玩家状态扩展实现

饱和度高于

saturation_above

玩家隐藏饱和度高于阈值时通过。

什么时候通过

玩家隐藏饱和度高于阈值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
saturation_above

必须与本条目 ID 完全一致。

示例 saturation_above
value最低饱和度必填
类型
数字或表达式
默认
0

读取 Bukkit 的 saturation 数值。

示例 5
READY TO USE

完整 YAML 示例

type: saturation_above
value: "5"
玩家状态扩展实现

剩余氧气高于

oxygen_above

玩家剩余空气 tick 高于阈值时通过。

什么时候通过

玩家剩余空气 tick 高于阈值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
oxygen_above

必须与本条目 ID 完全一致。

示例 oxygen_above
value最低空气 tick必填
类型
数字或表达式
默认
0

原版满氧通常为 300 tick。

示例 100
READY TO USE

完整 YAML 示例

type: oxygen_above
value: "100"
玩家状态扩展实现

剩余氧气低于

oxygen_below

玩家剩余空气 tick 低于阈值时通过。

什么时候通过

玩家剩余空气 tick 低于阈值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
oxygen_below

必须与本条目 ID 完全一致。

示例 oxygen_below
value最高空气 tick必填
类型
数字或表达式
默认
最大空气值

原版满氧通常为 300 tick。

示例 60
READY TO USE

完整 YAML 示例

type: oxygen_below
value: "60"
玩家状态扩展实现

吸收生命高于

absorption_above

玩家黄色吸收生命值高于阈值时通过。

什么时候通过

玩家黄色吸收生命值高于阈值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
absorption_above

必须与本条目 ID 完全一致。

示例 absorption_above
value最低吸收生命必填
类型
数字或表达式
默认
0

按生命点计算；1 颗心等于 2 点。

示例 4
READY TO USE

完整 YAML 示例

type: absorption_above
value: "4"
玩家状态扩展实现

护甲值高于

armor_points_above

玩家当前护甲属性高于阈值时通过。

什么时候通过

玩家当前护甲属性高于阈值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
armor_points_above

必须与本条目 ID 完全一致。

示例 armor_points_above
value最低护甲值必填
类型
数字或表达式
默认
0

读取最终 ARMOR 属性值。

示例 15
READY TO USE

完整 YAML 示例

type: armor_points_above
value: "15"
玩家状态扩展实现

护甲韧性高于

armor_toughness_above

玩家当前护甲韧性属性高于阈值时通过。

什么时候通过

玩家当前护甲韧性属性高于阈值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
armor_toughness_above

必须与本条目 ID 完全一致。

示例 armor_toughness_above
value最低护甲韧性必填
类型
数字或表达式
默认
0

读取最终 ARMOR_TOUGHNESS 属性值。

示例 6
READY TO USE

完整 YAML 示例

type: armor_toughness_above
value: "6"
玩家状态扩展实现

幸运属性高于

luck_above

玩家当前幸运属性高于阈值时通过。

什么时候通过

玩家当前幸运属性高于阈值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
luck_above

必须与本条目 ID 完全一致。

示例 luck_above
value最低幸运值必填
类型
数字或表达式
默认
0

读取最终 LUCK 属性值。

示例 1
READY TO USE

完整 YAML 示例

type: luck_above
value: "1"
玩家状态扩展实现

原版统计值高于

stat_value_above

玩家指定 Bukkit Statistic 的累计值高于阈值时通过。

什么时候通过

玩家指定 Bukkit Statistic 的累计值高于阈值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
stat_value_above

必须与本条目 ID 完全一致。

示例 stat_value_above
stat统计项必填
类型
文本
默认
PLAY_ONE_MINUTE

填写 Bukkit Statistic 枚举名。

示例 MOB_KILLS
value最低统计值必填
类型
数字或表达式
默认
0

按该统计项的原始整数值比较。

示例 100
READY TO USE

完整 YAML 示例

type: stat_value_above
stat: "MOB_KILLS"
value: 100
玩家状态扩展实现

站在地面

is_on_ground

玩家被 Bukkit 判定为在地面上时通过。

什么时候通过

玩家被 Bukkit 判定为在地面上时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
is_on_ground

必须与本条目 ID 完全一致。

示例 is_on_ground
READY TO USE

完整 YAML 示例

type: is_on_ground
玩家状态扩展实现

离开地面

is_in_air

玩家没有被 Bukkit 判定为在地面上时通过。

什么时候通过

玩家没有被 Bukkit 判定为在地面上时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
is_in_air

必须与本条目 ID 完全一致。

示例 is_in_air
READY TO USE

完整 YAML 示例

type: is_in_air
玩家状态扩展实现

正在下落

is_falling

玩家存在摔落距离或 Y 轴速度低于 -0.08 时通过。

什么时候通过

玩家存在摔落距离或 Y 轴速度低于 -0.08 时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
is_falling

必须与本条目 ID 完全一致。

示例 is_falling
READY TO USE

完整 YAML 示例

type: is_falling
玩家状态扩展实现

正在飞行

is_flying

玩家当前启用了飞行状态时通过。

什么时候通过

玩家当前启用了飞行状态时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
is_flying

必须与本条目 ID 完全一致。

示例 is_flying
READY TO USE

完整 YAML 示例

type: is_flying
玩家状态扩展实现

正在鞘翅滑翔

is_gliding

玩家处于鞘翅滑翔状态时通过。

什么时候通过

玩家处于鞘翅滑翔状态时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
is_gliding

必须与本条目 ID 完全一致。

示例 is_gliding
READY TO USE

完整 YAML 示例

type: is_gliding
玩家状态扩展实现

正在游泳

is_swimming

玩家处于游泳姿态时通过。

什么时候通过

玩家处于游泳姿态时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
is_swimming

必须与本条目 ID 完全一致。

示例 is_swimming
READY TO USE

完整 YAML 示例

type: is_swimming
玩家状态扩展实现

正在潜行

is_sneaking

玩家按住潜行并被服务端判定为潜行时通过。

什么时候通过

玩家按住潜行并被服务端判定为潜行时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
is_sneaking

必须与本条目 ID 完全一致。

示例 is_sneaking
READY TO USE

完整 YAML 示例

type: is_sneaking
玩家状态扩展实现

正在疾跑

is_sprinting

玩家处于疾跑状态时通过。

什么时候通过

玩家处于疾跑状态时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
is_sprinting

必须与本条目 ID 完全一致。

示例 is_sprinting
READY TO USE

完整 YAML 示例

type: is_sprinting
玩家状态扩展实现

正在骑乘

is_riding

玩家位于任意载具或实体内部时通过。

什么时候通过

玩家位于任意载具或实体内部时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
is_riding

必须与本条目 ID 完全一致。

示例 is_riding
READY TO USE

完整 YAML 示例

type: is_riding
玩家状态扩展实现

正在攀爬

is_climbing

玩家所在方块名称包含 LADDER、VINE 或 SCAFFOLDING 时通过。

什么时候通过

玩家所在方块名称包含 LADDER、VINE 或 SCAFFOLDING 时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
is_climbing

必须与本条目 ID 完全一致。

示例 is_climbing
READY TO USE

完整 YAML 示例

type: is_climbing
玩家状态扩展实现

头部浸入液体

is_submerged

玩家眼睛位置所在方块是液体时通过。

什么时候通过

玩家眼睛位置所在方块是液体时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
is_submerged

必须与本条目 ID 完全一致。

示例 is_submerged
READY TO USE

完整 YAML 示例

type: is_submerged
玩家状态扩展实现

正在冻结

is_frozen

玩家 freezeTicks 大于 0 时通过。

什么时候通过

玩家 freezeTicks 大于 0 时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
is_frozen

必须与本条目 ID 完全一致。

示例 is_frozen
READY TO USE

完整 YAML 示例

type: is_frozen
玩家状态扩展实现

移动速度低于

velocity_below

玩家当前速度向量长度低于阈值时通过。

什么时候通过

玩家当前速度向量长度低于阈值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
velocity_below

必须与本条目 ID 完全一致。

示例 velocity_below
value最高速度必填
类型
数字或表达式
默认
0

比较 Bukkit velocity 向量长度。

示例 0.1
READY TO USE

完整 YAML 示例

type: velocity_below
value: "0.1"
玩家状态扩展实现

累计摔落距离高于

fall_distance_above

玩家当前累计摔落距离高于阈值时通过。

什么时候通过

玩家当前累计摔落距离高于阈值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
fall_distance_above

必须与本条目 ID 完全一致。

示例 fall_distance_above
value最低摔落距离必填
类型
数字或表达式
默认
0

单位为方块。

示例 4
READY TO USE

完整 YAML 示例

type: fall_distance_above
value: "4"
玩家状态扩展实现

移动速度属性高于

movement_speed_above

玩家 MOVEMENT_SPEED 属性高于阈值时通过。

什么时候通过

玩家 MOVEMENT_SPEED 属性高于阈值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
movement_speed_above

必须与本条目 ID 完全一致。

示例 movement_speed_above
value最低移动速度属性必填
类型
数字或表达式
默认
0

原版基础值通常为 0.1。

示例 0.12
READY TO USE

完整 YAML 示例

type: movement_speed_above
value: "0.12"
环境与区域扩展实现

正看向指定方块

looking_at_block

玩家视线射线在指定距离内命中配置的方块材质时通过。

什么时候通过

玩家视线射线在指定距离内命中配置的方块材质时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
looking_at_block

必须与本条目 ID 完全一致。

示例 looking_at_block
block方块材质必填
类型
文本
默认
无

填写 Bukkit Material 名称；也可使用 material 或 value。

示例 DIAMOND_ORE
distance检测距离可选
类型
数字或表达式
默认
5

视线射线的最大方块距离。

示例 5
READY TO USE

完整 YAML 示例

type: looking_at_block
block: "DIAMOND_ORE"
distance: 5
玩家状态扩展实现

主手物品材质

mainhand_is

玩家主手物品材质与配置值相同时通过。

什么时候通过

玩家主手物品材质与配置值相同时通过。

判断对象

读取玩家主手。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
mainhand_is

必须与本条目 ID 完全一致。

示例 mainhand_is
material物品材质可选
类型
文本
默认
任意非空气物品

填写 Bukkit Material；省略时只要求该槽位非空。

示例 DIAMOND_SWORD
READY TO USE

完整 YAML 示例

type: mainhand_is
material: "DIAMOND_SWORD"
玩家状态扩展实现

副手物品材质

offhand_is

玩家副手物品材质与配置值相同时通过。

什么时候通过

玩家副手物品材质与配置值相同时通过。

判断对象

读取玩家副手。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
offhand_is

必须与本条目 ID 完全一致。

示例 offhand_is
material物品材质可选
类型
文本
默认
任意非空气物品

填写 Bukkit Material；省略时只要求该槽位非空。

示例 DIAMOND_SWORD
READY TO USE

完整 YAML 示例

type: offhand_is
material: "DIAMOND_SWORD"
物品与装备扩展实现

穿戴指定头盔

wearing_helmet

玩家头盔槽有物品且材质命中配置时通过。

什么时候通过

玩家头盔槽有物品且材质命中配置时通过。

判断对象

读取玩家头盔槽。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
wearing_helmet

必须与本条目 ID 完全一致。

示例 wearing_helmet
material物品材质可选
类型
文本
默认
任意非空气物品

填写 Bukkit Material；省略时只要求该槽位非空。

示例 DIAMOND_SWORD
READY TO USE

完整 YAML 示例

type: wearing_helmet
material: "DIAMOND_SWORD"
物品与装备扩展实现

穿戴指定胸甲

wearing_chestplate

玩家胸甲槽有物品且材质命中配置时通过。

什么时候通过

玩家胸甲槽有物品且材质命中配置时通过。

判断对象

读取玩家胸甲槽。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
wearing_chestplate

必须与本条目 ID 完全一致。

示例 wearing_chestplate
material物品材质可选
类型
文本
默认
任意非空气物品

填写 Bukkit Material；省略时只要求该槽位非空。

示例 DIAMOND_SWORD
READY TO USE

完整 YAML 示例

type: wearing_chestplate
material: "DIAMOND_SWORD"
物品与装备扩展实现

穿戴指定护腿

wearing_leggings

玩家护腿槽有物品且材质命中配置时通过。

什么时候通过

玩家护腿槽有物品且材质命中配置时通过。

判断对象

读取玩家护腿槽。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
wearing_leggings

必须与本条目 ID 完全一致。

示例 wearing_leggings
material物品材质可选
类型
文本
默认
任意非空气物品

填写 Bukkit Material；省略时只要求该槽位非空。

示例 DIAMOND_SWORD
READY TO USE

完整 YAML 示例

type: wearing_leggings
material: "DIAMOND_SWORD"
物品与装备扩展实现

穿戴指定靴子

wearing_boots

玩家靴子槽有物品且材质命中配置时通过。

什么时候通过

玩家靴子槽有物品且材质命中配置时通过。

判断对象

读取玩家靴子槽。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
wearing_boots

必须与本条目 ID 完全一致。

示例 wearing_boots
material物品材质可选
类型
文本
默认
任意非空气物品

填写 Bukkit Material；省略时只要求该槽位非空。

示例 DIAMOND_SWORD
READY TO USE

完整 YAML 示例

type: wearing_boots
material: "DIAMOND_SWORD"
物品与装备扩展实现

穿戴完整四件套

wearing_full_set

头盔、胸甲、护腿和靴子四个槽位都存在物品并符合材质要求时通过。

什么时候通过

头盔、胸甲、护腿和靴子四个槽位都存在物品并符合材质要求时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
wearing_full_set

必须与本条目 ID 完全一致。

示例 wearing_full_set
material统一材质可选
类型
文本
默认
任意非空气物品

四件装备都必须完全等于这个 Bukkit Material；省略时只检查四槽均非空。

示例 NETHERITE_HELMET
READY TO USE

完整 YAML 示例

type: wearing_full_set
物品与装备扩展实现

物品包含 Lore

item_has_lore

上下文物品具有至少一行 Lore 时通过。

什么时候通过

上下文物品具有至少一行 Lore 时通过。

判断对象

优先读取触发器提供的 item；没有时回退玩家主手。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
item_has_lore

必须与本条目 ID 完全一致。

示例 item_has_lore
READY TO USE

完整 YAML 示例

type: item_has_lore
物品与装备扩展实现

物品有自定义名称

item_has_name

上下文物品具有自定义显示名时通过。

什么时候通过

上下文物品具有自定义显示名时通过。

判断对象

优先读取触发器提供的 item；没有时回退玩家主手。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
item_has_name

必须与本条目 ID 完全一致。

示例 item_has_name
READY TO USE

完整 YAML 示例

type: item_has_name
物品与装备扩展实现

物品有 CustomModelData

item_has_model_data

上下文物品的 ItemMeta 含 CustomModelData 时通过。

什么时候通过

上下文物品的 ItemMeta 含 CustomModelData 时通过。

判断对象

优先读取触发器提供的 item；没有时回退玩家主手。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
item_has_model_data

必须与本条目 ID 完全一致。

示例 item_has_model_data
READY TO USE

完整 YAML 示例

type: item_has_model_data
物品与装备扩展实现

物品含持久化数据

item_has_custom_data

上下文物品的 PersistentDataContainer 至少有一个键时通过。

什么时候通过

上下文物品的 PersistentDataContainer 至少有一个键时通过。

判断对象

优先读取触发器提供的 item；没有时回退玩家主手。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
item_has_custom_data

必须与本条目 ID 完全一致。

示例 item_has_custom_data
READY TO USE

完整 YAML 示例

type: item_has_custom_data
物品与装备扩展实现

物品剩余耐久百分比高于

item_durability_above

上下文物品的剩余耐久百分比高于阈值时通过。

什么时候通过

上下文物品的剩余耐久百分比高于阈值时通过。

判断对象

读取触发上下文物品或玩家主手物品。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
item_durability_above

必须与本条目 ID 完全一致。

示例 item_durability_above
value最低剩余耐久百分比必填
类型
数字或表达式
默认
0

0–100；优先检查触发器物品，否则检查主手。

示例 50
READY TO USE

完整 YAML 示例

type: item_durability_above
value: "50"
物品与装备扩展实现

物品剩余耐久百分比低于

item_durability_below

上下文物品的剩余耐久百分比低于阈值时通过。

什么时候通过

上下文物品的剩余耐久百分比低于阈值时通过。

判断对象

读取触发上下文物品或玩家主手物品。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
item_durability_below

必须与本条目 ID 完全一致。

示例 item_durability_below
value最高剩余耐久百分比必填
类型
数字或表达式
默认
100

0–100；优先检查触发器物品，否则检查主手。

示例 15
READY TO USE

完整 YAML 示例

type: item_durability_below
value: "15"
物品与装备扩展实现

物品含原版附魔

item_has_vanilla_enchant

上下文物品包含指定原版附魔，或在未指定时包含任意原版附魔。

什么时候通过

上下文物品包含指定原版附魔，或在未指定时包含任意原版附魔。

判断对象

优先读取触发器提供的 item；没有时回退玩家主手。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
item_has_vanilla_enchant

必须与本条目 ID 完全一致。

示例 item_has_vanilla_enchant
enchant附魔键可选
类型
文本
默认
任意原版附魔

可写 sharpness 或 minecraft:sharpness；也可使用 value。

示例 minecraft:sharpness
READY TO USE

完整 YAML 示例

type: item_has_vanilla_enchant
enchant: "minecraft:sharpness"
物品与装备扩展实现

物品含自定义数据键

item_has_custom_enchant

上下文物品的持久化数据中存在指定键名时通过。

什么时候通过

上下文物品的持久化数据中存在指定键名时通过。

判断对象

优先读取触发器提供的 item；没有时回退玩家主手。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
item_has_custom_enchant

必须与本条目 ID 完全一致。

示例 item_has_custom_enchant
enchant数据键名可选
类型
文本
默认
任意持久化数据键

当前实现比较 PDC key 的 key 部分；也可使用 value。

示例 lifesteal
READY TO USE

完整 YAML 示例

type: item_has_custom_enchant
enchant: "lifesteal"
物品与装备扩展实现

背包含指定数量物品

inventory_contains

玩家背包中匹配材质的物品总数达到 amount 时通过。

什么时候通过

玩家背包中匹配材质的物品总数达到 amount 时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
inventory_contains

必须与本条目 ID 完全一致。

示例 inventory_contains
material物品材质可选
类型
文本
默认
任意材质

填写 Bukkit Material；省略时统计所有非空物品。

示例 EMERALD
amount最低数量可选
类型
数字或表达式
默认
1

跨背包槽累加物品数量。

示例 32
READY TO USE

完整 YAML 示例

type: inventory_contains
material: "EMERALD"
amount: 32
物品与装备扩展实现

背包存在空槽

inventory_has_space

玩家主背包至少有一个完全空的槽位时通过。

什么时候通过

玩家主背包至少有一个完全空的槽位时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
inventory_has_space

必须与本条目 ID 完全一致。

示例 inventory_has_space
READY TO USE

完整 YAML 示例

type: inventory_has_space
玩家状态扩展实现

指定装备槽为空

slot_empty

配置的手持或护甲槽位没有物品时通过。

什么时候通过

配置的手持或护甲槽位没有物品时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
slot_empty

必须与本条目 ID 完全一致。

示例 slot_empty
slot槽位必填
类型
文本
默认
mainhand

可用 mainhand、offhand、helmet、chestplate、leggings、boots。

示例 offhand
READY TO USE

完整 YAML 示例

type: slot_empty
slot: "offhand"
目标与战斗扩展实现

存在目标

target_exists

触发器提供了目标实体时通过。

什么时候通过

触发器提供了目标实体时通过。

判断对象

读取 TriggerContext.target。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_exists

必须与本条目 ID 完全一致。

示例 target_exists
READY TO USE

完整 YAML 示例

type: target_exists
目标与战斗扩展实现

目标是生物

target_is_living

触发器提供了生物目标时通过。

什么时候通过

触发器提供了生物目标时通过。

判断对象

当前管道的 target 类型本身就是 LivingEntity。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_is_living

必须与本条目 ID 完全一致。

示例 target_is_living
READY TO USE

完整 YAML 示例

type: target_is_living
目标与战斗扩展实现

目标是敌对生物

target_is_monster

目标实现 Bukkit Monster 接口时通过。

什么时候通过

目标实现 Bukkit Monster 接口时通过。

判断对象

读取触发器提供的生物目标。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_is_monster

必须与本条目 ID 完全一致。

示例 target_is_monster
READY TO USE

完整 YAML 示例

type: target_is_monster
目标与战斗扩展实现

目标是 Boss

target_is_boss

目标实现 Bukkit Boss 接口时通过。

什么时候通过

目标实现 Bukkit Boss 接口时通过。

判断对象

读取触发器提供的生物目标。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_is_boss

必须与本条目 ID 完全一致。

示例 target_is_boss
READY TO USE

完整 YAML 示例

type: target_is_boss
目标与战斗扩展实现

目标已驯服

target_is_tamed

目标是 Tameable 且已被驯服时通过。

什么时候通过

目标是 Tameable 且已被驯服时通过。

判断对象

读取触发器提供的生物目标。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_is_tamed

必须与本条目 ID 完全一致。

示例 target_is_tamed
READY TO USE

完整 YAML 示例

type: target_is_tamed
目标与战斗扩展实现

目标有自定义名称

target_is_named

目标的 Adventure customName 不为空时通过。

什么时候通过

目标的 Adventure customName 不为空时通过。

判断对象

读取触发器提供的生物目标。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_is_named

必须与本条目 ID 完全一致。

示例 target_is_named
READY TO USE

完整 YAML 示例

type: target_is_named
目标与战斗扩展实现

目标正在燃烧

target_on_fire

目标 fireTicks 大于 0 时通过。

什么时候通过

目标 fireTicks 大于 0 时通过。

判断对象

读取触发器提供的生物目标。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_on_fire

必须与本条目 ID 完全一致。

示例 target_on_fire
READY TO USE

完整 YAML 示例

type: target_on_fire
目标与战斗扩展实现

目标位于液体

target_in_water

目标脚下位置所在方块是液体时通过。

什么时候通过

目标脚下位置所在方块是液体时通过。

判断对象

读取触发器提供的生物目标。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_in_water

必须与本条目 ID 完全一致。

示例 target_in_water
READY TO USE

完整 YAML 示例

type: target_in_water
目标与战斗扩展实现

目标生命百分比高于

target_health_percent_above

目标当前生命百分比高于阈值时通过。

什么时候通过

目标当前生命百分比高于阈值时通过。

判断对象

读取触发器提供的生物目标。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_health_percent_above

必须与本条目 ID 完全一致。

示例 target_health_percent_above
value最低生命百分比必填
类型
数字或表达式
默认
0

0–100 的百分比。

示例 70
READY TO USE

完整 YAML 示例

type: target_health_percent_above
value: "70"
目标与战斗扩展实现

目标生命百分比低于

target_health_percent_below

目标当前生命百分比低于阈值时通过。

什么时候通过

目标当前生命百分比低于阈值时通过。

判断对象

读取触发器提供的生物目标。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_health_percent_below

必须与本条目 ID 完全一致。

示例 target_health_percent_below
value最高生命百分比必填
类型
数字或表达式
默认
100

0–100 的百分比。

示例 25
READY TO USE

完整 YAML 示例

type: target_health_percent_below
value: "25"
目标与战斗扩展实现

目标距离大于

target_distance_above

玩家与目标同世界且距离大于阈值时通过。

什么时候通过

玩家与目标同世界且距离大于阈值时通过。

判断对象

读取触发器提供的目标实体。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_distance_above

必须与本条目 ID 完全一致。

示例 target_distance_above
value最小距离必填
类型
数字或表达式
默认
0

单位为方块。

示例 8
READY TO USE

完整 YAML 示例

type: target_distance_above
value: "8"
目标与战斗扩展实现

目标距离小于

target_distance_below

玩家与目标同世界且距离小于阈值时通过。

什么时候通过

玩家与目标同世界且距离小于阈值时通过。

判断对象

读取触发器提供的目标实体。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_distance_below

必须与本条目 ID 完全一致。

示例 target_distance_below
value最大距离必填
类型
数字或表达式
默认
0

单位为方块。

示例 5
READY TO USE

完整 YAML 示例

type: target_distance_below
value: "5"
目标与战斗扩展实现

目标拥有权限

target_has_permission

目标是玩家且拥有指定 Bukkit 权限节点时通过。

什么时候通过

目标是玩家且拥有指定 Bukkit 权限节点时通过。

判断对象

目标不是玩家或没有目标时不通过。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_has_permission

必须与本条目 ID 完全一致。

示例 target_has_permission
permission权限节点必填
类型
文本
默认
无

也可把权限节点写入 value。

示例 fotia.vip
READY TO USE

完整 YAML 示例

type: target_has_permission
permission: "fotia.vip"
目标与战斗扩展实现

目标位于 WorldGuard 区域

target_in_region

目标位置属于指定 WorldGuard 区域时通过。

什么时候通过

目标位置属于指定 WorldGuard 区域时通过。

判断对象

读取触发器目标的位置。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_in_region

必须与本条目 ID 完全一致。

示例 target_in_region
region区域 ID可选
类型
文本
默认
任意区域

也可写入 value；省略时判断是否位于任意区域。

示例 spawn
READY TO USE

完整 YAML 示例

type: target_in_region
region: "spawn"
目标与战斗扩展实现

目标与玩家同世界

target_is_same_world

目标存在且与玩家处于同一世界时通过。

什么时候通过

目标存在且与玩家处于同一世界时通过。

判断对象

读取触发器提供的目标。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_is_same_world

必须与本条目 ID 完全一致。

示例 target_is_same_world
READY TO USE

完整 YAML 示例

type: target_is_same_world
目标与战斗扩展实现

玩家能看见目标

target_line_of_sight

Bukkit hasLineOfSight 判定玩家与目标之间无遮挡时通过。

什么时候通过

Bukkit hasLineOfSight 判定玩家与目标之间无遮挡时通过。

判断对象

读取触发器提供的目标。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
target_line_of_sight

必须与本条目 ID 完全一致。

示例 target_line_of_sight
READY TO USE

完整 YAML 示例

type: target_line_of_sight
目标与战斗扩展实现

本次伤害高于

damage_above

伤害事件的当前伤害值高于阈值时通过。

什么时候通过

伤害事件的当前伤害值高于阈值时通过。

判断对象

读取当前伤害事件或触发器数值。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
damage_above

必须与本条目 ID 完全一致。

示例 damage_above
value最低伤害必填
类型
数字或表达式
默认
0

有伤害事件时读取 event.damage，否则读取触发器 value。

示例 10
READY TO USE

完整 YAML 示例

type: damage_above
value: "10"
目标与战斗扩展实现

本次伤害低于

damage_below

伤害事件的当前伤害值低于阈值时通过。

什么时候通过

伤害事件的当前伤害值低于阈值时通过。

判断对象

读取当前伤害事件或触发器数值。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
damage_below

必须与本条目 ID 完全一致。

示例 damage_below
value最高伤害必填
类型
数字或表达式
默认
0

有伤害事件时读取 event.damage，否则读取触发器 value。

示例 6
READY TO USE

完整 YAML 示例

type: damage_below
value: "6"
环境与区域扩展实现

位于 WorldGuard 区域

in_region

玩家当前位置属于指定 WorldGuard 区域时通过。

什么时候通过

玩家当前位置属于指定 WorldGuard 区域时通过。

判断对象

读取触发玩家的位置。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
in_region

必须与本条目 ID 完全一致。

示例 in_region
region区域 ID可选
类型
文本
默认
任意区域

也可写入 value；省略时判断是否位于任意区域。

示例 spawn
READY TO USE

完整 YAML 示例

type: in_region
region: "spawn"
环境与区域扩展实现

不在 WorldGuard 区域

not_in_region

玩家当前位置不属于指定 WorldGuard 区域时通过。

什么时候通过

玩家当前位置不属于指定 WorldGuard 区域时通过。

判断对象

读取触发玩家的位置。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
not_in_region

必须与本条目 ID 完全一致。

示例 not_in_region
region区域 ID可选
类型
文本
默认
任意区域

也可写入 value；省略时判断是否位于任意区域。

示例 spawn
READY TO USE

完整 YAML 示例

type: not_in_region
region: "spawn"
玩家状态扩展实现

位于领地

in_claim

玩家拥有对应计分板标签时通过。

什么时候通过

玩家拥有对应计分板标签时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
in_claim

必须与本条目 ID 完全一致。

示例 in_claim
tag计分板标签可选
类型
文本
默认
in_claim

也可写入 value；省略时使用该条件的默认标签。

示例 in_claim
READY TO USE

完整 YAML 示例

type: in_claim
tag: "in_claim"
玩家状态扩展实现

位于安全区

in_safe_zone

玩家拥有对应计分板标签时通过。

什么时候通过

玩家拥有对应计分板标签时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
in_safe_zone

必须与本条目 ID 完全一致。

示例 in_safe_zone
tag计分板标签可选
类型
文本
默认
in_safe_zone

也可写入 value；省略时使用该条件的默认标签。

示例 in_safe_zone
READY TO USE

完整 YAML 示例

type: in_safe_zone
tag: "in_safe_zone"
玩家状态扩展实现

位于 PvP 区

in_pvp_zone

玩家拥有对应计分板标签时通过。

什么时候通过

玩家拥有对应计分板标签时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
in_pvp_zone

必须与本条目 ID 完全一致。

示例 in_pvp_zone
tag计分板标签可选
类型
文本
默认
in_pvp_zone

也可写入 value；省略时使用该条件的默认标签。

示例 in_pvp_zone
READY TO USE

完整 YAML 示例

type: in_pvp_zone
tag: "in_pvp_zone"
玩家状态扩展实现

亮度高于

in_light_level_above

玩家脚下方块的亮度等级高于阈值时通过。

什么时候通过

玩家脚下方块的亮度等级高于阈值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
in_light_level_above

必须与本条目 ID 完全一致。

示例 in_light_level_above
value最低亮度必填
类型
数字或表达式
默认
0

原版亮度范围为 0–15。

示例 10
READY TO USE

完整 YAML 示例

type: in_light_level_above
value: "10"
玩家状态扩展实现

亮度低于

in_light_level_below

玩家脚下方块的亮度等级低于阈值时通过。

什么时候通过

玩家脚下方块的亮度等级低于阈值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
in_light_level_below

必须与本条目 ID 完全一致。

示例 in_light_level_below
value最高亮度必填
类型
数字或表达式
默认
15

原版亮度范围为 0–15。

示例 5
READY TO USE

完整 YAML 示例

type: in_light_level_below
value: "5"
环境与区域扩展实现

站在指定方块上

standing_on_block

玩家脚下一个方块的材质命中配置时通过。

什么时候通过

玩家脚下一个方块的材质命中配置时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
standing_on_block

必须与本条目 ID 完全一致。

示例 standing_on_block
block方块材质必填
类型
文本
默认
无

填写 Bukkit Material；也可使用 material 或 value。

示例 GRASS_BLOCK
READY TO USE

完整 YAML 示例

type: standing_on_block
block: "GRASS_BLOCK"
环境与区域扩展实现

身体位于指定方块

inside_block

玩家当前位置所在方块的材质命中配置时通过。

什么时候通过

玩家当前位置所在方块的材质命中配置时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
inside_block

必须与本条目 ID 完全一致。

示例 inside_block
block方块材质必填
类型
文本
默认
无

填写 Bukkit Material；也可使用 material 或 value。

示例 WATER
READY TO USE

完整 YAML 示例

type: inside_block
block: "WATER"
环境与区域扩展实现

附近存在指定方块

near_block

玩家周围立方范围内至少存在一个匹配材质的方块时通过。

什么时候通过

玩家周围立方范围内至少存在一个匹配材质的方块时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
near_block

必须与本条目 ID 完全一致。

示例 near_block
block方块材质必填
类型
文本
默认
无

填写 Bukkit Material；也可使用 material 或 value。

示例 DIAMOND_ORE
radius搜索半径可选
类型
数字或表达式
默认
5

会扫描 (2r+1)³ 个方块，半径越大开销越高。

示例 3
READY TO USE

完整 YAML 示例

type: near_block
block: "DIAMOND_ORE"
radius: 3
玩家状态扩展实现

附近存在指定实体

near_entity_type

玩家附近至少存在一个匹配 Bukkit EntityType 的实体时通过。

什么时候通过

玩家附近至少存在一个匹配 Bukkit EntityType 的实体时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
near_entity_type

必须与本条目 ID 完全一致。

示例 near_entity_type
entity实体类型必填
类型
文本
默认
无

也可写入 value；例如 ZOMBIE、VILLAGER。

示例 ZOMBIE
radius检测半径可选
类型
数字或表达式
默认
8

按 X/Y/Z 三轴范围查找附近实体。

示例 8
READY TO USE

完整 YAML 示例

type: near_entity_type
entity: "ZOMBIE"
radius: 8
玩家状态扩展实现

附近玩家至少有几人

near_player_count

玩家附近的其他玩家数量达到 min 时通过。

什么时候通过

玩家附近的其他玩家数量达到 min 时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
near_player_count

必须与本条目 ID 完全一致。

示例 near_player_count
radius检测半径可选
类型
数字或表达式
默认
8

按 X/Y/Z 三轴范围查找。

示例 8
min最低人数可选
类型
数字或表达式
默认
1

不包含触发玩家本人；也可写入 value。

示例 2
READY TO USE

完整 YAML 示例

type: near_player_count
radius: 8
min: 2
玩家状态扩展实现

月相编号匹配

moon_phase

世界当前月相编号等于配置值时通过。

什么时候通过

世界当前月相编号等于配置值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
moon_phase

必须与本条目 ID 完全一致。

示例 moon_phase
value月相编号必填
类型
数字或表达式
默认
0

取 world.fullTime / 24000 后对 8 取模，范围 0–7。

示例 0
READY TO USE

完整 YAML 示例

type: moon_phase
value: "0"
玩家状态扩展实现

季节标签匹配

season_is

玩家拥有 season:值 格式的计分板标签时通过。

什么时候通过

玩家拥有 season:值 格式的计分板标签时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
season_is

必须与本条目 ID 完全一致。

示例 season_is
season季节值必填
类型
文本
默认
无

也可写入 value，例如 spring、winter。

示例 winter
READY TO USE

完整 YAML 示例

type: season_is
season: "winter"
玩家状态扩展实现

经济余额高于

balance_above

指定计分板目标中的玩家分数高于阈值时通过。

什么时候通过

指定计分板目标中的玩家分数高于阈值时通过。

判断对象

读取玩家计分板分数。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
balance_above

必须与本条目 ID 完全一致。

示例 balance_above
objective计分板目标可选
类型
文本
默认
balance_above

要读取的 scoreboard objective；也可使用 key。

示例 balance_above
value最低余额必填
类型
数字或表达式
默认
0

默认读取名为 balance_above 的计分板目标。

示例 1000
READY TO USE

完整 YAML 示例

type: balance_above
objective: "balance_above"
value: "1000"
玩家状态扩展实现

经济余额低于

balance_below

指定计分板目标中的玩家分数低于阈值时通过。

什么时候通过

指定计分板目标中的玩家分数低于阈值时通过。

判断对象

读取玩家计分板分数。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
balance_below

必须与本条目 ID 完全一致。

示例 balance_below
objective计分板目标可选
类型
文本
默认
balance_below

要读取的 scoreboard objective；也可使用 key。

示例 balance_below
value最高余额必填
类型
数字或表达式
默认
0

默认读取名为 balance_below 的计分板目标。

示例 100
READY TO USE

完整 YAML 示例

type: balance_below
objective: "balance_below"
value: "100"
玩家状态扩展实现

点数高于

points_above

指定计分板目标中的玩家点数高于阈值时通过。

什么时候通过

指定计分板目标中的玩家点数高于阈值时通过。

判断对象

读取玩家计分板分数。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
points_above

必须与本条目 ID 完全一致。

示例 points_above
objective计分板目标可选
类型
文本
默认
points_above

要读取的 scoreboard objective；也可使用 key。

示例 points_above
value最低点数必填
类型
数字或表达式
默认
0

默认读取名为 points_above 的计分板目标。

示例 100
READY TO USE

完整 YAML 示例

type: points_above
objective: "points_above"
value: "100"
玩家状态扩展实现

点数低于

points_below

指定计分板目标中的玩家点数低于阈值时通过。

什么时候通过

指定计分板目标中的玩家点数低于阈值时通过。

判断对象

读取玩家计分板分数。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
points_below

必须与本条目 ID 完全一致。

示例 points_below
objective计分板目标可选
类型
文本
默认
points_below

要读取的 scoreboard objective；也可使用 key。

示例 points_below
value最高点数必填
类型
数字或表达式
默认
0

默认读取名为 points_below 的计分板目标。

示例 10
READY TO USE

完整 YAML 示例

type: points_below
objective: "points_below"
value: "10"
玩家状态扩展实现

拥有职业

has_job

玩家拥有职业标签时通过。

什么时候通过

玩家拥有职业标签时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
has_job

必须与本条目 ID 完全一致。

示例 has_job
tag计分板标签可选
类型
文本
默认
has_job

也可写入 value；省略时使用该条件的默认标签。

示例 has_job
READY TO USE

完整 YAML 示例

type: has_job
tag: "has_job"
玩家状态扩展实现

职业等级高于

job_level_above

指定计分板目标中的职业等级高于阈值时通过。

什么时候通过

指定计分板目标中的职业等级高于阈值时通过。

判断对象

读取玩家计分板分数。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
job_level_above

必须与本条目 ID 完全一致。

示例 job_level_above
objective计分板目标可选
类型
文本
默认
job_level_above

要读取的 scoreboard objective；也可使用 key。

示例 job_level_above
value最低职业等级必填
类型
数字或表达式
默认
0

默认读取名为 job_level_above 的计分板目标。

示例 20
READY TO USE

完整 YAML 示例

type: job_level_above
objective: "job_level_above"
value: "20"
玩家状态扩展实现

技能等级高于

skill_level_above

指定计分板目标中的技能等级高于阈值时通过。

什么时候通过

指定计分板目标中的技能等级高于阈值时通过。

判断对象

读取玩家计分板分数。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
skill_level_above

必须与本条目 ID 完全一致。

示例 skill_level_above
objective计分板目标可选
类型
文本
默认
skill_level_above

要读取的 scoreboard objective；也可使用 key。

示例 skill_level_above
value最低技能等级必填
类型
数字或表达式
默认
0

默认读取名为 skill_level_above 的计分板目标。

示例 20
READY TO USE

完整 YAML 示例

type: skill_level_above
objective: "skill_level_above"
value: "20"
玩家状态扩展实现

mcMMO 等级高于

mcmmo_level_above

指定计分板目标中的 mcMMO 等级高于阈值时通过。

什么时候通过

指定计分板目标中的 mcMMO 等级高于阈值时通过。

判断对象

读取玩家计分板分数。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
mcmmo_level_above

必须与本条目 ID 完全一致。

示例 mcmmo_level_above
objective计分板目标可选
类型
文本
默认
mcmmo_level_above

要读取的 scoreboard objective；也可使用 key。

示例 mcmmo_level_above
value最低 mcMMO 等级必填
类型
数字或表达式
默认
0

默认读取名为 mcmmo_level_above 的计分板目标。

示例 100
READY TO USE

完整 YAML 示例

type: mcmmo_level_above
objective: "mcmmo_level_above"
value: "100"
玩家状态扩展实现

AuraSkills 等级高于

aura_skill_level_above

指定计分板目标中的 AuraSkills 等级高于阈值时通过。

什么时候通过

指定计分板目标中的 AuraSkills 等级高于阈值时通过。

判断对象

读取玩家计分板分数。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
aura_skill_level_above

必须与本条目 ID 完全一致。

示例 aura_skill_level_above
objective计分板目标可选
类型
文本
默认
aura_skill_level_above

要读取的 scoreboard objective；也可使用 key。

示例 aura_skill_level_above
value最低技能等级必填
类型
数字或表达式
默认
0

默认读取名为 aura_skill_level_above 的计分板目标。

示例 25
READY TO USE

完整 YAML 示例

type: aura_skill_level_above
objective: "aura_skill_level_above"
value: "25"
玩家状态扩展实现

外部值等于文本

placeholder_equals

读取的实际值与 expected 文本忽略大小写相等时通过。

什么时候通过

读取的实际值与 expected 文本忽略大小写相等时通过。

判断对象

如果配置 objective，则读取该计分板分数；否则读取 actual 中的静态文本。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
placeholder_equals

必须与本条目 ID 完全一致。

示例 placeholder_equals
objective计分板目标可选
类型
文本
默认
不读取计分板

填写后把玩家分数作为实际值。

示例 rank_score
actual实际文本可选
类型
文本
默认
空文本

未配置 objective 时直接使用这里的文本。

示例 vip
expected期望文本必填
类型
文本
默认
无

按“完全相等”规则比较；也可写入 value。

示例 vip
READY TO USE

完整 YAML 示例

type: placeholder_equals
actual: "vip"
expected: "vip"
玩家状态扩展实现

外部值包含文本

placeholder_contains

读取的实际值包含 expected 文本时通过。

什么时候通过

读取的实际值包含 expected 文本时通过。

判断对象

如果配置 objective，则读取该计分板分数；否则读取 actual 中的静态文本。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
placeholder_contains

必须与本条目 ID 完全一致。

示例 placeholder_contains
objective计分板目标可选
类型
文本
默认
不读取计分板

填写后把玩家分数作为实际值。

示例 rank_score
actual实际文本可选
类型
文本
默认
空文本

未配置 objective 时直接使用这里的文本。

示例 vip
expected期望文本必填
类型
文本
默认
无

按“包含”规则比较；也可写入 value。

示例 premium
READY TO USE

完整 YAML 示例

type: placeholder_contains
actual: "vip"
expected: "premium"
玩家状态扩展实现

外部数值大于阈值

placeholder_greater_than

计分板分数或 actual 文本解析为数字后大于 value 时通过。

什么时候通过

计分板分数或 actual 文本解析为数字后大于 value 时通过。

判断对象

如果配置 objective，则读取该计分板分数；否则解析 actual。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
placeholder_greater_than

必须与本条目 ID 完全一致。

示例 placeholder_greater_than
objective计分板目标可选
类型
文本
默认
不读取计分板

填写后把玩家分数作为实际值。

示例 power
actual实际数值文本可选
类型
文本
默认
空文本，解析为 0

未配置 objective 时解析这里的文本。

示例 42
value比较阈值必填
类型
数字或表达式
默认
0

实际数值必须严格大于此值。

示例 10
READY TO USE

完整 YAML 示例

type: placeholder_greater_than
objective: "power"
value: 10
玩家状态扩展实现

任务进行中

quest_active

玩家拥有任务进行中标签时通过。

什么时候通过

玩家拥有任务进行中标签时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
quest_active

必须与本条目 ID 完全一致。

示例 quest_active
tag计分板标签可选
类型
文本
默认
quest_active

也可写入 value；省略时使用该条件的默认标签。

示例 quest_active
READY TO USE

完整 YAML 示例

type: quest_active
tag: "quest_active"
玩家状态扩展实现

任务已完成

quest_completed

玩家拥有任务完成标签时通过。

什么时候通过

玩家拥有任务完成标签时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
quest_completed

必须与本条目 ID 完全一致。

示例 quest_completed
tag计分板标签可选
类型
文本
默认
quest_completed

也可写入 value；省略时使用该条件的默认标签。

示例 quest_completed
READY TO USE

完整 YAML 示例

type: quest_completed
tag: "quest_completed"
玩家状态扩展实现

城镇身份匹配

town_role_is

玩家拥有指定城镇身份标签时通过。

什么时候通过

玩家拥有指定城镇身份标签时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
town_role_is

必须与本条目 ID 完全一致。

示例 town_role_is
tag计分板标签可选
类型
文本
默认
town_role_is

也可写入 value；省略时使用该条件的默认标签。

示例 town_role_is
READY TO USE

完整 YAML 示例

type: town_role_is
tag: "town_role_is"
玩家状态扩展实现

Lands 身份匹配

lands_role_is

玩家拥有指定 Lands 身份标签时通过。

什么时候通过

玩家拥有指定 Lands 身份标签时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
lands_role_is

必须与本条目 ID 完全一致。

示例 lands_role_is
tag计分板标签可选
类型
文本
默认
lands_role_is

也可写入 value；省略时使用该条件的默认标签。

示例 lands_role_is
READY TO USE

完整 YAML 示例

type: lands_role_is
tag: "lands_role_is"
玩家状态扩展实现

任意一个条件通过

any_of

conditions 列表中至少一个子条件通过时通过。

什么时候通过

conditions 列表中至少一个子条件通过时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
any_of

必须与本条目 ID 完全一致。

示例 any_of
conditions子条件必填
类型
条件对象列表
默认
无

每一项都必须包含 type，并可携带该条件自己的字段。

示例 见完整示例
READY TO USE

完整 YAML 示例

type: any_of
conditions:
  - type: health_percent_below
    value: "30"
  - type: is_sneaking
玩家状态扩展实现

全部条件通过

all_of

conditions 列表中的所有子条件都通过时通过。

什么时候通过

conditions 列表中的所有子条件都通过时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
all_of

必须与本条目 ID 完全一致。

示例 all_of
conditions子条件必填
类型
条件对象列表
默认
无

每一项都必须包含 type，并可携带该条件自己的字段。

示例 见完整示例
READY TO USE

完整 YAML 示例

type: all_of
conditions:
  - type: health_percent_below
    value: "30"
  - type: is_sneaking
玩家状态扩展实现

没有条件通过

none_of

conditions 列表中一个子条件都不通过时通过。

什么时候通过

conditions 列表中一个子条件都不通过时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
none_of

必须与本条目 ID 完全一致。

示例 none_of
conditions子条件必填
类型
条件对象列表
默认
无

每一项都必须包含 type，并可携带该条件自己的字段。

示例 见完整示例
READY TO USE

完整 YAML 示例

type: none_of
conditions:
  - type: health_percent_below
    value: "30"
  - type: is_sneaking
玩家状态扩展实现

至少 N 个条件通过

at_least_of

conditions 列表中通过的子条件数量达到 required 时通过。

什么时候通过

conditions 列表中通过的子条件数量达到 required 时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
at_least_of

必须与本条目 ID 完全一致。

示例 at_least_of
required最低通过数可选
类型
数字或表达式
默认
1

必须通过多少个子条件。

示例 2
conditions子条件必填
类型
条件对象列表
默认
无

每项包含 type 和对应字段。

示例 见完整示例
READY TO USE

完整 YAML 示例

type: at_least_of
required: 2
conditions:
  - type: health_percent_below
    value: "30"
  - type: is_sneaking
逻辑组合扩展实现

表达式结果为真

expression_true

数值表达式计算结果为真时通过。

什么时候通过

数值表达式计算结果为真时通过。

判断对象

使用当前附魔等级与触发上下文变量计算表达式。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
expression_true

必须与本条目 ID 完全一致。

示例 expression_true
expression判断表达式必填
类型
文本
默认
无

也可写入 value；可使用 {level} 等管道变量。

示例 {level} >= 3
READY TO USE

完整 YAML 示例

type: expression_true
expression: "{level} >= 3"
逻辑组合扩展实现

表达式结果为假

expression_false

数值表达式计算结果为假时通过。

什么时候通过

数值表达式计算结果为假时通过。

判断对象

使用当前附魔等级与触发上下文变量计算表达式。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
expression_false

必须与本条目 ID 完全一致。

示例 expression_false
expression判断表达式必填
类型
文本
默认
无

也可写入 value；可使用 {level} 等管道变量。

示例 {level} >= 3
READY TO USE

完整 YAML 示例

type: expression_false
expression: "{level} >= 3"
逻辑组合扩展实现

标签冷却已就绪

cooldown_ready

玩家没有指定冷却标签时通过。

什么时候通过

玩家没有指定冷却标签时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
cooldown_ready

必须与本条目 ID 完全一致。

示例 cooldown_ready
tag计分板标签可选
类型
文本
默认
cooldown_active

也可写入 value；省略时使用该条件的默认标签。

示例 cooldown_active
READY TO USE

完整 YAML 示例

type: cooldown_ready
tag: "cooldown_active"
逻辑组合扩展实现

标签冷却生效中

cooldown_active

玩家拥有指定冷却标签时通过。

什么时候通过

玩家拥有指定冷却标签时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
cooldown_active

必须与本条目 ID 完全一致。

示例 cooldown_active
tag计分板标签可选
类型
文本
默认
cooldown_active

也可写入 value；省略时使用该条件的默认标签。

示例 cooldown_active
READY TO USE

完整 YAML 示例

type: cooldown_active
tag: "cooldown_active"
逻辑组合扩展实现

权重随机通过

random_weight_passed

本次 0–100 随机值低于配置权重时通过。

什么时候通过

本次 0–100 随机值低于配置权重时通过。

判断对象

不读取实体属性。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
random_weight_passed

必须与本条目 ID 完全一致。

示例 random_weight_passed
value通过权重必填
类型
数字或表达式
默认
50

与 chance 类似；50 表示约 50% 概率。

示例 50
READY TO USE

完整 YAML 示例

type: random_weight_passed
value: "50"
玩家状态扩展实现

触发值高于

trigger_value_above

触发器提供的主数值 value 高于阈值时通过。

什么时候通过

触发器提供的主数值 value 高于阈值时通过。

判断对象

读取 TriggerContext.value。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
trigger_value_above

必须与本条目 ID 完全一致。

示例 trigger_value_above
value最低触发值必填
类型
数字或表达式
默认
0

具体含义由触发器决定，例如伤害或数量。

示例 10
READY TO USE

完整 YAML 示例

type: trigger_value_above
value: "10"
玩家状态扩展实现

触发值低于

trigger_value_below

触发器提供的主数值 value 低于阈值时通过。

什么时候通过

触发器提供的主数值 value 低于阈值时通过。

判断对象

读取 TriggerContext.value。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
trigger_value_below

必须与本条目 ID 完全一致。

示例 trigger_value_below
value最高触发值必填
类型
数字或表达式
默认
0

具体含义由触发器决定，例如伤害或数量。

示例 5
READY TO USE

完整 YAML 示例

type: trigger_value_below
value: "5"
玩家状态扩展实现

触发器备用值存在

alt_value_present

TriggerContext.altValue 不等于 0 时通过。

什么时候通过

TriggerContext.altValue 不等于 0 时通过。

判断对象

读取触发器提供的备用数值。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
alt_value_present

必须与本条目 ID 完全一致。

示例 alt_value_present
READY TO USE

完整 YAML 示例

type: alt_value_present
环境与区域扩展实现

上下文包含方块

context_has_block

当前事件能解析出方块对象时通过。

什么时候通过

当前事件能解析出方块对象时通过。

判断对象

支持方块破坏、放置、交互等带方块的事件。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
context_has_block

必须与本条目 ID 完全一致。

示例 context_has_block
READY TO USE

完整 YAML 示例

type: context_has_block
玩家状态扩展实现

上下文是弹射物命中事件

context_has_projectile

当前事件是 ProjectileHitEvent 时通过。

什么时候通过

当前事件是 ProjectileHitEvent 时通过。

判断对象

读取触发器原始 Bukkit 事件。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
context_has_projectile

必须与本条目 ID 完全一致。

示例 context_has_projectile
READY TO USE

完整 YAML 示例

type: context_has_projectile
玩家状态扩展实现

玩家是管理员

is_op

玩家拥有服务器 OP 状态时通过。

什么时候通过

玩家拥有服务器 OP 状态时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
is_op

必须与本条目 ID 完全一致。

示例 is_op
READY TO USE

完整 YAML 示例

type: is_op
玩家状态扩展实现

本次在线时长高于

is_online_longer_than

玩家 PLAY_ONE_MINUTE 统计换算后的累计秒数高于阈值时通过。

什么时候通过

玩家 PLAY_ONE_MINUTE 统计换算后的累计秒数高于阈值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
is_online_longer_than

必须与本条目 ID 完全一致。

示例 is_online_longer_than
seconds最低秒数必填
类型
数字或表达式
默认
0

优先读取 seconds，也可使用 value。

示例 1800
READY TO USE

完整 YAML 示例

type: is_online_longer_than
seconds: 1800
玩家状态扩展实现

玩家曾加入过服务器

joined_before

Bukkit hasPlayedBefore 返回 true 时通过。

什么时候通过

Bukkit hasPlayedBefore 返回 true 时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
joined_before

必须与本条目 ID 完全一致。

示例 joined_before
READY TO USE

完整 YAML 示例

type: joined_before
玩家状态扩展实现

总游玩时间高于

has_playtime_above

玩家总游玩时间高于指定秒数时通过。

什么时候通过

玩家总游玩时间高于指定秒数时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
has_playtime_above

必须与本条目 ID 完全一致。

示例 has_playtime_above
value最低秒数必填
类型
数字或表达式
默认
0

底层统计值 PLAY_ONE_MINUTE 会除以 20 转换为秒。

示例 3600
READY TO USE

完整 YAML 示例

type: has_playtime_above
value: "3600"
玩家状态扩展实现

属于权限组

in_permission_group

玩家拥有 group.组名 权限节点时通过。

什么时候通过

玩家拥有 group.组名 权限节点时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
in_permission_group

必须与本条目 ID 完全一致。

示例 in_permission_group
group权限组名必填
类型
文本
默认
无

也可写入 value；例如 vip 会检查 group.vip。

示例 vip
READY TO USE

完整 YAML 示例

type: in_permission_group
group: "vip"
玩家状态扩展实现

拥有计分板标签

has_scoreboard_tag

玩家的 Bukkit scoreboard tags 包含指定标签时通过。

什么时候通过

玩家的 Bukkit scoreboard tags 包含指定标签时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
has_scoreboard_tag

必须与本条目 ID 完全一致。

示例 has_scoreboard_tag
tag标签必填
类型
文本
默认
无

也可写入 value，必须与实际标签完全一致。

示例 event:participant
READY TO USE

完整 YAML 示例

type: has_scoreboard_tag
tag: "event:participant"
玩家状态扩展实现

已完成进度

has_advancement

玩家已完成指定 Minecraft advancement 时通过。

什么时候通过

玩家已完成指定 Minecraft advancement 时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
has_advancement

必须与本条目 ID 完全一致。

示例 has_advancement
advancement进度键必填
类型
文本
默认
无

填写完整 NamespacedKey；也可写入 value。

示例 minecraft:story/mine_diamond
READY TO USE

完整 YAML 示例

type: has_advancement
advancement: "minecraft:story/mine_diamond"
玩家状态扩展实现

已解锁配方

has_recipe

玩家已发现指定 NamespacedKey 配方时通过。

什么时候通过

玩家已发现指定 NamespacedKey 配方时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
has_recipe

必须与本条目 ID 完全一致。

示例 has_recipe
recipe配方键必填
类型
文本
默认
无

填写完整 NamespacedKey；也可写入 value。

示例 minecraft:diamond_sword
READY TO USE

完整 YAML 示例

type: has_recipe
recipe: "minecraft:diamond_sword"
玩家状态扩展实现

客户端语言匹配

language_is

玩家 locale 转换后的语言标签与配置值忽略大小写相等时通过。

什么时候通过

玩家 locale 转换后的语言标签与配置值忽略大小写相等时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
language_is

必须与本条目 ID 完全一致。

示例 language_is
language语言标签必填
类型
文本
默认
无

也可写入 value；建议使用 zh-CN、en-US 格式。

示例 zh-CN
READY TO USE

完整 YAML 示例

type: language_is
language: "zh-CN"
玩家状态扩展实现

客户端品牌匹配

client_brand_is

Paper 获取到的客户端 brand 与配置值忽略大小写相等时通过。

什么时候通过

Paper 获取到的客户端 brand 与配置值忽略大小写相等时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
client_brand_is

必须与本条目 ID 完全一致。

示例 client_brand_is
brand客户端品牌必填
类型
文本
默认
无

也可写入 value，例如 vanilla、fabric。

示例 fabric
READY TO USE

完整 YAML 示例

type: client_brand_is
brand: "fabric"
玩家状态扩展实现

延迟低于

ping_below

玩家当前延迟低于阈值时通过。

什么时候通过

玩家当前延迟低于阈值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
ping_below

必须与本条目 ID 完全一致。

示例 ping_below
value最大延迟必填
类型
数字或表达式
默认
0

单位为毫秒。

示例 80
READY TO USE

完整 YAML 示例

type: ping_below
value: "80"
玩家状态扩展实现

延迟高于

ping_above

玩家当前延迟高于阈值时通过。

什么时候通过

玩家当前延迟高于阈值时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
ping_above

必须与本条目 ID 完全一致。

示例 ping_above
value最小延迟必填
类型
数字或表达式
默认
0

单位为毫秒。

示例 150
READY TO USE

完整 YAML 示例

type: ping_above
value: "150"
环境与区域扩展实现

WorldGuard 允许附魔

worldguard_flag_allowed

当前位置通过 FotiaEnchantment 的 WorldGuard 附魔标志检查时通过。

什么时候通过

当前位置通过 FotiaEnchantment 的 WorldGuard 附魔标志检查时通过。

判断对象

读取玩家当前位置。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
worldguard_flag_allowed

必须与本条目 ID 完全一致。

示例 worldguard_flag_allowed
READY TO USE

完整 YAML 示例

type: worldguard_flag_allowed
玩家状态扩展实现

拥有黑名单豁免权限

blacklist_exempt

玩家拥有配置的黑名单豁免权限节点时通过。

什么时候通过

玩家拥有配置的黑名单豁免权限节点时通过。

判断对象

读取触发这条附魔的玩家状态。

CONFIG FIELDS

配置字段逐项说明

只填写你需要的可选字段；必填字段不能省略。
字段类型 / 默认值怎么填写
type能力 ID必填
类型
固定文本
默认
blacklist_exempt

必须与本条目 ID 完全一致。

示例 blacklist_exempt
permission豁免权限可选
类型
文本
默认
fotia.enchantment.blacklist.exempt

也可写入 value。

示例 fotia.enchantment.blacklist.exempt
READY TO USE

完整 YAML 示例

type: blacklist_exempt
permission: "fotia.enchantment.blacklist.exempt"