> ## Documentation Index
> Fetch the complete documentation index at: https://docs.awokenlabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Language

> Switch Awoken Banking into one of 11 built-in languages, or reword any text yourself.

Awoken Banking ships fully translated in **11 languages**. One setting switches the whole thing - bank app, ATM screen, and every notification - into the language you pick. You can also reword any text or add your own language.

## Shipped languages

| Code | Language            |
| ---- | ------------------- |
| `en` | English (default)   |
| `es` | Spanish             |
| `fr` | French              |
| `de` | German              |
| `pt` | Portuguese (Brazil) |
| `cs` | Czech               |
| `it` | Italian             |
| `nl` | Dutch               |
| `pl` | Polish              |
| `sv` | Swedish             |
| `tr` | Turkish             |

## Switch language

Set `Config.Locale` in `config/core.lua` to a code from the table, then restart the resource.

```lua config/core.lua theme={"dark"}
Config.Locale = 'fr'   -- en, es, fr, de, pt, cs, it, nl, pl, sv, tr
```

## Reword or translate text

Every word players see lives in one file per language under `config/locales/` - for French, `config/locales/fr.lua`. Edit the file that matches your language to change wording or fix a translation. Untranslated lines fall back to English, so you can translate a little at a time.

Each file has two parts: **notifications** (short in-game pop-ups, at the top) and the **`web`** table (text shown inside the bank app and ATM).

```lua config/locales/en.lua theme={"dark"}
-- Notifications (top of the file)
atm_not_near = 'There is no ATM nearby.',

-- The app (the `web` table)
web = {
    ['create.title'] = 'Open an account',
},
```

<Warning>
  Leave symbols exactly as they are. `%s`, `%d`, `%g%%` (notifications) and `{name}` tags (`web` table) get filled in with real values - change the words around them, not the markers.
</Warning>

## Add a brand-new language

Copy an existing file in `config/locales/` (English is the fullest) to one named with your language code, e.g. `config/locales/ja.lua`. Change the code at the top and translate the text.

```lua config/locales/ja.lua theme={"dark"}
Config.Locales.ja = {
    atm_not_near = 'ちかくにATMがありません。',
    -- ...the rest of your translations
    web = { },
}
```

Then set `Config.Locale = 'ja'` in `config/core.lua` and restart. New locale files load automatically - there's nothing to register.