DynFirework

更真实自然的烟花！

> 简介

DynFirework是使用Python编写的Minecraft粒子烟花生成器代码模板，提供了若干模板函数以便生成一定样式的烟花数据包文件( .mcfunction)。

介绍视频

> 前置Mod及版本兼容性

DynFirework的输出指令基于Colorblock的rgbatickparameter和normal子指令，以实现渐变颜色粒子。

由于Colorblock仅支持1.12.2和1.16.5版本，当前版本的DynFirework v1.1生成的指令也只在上述2个版本有效。

理论上可以通过修改输出指令部分的代码并移除渐变色功能，使用原版particle指令以兼容全部版本，这是之后的更新内容之一。

> 依赖

在源码所在根目录打开PowerShell，执行如下指令以下载依赖

pip install -r requirements.txt

> 使用方法

方法1.图形化编辑

DynFirework v1.1使用tkinter编写图形化界面

使用方法为，下载源代码后，运行gui.py，在界面中选择需生成的轨迹、烟花类型（暂时可以通过设置相同的起始点和终止点来实现无轨迹）。

生成器会在根目录下创建一个与GUI界面设置中命名相同的子文件夹，该文件夹即为创建的数据包，可直接复制到存档中的datapacks目录下进行使用。

执行时，根据Datapack Generator内对namespace的命名，在游戏内执行/function namespace:0。 namespace的命名规范请参考Minecraft Wiki

方法2.代码编辑

编写main.py，调用template.md提供的函数模板介绍部分进行自由度更大的烟花设计。

生成器会在代码目录下创建一个functions子文件夹，一个tick对应该文件夹下的一个.mcfuntion文件。

如果你不了解.mcfuntion，可以参考BV1aP41167ef

执行时，根据对namespace的命名，在游戏内执行/function namespace:0。 namespace的命名规范请参考Minecraft Wiki

> 效果展示

双层烟花

双层渐变烟花

单层渐变烟花

> 更新日志

• v1.0 2024.9.30 初始版本，提供多种烟花轨迹模板和烟花模板
• v1.1 2025.1.26 更新图形化界面

> 作者&技术交流/反馈群

• bilibili：TianKong_y
• QQ：技术交流/反馈群

> 鸣谢

• MCXCC303 编写图形化界面