/particle
来源:Commands/particle;原文修订 ID:3846970。
权限等级:Java 版为 2,基岩版为 1;基岩版需要启用作弊。
创建粒子。
语法
Java 版
particle <name> [<pos>]。particle <name> <pos> <delta> <speed> <count> [force|normal] [<viewers>]。
基岩版
particle <effect: string> [position: x y z]
参数
name(particle)/effect: string(basic_string):要创建的粒子类型。pos(vec3)/position: x y z(CommandPositionFloat):创建粒子的位置,省略时默认为命令执行位置。- 仅 Java 版
count(integer):创建的粒子效果数量,整数且不小于 0。为 0 时的行为见下文。 - 仅 Java 版
delta(vec3)和speed(float,不小于 0.0):决定粒子创建位置及传给粒子的额外参数。两者含义取决于count是否为 0。
delta、speed 和 count
当 count=0 时,只在 <pos> 创建单个粒子。将 <delta> 的三个值分别乘以 <speed>,再作为三个参数传入粒子。对于大多数接受参数的粒子,<delta> 相当于运动向量,<speed> 是乘数,粒子便沿 <delta> 方向运动。
当 count 非 0 时,指定数量的粒子创建于随机位置。X、Y、Z 三个方向的位置分别服从正态分布,均值为 <pos> 对应分量,因此越接近 <pos> 越容易生成;标准差为 <delta> 对应分量。例如 1 1 1 表示三轴均为标准正态分布,粒子有 99.7% 概率生成在以 <pos> 为中心的 6 × 6 × 6 长方体内;2 2 2 对应 12 × 12 × 12。<delta> 接受负数,但效果与对应正数相同,例如 -1 -1 -1 与 1 1 1 相同。传入粒子的各额外参数也服从均值为 0、标准差为 <speed> 对应值的正态分布。
<delta> 接受相对坐标和局部坐标,但会转换为绝对坐标,因此这两种坐标在此通常没有用途。省略时 <delta> 默认为 0 0 0,<speed> 默认为 0。
显示模式与观察者(仅 Java 版)
force|normal 指定显示模式,默认为 normal:
normal:将粒子发送给距离严格小于 32.0 方块的玩家。视频设置的“粒子”设为“最少”时可能不显示,具体取决于粒子类型;某些粒子仍显示。force:将粒子发送给距离严格小于 512.0 方块的玩家。即使“粒子”设为“最少”也始终显示。
viewers(entity,多个玩家):控制哪些玩家看到粒子,而不是向粒子可视范围内所有玩家显示。
粒子类型的额外参数
主条目:粒子格式。原文将此节标记为待扩充。
结果
命令不完整或任意参数不正确时无法解析。Java 版目标未能解析到在线玩家时失败;全部目标距粒子不小于正常模式的 32.0 方块或强制模式的 512.0 方块时,Java 版失败、基岩版成功。其他情况成功。
输出
Java 版失败时成功次数、success、result 均为 0;成功时成功次数和 success 为 1,result 为能看到粒子的玩家数量。基岩版失败成功次数为 0,成功为 1。
示例
- 在东面 10 方块处创建一个静止的巨大爆炸粒子:Java 版
/particle minecraft:explosion_emitter ~10 ~ ~;基岩版/particle minecraft:huge_explosion_emitter ~10 ~ ~。 - Java 版利用粒子格式参数创建大颗粒紫色尘埃:
/particle minecraft:dust{color:[1, 0, 1], scale:4} ~ ~ ~ 1 1 1 1 10。 - 利用
<delta>和<speed>传入参数,使单个粒子向下运动(count必须为 0):/particle minecraft:white_smoke ^ ^1 ^2 0 -1 0 0.1 0。 - 将同一命令的
count改为非 0 后,<delta>改为决定粒子分布,产生垂直粒子云:/particle minecraft:white_smoke ^ ^1 ^2 0 -1 0 0.1 10。
外部链接
- Microsoft Learn:/particle 命令(2023-10-11)。
中文翻译/改编自 Minecraft Wiki 原条目,原文作者可由页面历史查看;译文遵循 CC BY-NC-SA 3.0(署名、非商业性使用、相同方式共享)。