<\/p>\n
## Introduction<\/p>\n
– A firework \/ particle effects datapack for Minecraft 1.21.11.
\n– Author: Mxpea (Aurelith \/ Mxpea).
\n– Automatically initializes scoreboards and storage, providing random fireworks, rainbow, ring, ray, line, letter pixel effects, and more.<\/p>\n
## Feature Overview<\/p>\n
– Auto-load and Tick
\n – Load function: [`firework:load`](firework\/data\/firework\/function\/load.mcfunction)
\n – Tick function: [`firework:tick`](firework\/data\/firework\/function\/tick.mcfunction)
\n – Registration files: [load.json](firework\/data\/minecraft\/tags\/function\/load.json) \/ [tick.json](firework\/data\/minecraft\/tags\/function\/tick.json)<\/p>\n
– Random Firework
\n – Main entry: [`firework:fireworks\/ran_firework`](firework\/data\/firework\/function\/fireworks\/ran_firework.mcfunction)
\n – Parameter subroutines: [`effects\/fireworks_ran\/`](firework\/data\/firework\/function\/effects\/fireworks_ran)<\/p>\n
– Particles & Rainbow
\n – Rainbow value generation: [`firework:effects\/rainbow\/rainbow_color_gen`](firework\/data\/firework\/function\/effects\/rainbow\/rainbow_color_gen.mcfunction)
\n – Rainbow particle entry: [`firework:run\/rainbow`](firework\/data\/firework\/function\/run\/rainbow.mcfunction)
\n – Random flash x10: [`firework:run\/ran_flash_10`](firework\/data\/firework\/function\/run\/ran_flash_10.mcfunction)
\n – Random Dust: [`firework:run\/ran_dust`](firework\/data\/firework\/function\/run\/ran_dust.mcfunction)<\/p>\n
– Rings, Rays, Lines
\n – Rings: [`firework:run\/ring_normal`](firework\/data\/firework\/function\/run\/ring_normal.mcfunction), [`firework:run\/ring_rainbow`](firework\/data\/firework\/function\/run\/ring_rainbow.mcfunction)
\n – Rays: [`firework:run\/ray_summon`](firework\/data\/firework\/function\/run\/ray_summon.mcfunction)
\n – Lines: [`firework:run\/line_summon`](firework\/data\/firework\/function\/run\/line_summon.mcfunction)<\/p>\n
– Lightning Effect
\n – Lightning entry: [`firework:run\/lightning_summon`](firework\/data\/firework\/function\/run\/lightning_summon.mcfunction)
\n – Calculation routines: [`lightning\/`](firework\/data\/firework\/function\/lightning)<\/p>\n
– Spherical Particles
\n – Sphere entry: [`firework:run\/ball_summon`](firework\/data\/firework\/function\/run\/ball_summon.mcfunction)
\n – Calculation routines: [`ball\/`](firework\/data\/firework\/function\/ball)<\/p>\n
– Other Effects & Utilities
\n – Colored falling block explosion: [`firework:run\/colord_block_exp`](firework\/data\/firework\/function\/run\/colord_block_exp.mcfunction)
\n – UUID utilities: [`firework:gu\/generate`](firework\/data\/firework\/function\/gu\/generate.mcfunction), [`firework:gu\/convert`](firework\/data\/firework\/function\/gu\/convert.mcfunction), [`firework:tools\/uuid_get`](firework\/data\/firework\/function\/tools\/uuid_get.mcfunction)
\n – Letter pixels: [`letters\/`](firework\/data\/firework\/function\/letters)<\/p>\n
## Quick Start<\/p>\n
1. Place the `firework\/` folder into the world’s `datapacks\/` directory.
\n2. Run any entry function to test effects (see example commands below).<\/p>\n
> Note: [`firework:load`](firework\/data\/firework\/function\/load.mcfunction) initializes many scoreboards (e.g., `rings`, `ray_settings`, `line`) and storage keys.<\/p>\n
## Example Commands<\/p>\n
– `\/function firework:fireworks\/ran_firework`: Generates a random firework (colors, trail, twinkle, type random).
\n– `\/function firework:run\/ran_flash_10`: Triggers 10 random flash particles in quick succession, good for strobe effects.
\n– `\/function firework:run\/ran_dust`: Spawns a random colored dust particle.
\n– `\/function firework:run\/rainbow`: Spawns rainbow particles using current rainbow parameters.
\n– `\/function firework:run\/ring_normal`: Renders a ring with fixed particles (end_rod).
\n– `\/function firework:run\/ring_rainbow`: Renders a ring with rainbow particles.
\n– `\/function firework:run\/ray_summon`: Spawns a ray effect (requires velocity\/lifetime parameters set first).
\n– `\/function firework:run\/line_summon`: Draws line particles between start and end points with step count.
\n– `\/function firework:run\/lightning_summon`: Spawns a lightning effect (requires attraction strength\/step length etc. set first).
\n– `\/function firework:run\/ball_summon`: Spawns spherical particles based on radius and layer count.
\n– `\/function firework:run\/colord_block_exp`: Spawns a colored falling block explosion (depends on Motion API).
\n– `\/function firework:letters\/a`: Draws the pixel pattern of letter A.
\n– `\/function firework:gu\/generate`: Generates UUID data and writes to storage.
\n– `\/function firework:tools\/uuid_get`: Reads and displays UUID info of current entity\/context.<\/p>\n
## Parameter Setup Hints (Common)<\/p>\n
– Ring effect depends on: `steps rings`, `distance rings`.
\n– Sphere effect depends on: `steps ball`, `distance ball` (distance ball is radius; implementation uses scaled storage for finer control).
\n– Ray effect depends on: `speed ray_settings`, `lifetime ray_settings`, `offset_x ray_settings`, `offset_y ray_settings`.
\n– Line effect depends on: `steps line`, and requires `tag @s add set_poz` to record endpoint coordinates.
\n– Lightning effect depends on: `attrack lightning`, `stepl lightning`, `delta lightning`, `maxstep lightning`, and requires `tag @s add set_poz` to record endpoint coordinates.<\/p>\n
## Directory Index<\/p>\n
– Entry functions: [run\/](firework\/data\/firework\/function\/run)
\n– Firework parameter routines: [effects\/fireworks_ran\/](firework\/data\/firework\/function\/effects\/fireworks_ran)
\n– Ring calculation: [effects\/ring\/](firework\/data\/firework\/function\/effects\/ring)
\n– Sphere: [ball\/](firework\/data\/firework\/function\/ball)
\n– Ray: [ray\/](firework\/data\/firework\/function\/ray)
\n– Line: [line\/](firework\/data\/firework\/function\/line)
\n– Lightning: [lightning\/](firework\/data\/firework\/function\/lightning)
\n– Letters: [letters\/](firework\/data\/firework\/function\/letters)<\/p>\n
## Dependencies<\/p>\n
– This pack does not include `Mxpea.s.Motion.API`. Some colored falling block effects (e.g., [`firework:run\/colord_block_exp`](firework\/data\/firework\/function\/run\/colord_block_exp.mcfunction)) depend on that API.<\/p>\n
## Common Issues<\/p>\n
– `\/function` no response: Verify datapack path and run `\/reload`, check that [load.json](firework\/data\/minecraft\/tags\/function\/load.json) and [tick.json](firework\/data\/minecraft\/tags\/function\/tick.json) exist.
\n– Ray\/line not executing: Set required scoreboard parameters first (see “Parameter Setup Hints” above).
\n– Sphere effect not showing: Check that `steps ball` > 0 and `distance ball` is within a reasonable range.<\/p>\n
## License<\/p>\n
– This project is licensed under the MIT License, see [LICENSE](LICENSE).<\/p>\n
## Acknowledgements<\/p>\n
– Includes UUID-related code from gu, originally under The Unlicense; redistributed according to its terms.<\/p>\n","protected":false},"excerpt":{"rendered":"
A fireworks\/particle effects datapack for Minecraft (1.21.11 environment). It provides a large number of function-based effects, glyphs, and firework summoning logic.<\/p>\n","protected":false},"featured_media":70350,"template":"","meta":{"_minecraft_slug":"firework!","_minecraft_project_id":"sRXMN8LC","_minecraft_author":"Aurelith_MX","_minecraft_license":"MIT","_minecraft_downloads":46,"_minecraft_follows":0,"_minecraft_client_side":"optional","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"firework!.zip","_minecraft_size_bytes":5442886,"_minecraft_version_count":8,"_minecraft_updated_at":"2026-05-15T23:27:15.269209Z","_minecraft_date_created":"2026-02-21T08:24:49.702533Z","_minecraft_date_modified":"2026-05-13T12:50:17.799610Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/firework!","_minecraft_icon_attachment_id":70350,"_minecraft_imported_at":"2026-06-04T00:03:54+00:00","_minecraft_import_hash":"886c502465665a1eba673da46454caf7","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[84,156,89,873],"mod_loader":[86],"minecraft_version":[41],"class_list":["post-70349","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-datapack","mod_category-decoration","mod_category-game-mechanics","mod_category-library","mod_loader-datapack","minecraft_version-1-21-11"],"yoast_head":"\n