FIREWORK!

Introduction

• A firework/particle effect datapack for Minecraft 1.21.11.
• Author: Mxpea (Aurelith / Mxpea).
• Automatically initializes scoreboards and storage, providing effects such as random fireworks, rainbows, rings, rays, line segments, spheres, and pixel letters.

Feature Overview

• Automatic Load and Tick

  • Load function: firework:load
  • Tick function: firework:tick
  • Registration files: load.json / tick.json

• Random Fireworks

  • Main entry: firework:fireworks/ran_firework
  • Parameter sub-processes: effects/fireworks_ran/

• Particles and Rainbows

  • Rainbow value update: firework:effects/rainbow/rainbow_color_gen
  • Rainbow particle entry: firework:run/rainbow
  • Random flash x10: firework:run/ran_flash_10
  • Random Dust: firework:run/ran_dust

• Rings, Rays, Line Segments

  • Rings: firework:run/ring_normal, firework:run/ring_rainbow
  • Rays: firework:run/ray_summon
  • Line segments: firework:run/line_summon

• Spherical Particles

  • Sphere entry: firework:run/ball_summon
  • Calculation process: ball/

• Other Effects and Utilities

  • Colored falling block explosion: firework:run/colord_block_exp
  • UUID tools: firework:gu/generate, firework:gu/convert, firework:tools/uuid_get
  • Pixel letters: letters/

Quick Start

1. Place the firework/ folder into your world's datapacks/ directory.
2. Run any entry function to test the effects (see example commands below).

Note: firework:load initializes numerous scoreboards (e.g., rings, ray_settings, line, etc.) and storage keys.

Example Commands

• /function firework:fireworks/ran_firework: Generates a firework with random parameters (random color/trail/twinkle/type).
• /function firework:run/ran_flash_10: Triggers 10 consecutive random flash particles, ideal for creating rapid strobe effects.
• /function firework:run/ran_dust: Generates dust particles with random colors.
• /function firework:run/rainbow: Generates rainbow particles based on current rainbow parameters.
• /function firework:run/ring_normal: Creates a ring using fixed particles (end rod).
• /function firework:run/ring_rainbow: Creates a ring using rainbow particles.
• /function firework:run/ray_summon: Generates a ray effect (requires setting speed/lifetime parameters first).
• /function firework:run/line_summon: Draws a line of particles based on start/end points and step count.
• /function firework:run/ball_summon: Generates a spherical particle shell based on radius and layers.
• /function firework:run/colord_block_exp: Generates a colorful falling block explosion effect (depends on Motion API).
• /function firework:letters/a: Draws the pixel pattern for the letter A.
• /function firework:gu/generate: Generates UUID data and writes it to relevant storage.
• /function firework:tools/uuid_get: Reads and displays UUID information for the current entity/context.

Parameter Setup Tips (Commonly Used)

• Ring effects depend on: steps rings, distance rings.
• Sphere effects depend on: steps ball, distance ball (distance ball is the radius; the current implementation writes scaled values to storage for finer control).
• Ray effects depend on: speed ray_settings, lifetime ray_settings, offset_x ray_settings, offset_y ray_settings.
• Line effects depend on: steps line, and you can use tag @s add set_poz to record the end point coordinates.

Directory Index

• Entry functions directory: run/
• Firework parameters directory: effects/fireworks_ran/
• Ring calculation directory: effects/ring/
• Sphere directory: ball/
• Ray directory: ray/
• Line directory: line/
• Letters directory: letters/

Dependency Notice

• This pack does not include Mxpea.s.Motion.API. Some colored falling block effects (such as firework:run/colord_block_exp) depend on that API.

Common Issues

• /function does nothing: Verify that the datapack path is correct and run /reload. Check that load.json and tick.json exist.
• Rays/lines do not execute: Ensure the required scoreboard parameters are set first (see "Parameter Setup Tips" above).
• Sphere effects show no output: Check that steps ball is greater than 0 and distance ball is set to a reasonable value.

License

• This project is licensed under the MIT License. See LICENSE for details.

Acknowledgements

• This project includes UUID-related code from gu, originally released under The Unlicense; it is redistributed here in accordance with its terms.