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

# Локализация (localization.yml)

> Настройка текстов интерфейса и меню для конкретной модели автомобиля.

Файл `localization.yml` в папке каждой машины отвечает за перевод элементов интерфейса, специфичных для этой модели: меню управления и заголовка багажника.

<Info>
  **Важно:** Глобальные сообщения плагина (сообщения в чате, ошибки, помощь) настраиваются в папке `plugins/CoolCars/lang/`. Файл в папке машины нужен только для GUI этой конкретной модели.
</Info>

## Меню управления (`car.menu`)

Здесь настраиваются названия кнопок и подсказки в GUI, которое открывается при нажатии клавиши взаимодействия (по умолчанию **F**).

```yaml theme={null}
car:
  menu:
    localization:
      ru:
        title: "&8Меню автомобиля"
        engine-on: "&aДвигатель: ВКЛ"
        engine-off: "&cДвигатель: ВЫКЛ"
        lights-on: "&eФары: ВКЛ"
        lights-off: "&7Фары: ВЫКЛ"
        trunk: "&6Багажник"
        toggle-hint: "&7Нажмите, чтобы переключить"
      en:
        title: "&8Car Menu"
        engine-on: "&aEngine: ON"
        engine-off: "&cEngine: OFF"
        lights-on: "&eHeadlights: ON"
        lights-off: "&7Headlights: OFF"
        trunk: "&6Open trunk"
        toggle-hint: "&7Click to toggle"
```

***

## Багажник (`car.trunk`)

Вы можете настроить заголовок инвентаря багажника.

```yaml theme={null}
car:
  trunk:
    use-lang-title: true        # Использовать ли локализацию для заголовка
    title: "Trunk"              # Заголовок по умолчанию
    localization:
      ru:
        title: "&8Багажник автомобиля"
      en:
        title: "&8Vehicle Trunk"
```

***

## Глобальная локализация (lang/)

Если вы хотите изменить системные сообщения (например, текст заправки или помощи), вам нужно редактировать файлы в `plugins/CoolCars/lang/ru.yml` или `en.yml`.

### Примеры системных строк:

* `fuel.started`: Сообщение о начале заправки.
* `repair.complete`: Сообщение об успешном ремонте.
* `actionbar.car`: Формат строки состояния над хотбаром.

<Tip>
  Вы можете использовать команду `/lang server <ru|en>`, чтобы мгновенно переключить основной язык сервера и синхронизировать документацию.
</Tip>

<Frame caption="Пример локализованного меню управления">
  <img src="https://mintcdn.com/coolcars/kivPNKWcZCb5Cy-N/images/coolcars/localization-demo.png?fit=max&auto=format&n=kivPNKWcZCb5Cy-N&q=85&s=e63af82ba11c808c2e0ef594e26d01b7" width="902" height="241" data-path="images/coolcars/localization-demo.png" />
</Frame>