管理玩家及其他實體上的狀態效果。
語法[]
- 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>
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版 | 基岩版 |
---|---|---|---|
任意 | 參數未正確指定 | 無法解析 | 無法解析 |
<targets> 或player: target 無法解析為一個或多個實體(若為玩家名則必須線上) | 執行失敗 | 執行失敗 | |
/effect give ... | 指定實體滿足以下任意條件:
| 執行成功 | |
/effect clear | <targets> 未指定且指令執行者不是玩家 | N/A | |
/effect clear ... | 沒有效果可從實體身上移除 | 執行失敗 | |
任意 | 執行成功時 | 移除或給予實體指定效果 |
輸出[]
指令 | 版本 | 條件 | 成功次數 | /execute store success ... | /execute store result ... |
---|---|---|---|---|---|
任意 | Java版 | 失敗時 | 0 | 0 | 0 |
成功時 | 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.3 | /effect 指令中的amplifier 不再接受負數值。 |
語言