本条目介绍的是命令。关于Minecraft中一种特殊的图形效果，请见“粒子”。

particle

需要的权限等级

Java版：2基岩版：1

限制条件

启用作弊[仅基岩版]

在指定位置显示粒子效果。

在基岩版中，不少原版粒子效果需要接收特定的上下文或变量才可正常显示，而/particle命令无法向其传递上下文或变量，因此某些粒子效果在游戏中无法通过/particle命令正常生成。而在ScriptAPI中则可以在调用时提供上下文。

目录

1 语法

2 参数

2.1 粒子所接收的参数

3 结果

4 输出

5 示例

6 历史

7 参考

8 导航

语法[编辑 | 编辑源代码]

Java版

particle []

particle [force|normal] []

基岩版

particle [position: x y z]

参数[编辑 | 编辑源代码]

JE：：particleBE：effect: string：basic_string

指定要生成的粒子的粒子类型。

在Java版中，必须为一个粒子。对于有粒子选项的粒子类型，格式为<粒子类型命名空间ID>{<粒子选项>}，其粒子选项必须写为SNBT格式。对于没有粒子选项的粒子类型，格式只需为<粒子类型命名空间ID>。关于粒子选项的详细数据格式和相关示例，可参见粒子数据格式 § 粒子选项。在基岩版中，必须为单个词或双引号（"）括起的字符串，引号内的字符可以使用\进行转义。其内容应为一个粒子的命名空间ID，且命名空间前缀不可省略。

JE：：vec3BE：position: x y z：CommandPositionFloat

指定要显示粒子的位置。如果未指定，默认为命令的执行位置。

必须为三维坐标，元素为双精度[仅Java版]或单精度[仅基岩版]浮点数。允许相对坐标（~ ~ ~）或局部坐标（^ ^ ^）。

JE: ：integer

指定创造的粒子的数量。0值有特殊作用，见下文。

必须为 32位整数。且必须大于等于0。

JE: ：vec3——必须为三维坐标，元素为双精度浮点数。允许相对坐标（~ ~ ~）或局部坐标（^ ^ ^）。

JE: ：float——必须为 单精度浮点数。且必须大于等于0.0。

和这两个参数决定粒子的生成位置以及要传给粒子的参数（见下表粒子所接收的参数）。根据是否为0，这两个参数有不同的含义。

若为0，则在处生成单个粒子，将中的三个值分别乘上后作为三个参数传入粒子。

这意味着对于大部分接收参数的粒子，设为0时，则令粒子从往的方向移动。

若非0，则在随机位置生成指定数量的粒子，粒子在X、Y、Z方向上都服从正态分布。各方向上的正态分布以所指定的坐标为均值，意味着粒子更有可能在靠近的位置出现。各方向上的正态分布以为标准差（例如1 1 1表示在X、Y、Z轴上都是标准正态分布，意味着粒子约有99.7%的概率位于以为中心6×6×6的矩形区域内，2 2 2则意味着粒子约有99.7%的概率位于以为中心12×12×12的矩形区域内）。可以使用负数，但效果与正数相同（例如-1 -1 -1与1 1 1效果相同）。要传入粒子的参数为三个独立的随机值，这三个随机值也服从正态分布，其均值为0，标准差为。

可以使用相对坐标与局部坐标，将会被转换为绝对坐标后使用绝对坐标的值，因此一般无实际用途。

若未指定，默认为0 0 0，默认为0。

JE: force|normal

指定显示模式。可为force或normal。设置为normal将给32.0格以内的玩家显示粒子，若视频设置中的“粒子效果”选项设为“最少”则可能不会显示（取决于粒子类型，有些粒子类型还会显示）。设置为force将给512.0格内的玩家显示粒子，并且即使玩家将“粒子效果”选项设为“最少”也能够看到此粒子。默认为normal。

JE: ：entity

限制能看到粒子效果的玩家。

必须为玩家名、目标选择器或UUID。且要求目标选择器为玩家类型，若不是则此命令将无法解析。

粒子所接收的参数[编辑 | 编辑源代码]

本段落所述内容仅适用于Java版。

接收参数的大多数粒子类型都将参数用于改变初速度，粒子初速度的单位为m/tick（方块/游戏刻）。

注意，虽然可以使用参数指定初速度，但不同粒子类型有不同的阻力、重力，有的粒子类型还有碰撞检测，因此初速度相同的情况下，不同粒子类型的运动轨迹可能不一致。

ID

注释

参数

bubble_pop

—

接收三个参数，直接作为初速度。

dragon_breath

end_rod

firework

fishing

glow_squid_ink

sculk_charge

需要幽匿块充能粒子选项。

squid_ink

—

totem_of_undying

electric_spark

接收三个参数，三个参数都乘上0.25后作为初速度。

scrape

接收三个参数，三个参数都乘上0.01后作为初速度。

bubble

寿命为8到40游戏刻之间的随机数，所在位置不是水方块会立即消失。

接收三个参数，三个参数分别加上随机偏差，结果再都乘以0.2，计算结果作为初速度。

bubble_column_up

—

crit

接收三个参数，三个参数都乘以0.4再分别加上随机偏差后作为初速度。

damage_indicator

enchanted_hit

cloud

当玩家在附近时会迅速下落。[1]

接收三个参数，三个参数分别加上随机偏差后作为初速度。

flame

—

item

需要物品粒子选项。

large_smoke

—

poof

sculk_soul

small_flame

smoke

sneeze

当玩家在附近时会迅速下落。[1]

snowflake

—

soul

soul_fire_flame

spit

white_smoke

campfire_cosy_smoke

运动过程中，水平方向有轻微摆动。

接收三个参数，三个参数中第一、三个参数直接作为X、Z轴初速度，第二个参数加上正的随机偏差值后，作为Y轴初速度。

campfire_signal_smoke

trial_spawner_detection

—

trial_spawner_detection_ominous

block

需要方块粒子选项。

接收三个参数，指定初速度方向。参数绝对值越小，方向越随机；绝对值越大，方向越稳定。初速度大小为随机值，不受参数影响。

composter

—

dolphin

dust

需要粉末粒子选项。

dust_color_transition

需要粉末颜色过渡选项。

egg_crack

—

happy_villager

mycelium

sculk_charge_pop

effect

接收三个参数，其中第二个参数主要影响水平方向上的初速度，整体上来说，第二个参数绝对值越大，水平初速度越小。第一、三个参数只有在都为0时才有影响，二者都为0时，X和Z轴初速度都乘上0.1。

entity_effect

需要颜色粒子选项。

glow

—

infested

instant_effect

raid_omen

trial_omen

witch

vault_connection

粒子在相对于粒子生成位置的一个相对位置处出现。不会移动。寿命为30到40游戏刻之间的随机数，寿命经过四分之一时，逐渐变半透明。

接收三个参数，作为粒子出现的相对位置。

enchant

粒子在相对于粒子生成位置的一个相对位置处出现，并作为起点，以粒子生成位置的下方1.2格处为终点，在寿命内由起点运动到终点。无碰撞检测。

nautilus

ominous_spawning

粒子在相对于粒子生成位置的一个相对位置处出现，并作为起点，以粒子生成位置为终点，在寿命内由起点运动到终点。无碰撞检测。

portal

粒子在相对于粒子生成位置的一个相对位置处的上方一格处出现，并作为起点，以粒子生成位置为终点，在寿命内由起点运动到终点。无碰撞检测。

splash

寿命为8到40游戏刻之间的随机数，落在地面或落入液体会立即消失。

接收三个参数。如果第二个参数为0，而第一、三个参数中有非0值，则水平初速度为0，垂直初速度为0.1。否则初速度随机。

dust_pillar

需要方块粒子选项。

接收第二个参数，加上一个随机偏差后作为Y轴初速度。第一、三个参数无作用。水平方向有较小的随机初速度，不受参数影响。

dust_plume

—

接收三个参数，作为速度叠加在初速度上。默认初速度朝斜上方，垂直初速度较大，水平初速度较小。三个参数会叠加到默认初速度上作为实际的初速度。

note

接收第一个参数。其小数部分（x−floor(x)）对应音符盒的使用次数，得到对应的音符颜色。

reverse_portal

初速度为0，速度越来越快，最终在寿命到达时达到指定速度。

接收三个参数，作为运动的最终速度。

wax_off

—

接收三个参数，用以计算初速度。三个参数乘上0.01，水平方向再乘0.5，计算结果作为初速度。

wax_on

explosion

不会移动。

接收一个参数，影响粒子的缩放大小，粒子大小为2−x，其中x为此参数。参数为2时粒子最小，不可见。大于2时粒子纹理翻转。例如，为4时与为0时大小相等，纹理相反。

sweep_attack

不会移动。

接收一个参数，影响粒子的缩放大小，粒子大小为1−x/2，其中x为此参数。参数为2时粒子最小，不可见。大于2时粒子纹理翻转。例如，为4时与为0时大小相等，纹理相反。

block_marker

不会移动。需要方块粒子选项。

不接收参数。

falling_dust

需要方块粒子选项。

不接收参数。

shriek

延迟之后出现。垂直向上运动。需要尖啸粒子选项。

不接收参数。

vibration

在寿命内从生成位置移动到目标位置。需要振动粒子选项。

不接收参数。

current_down

寿命为30游戏刻到90游戏刻间的一个随机数。所在的方块中不是水或不含水会立即消失。

不接收参数。

其他粒子类型

—

不接收参数。

结果[编辑 | 编辑源代码]

命令触发条件Java版基岩版

任意命令不完整或参数未正确指定 无法解析 无法解析

未能选中至少一个在线的玩家 执行失败 N/A

所有指定的玩家都远于粒子32.0格（normal模式）或512.0格（force模式） 执行成功

不符合以上所有条件执行成功

输出[编辑 | 编辑源代码]

命令版本条件成功次数/execute store success .../execute store result ...

任意Java版执行失败000

执行成功11在命令执行维度中，在粒子32.0格（normal模式）或512.0格（force模式）以内的玩家数量

基岩版执行失败0N/AN/A

执行成功1N/AN/A

示例[编辑 | 编辑源代码]

在向东10米处创造一个静止的巨型爆炸粒子：particle explosion_emitter ~10 ~ ~ 0 0 0 0 0[仅Java版]

在向东5米处创造一个普通的龙息粒子：particle minecraft:dragon_breath_fire ~5 ~ ~ [仅基岩版]

历史[编辑 | 编辑源代码]

Java版1.814w04a加入了/particle命令。14w29a加入了force参数。1.915w32c范围限制提高到了32个方块。15w49a为/particle命令加入了player和params参数。1.1317w47a各种粒子类型被重命名。18w03a加入了/particle 作为该命令的一个简写。1.20.524w12a使用命令生成entity_effect粒子时需要使用颜色参数。pre1现在，命令中使用粒子选项。

此前的粒子参数

这些参数位于与之间，可能存在多个。

block、block_marker和falling_dust需要1个方块命名空间ID（以及可选的方块状态）作为参数。例如：/particle block minecraft:grass_block[snowy=true]会创建一个覆盖雪的草方块的粒子。

dust共需要4个参数。前三个是颜色通道参数，分别代表红色、绿色和蓝色，应在0和1之间（不在[0,1]内的取小数部分）；第四个参数表示该粒子的大小。例如：/particle dust 1.0 0.5 0.5 1.0会创建一个大小为1.0的粉色粒子。

dust_color_transition共需要7个参数。前三个是初始颜色通道参数，分别代表红色、绿色和蓝色；第四个参数表示该粒子的大小；后三个是最终颜色通道参数，格式与前3个相同。粒子的颜色通道参数会由初始参数渐变为最终参数（不在[0,1]内的取小数部分）（例如：/particle dust_color_transition 1.0 0.5 0.5 1.0 1.0 0.0 0.0会创建一个大小为1.0的粉色粒子，然后该粒子在消散过程中会逐渐转变为红色。

entity_effect共需4个浮点数参数（取值范围0.0到1.0）：、​、​和​。前三个参数表示粒子的RGB颜色，第四个参数表示粒子的透明度（Alpha Channel）。