# Sound

The `sound` action will play a sound whenever an elevator is used.

---

## Variables

| Variable Name | Description                                                           | Default Value      | Elevator Setting Name | Per-Ele Customizable
|---------------|-----------------------------------------------------------------------|--------------------|-----------------------|----------------------
| `sound`       | Controls the sound that is played                                     | ENTITY_BLAZE_SHOOT | `sound/sound`         | true
| `volume`      | Controls the volume of the played sound                               | 1.0                | `sound/volume`        | true
| `pitch`       | Controls the pitch of the played sound                                | 1.0                | `sound/pitch`         | true
| `global`      | Controls whether the sound is played to the world or just the player. | true               | `sound/global`        | true

---

## Example Usage

```yaml
- 'sound: sound=ENTITY_GHAST_SCREAM volume=5 pitch=0.1 global=true'
```

---

## Notes

- For volumes > 1, the sound does not get louder but will instead be heard from further away.
- Pitch has a maximum value of 2.
- Supported Sounds can be found in the [Sound PaperMC JavaDocs](https://jd.papermc.io/paper/1.21.5/org/bukkit/Sound.html). Different Minecraft versions may vary.