# TNT Tag

URL: https://greenarrowlol.github.io/TNTGamesCore/docs/features/tnt-tag/
Section: features
Description: Pass the TNT before the timer runs out. Do not be the one holding it.

---

> For a complete page index, fetch https://greenarrowlol.github.io/TNTGamesCore/llms.txt.

Hot-potato with TNT. Tag someone to pass it on, and do not be a tagger when the timer hits zero.

## How it plays

At the start, one or more players become taggers. A tagger carries the TNT and gets Speed II. Touch another player to pass the TNT to them. When the round timer reaches zero, whoever is still a tagger explodes and is eliminated. The round then restarts with the remaining players until one is left.

Effects like glowing taggers, TNT on the head, and explosion sounds are on by default and can be turned off in the config.

## Settings

Defaults come from `config.yml` under `tnt-tag`.

| Setting | What it controls | Default |
| --- | --- | --- |
| Round timer | Seconds before the current taggers explode. | `60` |
| Tag cooldown | Milliseconds before a fresh tag can be passed back. | `2000` |
| Round restart delay | Ticks between one round ending and the next starting. | `60` |
| Taggers | How many players start as taggers. | `1` |
| Min players | Players needed to start. | `2` |
| Max players | Arena capacity. | `16` |

Effect and feedback toggles (all default on unless noted):

| Toggle | What it does |
| --- | --- |
| `effects.tagger-glowing` | Taggers glow so runners can see them. |
| `effects.tnt-on-head` | Taggers wear a TNT block on their head. |
| `effects.explosion-on-death` | Play an explosion effect when a tagger blows up. |
| `effects.explosion-damage` | Deal real explosion damage. Off by default. |
| `sounds.*` | Tag, countdown beep, and explosion sounds. |
| `actionbar.enabled` | Live action-bar showing the tagger and time left. |

Title, chat, and action-bar warning times are lists you can edit (for example title warnings at 5, 4, 3, 2, 1 seconds).

## Set up a TNT Tag arena

```
/tt create <name> tnt_tag
/tt wand
/tt setcorner1 <name>
/tt setcorner2 <name>
/tt setspawn <name>
/tt setlobby <name>
/tt save <name>
/tt setupstatus <name>
```

Tune the round:

```
/tt settimer <name> <seconds>
/tt settaggers <name> <n>
/tt setmin <name> <n>
/tt setmax <name> <n>
```

:::{tip}
More taggers make bigger lobbies frantic. Start with one tagger for small groups and raise it as your player counts grow.
:::

## Related

- [Configuration](/docs/configuration/configuration/): the full `tnt-tag` config block.
- [Commands](/docs/reference/commands/): setup command list.