Commands/effect

Adds or removes status effects on players and other entities.

Syntax[]

• Java Edition

effect clear [<targets>] [<effect>]

Removes an effect.

effect give <targets> <effect> [<seconds>] [<amplifier>] [<hideParticles>]

Gives an effect.

effect give <targets> <effect> infinite [<amplifier>] [<hideParticles>]

Gives an effect with infinite duration, which displays as ∞ in the GUI.

• Bedrock Edition

effect <player: target> clear

Removes all effects.

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

Gives or removes an effect.

Arguments[]

JE: <targets>: entity
BE: player: target: CommandSelector<Actor>

Specifies the target(s). In Java Edition, if not specified, defaults to the player who executes the command.

Must be a player name, a target selector or a UUID‌^{[Java Edition only]}.

JE: <effect>: resource
BE: effect: Effect: enum

Specifies the effect to be added or removed.

In Java Edition, must be an existing registered resource location in minecraft:mob_effect registry. In Bedrock Edition, must be an ID of a status effect (without namespace)

JE: <seconds>: integer
BE: seconds: int: int

Specifies the effect's duration in seconds (or in gameticks for instant_damage, instant_health, and saturation). If not specified, defaults to 30 seconds (or 1 gameticks for instant_damage, instant_health, and saturation).

Must be a 32-bit integer number. In Java Edition, it must be between 0 and 1000000 (inclusive). In Bedrock Edition, it must be between 0 and 2147483647 (inclusive), and values higher than 1000000 are treated as 1000000.

JE: <amplifier>: integer
BE: amplifier: int: int

Specifies the number of additional levels to add to the effect. If not specified, defaults to 0. Note that the first tier of a status effect (e.g. Regeneration I) is 0, so the second tier, for example Regeneration II, would be specified by an amplifier level of 1.

Must be a 32-bit integer number. And it must be between 0 and 255 (inclusive).

JE: <hideParticles>: bool
BE: hideParticles: Boolean: enum

Specifies whether the particles and the HUD indicator‌^{[Java Edition only]} of the status effect should be hidden. If not specified, defaults to false.

Must be a boolean (either true or false).

Result[]

Output[]

Note[]

In Java Edition, if a target already has a status effect with the same id, a new effect only with a longer duration or a higher amplifier can be added.

• If the new effect has a higher amplifier and a shorter duration, the original effect will be hidden.
• If the new effect has a lower amplifier and a longer duration, the new effect will be hidden.
  • If their "hideParticles" values are different, the active effect's value will be set to the specified value.
• Otherwise, the original active effect will be replaced by the new effect, without changing hidden effects.

Only if the active effect is changed does the command succeed, no matter whether the hidden effects are changed or not.

In Bedrock Edition, if a target already has the status effect, a new status effect with the same amplifier overrides the old duration if it is longer, but a new status effect with a higher amplifier overrides any previous effect.

In Bedrock Edition, no matter whether the new effect can override the original effect, "hideParticles" value is always applied.

In Bedrock Edition, if the player uses an NBT editor to get negative levels of effects, the level of the effect jumps to 255 instead.

Examples[]

• To grant a Resistance V effect to the current entity for 1 million seconds, hiding particles: effect give @s minecraft:resistance 1000000 4 true‌^{[Java Edition only]} or effect @s resistance 1000000 4 true‌^{[Bedrock Edition only]}
• To grant a Speed II effect to the nearest player for 60 seconds: effect give @p minecraft:speed 60 1‌^{[Java Edition only]} or effect @p speed 60 1‌^{[Bedrock Edition only]}
• To grant a Speed III effect to the nearest player for 60 seconds: effect give @p minecraft:speed 60 2‌^{[Java Edition only]} or effect @p speed 60 2‌^{[Bedrock Edition only]}
• To clear any Haste effects from all players: effect clear @a minecraft:haste‌^{[Java Edition only]} or effect @a haste 0‌^{[Bedrock Edition only]}
• To clear all effects from all zombies: effect clear @e[type=zombie]‌^{[Java Edition only]} or effect @e[type=zombie] clear‌^{[Bedrock Edition only]}

History[]

References[]