手冊:/effect

effect

指令

權限等級

1

指令旗標

用法旗標

普通指令（0）

可見性旗標

可見（0）

同步旗標

同步指令（0）

執行旗標

允許執行（0）

型別旗標

無型別（0）

作弊旗標

作弊指令（0）

遊戲內描述

“

加入或刪除狀態效果。

”

限制條件

無

/effect指令用於給予或移除玩家或實體的狀態效果。

語法

移除狀態效果

effect <player: target> clear

加入狀態效果

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

參數

player

target型別，指定對哪個實體進行操作。

effect

Effect型別，指定加入哪個狀態效果。必須是一個有效的狀態效果ID。

seconds

int型別，指定狀態效果的持續時長，單位為秒。

需要注意的是，有三個例外是瞬時狀態效果，單位為遊戲刻（0.05秒），這三個例外分別是：立即治療instant_health、立即傷害instant_damage、飽食saturation

若未指定，預設為30秒（或遊戲刻）。

接受0~2,147,483,647之間的整數，但實際上最高只會給予1,000,000秒的效果。

amplifier

int型別，指定狀態效果的等級。接受0~255之間的值。若未指定，預設為0。

需要指出的是，給予的實際等級應該是指定等級+1。例如，如果指定為2，則給予3級的效果等級；預設的0則指代1級。

部分效果例如夜視、緩降、抗火沒有等級之分，它們的效果與等級無關。

hideParticles

Boolean型別，指定是否顯示狀態效果的粒子。如不指定則預設為false（即顯示粒子效果）。和Java版不同，在基岩版中這個選項調整為false並不能隱藏狀態效果的圖示。

效果

指令	觸發條件	執行結果
任意	參數未正確指定	失敗
	player: target無法解析為一個或多個實體（若為玩家名則必須線上）
	沒有狀態效果可以清除
	執行成功	給予或移除實體的狀態效果

輸出

指令	執行結果	成功次數增量
任意	失敗	0
	成功	給予或移除效果的實體數

範例

/effect @a clear - 移除所有玩家的狀態效果。

/effect @e[type=zombie] strength - 給予殭屍力量效果（30秒，1級，顯示粒子效果）。

/effect @a instant_health 5 2 true - 給予所有玩家5遊戲刻（0.25秒）立即治療III，且隱藏粒子效果。

/effect @a haste 10000 1 false - 給予所有玩家10000秒的挖掘加速II狀態效果，且顯示粒子效果。

歷史

攜帶版
1.0.5		1.0.5.0			加入了/effect指令。
		1.0.5.3			指令中的amplifier不再接受負數值。

畫廊

• 

  指令/effect的說明頁面。

• 

  指令/effect @a strength 10000 2 true的執行效果。