> ## Documentation Index
> Fetch the complete documentation index at: https://pumpkings.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# LiricTNT Special Events: Lava, Tornado, and More

> Admin reference for the five live events in LiricTNT: Lava, Tornado, Tormenta, Yunques, and Geoffrey, each triggered with /extras evento mid-match.

LiricTNT gives administrators the ability to inject live events into any active match with a single command. Events run independently of the game's timer and clean themselves up automatically after their duration expires — you do not need to manually stop them. Use them to keep long matches exciting, surprise viewers during a livestream, or spike the difficulty right before a Sudden Death phase.

**Permission required:** `tnt.admin.extras`

```bash theme={null}
/extras evento <type>
```

## Event Reference

<CardGroup cols={2}>
  <Card title="Lava" icon="fire">
    **Duration:** 15 seconds

    The floor beneath every running player starts converting to lava. The conversion targets the block directly under each alive player's feet, checked every 5 ticks. Players who stop moving are especially vulnerable — the lava catches up to them almost immediately.
  </Card>

  <Card title="Tornado" icon="tornado">
    **Duration:** 15 seconds

    A moving vortex spawns at a random arena spawn point and travels in a random direction, slowly rotating its path. Players within 7 blocks are affected: those inside the 3-block core are launched straight up, while players on the outer edge are flung away horizontally. Blocks at the tornado's base are destroyed as it passes.
  </Card>

  <Card title="Tormenta (Storm)" icon="cloud-bolt">
    **Duration:** 20 seconds

    A lightning storm targets random alive players every 0.75 seconds. Before each strike, a ring of flame particles appears on the ground at the impact point — players have about 1 second to move out of the circle before the actual lightning bolt hits. This telegraphing design keeps the event fair while still creating intense pressure.
  </Card>

  <Card title="Yunques (Anvils)" icon="cube">
    **Duration:** 15 seconds

    Damaged Anvil blocks spawn 15 blocks above random alive players every 0.5 seconds and fall with full gravity physics. A puff of smoke appears on the ground directly below each anvil's projected landing spot so players can see where to dodge. Anvils deal their native Minecraft fall damage on impact and are automatically removed 3 seconds after landing to keep the arena clean.
  </Card>
</CardGroup>

### Geoffrey (Boss Entity)

```bash theme={null}
/extras evento Geoffrey
```

Geoffrey spawns a custom boss entity inside the arena. Unlike the timed events above, Geoffrey persists until the match ends naturally or is force-stopped with `/tnt detener`. The boss is removed automatically during match cleanup, so you do not need to handle it manually.

<Warning>
  Spawning Geoffrey during a very small arena or a Sudden Death phase can make the match extremely difficult. Reserve this event for large open maps with many players still alive.
</Warning>

## Potion Effects

In addition to structured events, you can apply a potion effect to every alive player instantly:

```bash theme={null}
/extras efecto <effect> <level>
```

| Effect       | Suggested Level | Use Case                                                         |
| ------------ | --------------- | ---------------------------------------------------------------- |
| `Speed`      | 1–3             | Speed up a slow match or reward surviving players                |
| `Slowness`   | 1–2             | Balance a match where one player is clearly dominant             |
| `Jump`       | 1–3             | Make floor collapse and spleef matches more chaotic              |
| `Blindness`  | 1               | Short dramatic burst for a jump-scare moment                     |
| `Levitation` | 1–2             | Launch all players into the air during an anvil or tornado event |

<Note>
  Potion effects apply only to **alive** players at the time the command is executed. Spectators and disqualified players are not affected.
</Note>

## Recommended Combinations

<Tip>
  These event + effect combinations work well for live streaming scenarios:

  * **Tension builder:** `/extras evento Tormenta` → 10 seconds later → `/extras efecto Blindness 1`
  * **Chaos round:** `/extras evento Tornado` + `/extras efecto Levitation 2` simultaneously
  * **Final showdown:** When 3 players remain, `/extras evento Geoffrey` + `/extras efecto Speed 2`
</Tip>

## Cleanup and Safety

Every timed event cancels its own scheduler task when either of these conditions is met:

1. The configured duration (in ticks) has elapsed.
2. The match ends or is force-stopped with `/tnt detener`.

This means force-stopping a match safely interrupts any running event without leaving stray tasks or modified blocks behind — the world instance itself is unloaded and destroyed by ASP immediately after the match ends.
