命令/infobox
effect命令管理玩家及其他实体上的状态效果。
- 语法
- Java版
effect clear <玩家> [<效果>](移除一个或所有效果)effect give <玩家> <效果> [<秒数>] [<强度>] (true|false)(给予一种效果)
- 基岩版
effect <玩家:目标> clear(移除所有效果)effect <玩家:目标> <效果:效果> [秒数:整数] [强度:整数] [true|false](给予一种效果)
- 参数
- 玩家(基岩版:玩家:目标)
- 指定目标。必须是一位玩家的名字或目标选择器(允许使用
@e选择非玩家实体)。
- 指定目标。必须是一位玩家的名字或目标选择器(允许使用
- 效果(基岩版:效果:效果)
- 指定给予或者需要移除的效果。必须是一个状态效果ID。在Java版,必须是字母ID,可以省略命名空间。在基岩版,可以是字母ID或数字ID,没有命名空间。
- 秒数(基岩版:秒数:整数)(可选)
- 以秒为单位指定效果时长。必须在0至1000000之间(含)(在Java版不能为0)。若未指定,默认为30秒。若输入的时长过大(如9999),则会在查看效果的时候看到时长为∞,但是计时仍正常进行。
- 强度(基岩版:强度:整数)(可选)
- 指定效果的额外等级。必须在0至255之间(含)。若未指定,默认为0。注意,状态效果的第一级(如生命恢复 I)对应为0,因此第二级状态效果,如生命回复 II,应指定强度为1。部分效果没有强度之分,如夜视。
- 效果
- 若参数指定不正确,或当玩家不是有效实体(指定名字的玩家必须在线),或当秒数被指定为0而目标没有该效果时,或当在
clear模式下没有该效果可以移除,或目标实体对效果免疫时失败。
- 若成功:
clear— 从目标身上清除所有状态效果。give或效果 — 给目标添加状态效果。如果一个目标已经拥有该状态效果,同等级的新状态效果仅在拥有更长的持续时覆盖旧的持续时间,但更高等级的新状态效果将会覆盖之前的持续时间。如果秒数设为0,则会取消指定的效果。
- 示例
- 给予自己60秒的速度 II效果:
effect @s 1 60 1[仅基岩版]或 effect give @s speed 60 1[仅Java版] - 给予自己60秒的速度 III效果:
effect @s 1 60 2[仅基岩版]或 effect give @s speed 60 2[仅Java版] - 从所有玩家身上清除任何效果:
effect @a clear[仅基岩版] - 从所有玩家身上清除任何急迫效果:
effect clear @a minecraft:haste[仅Java版] - 清除所有僵尸身上的所有效果:
effect clear @e[type=zombie][仅Java版]
历史
| Java版 | |||||
|---|---|---|---|---|---|
| 1.5 | 13w09b | 加入了/effect命令。 | |||
| 1.6.1 | pre | 加入了clear参数。 | |||
| 1.8 | 14w06a | 加入了hideParticles参数。 | |||
| 1.13 | ? | 更改了语法 | |||
| 携带版 | |||||
| 1.0.5 | alpha 1.0.5.0 | 加入了/effect命令。 | |||
| alpha 1.0.5.3 | /effect命令中的amplifier不再接受负数值。 | ||||