# 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 `<world>/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-<minecraft-version>-v<tag>.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`.
