> ## 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 (localization.yml)

> Configuring interface and menu texts for a specific vehicle model.

The `localization.yml` file in each car's folder is responsible for translating interface elements specific to that model: the car control menu and the trunk header.

<Info>
  **Important:** Global plugin messages (chat messages, errors, help) are configured in the `plugins/CoolCars/lang/` folder. The file in the car folder is only for the GUI of that specific model.
</Info>

## Control Menu (`car.menu`)

This section configures button names and hints in the GUI that opens when the interaction key (default **F**) is pressed.

```yaml theme={null}
car:
  menu:
    localization:
      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"
      ru:
        title: "&8Меню автомобиля"
        engine-on: "&aДвигатель: ВКЛ"
        engine-off: "&cДвигатель: ВЫКЛ"
        lights-on: "&eФары: ВКЛ"
        lights-off: "&7Фары: ВЫКЛ"
        trunk: "&6Багажник"
        toggle-hint: "&7Нажмите, чтобы переключить"
```

***

## Trunk (`car.trunk`)

You can configure the trunk inventory header.

```yaml theme={null}
car:
  trunk:
    use-lang-title: true        # Whether to use localization for the title
    title: "Trunk"              # Default title
    localization:
      en:
        title: "&8Vehicle Trunk"
      ru:
        title: "&8Багажник автомобиля"
```

***

## Global Localization (lang/)

If you want to change system messages (e.g., refueling or help text), you need to edit the files in `plugins/CoolCars/lang/en.yml` or `ru.yml`.

### System String Examples:

* `fuel.started`: Message when refueling starts.
* `repair.complete`: Message when repair is successful.
* `actionbar.car`: Status bar format above the hotbar.

<Tip>
  You can use the `/lang server <en|ru>` command to instantly switch the server's primary language and synchronize documentation.
</Tip>

<Frame caption="Example of a localized control menu">
  <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>