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

# Sounds (sounds.yml)

> Configuration for engine sounds, horns, and environmental effects.

The `sounds.yml` file controls all audio aspects of the plugin. CoolCars supports both standard Minecraft sounds and custom sounds from your resource pack.

## Global Settings (`sounds`)

Here you define general sound playback parameters.

* **enabled**: Global toggle for all plugin sounds.
* **category**: Sound category in Minecraft settings (usually `PLAYERS` or `NEUTRAL`).

### Spatial Sound (`spatial`)

Configures how sound fades as you move away from the vehicle.

* **near-distance-blocks**: Distance at which the sound is heard at full volume.
* **falloff-curve-power**: Fading strength. Higher values make the sound get quieter faster as distance increases.

***

## Events and Effects (`events`)

Each vehicle action can be accompanied by a unique sound.

### Key Events:

* **engine-start**: Sound of the engine starting.
* **horn**: Horn (klaxon) sound.
* **seat-open**: Door opening sound when entering.
* **landing**: Impact sound when hitting the ground.

```yaml theme={null}
events:
  horn:
    enabled: true
    key: "coolcars.horn"      # Sound key from resource pack or Minecraft
    volume: 1.25              # Volume
    pitch: 1.00               # Pitch (tone)
    radius: 36.0              # Audibility radius in blocks
    cooldown-ticks: 24        # Cooldown before reuse
```

***

## Engine Sounds (`engine`)

The engine sound system in CoolCars is dynamic. It changes pitch and volume based on RPM and speed.

* **idle**: Engine sound while stationary.
* **driving**: Engine sound under load (while moving).

### Smooth Transitions (`transition`)

To prevent the sound from "cutting off" when starting to move, delays are used:

* **driving-to-idle-delay-ticks**: Smoothness of the transition from driving to idle.

<Tip>
  For the best effect, use looped sounds in your resource pack.
</Tip>

***

## Specific Movement Sounds

| Event    | Description                                        |
| :------- | :------------------------------------------------- |
| `drift`  | Tire screech sound during sharp turns or drifting. |
| `skid`   | Braking skid sound.                                |
| `impact` | Collision sound with an obstacle.                  |