> For the complete documentation index, see [llms.txt](https://docs.otherplanet.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.otherplanet.dev/scripts/op-hud-v2/tutorials/how-to-change-locale.md).

# How to change locale

HUD strings (NUI + client keybind labels) load from JSON under locales/.

{% stepper %}
{% step %}
**Pick a language**

Available out of the box:

| File              | Language |
| ----------------- | -------- |
| `locales/en.json` | English  |
| `locales/pl.json` | Polish   |
| {% endstep %}     |          |

{% step %}
**Set Config.Locale**

In `config/MainConfig.lua`:

```lua
Config.Locale = 'pl'
```

Use the file name without `.json`.
{% endstep %}

{% step %}
**Restart the resource**

```
ensure op-hud
```

Or restart the server. Players already in settings should reopen the menu to see updated strings.
{% endstep %}
{% endstepper %}

#### Adding your own language

1. Copy `locales/en.json` to e.g. `locales/de.json`
2. Translate values (keep keys identical)
3. Set `Config.Locale = 'de'`

{% hint style="warning" %}
Do not remove keys the NUI expects. Missing keys fall back poorly in the UI.
{% endhint %}