战斗类动作

potion

给玩家施加药水效果。

action.potion(选择器, 药水类型, 持续时间, 等级)
action.potion(选择器, 药水类型, 持续时间, 等级, 粒子=bool, 图标=bool)

参数	类型	说明
选择器	String	目标玩家
药水类型	String	Bukkit PotionEffectType 名称
持续时间	String	如 10s、30s
等级	Int	药水等级（从 0 开始）
粒子	Boolean	是否显示粒子，默认 true
图标	Boolean	是否显示图标，默认 true

action.potion('@all', 'SPEED', '30s', 1)
action.potion('@trigger', 'REGENERATION', '10s', 2, 'particle=false')

别名：apply_potion

clear_potion

清除玩家的药水效果。

action.clear_potion(选择器)
action.clear_potion(选择器, 药水类型)

参数	类型	说明
选择器	String	目标玩家
药水类型	String	可选，不填则清除全部

action.clear_potion('@all')
action.clear_potion('@trigger', 'SLOW')

别名：remove_potion

damage

对玩家造成伤害。

action.damage(选择器, 伤害值)
action.damage(选择器, 伤害值, 原因=DamageCause)

参数	类型	说明
选择器	String	目标玩家
伤害值	Double	伤害量
原因	String	可选，Bukkit DamageCause 枚举名

action.damage('@all', 4)
action.damage('@trigger', 10, 'cause=FIRE')

absorption

设置玩家的吸收伤害（黄色血量）。

action.absorption(选择器, 数值)
action.absorption(选择器, 数值, 模式=set)

参数	类型	说明
选择器	String	目标玩家
数值	Double	护盾值
模式	String	set（设置）/ add（叠加），默认 set

action.absorption('@all', 10)
action.absorption('@trigger', 5, 'mode=add')

别名：absorb

velocity

对玩家施加速度向量（击退/弹射）。

action.velocity(选择器, x, y, z)
action.velocity(选择器, x, y, z, 叠加=bool)

参数	类型	说明
选择器	String	目标玩家
x / y / z	Double	各方向速度分量
叠加	Boolean	是否叠加到当前速度，默认 true

action.velocity('@trigger', 0, 1.5, 0)

别名：knockback

set_health

直接设置玩家生命值。

action.set_health(选择器, 数值)
action.set_health(选择器, 数值, 模式=set)

参数	类型	说明
选择器	String	目标玩家
数值	Double	血量数值
模式	String	set / add / subtract，默认 set

action.set_health('@all', 20)
action.set_health('@trigger', 5, 'mode=add')

burn

设置玩家着火时间。

action.burn(选择器)
action.burn(选择器, 持续时间)

参数	类型	说明
选择器	String	目标玩家
持续时间	String	如 5s、100t，默认 5 秒

action.burn('@trigger', '3s')

别名：fire