管理玩家及其他实体上的状态效果。
语法
- Java版
effect clear <玩家> [效果]
(移除一个或所有效果)effect give <玩家> <效果> [秒数] [强度] [隐藏粒子]
(给予一种效果)
- 基岩版
effect <玩家:目标> clear
(移除所有效果)effect <玩家:目标> <效果:效果> [秒数:整数] [强度:整数] [隐藏粒子:布尔值]
(给予一种效果)
参数
玩家
(基岩版:玩家:目标
)
- 指定目标。必须是一位玩家的名字或目标选择器(允许使用
@e
选择非玩家实体)。
效果
(基岩版:效果:效果
)
- 指定给予或者需要移除的效果。必须是一个状态效果ID。在Java版,必须是字母ID,可以省略命名空间。在基岩版,必须是字母ID,没有命名空间。
秒数
(基岩版:秒数:整数
)(可选)
- 以秒为单位指定效果时长。必须在1至1,000,000
[仅Java版]或1至2,147,483,647之间(仅在2,040,109,465或以下时才会生效。如果更大,虽然会提示成功,但不会产生效果) [仅基岩版]。若未指定,默认为30秒。若输入的时长过大(超过1638秒),则会在查看效果的时候看到时长为“**:**”,但是计时仍正常进行 [仅Java版]。
强度
(基岩版:强度:整数
)(可选)
- 指定效果的额外等级。必须在0至255之间(含)。若未指定,默认为0。注意,状态效果的第一级(如生命恢复 I)对应为0,因此第二级状态效果,如生命回复 II,应指定强度为1。部分效果没有强度之分,如夜视。
隐藏粒子
(基岩版:隐藏粒子:布尔值
)
效果
以下情况会导致命令执行失败:
若成功:
clear
— 从目标身上清除所有状态效果。give
或效果 — 给目标添加状态效果。如果一个目标已经拥有该状态效果,同等级的新状态效果仅在拥有更长的持续时覆盖旧的持续时间,但更高等级的新状态效果将会覆盖之前的持续时间。如果秒数设为0,则会取消指定的效果。
示例
- 给予自己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.0.5 | alpha 1.0.5.0 | 加入了/effect 命令。 | |||
alpha 1.0.5.3 | /effect 命令中的amplifier 不再接受负数值。 |