简介

• 适用于 Minecraft 1.21.11 的烟花 / 粒子效果 datapack。
• 作者：Mxpea（Aurelith / Mxpea）。
• 自动初始化计分板与 storage，提供随机烟花、彩虹、环形、射线、线段、字母像素等效果。
• 注意，如果你在你的数据包中调用此数据包，请参考run/目录下的实例正确设置参数后调用，而不是直接使用run/目录下的函数！

功能概览

• 自动加载与 Tick

  • 加载函数：firework:load
  • 周期函数：firework:tick
  • 注册文件：load.json / tick.json

• 随机烟花

  • 主入口：firework:fireworks/ran_firework
  • 参数子流程：effects/fireworks_ran/

• 粒子与彩虹

  • 彩虹数值更新：firework:effects/rainbow/rainbow_color_gen
  • 彩虹粒子入口：firework:run/rainbow
  • 随机闪光 x10：firework:run/ran_flash_10
  • 随机 Dust：firework:run/ran_dust

• 环形、射线、线段

  • 环形：firework:run/ring_normal、firework:run/ring_rainbow
  • 射线：firework:run/ray_summon
  • 线段：firework:run/line_summon

• 闪电效果

  • 闪电入口：firework:run/lightning_summon
  • 计算流程：lightning/

• 球形粒子

  • 球形入口：firework:run/ball_summon
  • 计算流程：ball/

• 其他效果与工具

  • 彩色下落方块爆散：firework:run/colord_block_exp
  • UUID 工具：firework:gu/generate、firework:gu/convert、firework:tools/uuid_get
  • 字母像素：letters/

快速开始

1. 将 firework/ 放入世界目录 datapacks/。
2. 运行任意入口函数测试效果（见下方示例命令）。

说明：firework:load 会初始化大量计分板（如 rings、ray_settings、line 等）与 storage 键。

示例命令

• /function firework:fireworks/ran_firework：生成一次随机参数烟花（颜色/拖尾/闪烁/类型随机）。
• /function firework:run/ran_flash_10：连续触发 10 次随机闪光粒子，适合快速营造爆闪效果。
• /function firework:run/ran_dust：生成随机颜色的 dust 粒子。
• /function firework:run/rainbow：按当前彩虹参数生成彩虹粒子。
• /function firework:run/ring_normal：以固定粒子（end_rod）生成圆环。
• /function firework:run/ring_rainbow：以彩虹粒子生成圆环。
• /function firework:run/ray_summon：生成射线效果（需先设置速度/寿命等参数）。
• /function firework:run/line_summon：根据起止点与步数绘制线段粒子。
• /function firework:run/lightning_summon：生成闪电效果（需先设置吸引强度/步长等参数）。
• /function firework:run/ball_summon：按球半径与层数生成球形粒子。
• /function firework:run/colord_block_exp：生成彩色下落方块爆散效果（依赖 Motion API）。
• /function firework:letters/a：绘制字母 A 的像素图案。
• /function firework:gu/generate：生成 UUID 数据并写入相关存储。
• /function firework:tools/uuid_get：读取并显示当前实体/上下文 UUID 信息。

参数设置提示（常用）

• 环形效果依赖：steps rings、distance rings。
• 球形效果依赖：steps ball、distance ball（distance ball 为球半径；当前实现按缩放写入 storage 以便更精细控制）。
• 射线效果依赖：speed ray_settings、lifetime ray_settings、offset_x ray_settings、offset_y ray_settings。
• 线段效果依赖：steps line，并可通过 tag @s add set_poz 记录终点坐标。
• 闪电效果依赖：attrack lightning、stepl lightning、delta lightning、maxstep lightning，并通过 tag @s add set_poz 记录终点坐标。推荐吸引吸引强度>=步长。

目录索引

• 入口函数目录：run/
• 烟花参数目录：effects/fireworks_ran/
• 环形计算目录：effects/ring/
• 球形目录：ball/
• 射线目录：ray/
• 线段目录：line/
• 闪电目录：lightning/
• 字母目录：letters/

依赖说明

• 本不包含 Mxpea.s.Motion.API。其中部分彩色下落方块效果（如 firework:run/colord_block_exp）依赖该 API。

常见问题

• /function 无反应：确认 datapack 路径正确并执行 /reload，检查 load.json 与 tick.json 是否存在。
• 射线 / 线段不执行：先设置必要计分板参数（见上方“参数设置提示”）。
• 球形效果无输出：检查 steps ball 是否大于 0，并确认 distance ball 为合理范围的数值。

许可证

• 项目采用 MIT 许可，详见 LICENSE。

鸣谢

• 项目包含来自 gu 的 UUID 相关代码，原始许可证为 The Unlicense；本项目按其条款进行再分发。