命令/effect

effect

需要的权限等级	Java版：2 基岩版：1
限制条件	启用作弊^{[仅基岩版]}

管理玩家及其他实体上的状态效果。

语法[]

Java版

effect clear [<targets>] [<effect>]

移除一个或所有效果

effect give <targets> <effect> [<seconds>] [<amplifier>] [<hideParticles>]

给予一种效果

基岩版

effect <player: target> clear

移除所有效果

effect <player: target> <effect: Effect> [seconds: int] [amplifier: int] [hideParticles: Boolean]

给予一种效果

参数[]

JE：<targets>：entity
BE：player: target：CommandSelector<Actor>

指定目标。

必须为玩家名、目标选择器或UUID^[仅Java版]。

JE：<effect>：mob_effect
BE：effect: Effect

指定给予或者需要移除的效果。必须是一个状态效果ID。在Java版，必须是字母ID，可以省略命名空间。在基岩版，必须是字母ID，没有命名空间。

JE：<seconds>：integer
BE：seconds: int：int

以秒为单位指定效果时长（也可指定infinite表示无限时长^[仅Java版]）。瞬间伤害（minecraft:instant_damage）、瞬间治疗（minecraft:instant_health）和饱和（minecraft:saturation）是仅有的三个例外，其单位是游戏刻。必须在0至1,000,000^[仅Java版]或0至2,147,483,647之间（仅在2,040,109,465或以下时才会生效。如果更大，虽然会提示成功，但不会产生效果）^{[仅基岩版]}。若未指定，默认为30秒（对上述三个例外为1游戏刻）。

JE：<amplifier>：integer
BE：amplifier: int：int

指定效果的放大倍率。必须在0至255之间（含）。若未指定，默认为0。注意，状态效果的第1级（如生命恢复I）对应为0倍率，因此第2级状态效果（如生命恢复II）应指定倍率为1。部分效果没有强弱之分，如夜视。

JE：<hideParticles>：bool
BE：hideParticles: Boolean：bool

指定是否隐藏状态效果的粒子，以及游戏界面上的状态效果指示图标^[仅Java版]。必须为true或false。若未指定，默认为false。

效果[]

命令	触发条件	Java版	基岩版
任意	参数未正确指定	无法解析	无法解析
任意	`<targets>`或`player: target`无法解析为一个或多个实体（若为玩家名则必须在线）	执行失败	执行失败
`/effect give ...`	指定实体满足以下任意条件：该实体免疫此效果。该实体拥有`hideParticles`属性相同的相同效果，且赋予的效果无更高等级或更长时长。		执行成功
`/effect clear`	`<targets>`未指定且命令执行者不是玩家		N/A
`/effect clear ... /effect ... clear`	没有效果可从实体身上移除		执行失败
任意	执行成功时	移除或给予实体指定效果

输出[]

命令	版本	条件	成功次数	`/execute store success ...`	`/execute store result ...`
任意	Java版	失败时	0	0	0
	Java版	成功时	1	1	被给予或移除效果的实体数
	基岩版	失败时	0	N/A	N/A
	基岩版	成功时	被给予或移除效果的实体数	N/A	N/A

示例[]

给予自己60秒的迅捷II效果：/effect @s speed 60 1^{[仅基岩版]}或effect give @s speed 60 1^[仅Java版]
给予自己60秒的速度III效果：/effect @s speed 60 2^{[仅基岩版]}或effect give @s speed 60 2^[仅Java版]
从所有玩家身上清除任何效果：effect @a clear^{[仅基岩版]}或effect clear @a^[仅Java版]
从所有玩家身上清除任何急迫效果：/effect clear @a minecraft:haste^[仅Java版]或effect @a minecraft:haste 0^{[仅基岩版]}
清除所有僵尸身上的所有效果：/effect clear @e[type=zombie]^[仅Java版]或effect @e[type=zombie] clear^{[仅基岩版]}

历史[]

Java版
1.5	13w09b	加入了`/effect`命令。
1.6.1	pre	加入了`clear`参数。
1.8	14w06a	加入了`hideParticles`参数。
1.13	17w45a	更改了语法。
1.19.4	23w05a	现在`[<seconds>]`参数可以被指定为`infinite`，给予无限时长的效果。
携带版
1.0.5	1.0.5.0	加入了`/effect`命令。
1.0.5	1.0.5.3	`/effect`命令中的`amplifier`不再接受负数值。

命令

语言

Minecraft Wiki