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

# Общий конфиг (config.yml)

> Глобальные настройки плагина CoolCars: база данных, язык, система ключей и интерфейс.

Файл `config.yml` находится в корне папки плагина (`plugins/CoolCars/config.yml`) и содержит настройки, которые влияют на работу всего плагина в целом.

## Система ключей (`keys`)

Этот раздел определяет, как игроки получают доступ к машинам. Вы можете сделать сервер в стиле GTA, где машину можно завести без ключа, или в стиле RP, где ключ обязателен.

```yaml theme={null}
keys:
  enabled: true                         # Включить систему ключей
  require-key-to-start-engine: true     # Нужен ли ключ для запуска
  allow-owner-start-without-key: true   # Владелец может заводить без ключа
  check-entire-inventory: true          # Искать ключ во всем инвентаре
```

<Info>
  Если `check-entire-inventory` выключен, игроку придется держать ключ в основной или второй руке, чтобы завести двигатель.
</Info>

***

## Интерфейс (Action Bar)

CoolCars выводит важную информацию (скорость, топливо, состояние) прямо над панелью предметов игрока.

### Настройка спидометра (`ui.action-bar.car`)

* **format**: Строка, которую видит игрок. Поддерживает множество плейсхолдеров.
* **update-ticks**: Частота обновления. `2` тика — идеальный баланс между плавностью и производительностью.

**Доступные плейсхолдеры:**

* `{speed_kmh}` — Скорость в км/ч.
* `{hp_bar}` — Полоска здоровья.
* `{fuel_percent}` — Процент топлива.
* `{engine}` — Статус двигателя (Вкл/Выкл).

<Frame caption="Пример Action Bar во время вождения">
  <img src="https://mintcdn.com/coolcars/2OnMYzpvWPxiQePr/images/coolcars/actionbar-preview.png?fit=max&auto=format&n=2OnMYzpvWPxiQePr&q=85&s=967b4fda42c71e3b6de7b36498bf2084" width="1883" height="147" data-path="images/coolcars/actionbar-preview.png" />
</Frame>

***

## Языковые настройки (`language`)

Плагин поддерживает автоматическое определение языка игрока.

* **global**: Если `true`, все игроки будут видеть сообщения на языке, указанном в `default`.
* **use-player-locale**: Если `true`, плагин будет смотреть на язык, выбранный в клиенте Minecraft игрока (RU, EN и т.д.).

***

## База данных (`database`)

CoolCars сохраняет данные о владельцах машин, их состоянии и местоположении.

* **type**: `sqlite` (файл) или `mysql` (для связи между серверами).
* **telemetry**: Если включено, плагин записывает историю событий (аварии, заправки), которую можно просмотреть позже.

***

## Команды (`commands`)

Вы можете ограничить использование некоторых административных команд.
Например, `car-heal` позволяет мгновенно починить машину. В конфиге можно разрешить или запретить использование этой команды из консоли.

```yaml theme={null}
commands:
  car-heal:
    enabled: true
    allow-console: true
```