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

# PlaceholderAPI

> Интеграция с PlaceholderAPI для отображения данных о машинах в других плагинах.

CoolCars предоставляет широкий набор плейсхолдеров, которые можно использовать в табах, скорбордах, голограммах или чате.

**Идентификатор плагина:** `coolcars`

**Формат:** `%coolcars_<placeholder>%`

## Глобальные плейсхолдеры

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

| Плейсхолдер               | Описание                                                   |
| :------------------------ | :--------------------------------------------------------- |
| `%coolcars_active_count%` | Общее количество активных машин на сервере.                |
| `%coolcars_has_car%`      | Возвращает `true`, если у игрока есть хотя бы одна машина. |

***

## Плейсхолдеры текущей машины

Эти плейсхолдеры работают, когда игрок находится внутри машины или является её владельцем.

### Информация о модели

* `%coolcars_car_uuid%` — Уникальный ID машины.
* `%coolcars_car_model_key%` — Технический ID модели (например, `volga`).
* `%coolcars_car_model_name%` — Локализованное название модели.
* `%coolcars_owner_name%` — Имя владельца машины.
* `%coolcars_driver_name%` — Имя текущего водителя.

### Состояние и Движение

* `%coolcars_speed_kmh%` — Текущая скорость в км/ч.
* `%coolcars_speed_mps%` — Текущая скорость в м/с.
* `%coolcars_engine%` — Статус двигателя (Вкл/Выкл).
* `%coolcars_lights%` — Статус фар (Вкл/Выкл).
* `%coolcars_passengers%` — Текущее количество пассажиров.
* `%coolcars_passengers_max%` — Максимальное количество мест.

### Топливо и Здоровье

* `%coolcars_fuel%` — Текущее количество литров.
* `%coolcars_fuel_max%` — Объем бака.
* `%coolcars_fuel_percent%` — Процент заполненности бака.
* `%coolcars_health%` — Текущее HP машины.
* `%coolcars_health_max%` — Максимальное HP.
* `%coolcars_health_percent%` — Процент прочности.

***

## Продвинутые повреждения

Если на сервере включена система повреждений по частям, вы можете выводить состояние каждой зоны.

| Плейсхолдер                   | Описание                                |
| :---------------------------- | :-------------------------------------- |
| `%coolcars_front_percent%`    | Состояние передней части (%).           |
| `%coolcars_rear_percent%`     | Состояние задней части (%).             |
| `%coolcars_wheel_fl_percent%` | Состояние переднего левого колеса (%).  |
| `%coolcars_wheel_fr_percent%` | Состояние переднего правого колеса (%). |
| `%coolcars_wheel_rl_percent%` | Состояние заднего левого колеса (%).    |
| `%coolcars_wheel_rr_percent%` | Состояние заднего правого колеса (%).   |

***

## Координаты и Позиция

* `%coolcars_world%` — Название мира, где находится машина.
* `%coolcars_x%`, `%coolcars_y%`, `%coolcars_z%` — Координаты машины.
* `%coolcars_yaw%` — Направление (угол поворота) машины.