管理玩家及其他实体上的状态效果。
- 语法
- Java版
effect clear <玩家> [<效果>]
(移除一个或所有效果)effect give <玩家> <效果> [<秒数>] [<强度>] (true|false)
(给予一种效果)
- 基岩版
effect <玩家:目标> clear
(移除所有效果)effect <玩家:目标> <效果:效果> [秒数:整数] [强度:整数] [true|false]
(给予一种效果)
- 参数
- 玩家(基岩版:玩家:目标)
- 指定目标。必须是一位玩家的名字或目标选择器(允许使用
@e
选择非玩家实体)。
- 指定目标。必须是一位玩家的名字或目标选择器(允许使用
- 效果(基岩版:效果:效果)
- 指定给予或者需要移除的效果。必须是一个状态效果ID。在Java版,必须是字母ID,可以省略命名空间。在基岩版,必须是字母ID,没有命名空间。
- 秒数(基岩版:秒数:整数)(可选)
- 以秒为单位指定效果时长。必须在0至2147483647之间(含)(在Java版不能为0)。若未指定,默认为30秒。若输入的时长过大(超过1638秒),则会在查看效果的时候看到时长为“**:**”,但是计时仍正常进行
[仅Java版]。
- 以秒为单位指定效果时长。必须在0至2147483647之间(含)(在Java版不能为0)。若未指定,默认为30秒。若输入的时长过大(超过1638秒),则会在查看效果的时候看到时长为“**:**”,但是计时仍正常进行
- 强度(基岩版:强度:整数)(可选)
- 指定效果的额外等级。必须在0至255之间(含)。若未指定,默认为0。注意,状态效果的第一级(如生命恢复 I)对应为0,因此第二级状态效果,如生命回复 II,应指定强度为1。部分效果没有强度之分,如夜视。
- 效果
- 若参数指定不正确,或当玩家不是有效实体(指定名字的玩家必须在线),或当秒数被指定为0而目标没有该效果时,或当在
clear
模式下没有该效果可以移除,或目标实体对效果免疫时失败。
- 若成功:
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 不再接受负数值。 |