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

# Производительность (performance.yml)

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

Файл `performance.yml` — это сердце вашей машины. Здесь вы определяете, будет ли это тяжелый грузовик или быстрый спорткар.

## Подвеска (`suspension`)

Подвеска определяет, как машина ведет себя на неровностях и как высоко она "сидит" над землей.

* **rest-length**: Высота подвески в покое (обычно `0.55`).
* **stiffness**: Жесткость пружин. Чем выше, тем меньше машина проседает.
* **damping**: Амортизация. Чем выше, тем быстрее машина перестает раскачиваться после прыжка.
* **step-height**: Максимальная высота блока, на который машина может заехать без прыжка (обычно `1.0`).

***

## Трансмиссия и скорость (`drivetrain`)

Здесь настраивается динамика разгона и максимальная скорость.

```yaml theme={null}
drivetrain:
  engine-force: 9700.0           # Мощность двигателя
  acceleration-forward: 1.0      # Множитель ускорения
  max-forward-speed: 34.0        # Макс. скорость (блоков в секунду)
  brake-force: 15000.0           # Сила торможения
```

* **acceleration-curve-exponent**: Определяет кривую разгона. `1.0` — линейно, меньше `1.0` — быстрее в начале, больше `1.0` — быстрее в конце.
* **max-reverse-speed**: Скорость заднего хода (обычно в 3-4 раза меньше передней).

***

## Рулевое управление (`steering`)

Настройка того, как машина поворачивает.

* **max-steer-deg**: Максимальный угол поворота колес (обычно `25-35` градусов).
* **steer-response**: Скорость поворота руля. Чем выше, тем резче машина реагирует на нажатие клавиш.
* **body-roll-limit-deg**: Наклон кузова при повороте. Добавляет реализма.

<Info>
  **High-speed reduction**: В CoolCars есть система уменьшения угла поворота на высокой скорости, чтобы машину не заносило. Настраивается в `tuning`.
</Info>

***

## Физика и масса (`physics`)

* **mass**: Вес машины в кг. Влияет на инерцию и столкновения.
* **drag-coeff**: Сопротивление воздуха. Чем выше, тем быстрее машина теряет скорость без газа.
* **lateral-grip-ground**: Сцепление с дорогой. Низкое значение превратит машину в "дрифт-кар".

***

## Топливная система (`fuel`)

Настройка объема бака и расхода.

```yaml theme={null}
fuel:
  tank-capacity: 60.0            # Объем бака в литрах
  initial-fuel: 35.0             # Топливо при первом спавне
  consumption:
    base-per-tick: 0.0008        # Расход на холостых
    speed-factor: 0.00020        # Доп. расход от скорости
    throttle-factor: 0.00120     # Доп. расход при нажатом газе
```

<Frame caption="Индикатор топлива в Action Bar">
  <img src="https://mintcdn.com/coolcars/kivPNKWcZCb5Cy-N/images/coolcars/fuel-bar.png?fit=max&auto=format&n=kivPNKWcZCb5Cy-N&q=85&s=833695d7762becc91378be50c43bd890" width="338" height="68" data-path="images/coolcars/fuel-bar.png" />
</Frame>

| Параметр        | Описание                                                                 |
| :-------------- | :----------------------------------------------------------------------- |
| `tank-capacity` | Максимальное количество литров, которое можно заправить.                 |
| `consumption`   | Суммарный расход = `base` + (`speed` \* скорость) + (`throttle` \* газ). |