# MC 指令生成器 | OCEAN

粒子名称： |  |  |
坐标： |  |  |
移动坐标： |  |  |
移动速度： |
粒子数量： |
可视距离： | 32格 256格
生成指令： |

vx vy vz：移动向量（1 = 8 m(格)）

无需将所有单元格都输入，为空的单元格将会启用默认值，您无需担心

(无需装载任何 mod)

模式： |  |  |

粒子名称： |
坐标： |  |  |
粒子颜色(rgba)： |
移动坐标： |  |  |
生成范围： |  |  |
数量： |
生命周期： |

速度表达式：

- 无速度

  null

- 漂浮

  vy=0.1

- 随机移动

  (vx,vy,vz)=((random(),random(),random())-0.5)*t/100

- RGB变色

  cr=sin(t/7)/2+0.5;cg=sin(t/5)/2+0.5;cb=sin(t/3)/2+0.5

- 旋转

  a=0.05;(vx,,vy,,vz)=(-sin(a),0,-cos(a),,0,1,0,,cos(a),0,-sin(a))*(x*2*sin(a),,0.1,,z*2*sin(a))

生成指令： |

粒子名称： |
坐标： |  |  |
粒子颜色(rgba)： |
移动坐标： |  |  |
定义域（t）： |  |

表达式：

- 一次函数

  x=t;y=t

- 二次函数

  x=t;y=t^2

- 三角函数

  x=t;y=sin(t)

间隔密度： |
生长动画： | 关 |
存在时间(t)： |

速度表达式：

- 无速度

  null

- 漂浮

  vy=0.1

- 随机移动

  (vx,vy,vz)=((random(),random(),random())-0.5)*t/100

- RGB变色

  cr=sin(t/7)/2+0.5;cg=sin(t/5)/2+0.5;cb=sin(t/3)/2+0.5

- 旋转

  a=0.05;(vx,,vy,,vz)=(-sin(a),0,-cos(a),,0,1,0,,cos(a),0,-sin(a))*(x*2*sin(a),,0.1,,z*2*sin(a))

生成指令： |

粒子名称： |
坐标： |  |  |
粒子颜色(rgba)： |
移动坐标： |  |  |
定义域（t）： |  |

表达式：

- 圆

  dis=1;s1=0;s2=t

- 球

  s1,s2,dis=t*10,t*PI/20,1

- 散点圈

  s1,s2,dis=t*10,t*PI/200,t%2+10

间隔密度： |
生长动画： | 关 |
存在时间(t)： |

速度表达式：

- 无速度

  null

- 漂浮

  vy=0.1

- 随机移动

  (vx,vy,vz)=((random(),random(),random())-0.5)*t/100

- RGB变色

  cr=sin(t/7)/2+0.5;cg=sin(t/5)/2+0.5;cb=sin(t/3)/2+0.5

- 旋转

  a=0.05;(vx,,vy,,vz)=(-sin(a),0,-cos(a),,0,1,0,,cos(a),0,-sin(a))*(x*2*sin(a),,0.1,,z*2*sin(a))

生成指令： |

粒子名称： |
坐标： |  |  |
粒子颜色(rgba)： |
移动坐标： |  |  |
生成范围： |  |  |

表达式：

- 正方体

  (abs(y)==0.5&!(abs(z) <0.5))|(abs(x)==0.5&(!(abs(z)<0.5)|!(abs(y)<0.5)))< /p>

间隔密度： |
存在时间(t)： |

速度表达式：

- 无速度

  null

- 漂浮

  vy=0.1

- 随机移动

  (vx,vy,vz)=((random(),random(),random())-0.5)*t/100

- RGB变色

  cr=sin(t/7)/2+0.5;cg=sin(t/5)/2+0.5;cb=sin(t/3)/2+0.5

- 旋转

  a=0.05;(vx,,vy,,vz)=(-sin(a),0,-cos(a),,0,1,0,,cos(a),0,-sin(a))*(x*2*sin(a),,0.1,,z*2*sin(a))

生成指令： |

粒子名称： |
坐标： |  |  |
路径： |  |
比例： |
旋转 |  |  |
空翻： |
dpb： |
移动坐标： |  |  |
生命周期： |

速度表达式：

- 无速度

  null

- 漂浮

  vy=0.1

- RGB变色

  t=t-50;x=sin(t)*t/15;y=t/5

- 随机移动

  (vx,vy,vz)=((random(),random(),random())-0.5)*t/100

- 旋转

  a=0.05;(vx,,vy,,vz)=(-sin(a),0,-cos(a),,0,1,0,,cos(a),0,-sin(a))*(x*2*sin(a),,0.1,,z*2*sin(a))

生成指令： |

清除粒子： |  |
清除缓存： |  |

概述 | 转速（rev） | 半径（r） | 初始角（ir）
--- | --- | --- | ---
父： |  |  |
子1： |  |  |
子2： |  |  |
子3： |  |  |
子4： |  |  |
子5： |  |  |
子6： |  |  |
子7： |  |  |
子8： |  |  |

### 指令语法格式

/particle [粒子名] x y z vx vy vz [扩散速度] [粒子数量] [可视距离]

未输入的单元格将启用系统默认值，您无需每一个都输入。

命令输出窗口

注：使用 colorBlock 指令前，请安装 colorBlock模组，否则无效

### 目录

- 粒子名称
- 案例
- 自编教程 ＞
- 编程与 mc
- 下载

- 1. 搭建依赖环境
- 2. 尝试写第一个实例
- 3. 函数概念
- 4. 运算符号
- 5. 函数生长动画
- 6. 彩色粒子
- 7. normal (原版拓展)
- 8. parameter (直角坐标)
- 9. polarparameter (极坐标)
- 10. iamge (打印图像)
- 11. clearparticle (防卡)

JAVA 1.16.5

ColorBlock 1.16.5

### ColorBlock 教程

### video (视频)

【我的世界】ColorBlock 教程——更好的粒子

2022-12-25

【我的世界】colorBlock 教程——赋予生命的粒子

2023-1-8

【我的世界】colorBlock 教程——傅里叶级数

2023-6-13

### word (文档)

colorBlock(色块) 是一个自定义度极高的我的世界JAVA版中的一款模组，它允许玩家自定义粒子的各种属性并进行穷举显示，且具备直角坐标式、极坐标式、条件式、图像打印等功能。 以下是如何让您在游戏中使用这款 mod 的教程。

## unit 1 搭建依赖环境（基础）

### 步骤：

- 1. 安装 JAVA版我的世界
- 2. 安装 JAVA 8
- 3. 安装 colorBlock 模组

第一步：安装 JAVA版我的世界。您可以使用免费的第三方启动器 PCL2 或 HMCL 等来安装和配置您的游戏环境。

第二步：安装 JAVA 8。也许您已经在启动器中安装了 JAVA，并且能正常运行游戏，如果您在使用colorblock 指令并确保指令语法无误时出现报错日志，那很可能是因为您没有安装JAVA 8

第三步：安装 colorBlock 模组。colorblock 目前只有兼容两个版本，分别是：1.16.5 fabric 和 1.12.2 forge。

您可能会遇到的问题：

导致这种错误的可能性有：1.指令语法错误、2.未安装JAVA 8。

解决方法：

- 1.检查指令是否能运行正确语法（指令格式）的指令，如果能正常执行，说明指令语法有误。
- 2.如果指令运行不了正确语法的指令，那么您需要去安装JAVA 8 即可。

## unit 2 尝试写第一个案例（窥探门径）

### 1.0 执行二次函数命令（quadratic function）

获取命令方块

/give @s command_block

执行二次函数命令（quadratic function）

/particleex parameter minecraft:end_rod ~ ~1 ~ 1 1 1 1 0 0 0 -10.0 10.0 'x=t;y=t^2' 0.1 0 null

效果图:

参数 | 概述
--- | ---
<bgCover>minecraft:end_rod：</bgCover> | 粒子名称
<bgCover>~ ~1 ~ ：</bgCover> | 相对坐标
<bgCover>1 1 1 1：</bgCover> | 颜色（rgba）
<bgCover>0 0 0：</bgCover> | 速度（vx,vy,vz）
<bgCover>-10.0 10.0：</bgCover> | 定义域（t:time）
<bgCover>'x=t;y=t^2'：</bgCover> | 表达式
<bgCover>0.1：</bgCover> | 间隔
<bgCover>0：</bgCover> | 生命周期
<bgCover>null：</bgCover> | 运动表达式

友情提示：输入指令时，按 <bgCover>TAB键</bgCover> 能有效提高书写效率。

以上是colorblock(色块)的子命令 <bgCover>parameter</bgCover> 案例， 另有：clearcache（清除文件缓存）、clearparticle（清除粒子）、conditional（条件）、functionlist（函数列表）、group、image（图片打印）、imagematrix、normal（原版）、parameter（直角坐标）、polarparameter（极坐标） 等等。每一个子命令的语法和参数都有所不同。

## unit 3 函数概念

函数自变量是指在函数中独立变化的变量，它的取值不受其他变量的影响。在数学中，自变量通常用字母表示，如x。自变量的取值范围可以是实数集、整数集、有理数集等。 函数因变量是指在函数中由自变量决定的变量，它的取值依赖于自变量的取值。在数学中，因变量通常用字母表示，如y。因变量的取值范围可以是实数集、整数集、有理数集等，取决于函数的定义域和值域。 函数自变量与因变量之间存在一种映射关系，即每个自变量对应一个唯一的因变量。这种映射关系可以用函数的定义式或图像表示。函数的定义式可以将自变量和因变量之间的关系用数学公式表示出来，而函数的图像则是将自变量和因变量的取值用坐标系上的点表示出来，从而形成一条曲线或曲面。

在 Minecraft 的 colorBlock 子命令中，只需要规定函数的<bgCover>定义域</bgCover>和函数的<bgCover>对应法则</bgCover> 即可构成一完整的函数，进而在游戏中生成图像。不仅如此，colorBlock 还支持参数方程运算，例如：定义域为[-2π, 2π] 且对应法则为 “x=t;y=sin(t)” 的一个函数，其中自变量是 t (time)，参数用“；”号隔开，这种写法与数学中 y=sinx 不同。在数学中， 我们通常喜欢将 x 作为自变量，而在一个三维立体空间中，自变量通常是 t (time 时间)。

## unit 4 运算符号

条件表达式可用符号如下:

自变量: "x"， "y"， "z"， "s1"， "s2"， "dis"

逻辑运算符: "&"，" |"， " ! "

关系运算符: ">"，"<"，"=="， "!=" ，">="， "<="< /p>

算数运算符: "+"，"一"， "*"，"/"，"^"，"%"

赋值运算符:"="

在表达式内可以使用各种函数来规定图像的形态：

函数名 | 概述
--- | ---
abs() | 返回一个数的绝对值
floor() | 将一个数向下取整为最接近的整数
ceil() | 将一个数向上取整为最接近的整数
round() | 四舍五入到最接近的整数
min() | 返回一组数字中的最小值
max() | 返回一组数字中的最大值
pow() | 计算一个数的幂
sqrt() | 计算一个数的平方根
sin() | 计算给定角度（弧度）的正弦值
cos() | 计算给定角度（弧度）的余弦值
... | ...

## unit 5 函数生长动画

### 赋予函数生长动画效果

在以此基础上在子命令parameter前加上 <bgCover>tick (刻度)</bgCover> 以及在生命周期参数后加上所加载的速度 10，这个值规定了一游戏刻加载 10 个粒子，即可加上动画效果。

particleex tickparameter minecraft:end_rod~ ~1 ~ 1 1 1 1 0 0 0 -10.0 10.0 'x=t;y=t^2' 0.1 10 0 null

## unit 6 彩色粒子

colorBlock 的粒子颜色采用 <blue>RGBA</blue> 四原色组成，每个字母分别代表<red>红</red>（Red）、<green>绿</green>（Green）、<blue>蓝</blue>（Blue）和 <alpha>透明度</alpha>（Alpha）。 在一般情况下，RGBA 的表示范围在 [0, 255] 之间，而在 colorBlock 中，这四个参数值表示的是 255/(除)R，255/G，255/B，255/A，这四个值的范围在 [0, 1] 之间。

### 指令部分：

1. 紫红：particleex normal minecraft:end_rod ~ ~1 ~ <bgCover>.8 .2 .8 1</bgCover> 0 0 0 0 0 0 1 0 "vy=0.1" 1.0 null

2. 锭蓝：particleex normal minecraft:end_rod ~ ~1 ~ <bgCover>0 .4 1 1</bgCover> 0 0 0 0 0 0 1 0 "vy=0.1" 1.0 null

3. 赤红：particleex normal minecraft:end_rod ~ ~1 ~ <bgCover>1 0.3 0.5 1</bgCover> 0 0 0 0 0 0 1 0 "vy=0.1" 1.0 null

4. 绿色：particleex normal minecraft:end_rod ~ ~1 ~ <bgCover>0.1 1 0.1 1</bgCover> 0 0 0 0 0 0 1 0 "vy=0.1" 1.0 null

5. 蓝白：particleex normal minecraft:end_rod ~ ~1 ~ <bgCover>0.2 0.5 1 1</bgCover> 0 0 0 0 0 0 1 0 "vy=0.1" 1.0 null

6. 纯白：particleex normal minecraft:end_rod ~ ~1 ~ <bgCover>1 1 1 1</bgCover> 0 0 0 0 0 0 1 0 "vy=0.1" 1.0 null

<yellow>注意</yellow>：不同光影的颜色呈现效果不同，甚至可能会与原本色有明显偏差。例如第 6 条指令效果，原本 1 1 1 1 是一种纯白色， 而使用 BSL+v7.1.02.2 光影却变成了金黄色。

一般情况下，给定<blue> r、g、b </blue>各一个固定的值，就能映射一种颜色， 那么规定一个不断变化的函数来映射<blue>cr、cg、cb</blue>（cr、cg、cb 是 color + red/green/blue 的缩写） 的值，就可以实现很酷炫的颜色变换效果。

### 粒子变色又可以分为两类：

- 表达式颜色渐变
- 速度表达式颜色渐变

### 1. 表达式颜色渐变

particleex rgba tickparameter minecraft:end_rod ~ ~1 ~ 0 0 0 -20.0 20.0 "x,y,cr,cb=t,sin(t),sin(t/7)/5+0.2,sin(t/5)/3-0.6" 0.1 10 0 "vy=0.0" 1.0 null

在 表达式 中给 cr、cg、cb 设置一个不断变化的量，就会更改每一段 距离路径 上的颜色。

### 2. 速度表达式颜色渐变

particleex tickparameter minecraft:end_rod ~ ~1 ~ 1 1 1 1 0 0 0 0 30.0 "x=sin(t);y=t/5;z=cos(t)" 0.1 10 0 <purple>"cr=sin(t/7)/2+.5;cg=sin(t/4)/2+.5"</purple>

在 速度表达式 中给 cr、cg、cb 设置一个不断变化的量，就会更改每一段 时间路径 上的颜色。

总结：<gradient>表达式颜色渐变</gradient> 更改每一段距离路径上的颜色；<gradient>速度表达式颜色渐变</gradient> 更改每一段时间路径上的颜色。

## unit 7 normal (原版)

### 指令格式：

/particleex normal<颗粒> <坐标> <颜色> <速度> <范围> <数量> [寿命] [速度表达式] [计算间隔] [组]

所谓原版，即是在原版 particle 指令上的拓展。normal 是 colorBlock mod 中的一个子命令，它在原版的基础上增加了 <blue>颜色</blue>、<blue>寿命</blue>、<blue>速度表达式</blue>、<blue>计算间隔</blue> 和 <blue>组</blue>。

参数名 | 概述
--- | ---
颗粒 | 自定义粒子类型
坐标 | 自定义粒子的显示位置
颜色 | 自定义粒子的颜色
速度 | 自定义粒子向任意方向移动的向量
范围 | 自定义粒子的生成范围
数量 | 自定义一次性产生的总数量粒子
寿命 | 自定义粒子的从召唤到凋零的生命周期的时长
速度表达式 | 自定义粒子如何去运动，速度表达式也可以看成一个速度函数，速度函数的图像即是整体的运动趋势
计算间隔 | 自定义计算间隔
组 | ...

效果案例

## unit 8 parameter (直角坐标)

三维直角坐标系是由三条相互垂直的坐标轴组成的坐标系统。除了x轴和y轴，还有一条垂直于二者的z轴。这三条坐标轴的交点被称为原点，通常用O表示。 在三维直角坐标系中，每个点都可以用一个有序数对(x, y, z)来表示，其中x表示点在x轴上的位置，y表示点在y轴上的位置，z表示点在z轴上的位置。x轴、y轴和z轴的正方向可以根据需要来确定，通常x轴向右为正方向，y轴向上为正方向，z轴向外为正方向。 三维直角坐标系可以用来描述空间中的点、直线、平面、曲线等。通过在坐标系中的点之间的距离和角度关系，可以进行几何推导和计算。三维直角坐标系也被广泛应用于数学、物理、工程等领域中的问题求解和数据分析中。

在这里，我们主要使用 colorBlock 的 parameter 子命令在 Minecraft 中实现粒子效果。

/particleex parameter<颗粒> <坐标> <颜色> <速度> [begin] [end] <表达式> [计算间隔] [寿命] [速度表达式] [计算间隔] [组]

参数名 | 概述
--- | ---
颗粒 | 自定义粒子类型
坐标 | 自定义粒子的显示位置
颜色 | 自定义粒子的颜色
速度 | 自定义粒子向任意方向移动的向量
begin 和 end | 自定义粒子函数的定义域 [begin, end]， begin 应当小于 end
表达式 | 自定义直角坐标函数图像
计算间隔 | 自定义在函数中以一个固定的间隔量去逐步取每一个粒子
寿命 | 自定义粒子的从召唤到凋零的生命周期的时长
速度表达式 | 自定义粒子如何去运动，速度表达式也可以看成一个速度函数，速度函数的图像即是整体的运动趋势
计算间隔 | 自定义计算间隔
组 | ...

效果案例

## unit 9 polarparameter (极坐标)

极坐标是一种表示平面上点位置的坐标系统。它使用两个数值来确定一个点的位置，一个是极径（r），表示点到原点的距离；另一个是极角（θ），表示点与某个固定方向的夹角。 在极坐标系统中，原点为极点，固定方向为极轴。极径可以是正数、零或负数，负数表示点在极轴的反方向上。极角可以是任意实数，但通常限制在一个周期内，如[0, 2π)或[-π, π)。 极坐标可以方便地描述圆形、螺旋等几何形状，也可以用于表示向量的方向和大小。与直角坐标系相比，极坐标系统在某些情况下更加直观和简洁。但在进行复杂计算和几何分析时，直角坐标系更为常用。 极坐标与直角坐标之间可以相互转换。通过极坐标到直角坐标的转换公式，可以将极坐标表示的点转换为直角坐标表示的点。反之，通过直角坐标到极坐标的转换公式，可以将直角坐标表示的点转换为极坐标表示的点。

/particleex polarparameter<颗粒> <坐标> <颜色> <速度> [begin] [end] <表达式> [计算间隔] [寿命] [速度表达式] [计算间隔] [组]

参数名 | 概述
--- | ---
颗粒 | 自定义粒子类型
坐标 | 自定义粒子的显示位置
颜色 | 自定义粒子的颜色
速度 | 自定义粒子向任意方向移动的向量
begin 和 end | 自定义粒子函数的定义域 [begin, end]， begin 应当小于 end
表达式 | 自定义极坐标函数图像
计算间隔 | 自定义在函数中以一个固定的间隔量去逐步取每一个粒子
寿命 | 自定义粒子的从召唤到凋零的生命周期的时长
速度表达式 | 自定义粒子如何去运动，速度表达式也可以看成一个速度函数，速度函数的图像即是整体的运动趋势
计算间隔 | 自定义计算间隔
组 | ...

效果案例

## unit 10 iamge (打印图像)

particleex image <颗粒> <坐标> <路径> [比例] [x轴旋转] [y轴旋转] [z轴旋转] [翻转] [DPB] [速度] [寿命] [速度表达式] [计算间隔] [组]

参数名 | 概述
--- | ---
颗粒 | 自定义粒子类型
坐标 | 自定义粒子的显示位置
路径 | 链接到 mod 的同级目录的 particleImages 的目录下的图像文件名
比例 | 自定义粒子图像的大小比例，这个值的范围是 [0, 1]
x轴旋转 | 自定义粒子图像延x轴旋转的角度
y轴旋转 | 自定义粒子图像延y轴旋转的角度
z轴旋转 | 自定义粒子图像延z轴旋转的角度
DPB | 自定义一格方块宽可容纳的粒子数
翻转 | 自定义粒子图像以90度为基本单位翻转
速度 | 自定义粒子向任意方向移动的向量
寿命 | 自定义粒子的从召唤到凋零的生命周期的时长
速度表达式 | 自定义粒子如何去运动，速度表达式也可以看成一个速度函数，速度函数的图像即是整体的运动趋势
计算间隔 | 自定义计算间隔
组 | ...

particleex image minecraft:end_rod ~ ~1 ~ <blue>three_link.png</blue> 0.5 0 0 0 not 10.0 0 0 0 500 "vy=0" 1.0 null

<blue> 路径参数 </blue>相当重要！文件名需要的指令中的完全一致（包括后缀名）。

## unit 11 clearparticle (防卡)

清除当前维度所有的粒子，达到减轻设备负载的目的。

particleex clearparticle

### ----------------------------------------------------截至现在已更新内容----------------------------------------------------------

如果您又疑问，欢迎加入我们的交流群与我们讨论。QQ群号：688569824

function结合

敬请期待

下载

## 光影

## replay

replay 是一款 JAVA 版的延伸摄影模组，它可以控制摄像机的移动、翻转视角等操作进行 mc 丝滑镜头航拍， 延时摄影、丝滑镜头，制作大型的高负载场景的创作者的福音！

官网：https://www.replaymod.com

## BSL+v7.1.02.2

BSL 光影，风格偏：唯美、柔和。它也是一个很好的粒子着色器，既保证的流畅的同时画质方面也丝毫不落。能够 配合与 colorBlock 一起使用，而且设备负载较低，渣机的福音。

官网：https://bitslablab.com/bslshaders

## SEUS - DAZZLING

SEUS 魔改系列，风格偏：绚丽、耀眼。它不仅拥有出色的视觉效果，还有亮眼的粒子着色功能。可配合 colorBlock 发出任意色彩的光，能够使 MC 粒子变得十分璀璨夺目。

官网：https://www.sonicether.com/seus

## 向您问好

欢迎使用 colorBlock (/≧▽≦)/~

×

选择粒子颜色

null

R

null

G

null

B
A：
100%
×

## 设置

- 问候语显示
- 生成指令时同时复制指令

## 关于

- 作者：Minecraft_OCEAN | B站空间
- 技术支持：爱吃饺子的吴先生 | B站空间

### 预设参数

七芒星 | | | 转速：rev1:4,r1:7; rev2:-3,r2:-10; |
四叶草 | | | 转速：rev1:4,r1:7; rev2:-3,r2:-10; |
月食 | | | 转速：rev1:4,r1:7; rev2:-3,r2:-10; |
花边 | | | 转速：rev1:4,r1:7; rev2:-3,r2:-10; |

您可以在以此预设的基础上修改并更快的绘制您需要的图形

反馈与建议

我很想听听您的意见，以便我可以改进自己。