> ## 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.yml)

> Настройка звуковых эффектов двигателя, сигналов и окружения.

Файл `sounds.yml` управляет всей аудио-составляющей плагина. CoolCars поддерживает как стандартные звуки Minecraft, так и кастомные звуки из вашего ресурспака.

## Глобальные настройки (`sounds`)

Здесь вы определяете общие параметры воспроизведения звуков.

* **enabled**: Глобальный переключатель всех звуков плагина.
* **category**: Категория звука в настройках Minecraft (обычно `PLAYERS` или `NEUTRAL`).

### Пространственный звук (`spatial`)

Настройка того, как звук затухает при удалении от машины.

* **near-distance-blocks**: Расстояние, на котором звук слышен в полную громкость.
* **falloff-curve-power**: Сила затухания. Чем выше значение, тем быстрее звук становится тише при удалении.

***

## События и эффекты (`events`)

Каждое действие машины может сопровождаться уникальным звуком.

### Основные события:

* **engine-start**: Звук запуска двигателя.
* **horn**: Звук клаксона (сигнала).
* **seat-open**: Звук открытия двери при посадке.
* **landing**: Звук удара о землю при падении.

```yaml theme={null}
events:
  horn:
    enabled: true
    key: "coolcars.horn"      # Ключ звука из ресурспака или Minecraft
    volume: 1.25              # Громкость
    pitch: 1.00               # Высота (тон)
    radius: 36.0              # Радиус слышимости в блоках
    cooldown-ticks: 24        # Задержка перед повторным использованием
```

***

## Звуки двигателя (`engine`)

Система звука двигателя в CoolCars динамическая. Она меняет тон и громкость в зависимости от оборотов и скорости.

* **idle**: Звук работающего двигателя на месте.
* **driving**: Звук двигателя под нагрузкой (при движении).

### Плавные переходы (`transition`)

Чтобы звук не "обрывался" при начале движения, используются задержки:

* **driving-to-idle-delay-ticks**: Плавность перехода от езды к холостому ходу.

<Tip>
  Для лучшего эффекта используйте зацикленные (looped) звуки в вашем ресурспаке.
</Tip>

***

## Специфические звуки движения

| Событие  | Описание                                       |
| :------- | :--------------------------------------------- |
| `drift`  | Звук визга шин при резком повороте или заносе. |
| `skid`   | Звук торможения юзом.                          |
| `impact` | Звук столкновения с препятствием.              |