# Death Firework Minecraft **26.2** datapack that launches a configurable firework when a player dies. ## Requirements - Minecraft Java Edition **26.2** (pack format 107) - No mods or plugins required ## Install 1. Download the datapack zip from a [release](https://git.timfalken.com/timfa/death-firework/-/releases), or build one locally (see [Build](#build)). 2. Remove any older copy of this datapack from the world's `datapacks` folder. 3. Place the zip **unextracted** in `/datapacks/`. 4. Run `/reload`, or restart the world. 5. Check with `/datapack list enabled`. The zip must have `pack.mcmeta` and `data/` at the root (not inside an extra folder). Release zips are built that way. ## Playing Open the personal colour menu: ```text /trigger df_menu ``` Available colours: red, blue, yellow, green, pink and purple. A player can only change their own colour. Operators can open the global admin menu: ```text /function death_firework:admin/menu ``` Global options: - lifetime: 20 / 40 / 60 / 80 ticks - trail: on / off - sparkle: on / off Defaults: lifetime 60, trail off, sparkle on, colour red. Test the current colour and global settings without dying: ```text /function death_firework:test/current ``` Or trigger the firework with `/kill @s`. Global scores: `/function death_firework:admin/status`. Notes: the admin menu runs `/function` buttons, so it needs sufficient command permission. A firework explosion can damage entities close to the blast. Missing or invalid config values are restored automatically. ## Releases Push a version tag (for example `1.0.0` or `v1.0.0`). The BlueGit pipeline runs **automatically** on that tag (no manual job): it validates the pack, builds the zip, and attaches it to the release. Do not add a second leading `v`; the pipeline strips one if the tag already starts with `v`. The zip is named: ```text death-firework--v.zip ``` The Minecraft version is the single line in the `minecraft-version` file at the repository root (currently `26.2`). Change that file when the pack targets a new game version. It is not included in the zip. ## Build From the repository root, without pushing a tag: ```bash bash scripts/ci/validate.sh bash scripts/ci/pack.sh 1.0.0 ``` The zip is written to `build/out/death-firework-26.2-v1.0.0.zip`.