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

# Поведение (behavior.yml)

> Настройка прочности, системы повреждений, коллизий и боевых характеристик.

Файл `behavior.yml` определяет, как машина взаимодействует с миром: ломается ли она при ударах, может ли давить мобов и как работает система ремонта.

## Прочность и Регенерация (`health`)

Машина может иметь общий запас здоровья и систему автоматического восстановления.

* **max**: Максимальное HP машины (например, `1000.0`).
* **engine-disabled-health-percent**: Процент здоровья (например, `0.10` или 10%), при котором двигатель глохнет и не заводится до ремонта.
* **regen**: Если включено, машина будет медленно чиниться сама, если её не били в течение `delay-ticks`.

***

## Система повреждений по частям (`damage`)

CoolCars поддерживает продвинутую систему повреждений. Вы можете разбить переднюю часть, заднюю или колеса по отдельности.

```yaml theme={null}
damage:
  parts:
    front:
      max-health: 350.0
    rear:
      max-health: 300.0
    wheels:
      max-health: 120.0
```

### Эффекты повреждений:

* **slowdown-start-percent**: При каком % здоровья колес машина начнет ехать медленнее.
* **smoke-threshold-percent**: При каком % здоровья кузова из-под капота пойдет черный дым.

***

## Урон при приземлении (`landing`)

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

* **min-impact-speed**: Минимальная скорость падения, при которой начинает засчитываться урон.
* **height-ranges**: Вы можете настроить фиксированный урон для разных высот. Например:
  * Падение с 3-5 блоков: легкие повреждения колес.
  * Падение с 10+ блоков: критический урон двигателю.

***

## Коллизии и Столкновения (`collision`)

Определяет физические размеры машины для столкновений с блоками.

* **half-width / half-length**: Половина ширины и длины хитбокса.
* **wall-damping**: Насколько сильно гасится скорость при ударе о стену.
* **unstuck**: Параметры системы "анти-застревания", которая выталкивает машину, если она попала внутрь блоков.

***

## Боевые параметры (`combat`)

### Таран (`ram`)

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

* **min-speed**: Скорость, выше которой таран начинает работать.
* **damage-scale**: Множитель урона от скорости.
* **knockback**: Сила отбрасывания цели.

### Урон по машине (`vehicle-damage`)

* **melee**: Можно ли бить машину мечом/рукой.
* **projectiles**: Урон от стрел, трезубцев и других снарядов. Вы можете включить `stick-arrows`, чтобы стрелы втыкались в кузов машины!

<Info>
  **Совет:** Для реализма включите `ignore-car-occupants`, чтобы стрелы попадали в машину, а не "пролетали" сквозь неё в водителя.
</Info>