> For the complete documentation index, see [llms.txt](https://documentation.rcore.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.rcore.cz/paid-resources/rcore_housing/configuration/locale.md).

# Locale

`rcore_housing` reads UI strings and notifications from `data/locales/[locale].lua`.

## 🌍 Selecting a Language

```lua
Config.Locale = 'en'
```

Set `Config.Locale` to the basename of the locale file you want to load. Only `en.lua` ships by default.

## ➕ Adding a New Language

1. Copy `data/locales/en.lua` to `data/locales/[your_locale].lua` (for example `cs.lua`).
2. Translate every value in the table. Leave keys untouched.
3. Set `Config.Locale = 'cs'` and restart the resource.

{% hint style="warning" %}
Do not rename or remove keys. Missing keys fall back to the literal key string in the UI.
{% endhint %}

## 🧩 What's Translated

The locale file covers:

* Property state labels (`FOR_SALE`, `FOR_RENT`, `OWNED`, `RENTED`)
* Upgrade names and feature lists
* Furniture delivery toasts
* Lockpick, breach, and alarm messages
* Access control prompts (member, manager, guest, tenant)
* Rent and utilities bill notifications
* Marketplace listing UI labels
* Real estate business UI strings